246 lines
		
	
	
		
			7.4 KiB
		
	
	
	
		
			Python
		
	
	
	
	
	
			
		
		
	
	
			246 lines
		
	
	
		
			7.4 KiB
		
	
	
	
		
			Python
		
	
	
	
	
	
from __future__ import annotations
 | 
						|
 | 
						|
from typing import Dict
 | 
						|
 | 
						|
from dataclasses import dataclass
 | 
						|
from Options import Choice, Option, DefaultOnToggle, DeathLink, Range, Toggle, PerGameCommonOptions
 | 
						|
 | 
						|
 | 
						|
class FreeincarnateMax(Range):
 | 
						|
    """How many maximum freeincarnate items to allow
 | 
						|
 | 
						|
    When done generating items, any remaining item slots will be filled
 | 
						|
    with freeincarnates, up to this maximum amount.  Any remaining item
 | 
						|
    slots after that will be 'nothing' items placed locally, so in multigame
 | 
						|
    multiworlds, keeping this value high will allow more items from other games
 | 
						|
    into Adventure.
 | 
						|
    """
 | 
						|
    display_name = "Freeincarnate Maximum"
 | 
						|
    range_start = 0
 | 
						|
    range_end = 17
 | 
						|
    default = 17
 | 
						|
 | 
						|
 | 
						|
class ItemRandoType(Choice):
 | 
						|
    """Choose how items are placed in the game
 | 
						|
 | 
						|
    Not yet implemented.  Currently only traditional supported
 | 
						|
    Traditional: Adventure items are not in the map until
 | 
						|
    they are collected (except local items) and are dropped
 | 
						|
    on the player when collected.  Adventure items are not checks.
 | 
						|
    Inactive: Every item is placed, but is inactive until collected.
 | 
						|
    Each item touched is a check.  The bat ignores inactive items.
 | 
						|
 | 
						|
    Supported values: traditional, inactive
 | 
						|
    Default value: traditional
 | 
						|
    """
 | 
						|
 | 
						|
    display_name = "Item type"
 | 
						|
    option_traditional = 0x00
 | 
						|
    option_inactive = 0x01
 | 
						|
    default = option_traditional
 | 
						|
 | 
						|
 | 
						|
class DragonSlayCheck(DefaultOnToggle):
 | 
						|
    """If true, slaying each dragon for the first time is a check
 | 
						|
    """
 | 
						|
    display_name = "Slay Dragon Checks"
 | 
						|
 | 
						|
 | 
						|
class TrapBatCheck(Choice):
 | 
						|
    """
 | 
						|
    Locking the bat inside a castle may be a check
 | 
						|
 | 
						|
    Not yet implemented
 | 
						|
    If set to yes, the bat will not start inside a castle.
 | 
						|
    Setting with_key requires the matching castle key to also be
 | 
						|
    in the castle with the bat, achieved by dropping the key in the
 | 
						|
    path of the portcullis as it falls.  This setting is not recommended with the bat use_logic setting
 | 
						|
 | 
						|
    Supported values: no, yes, with_key
 | 
						|
    Default value: yes
 | 
						|
    """
 | 
						|
    display_name = "Trap bat check"
 | 
						|
    option_no_check = 0x0
 | 
						|
    option_yes_key_optional = 0x1
 | 
						|
    option_with_key = 0x2
 | 
						|
    default = option_yes_key_optional
 | 
						|
 | 
						|
 | 
						|
class DragonRandoType(Choice):
 | 
						|
    """
 | 
						|
    How to randomize the dragon starting locations
 | 
						|
 | 
						|
    normal: Grundle is in the overworld, Yorgle in the white castle, and Rhindle in the black castle
 | 
						|
    shuffle: A random dragon is placed in the overworld, one in the white castle, and one in the black castle
 | 
						|
    overworldplus: Dragons can be placed anywhere, but at least one will be in the overworld
 | 
						|
    randomized: Dragons can be anywhere except the credits room
 | 
						|
 | 
						|
 | 
						|
    Supported values: normal, shuffle, overworldplus, randomized
 | 
						|
    Default value: shuffle
 | 
						|
    """
 | 
						|
    display_name = "Dragon Randomization"
 | 
						|
    option_normal = 0x0
 | 
						|
    option_shuffle = 0x1
 | 
						|
    option_overworldplus = 0x2
 | 
						|
    option_randomized = 0x3
 | 
						|
    default = option_shuffle
 | 
						|
 | 
						|
 | 
						|
class BatLogic(Choice):
 | 
						|
    """How the bat is considered for logic
 | 
						|
 | 
						|
    With cannot_break, the bat cannot pick up an item that starts out-of-logic until the player touches it
 | 
						|
    With can_break, the bat is free to pick up any items, even if they are out-of-logic
 | 
						|
    With use_logic, the bat can pick up anything just like can_break, and locations are no longer considered to require
 | 
						|
      the magnet or bridge to collect, since the bat can retrieve these.
 | 
						|
    A future option may allow the bat itself to be placed as an item.
 | 
						|
 | 
						|
    Supported values: cannot_break, can_break, use_logic
 | 
						|
    Default value: can_break
 | 
						|
    """
 | 
						|
    display_name = "Bat Logic"
 | 
						|
    option_cannot_break = 0x0
 | 
						|
    option_can_break = 0x1
 | 
						|
    option_use_logic = 0x2
 | 
						|
    default = option_can_break
 | 
						|
 | 
						|
 | 
						|
class YorgleStartingSpeed(Range):
 | 
						|
    """
 | 
						|
    Sets Yorgle's initial speed.  Yorgle has a speed of 2 in the original game
 | 
						|
    Default value: 2
 | 
						|
    """
 | 
						|
    display_name = "Yorgle MaxSpeed"
 | 
						|
    range_start = 1
 | 
						|
    range_end = 9
 | 
						|
    default = 2
 | 
						|
 | 
						|
 | 
						|
class YorgleMinimumSpeed(Range):
 | 
						|
    """
 | 
						|
    Sets Yorgle's speed when all speed reducers are found.  Yorgle has a speed of 2 in the original game
 | 
						|
    Default value: 2
 | 
						|
    """
 | 
						|
    display_name = "Yorgle Min Speed"
 | 
						|
    range_start = 1
 | 
						|
    range_end = 9
 | 
						|
    default = 1
 | 
						|
 | 
						|
 | 
						|
class GrundleStartingSpeed(Range):
 | 
						|
    """
 | 
						|
    Sets Grundle's initial speed.  Grundle has a speed of 2 in the original game
 | 
						|
    Default value: 2
 | 
						|
    """
 | 
						|
    display_name = "Grundle MaxSpeed"
 | 
						|
    range_start = 1
 | 
						|
    range_end = 9
 | 
						|
    default = 2
 | 
						|
 | 
						|
 | 
						|
class GrundleMinimumSpeed(Range):
 | 
						|
    """
 | 
						|
    Sets Grundle's speed when all speed reducers are found.  Grundle has a speed of 2 in the original game
 | 
						|
    Default value: 2
 | 
						|
    """
 | 
						|
    display_name = "Grundle Min Speed"
 | 
						|
    range_start = 1
 | 
						|
    range_end = 9
 | 
						|
    default = 1
 | 
						|
 | 
						|
 | 
						|
class RhindleStartingSpeed(Range):
 | 
						|
    """
 | 
						|
    Sets Rhindle's initial speed.  Rhindle has a speed of 3 in the original game
 | 
						|
    Default value: 3
 | 
						|
    """
 | 
						|
    display_name = "Rhindle MaxSpeed"
 | 
						|
    range_start = 1
 | 
						|
    range_end = 9
 | 
						|
    default = 3
 | 
						|
 | 
						|
 | 
						|
class RhindleMinimumSpeed(Range):
 | 
						|
    """
 | 
						|
    Sets Rhindle's speed when all speed reducers are found.  Rhindle has a speed of 3 in the original game
 | 
						|
    Default value: 2
 | 
						|
    """
 | 
						|
    display_name = "Rhindle Min Speed"
 | 
						|
    range_start = 1
 | 
						|
    range_end = 9
 | 
						|
    default = 2
 | 
						|
 | 
						|
 | 
						|
class ConnectorMultiSlot(Toggle):
 | 
						|
    """If true, the client and lua connector will add lowest 8 bits of the player slot
 | 
						|
    to the port number used to connect to each other, to simplify connecting multiple local
 | 
						|
    clients to local EmuHawk instances.
 | 
						|
    Set in the yaml, since the connector has to read this out of the rom file before connecting.
 | 
						|
    """
 | 
						|
    display_name = "Connector Multi-Slot"
 | 
						|
 | 
						|
 | 
						|
class DifficultySwitchA(Choice):
 | 
						|
    """Set availability of left difficulty switch
 | 
						|
    This controls the speed of the dragons' bite animation
 | 
						|
 | 
						|
    """
 | 
						|
    display_name = "Left Difficulty Switch"
 | 
						|
    option_normal = 0x0
 | 
						|
    option_locked_hard = 0x1
 | 
						|
    option_hard_with_unlock_item = 0x2
 | 
						|
    default = option_hard_with_unlock_item
 | 
						|
 | 
						|
 | 
						|
class DifficultySwitchB(Choice):
 | 
						|
    """Set availability of right difficulty switch
 | 
						|
    On hard, dragons will run away from the sword
 | 
						|
 | 
						|
    """
 | 
						|
    display_name = "Right Difficulty Switch"
 | 
						|
    option_normal = 0x0
 | 
						|
    option_locked_hard = 0x1
 | 
						|
    option_hard_with_unlock_item = 0x2
 | 
						|
    default = option_hard_with_unlock_item
 | 
						|
 | 
						|
 | 
						|
class StartCastle(Choice):
 | 
						|
    """Choose or randomize which castle to start in front of.
 | 
						|
 | 
						|
    This affects both normal start and reincarnation.  Starting
 | 
						|
    at the black castle may give easy dot runs, while starting
 | 
						|
    at the white castle may make them more dangerous!  Also, not
 | 
						|
    starting at the yellow castle can make delivering the chalice
 | 
						|
    with a full inventory slightly less trivial.
 | 
						|
 | 
						|
    This doesn't affect logic since all the castles are reachable
 | 
						|
    from each other.
 | 
						|
    """
 | 
						|
    display_name = "Start Castle"
 | 
						|
    option_yellow = 0
 | 
						|
    option_black = 1
 | 
						|
    option_white = 2
 | 
						|
    default = option_yellow
 | 
						|
 | 
						|
@dataclass
 | 
						|
class AdventureOptions(PerGameCommonOptions):
 | 
						|
    dragon_slay_check: DragonSlayCheck
 | 
						|
    death_link: DeathLink
 | 
						|
    bat_logic: BatLogic
 | 
						|
    freeincarnate_max: FreeincarnateMax
 | 
						|
    dragon_rando_type: DragonRandoType
 | 
						|
    connector_multi_slot: ConnectorMultiSlot
 | 
						|
    yorgle_speed: YorgleStartingSpeed
 | 
						|
    yorgle_min_speed: YorgleMinimumSpeed
 | 
						|
    grundle_speed: GrundleStartingSpeed
 | 
						|
    grundle_min_speed: GrundleMinimumSpeed
 | 
						|
    rhindle_speed: RhindleStartingSpeed
 | 
						|
    rhindle_min_speed: RhindleMinimumSpeed
 | 
						|
    difficulty_switch_a: DifficultySwitchA
 | 
						|
    difficulty_switch_b: DifficultySwitchB
 | 
						|
    start_castle: StartCastle
 | 
						|
 | 
						|
 |