start adding some comments to easy.yaml

easy.yaml

@@ -1,36 +1,36 @@
-description: Easy/Open/Normal
+description: Easy/Open/Normal #please describe your options. Especially useful when you have multiple yamls for different occasions
-glitches_required: none
+glitches_required: none #there is also no_logic.
-item_placement: basic
+item_placement: basic #this is based on Entrance Randomizer, which does not (yet?) support advanced
-map_shuffle:
+map_shuffle: #to shuffle dungeon maps into the outside world and other dungeons, as well as other player's worlds in multiworld
   on: 0
   off: 1
-compass_shuffle:
+compass_shuffle: #same for compass
   on: 0
   off: 1
-smallkey_shuffle:
+smallkey_shuffle: #same for small keys
   on: 0
   off: 1
-bigkey_shuffle:
+bigkey_shuffle: #same for big keys
   on: 0
   off: 1
 accessibility:
-  items: 0
+  items: 0 # item accessibility means you can get all inventory items. So a key could lock itself, but you can fill your inventory
-  locations: 1
+  locations: 1 # location accessibility means you can access every location in your seed and get all 216 checks
-  none: 0
+  none: 0 # no accessibility means your seed is "beatable only", meaning any items you do not need to beat the game can be unreachable. This can mean you have to defeat ganon with a lamp and master sword.
 entrance_shuffle:
-  none: 1
+  none: 1 # no entrance shuffle
-  simple: 0
+  simple: 0 #dungeons are shuffled with each other and the other entrances are shuffled with each other
-  restricted: 0
+  restricted: 0 #dungeons still shuffle along each other but connects other entrances more feely with each other while keeping entrances in one world
-  full: 0
+  full: 0 # mixes caves and dungeons freely, except for confining all entrances to one world
-  crossed: 0
+  crossed: 0 #introduces cross world connectors
-  insanity: 0
+  insanity: 0 #any entrance can lead to any other entrance
 goals:
-  ganon: 5
+  ganon: 5 #beat GT and then Ganon
-  fast_ganon: 4
+  fast_ganon: 4 # Just kill Ganon
-  dungeons: 1
+  dungeons: 1 # All Dungeons, including GT, and Agahnims Tower
-  pedestal: 0
+  pedestal: 0 # Pull the win out of the Pedestal
-  triforce-hunt: 0
+  triforce-hunt: 0 # Collect 20 of 30 Triforce pieces then hand them in in front of Hyrule Castle
-tower_open:
+tower_open: # Crystals required to open GT
   '0': 0
   '1': 0
   '2': 0
@@ -40,7 +40,7 @@ tower_open:
   '6': 0
   '7': 0
   random: 1
-ganon_open:
+ganon_open: # Crystals required to hurt Ganon
   '0': 0
   '1': 0
   '2': 0
@@ -51,18 +51,18 @@ ganon_open:
   '7': 0
   random: 1
 world_state:
-  standard: 1
+  standard: 1 # Do standard escape to bring Zelda to Sanctuary
-  open: 9
+  open: 9 # Start with the ability to skip the standard opening and go where you want
-  inverted: 0
+  inverted: 0 # You start in the Dark World, the Light World has changes to it's Map and requires a Moon Pearl to not be Bunny
-  retro: 0
+  retro: 0 # Keys are universal, you have to buy a quiver, there are take any caves and some other changes. Makes it more like Z1
 hints:
-  'on': 1
+  'on': 1 # Hint tiles can give useful item location hints on occasion
-  'off': 0
+  'off': 0 # You get gameplay hints, but not location/item hints
-weapons:
+weapons: # this means swords
-  randomized: 5
+  randomized: 5 # Your swords can be anywhere
-  assured: 2
+  assured: 2 # You start with a sword, the rest are anywhere
-  vanilla: 3
+  vanilla: 3 # Your swords are in vanilla locations in your own game (Uncle, Pyramid Fairy, Smiths, Pedestal)
-  swordless: 0
+  swordless: 0 # You don't have a sword. A hammer can be used like a Master Sword in certain situations
 item_pool:
   normal: 1
   hard: 0