# Q. What is this file?
# A. This file contains options which allow you to configure your multiworld experience while allowing
#    others to play how they want as well.
#
# Q. How do I use it?
# A. The options in this file are weighted. This means the higher number you assign to a value, the
#    more chances you have for that option to be chosen. For example, an option like this:
#
#    map_shuffle:
#      on: 5
#      off: 15
#
#    Means you have 5 chances for map shuffle to occur, and 15 chances for map shuffle to be turned
#    off.
#
# Q. I've never seen a file like this before. What characters am I allowed to use?
# A. This is a .yaml file. You are allowed to use most characters.
#    To test if your yaml is valid or not, you can use this website:
#        http://www.yamllint.com/
#    You can also verify that your Archipelago options are valid at this site:
#        https://archipelago.gg/check

# Your name in-game, limited to 16 characters.
#     {player} will be replaced with the player's slot number.
#     {PLAYER} will be replaced with the player's slot number, if that slot number is greater than 1.
#     {number} will be replaced with the counter value of the name.
#     {NUMBER} will be replaced with the counter value of the name, if the counter value is greater than 1.
name: PuzzlerDice

# Used to describe your yaml. Useful if you have multiple files.
description: Default Yacht Dice Template

game: Yacht Dice
requires:
  version: 0.6.1 # Version of Archipelago required for this yaml to work as expected.

Yacht Dice:
  # Game Options
  progression_balancing:
    # A system that can move progression earlier, to try and prevent the player from getting stuck and bored early.
    # 
    # A lower setting means more getting stuck. A higher setting means less getting stuck.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 0
    # Maximum value is 99
    random: 0
    random-low: 0
    random-high: 0
    disabled: 0 # equivalent to 0
    normal: 50 # equivalent to 50
    extreme: 0 # equivalent to 99

  accessibility:
    # Set rules for reachability of your items/locations.
    # 
    # **Full:** ensure everything can be reached and acquired.
    # 
    # **Minimal:** ensure what is needed to reach your goal can be acquired.
    full: 50
    minimal: 0

  game_difficulty:
    # Difficulty. This option determines how difficult the scores are to achieve.
    # Easy: for beginners. No luck required, just roll the dice and have fun. Lower final goal.
    # Medium: intended difficulty. If you play smart, you will finish the game without any trouble.
    # Hard: you will need to play smart and be lucky.
    # Extreme: really hard mode, which requires many brain wrinkles and insane luck. NOT RECOMMENDED FOR MULTIWORLDS.
    easy: 0
    medium: 50
    hard: 0
    extreme: 0

  score_for_last_check:
    # The items in the item pool will always allow you to reach a score of 1000.
    # By default, the last check is also at a score of 1000.
    # However, you can set the score for the last check to be lower. This will make the game shorter and easier.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 500
    # Maximum value is 1000
    1000: 50
    random: 0
    random-low: 0
    random-high: 0

  score_for_goal:
    # This option determines what score you need to reach to finish the game.
    # It cannot be higher than the score for the last check (if it is, this option is changed automatically).
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 500
    # Maximum value is 1000
    777: 50
    random: 0
    random-low: 0
    random-high: 0

  minimal_number_of_dice_and_rolls:
    # The minimal number of dice and rolls in the pool.
    # These are guaranteed, unlike the later items.
    # You can never get more than 8 dice and 5 rolls.
    # You start with one dice and one roll.
    5_dice_and_3_rolls: 50
    5_dice_and_5_rolls: 0
    6_dice_and_4_rolls: 0
    7_dice_and_3_rolls: 0
    8_dice_and_2_rolls: 0

  number_of_dice_fragments_per_dice:
    # Dice can be split into fragments, gathering enough will give you an extra dice.
    # You start with one dice, and there will always be one full dice in the pool.
    # The other dice are split into fragments, according to this option.
    # Setting this to 1 fragment per dice just puts "Dice" objects in the pool.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 1
    # Maximum value is 5
    4: 50
    random: 0
    random-low: 0
    random-high: 0

  number_of_roll_fragments_per_roll:
    # Rolls can be split into fragments, gathering enough will give you an extra roll.
    # You start with one roll, and there will always be one full roll in the pool.
    # The other rolls are split into fragments, according to this option.
    # Setting this to 1 fragment per roll just puts "Roll" objects in the pool.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 1
    # Maximum value is 5
    4: 50
    random: 0
    random-low: 0
    random-high: 0

  alternative_categories:
    # There are 16 default categories, but there are also 16 alternative categories.
    # These alternative categories can be randomly selected to replace the default categories.
    # They are a little strange, but can give a fun new experience.
    # In the game, you can hover over categories to check what they do.
    # This option determines the number of alternative categories in your game.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 0
    # Maximum value is 16
    0: 50
    random: 0
    random-low: 0
    random-high: 0

  allow_manual_input:
    # If allowed, players can roll IRL dice and input them manually into the game.
    # By sending "manual" in the chat, an input field appears where you can type your dice rolls.
    # Of course, we cannot check anymore if the player is playing fair.
    yes_allow: 50
    no_dont_allow: 0

  # Extra progression items
  weight_of_dice:
    # The item pool is always filled in such a way that you can reach a score of 1000.
    # Extra progression items are added that will help you on your quest.
    # You can set the weight for each extra progressive item in the following options.
    # 
    # Of course, more dice = more points!
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 0
    # Maximum value is 100
    5: 50
    random: 0
    random-low: 0
    random-high: 0

  weight_of_roll:
    # With more rolls, you will be able to reach higher scores.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 0
    # Maximum value is 100
    20: 50
    random: 0
    random-low: 0
    random-high: 0

  weight_of_fixed_score_multiplier:
    # Getting a Fixed Score Multiplier will boost all future scores by 10%.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 0
    # Maximum value is 100
    30: 50
    random: 0
    random-low: 0
    random-high: 0

  weight_of_step_score_multiplier:
    # The Step Score Multiplier boosts your multiplier after every roll by 1%, and resets on sheet reset.
    # So, keep high scoring categories for later to get the most out of them.
    # By default, this item is not included. It is fun however, you just need to know the above strategy.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 0
    # Maximum value is 100
    0: 50
    random: 0
    random-low: 0
    random-high: 0

  weight_of_double_category:
    # This option allows categories to appear multiple times.
    # Each time you get a category after the first, its score value gets doubled.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 0
    # Maximum value is 100
    50: 50
    random: 0
    random-low: 0
    random-high: 0

  weight_of_points:
    # Are you tired of rolling dice countless times and tallying up points one by one, all by yourself? 
    # Worry not, as this option will simply add some points items to the item pool! 
    # And getting one of these points items gives you... points!
    # Imagine how nice it would be to find tons of them. Or even better, having others find them FOR you!
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 0
    # Maximum value is 100
    20: 50
    random: 0
    random-low: 0
    random-high: 0

  points_size:
    # If you choose to add points to the item pool, you can choose to have many small points,
    # medium-size points, a few larger points, or a mix of them.
    small: 0
    medium: 50
    large: 0
    mix: 0

  # Other items
  minimize_extra_items:
    # Besides necessary items, Yacht Dice has extra useful/filler items in the item pool.
    # It is possible however to decrease the number of locations and extra items.
    # This option will:
    # - decrease the number of locations at the start (you'll start with 2 dice and 2 rolls).
    # - will limit the number of dice/roll fragments per dice/roll to 2.
    # - in multiplayer games, it will reduce the number of filler items.
    no_dont: 50
    yes_please: 0

  add_bonus_points:
    # Yacht Dice typically has space for extra items.
    # This option determines if bonus points are put into the item pool.
    # They make the game a little bit easier, as they are not considered in the logic.
    # 
    # All Of It: fill all locations with extra points
    # Sure: put some bonus points in
    # Never: do not put any bonus points
    all_of_it: 0
    sure: 50
    never: 0

  add_story_chapters:
    # Yacht Dice typically has space for more items.
    # This option determines if extra story chapters are put into the item pool.
    # Note: if you have extra points on "all_of_it", there will not be story chapters.
    # 
    # All Of It: fill all locations with story chapters
    # Sure: if there is space left, put in 10 story chapters.
    # Never: do not put any story chapters in, I do not like reading (but I am glad you are reading THIS!)
    all_of_it: 0
    sure: 0
    never: 50

  which_story:
    # The most important part of Yacht Dice is the narrative.
    # Of course you will need to add story chapters to the item pool.
    # You can read story chapters in the feed on the website and there are several stories to choose from.
    the_quest_of_the_dice_warrior: 0
    the_tragedy_of_fortunas_gambit: 0
    the_dicey_animal_dice_game: 0
    whispers_of_fate: 0
    a_yacht_dice_odyssey: 0
    a_rollin_rhyme_adventure: 0
    random_story: 50

  # Item & Location Options
  local_items:
    # Forces these items to be in their native world.
    []

  non_local_items:
    # Forces these items to be outside their native world.
    []

  start_inventory:
    # Start with these items.
    {}

  start_hints:
    # Start with these item's locations prefilled into the ``!hint`` command.
    []

  start_location_hints:
    # Start with these locations and their item prefilled into the ``!hint`` command.
    []

  exclude_locations:
    # Prevent these locations from having an important item.
    []

  priority_locations:
    # Prevent these locations from having an unimportant item.
    []

  item_links:
    # Share part of your item pool with other players.
    []