Revise comments in multiple YAML files (#137)

* Clean up README.md and easy.yaml

Removed periods at end of bullets
General revisions to wording and format
Updated glitch logic comments in easy.yaml

* #133: Implemented requested changes by ljwu

* Update README.md

* Revise comments in multiple YAML files

* #137: Implement revisions from PR conversations
This commit is contained in:
Pandatron76 2020-09-03 07:14:25 -04:00 committed by GitHub
parent ecf5c505d3
commit 33a86e0812
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 94 additions and 81 deletions

107
host.yaml
View File

@ -1,17 +1,17 @@
general_options:
#File name of the v1.0 J rom
# File name of the v1.0 J rom
rom_file: "Zelda no Densetsu - Kamigami no Triforce (Japan).sfc"
# set this to your (Q)Usb2Snes location if you want the MultiClient to attempt an auto start, does nothing if not found
# Set this to your (Q)Usb2Snes location if you want the MultiClient to attempt an auto start, does nothing if not found
qusb2snes: "QUsb2Snes\\QUsb2Snes.exe"
# Set this to false to never autostart a rom (such as after patching)
# true for operating system default program
# alternatively, a path to a program to open the .sfc file with
# True for operating system default program
# Alternatively, a path to a program to open the .sfc file with
rom_start: true
# Where to place output files
output_path: "output"
#options for MultiServer
#null means nothing, for the server this means to default the value
#these overwrite command line arguments!
# Options for MultiServer
# Null means nothing, for the server this means to default the value
# These overwrite command line arguments!
server_options:
host: null
port: 38281
@ -20,64 +20,77 @@ server_options:
savefile: null
disable_save: false
loglevel: "info"
#automatically forward the port that is used, then close that port after 24 hours
# Automatically forward the port that is used, then close that port after 24 hours
port_forward: false
#Disallow !getitem. Old /getitem cannot be blocked this way
# Disallow !getitem. Old /getitem cannot be blocked this way
disable_item_cheat: false
#Client hint system
#points given to player for each acquired item
# Client hint system
# Points given to a player for each acquired item in their world
location_check_points: 1
#point cost to receive a hint via !hint for players
hint_cost: 1000 #set to 0 if you want free hints
#forfeit modes: "disabled" -> clients can't forfeit, "enabled" -> clients can always forfeit
# Point cost to receive a hint via !hint for players
hint_cost: 1000 # Set to 0 if you want free hints
# Forfeit modes
# "disabled" -> clients can't forfeit,
# "enabled" -> clients can always forfeit
# "auto" -> automatic forfeit on goal completion, "goal" -> clients can forfeit after achieving their goal
# "auto-enabled" -> automatic forfeit on goal completion and manual forfeit is also enabled
# warning: only Berserker's Multiworld clients of version 2.1+ send game beaten information
# Warning: Only Berserker's Multiworld clients of version 2.1+ send game beaten information
forfeit_mode: "goal"
# Remaining modes
# !remaining handling, that tells a client which items remain in their pool
# "enabled" -> client can always ask for remaining items
# "disabled" -> client can never ask for remaining items
# "goal" -> client can ask for remaining items after goal completion
# warning: only Berserker's Multiworld clients of version 2.1+ send game beaten information
# "enabled" -> Client can always ask for remaining items
# "disabled" -> Client can never ask for remaining items
# "goal" -> Client can ask for remaining items after goal completion
# Warning: Only Berserker's Multiworld clients of version 2.1+ send game beaten information
remaining_mode: "goal"
# automatically shut down the server after this many seconds without new location checks, 0 to keep running
# Automatically shut down the server after this many seconds without new location checks, 0 to keep running
auto_shutdown: 0
#compatibility handling
#2 -> recommended for casual/cooperative play, attempt to be compatible with everything across all versions
#1 -> recommended for friendly racing, only allow Berserker's Multiworld, to disallow old /getitem for example
#0 -> recommended for tournaments to force a level playing field, only allow an exact version match
# Compatibility handling
# 2 -> Recommended for casual/cooperative play, attempt to be compatible with everything across all versions
# 1 -> Recommended for friendly racing, only allow Berserker's Multiworld, to disallow old /getitem for example
# 0 -> Recommended for tournaments to force a level playing field, only allow an exact version match
compatibility: 2
#options for MultiMystery.py
# Options for MultiMystery.py
multi_mystery_options:
#teams, however, note that there is currently no way to supply names for teams 2+ through MultiMystery
# Teams
# Note that there is currently no way to supply names for teams 2+ through MultiMystery
teams: 1
#location of your Enemizer CLI, available here: https://github.com/Bonta0/Enemizer/releases
# Location of your Enemizer CLI, available here: https://github.com/Bonta0/Enemizer/releases
enemizer_path: "EnemizerCLI/EnemizerCLI.Core.exe"
#folder from which the player yaml files are pulled from
# Folder from which the player yaml files are pulled from
player_files_path: "Players"
#meta file name, within players folder
# Meta file name, within the stated player_files_path location
meta_file_path: "meta.yaml"
#automatically launches {player_name}.yaml's ROM file using the OS's default program once generation completes. (likely your emulator)
#does nothing if the name is not found
#example: player_name = "Berserker"
player_name: "" # the hosts name
#create a spoiler file
# 0 -> none
# 1 -> full spoiler
# 2- -> spoiler without playthrough
# Automatically launches {player_name}.yaml's ROM file using the OS's default program once generation completes. (likely your emulator)
# Does nothing if the name is not found
# Example: player_name = "Berserker"
player_name: "" # The hosts name
# Create a spoiler file
# 0 -> None
# 1 -> Full spoiler
# 2 -> Spoiler without playthrough
create_spoiler: 1
#Zip the resulting roms
#0 -> Don't
#1 -> Create a zip
#2 -> Create a zip and delete the ROMs that will be in it, except the hosts (requires player_name to be set correctly)
# Zip the resulting roms
# 0 -> Don't
# 1 -> Create a zip
# 2 -> Create a zip and delete the ROMs that will be in it, except the hosts (requires player_name to be set correctly)
zip_roms: 0
# zip diff files, 2 -> delete the non-zipped one. -1 -> create them without zipping
# Zip diffs
# -1 -> Create them without zipping
# 2 -> Delete the non-zipped one.
zip_diffs: 2
#include the spoiler log in the zip, 2 -> delete the non-zipped one
# Zip spoiler log
# 0 -> Include the spoiler log in the zip
# 2 -> Delete the non-zipped one
zip_spoiler: 0
#include the multidata file in the zip, 2 -> delete the non-zipped one, which also means the server won't autostart
# Zip multidata
# 1 -> Include the multidata file in the zip
# 2 -> Delete the non-zipped one, which also means the server won't autostart
zip_multidata: 1
#zip algorithm to use. zip is recommended for patch files, 7z is recommended for roms. All of them get the job done.
zip_format: 1 # 1 -> zip, 2 -> 7z, 3->bz2
#create roms flagged as race roms
# Zip algorithm
# 1 -> Zip is recommended for patch files
# 2 -> 7z is recommended for roms. All of them get the job done.
# 3 -> bz2
zip_format: 1
# Create roms flagged as race roms
race: 0

View File

@ -1,36 +1,36 @@
# this file has to be in the Players folder to take effect, keeping the "meta.yaml" name.
# This file has to be in the Players folder to take effect, keeping the "meta.yaml" name
# A meta file rolls its own set of options first
# the result will then overwrite each player's option in that particular field
# for example, if a meta.yaml fast_ganon result is rolled, every player will have that fast_ganon goal
# there is the special case of null, which ignores that part of the meta.yaml,
# The result will then overwrite each player's option in that particular field
# For example, if a meta.yaml fast_ganon result is rolled, every player will have that fast_ganon goal
# There is the special case of null, which ignores that part of the meta.yaml,
# allowing for a chance for that meta to not take effect
# players can also have a meta_ignore option to ignore specific options
# example of ignore that would be in a player's file:
# Players can also have a meta_ignore option to ignore specific options
# Example of ignore that would be in a player's file:
# meta_ignore:
# world_state:
# mode:
# inverted
#this means, if world_state is meta-rolled and the result happens to be inverted, then defer to the player's yaml instead.
# This means, if mode is meta-rolled and the result happens to be inverted, then defer to the player's yaml instead.
meta_description: Meta-Mystery file with the intention of having similar-length completion times for a hopefully better experience
progression_balancing: # progression balancing tries to make sure that the player has *something* towards any players goal in each "sphere"
on: 0 # force every player into progression balancing
off: 0 # force every player out of progression balancing, then prepare for a lot of logical BK
null: 1 # let players decide via their own progression_balancing flag in their yaml, defaulting to on
progression_balancing: # Progression balancing tries to make sure that the player has *something* towards any players goal in each "sphere"
on: 0 # Force every player into progression balancing
off: 0 # Force every player out of progression balancing, then prepare for a lot of logical BK
null: 1 # Let players decide via their own progression_balancing flag in their yaml, defaulting to on
goals:
ganon: 100
fast_ganon: 250
dungeons: 50
pedestal: 100
triforce-hunt: 5
ganon: 100 # Climb GT, defeat Agahnim 2, and then kill Ganon
fast_ganon: 250 # Only killing Ganon is required. The hole is always open. However, items may still be placed in GT
dungeons: 50 # Defeat the boss of all dungeons, including Agahnim's tower and GT (Aga 2)
pedestal: 100 # Pull the Triforce from the Master Sword pedestal
triforce-hunt: 5 # Collect 20 of 30 Triforce pieces spread throughout the worlds, then turn them in to Murahadala in front of Hyrule Castle
local_triforce_hunt: 10 # Collect 20 of 30 Triforce pieces spread throughout your world, then turn them in to Murahadala in front of Hyrule Castle
ganon_triforce_hunt: 5 # Collect 20 of 30 Triforce pieces spread throughout the worlds, then kill Ganon
local_ganon_triforce_hunt: 20 # Collect 20 of 30 Triforce pieces spread throughout your world, then kill Ganon
null: 0 # maintain individual goals
world_state:
null: 0 # Maintain individual goals
mode:
standard: 10
open: 60
inverted: 10
retro: 10
null: 10 # maintain individual world states
null: 10 # Maintain individual world states
tower_open:
'0': 8
'1': 7
@ -40,7 +40,7 @@ tower_open:
'5': 3
'6': 2
'7': 1
random: 10 # a different GT open time should not usually result in a vastly different completion time, unless ganon goal and tower_open > ganon_open
random: 10 # A different GT open time should not usually result in a vastly different completion time, unless ganon goal and tower_open > ganon_open
ganon_open:
'0': 3
'1': 4
@ -50,5 +50,5 @@ ganon_open:
'5': 8
'6': 9
'7': 10
random: 5 # this will mean differing completion times. But leaving it for that surprise effect
#do not use meta rom options at this time.
random: 5 # This will mean differing completion times. But leaving it for that surprise effect
# Do not use meta rom options at this time

View File

@ -154,16 +154,16 @@ boss_shuffle:
full: 0 # 3 bosses can occur twice
random: 0 # Any boss can appear any amount of times
singularity: 0 # Picks a boss, tries to put it everywhere that works, if there's spaces remaining it picks a boss to fill those
enemy_shuffle: # randomize enemy placement
enemy_shuffle: # Randomize enemy placement
on: 0
off: 50
killable_thieves: # make thieves killable.
on: 0 # usually turned on together with enemy_shuffle to make annoying thief placement more manageable
killable_thieves: # Make thieves killable
on: 0 # Usually turned on together with enemy_shuffle to make annoying thief placement more manageable
off: 50
tile_shuffle: # randomize the tile layouts in flying tile rooms
tile_shuffle: # Randomize the tile layouts in flying tile rooms
on: 0
off: 50
bush_shuffle: # randomize the chance that bushes have enemies and the enemies under said bush
bush_shuffle: # Randomize the chance that bushes have enemies and the enemies under said bush
on: 0
off: 50
enemy_damage:
@ -187,12 +187,12 @@ beemizer: # Remove items from the global item pool and replace them with single
4: 0 # 100% of the non-essential item pool is replaced with bee traps
shop_shuffle:
none: 50
i: 0 # shuffle the inventories of the shops around
p: 0 # randomize the prices of the items in shop inventories
u: 0 # shuffle capacity upgrades into the item pool (and allow them to traverse the multiworld)
ip: 0 # shuffle inventories and randomize prices
uip: 0 # shuffle inventories, randomize prices and shuffle capacity upgrades into the item pool
# you can add more combos
i: 0 # Shuffle the inventories of the shops around
p: 0 # Randomize the prices of the items in shop inventories
u: 0 # Shuffle capacity upgrades into the item pool (and allow them to traverse the multiworld)
ip: 0 # Shuffle inventories and randomize prices
uip: 0 # Shuffle inventories, randomize prices and shuffle capacity upgrades into the item pool
# You can add more combos
timer:
none: 50 # No timer will be displayed.
timed: 0 # Starts with clock at zero. Green clocks subtract 4 minutes (total 20). Blue clocks subtract 2 minutes (total 10). Red clocks add two minutes (total 10). Winner is the player with the lowest time at the end.