| 
									
										
										
										
											2022-11-01 18:07:56 -05:00
										 |  |  | # 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
 | 
					
						
							| 
									
										
										
										
											2021-07-22 18:21:31 +02:00
										 |  |  | #
 | 
					
						
							| 
									
										
										
										
											2022-11-01 18:07:56 -05:00
										 |  |  | #    Means you have 5 chances for map shuffle to occur, and 15 chances for map shuffle to be turned
 | 
					
						
							|  |  |  | #    off.
 | 
					
						
							| 
									
										
										
										
											2021-07-22 18:21:31 +02:00
										 |  |  | #
 | 
					
						
							| 
									
										
										
										
											2022-11-01 18:07:56 -05:00
										 |  |  | # 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 your Archipelago settings are valid at this site:
 | 
					
						
							|  |  |  | #        https://archipelago.gg/check
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | # Your name in-game. Spaces will be replaced with underscores and there is a 16-character limit.
 | 
					
						
							| 
									
										
										
										
											2022-11-06 08:28:16 -06:00
										 |  |  | #     {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.
 | 
					
						
							| 
									
										
										
										
											2022-11-01 18:07:56 -05:00
										 |  |  | name: Player{number}
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | # Used to describe your yaml. Useful if you have multiple files.
 | 
					
						
							|  |  |  | description: Default {{ game }} Template
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | game: {{ game }}
 | 
					
						
							| 
									
										
										
										
											2021-07-22 18:21:31 +02:00
										 |  |  | requires:
 | 
					
						
							|  |  |  |   version: {{ __version__ }} # Version of Archipelago required for this yaml to work as expected.
 | 
					
						
							| 
									
										
										
										
											2021-09-17 00:17:54 +02:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2021-08-31 19:54:55 +02:00
										 |  |  | {%- macro range_option(option) %}
 | 
					
						
							| 
									
										
										
										
											2022-11-01 18:07:56 -05:00
										 |  |  |     # You can define additional values between the minimum and maximum values.
 | 
					
						
							|  |  |  |     # Minimum value is {{ option.range_start }}
 | 
					
						
							|  |  |  |     # Maximum value is {{ option.range_end }}
 | 
					
						
							| 
									
										
										
										
											2021-08-31 19:54:55 +02:00
										 |  |  |     {%- set data, notes = dictify_range(option) %}
 | 
					
						
							|  |  |  |     {%- for entry, default in data.items() %}
 | 
					
						
							|  |  |  |     {{ entry }}: {{ default }}{% if notes[entry] %} # {{ notes[entry] }}{% endif %}
 | 
					
						
							|  |  |  |     {%- endfor -%}
 | 
					
						
							| 
									
										
										
										
											2021-08-31 19:56:45 +02:00
										 |  |  | {% endmacro %}
 | 
					
						
							| 
									
										
										
										
											2022-11-01 18:07:56 -05:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2021-07-22 18:21:31 +02:00
										 |  |  | {{ game }}:
 | 
					
						
							| 
									
										
										
										
											2021-08-30 16:31:56 +02:00
										 |  |  |   {%- for option_key, option in options.items() %}
 | 
					
						
							| 
									
										
										
										
											2022-11-01 18:07:56 -05:00
										 |  |  |   {{ option_key }}:
 | 
					
						
							|  |  |  |     {%- if option.__doc__ %}
 | 
					
						
							|  |  |  |     # {{ option.__doc__
 | 
					
						
							| 
									
										
										
										
											2022-11-06 08:28:16 -06:00
										 |  |  |         | trim
 | 
					
						
							|  |  |  |         | replace('\n\n', '\n    \n')
 | 
					
						
							|  |  |  |         | replace('\n    ', '\n# ')
 | 
					
						
							|  |  |  |         | indent(4, first=False)
 | 
					
						
							|  |  |  |       }}
 | 
					
						
							| 
									
										
										
										
											2022-11-01 18:07:56 -05:00
										 |  |  |     {%- endif -%}
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |     {%- if option.__doc__ and option.range_start is defined %}
 | 
					
						
							|  |  |  |     #
 | 
					
						
							|  |  |  |     {%- endif -%}
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2021-09-18 01:32:34 +02:00
										 |  |  |     {%- if option.range_start is defined and option.range_start is number %}
 | 
					
						
							| 
									
										
										
										
											2021-08-31 19:54:55 +02:00
										 |  |  |     {{- range_option(option) -}}
 | 
					
						
							| 
									
										
										
										
											2022-11-01 18:07:56 -05:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2021-07-22 18:21:31 +02:00
										 |  |  |     {%- elif option.options -%}
 | 
					
						
							| 
									
										
										
										
											2022-11-01 18:07:56 -05:00
										 |  |  |     {%- for suboption_option_id, sub_option_name in option.name_lookup.items() %}
 | 
					
						
							| 
									
										
										
										
											2021-07-22 18:21:31 +02:00
										 |  |  |     {{ sub_option_name }}: {% if suboption_option_id == option.default %}50{% else %}0{% endif %}
 | 
					
						
							| 
									
										
										
										
											2022-11-01 18:07:56 -05:00
										 |  |  |     {%- endfor -%}
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |     {%- if option.name_lookup[option.default] not in option.options %}
 | 
					
						
							| 
									
										
										
										
											2022-10-09 17:16:59 -05:00
										 |  |  |     {{ option.default }}: 50
 | 
					
						
							| 
									
										
										
										
											2022-11-01 18:07:56 -05:00
										 |  |  |     {%- endif -%}
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-10-09 17:16:59 -05:00
										 |  |  |     {%- elif option.default is string %}
 | 
					
						
							|  |  |  |     {{ option.default }}: 50
 | 
					
						
							| 
									
										
										
										
											2022-11-01 18:07:56 -05:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-10-09 17:16:59 -05:00
										 |  |  |     {%- elif option.default is iterable and option.default is not mapping %}
 | 
					
						
							|  |  |  |     {{ option.default | list }}
 | 
					
						
							| 
									
										
										
										
											2022-11-01 18:07:56 -05:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2021-07-22 18:21:31 +02:00
										 |  |  |     {%- else %}
 | 
					
						
							| 
									
										
										
										
											2022-11-01 18:07:56 -05:00
										 |  |  |     {{ yaml_dump(option.default) | trim | indent(4, first=false) }}
 | 
					
						
							| 
									
										
										
										
											2022-10-09 17:16:59 -05:00
										 |  |  |     {%- endif -%}
 | 
					
						
							| 
									
										
										
										
											2022-11-06 08:28:16 -06:00
										 |  |  |     {{ "\n" }}
 | 
					
						
							| 
									
										
										
										
											2021-08-31 19:56:45 +02:00
										 |  |  |   {%- endfor %}
 |