about summary refs log tree commit diff stats
path: root/apworld/options.py
diff options
context:
space:
mode:
Diffstat (limited to 'apworld/options.py')
-rw-r--r--apworld/options.py154
1 files changed, 151 insertions, 3 deletions
diff --git a/apworld/options.py b/apworld/options.py index d984beb..3d7c9a5 100644 --- a/apworld/options.py +++ b/apworld/options.py
@@ -1,15 +1,144 @@
1from dataclasses import dataclass 1from dataclasses import dataclass
2 2
3from Options import PerGameCommonOptions, Toggle, Choice 3from Options import PerGameCommonOptions, Toggle, Choice, DefaultOnToggle, Range
4 4
5 5
6class ShuffleDoors(Toggle): 6class ShuffleDoors(DefaultOnToggle):
7 """If enabled, most doors will open from receiving an item rather than fulfilling the in-game requirements.""" 7 """If enabled, most doors will open from receiving an item rather than fulfilling the in-game requirements."""
8 display_name = "Shuffle Doors" 8 display_name = "Shuffle Doors"
9 9
10 10
11class ShuffleControlCenterColors(Toggle):
12 """
13 Some doors open after solving the COLOR panel in the Control Center. If this option is enabled, these doors will
14 instead open upon receiving an item.
15 """
16 display_name = "Shuffle Control Center Colors"
17
18
19class ShuffleGalleryPaintings(Toggle):
20 """If enabled, gallery paintings will appear from receiving an item rather than by triggering them normally."""
21 display_name = "Shuffle Gallery Paintings"
22
23
24class ShuffleLetters(Choice):
25 """
26 Controls how letter unlocks are handled. Note that H1, I1, N1, and T1 will always be present at their vanilla
27 locations in the starting room, even if letters are shuffled remotely.
28
29 - **Vanilla**: All letters will be present at their vanilla locations.
30 - **Unlocked**: Players will start with their keyboards fully unlocked.
31 - **Progressive**: Two items will be added to the pool for every letter (one for H, I, N, and T). Receiving the
32 first item gives you the corresponding level 1 letter, and the second item gives you the corresponding level 2
33 letter.
34 - **Vanilla Cyan**: Players will start with all level 1 (purple) letters unlocked. Level 2 (cyan) letters will be
35 present at their vanilla locations.
36 - **Item Cyan**: Players will start with all level 1 (purple) letters unlocked. One item will be added to the pool
37 for every level 2 (cyan) letter.
38 """
39 display_name = "Shuffle Letters"
40 option_vanilla = 0
41 option_unlocked = 1
42 option_progressive = 2
43 option_vanilla_cyan = 3
44 option_item_cyan = 4
45
46
47class ShuffleSymbols(Toggle):
48 """
49 If enabled, 19 items will be added to the pool, representing the different symbols that can appear on a panel.
50 Players will be prevented from solving puzzles with symbols on them until all of the required symbols are unlocked.
51 """
52 display_name = "Shuffle Symbols"
53
54
55class ShuffleWorldports(Toggle):
56 """
57 Randomizes the connections between maps. This affects worldports only, which are the loading zones you walk into in
58 order to change maps. This does not affect paintings, panels that teleport you, or certain other special connections
59 like the one between The Shop and Control Center. Connections that depend on placing letters in keyholders are also
60 currently not shuffled.
61
62 NOTE: It is highly recommended that you turn on Shuffle Control Center Colors when using Shuffle Worldports. Not
63 doing so runs the risk of creating an unfinishable seed.
64 """
65 display_name = "Shuffle Worldports"
66
67
68class KeyholderSanity(Toggle):
69 """
70 If enabled, 26 locations will be created for placing each key into its respective Green Ending keyholder.
71
72 NOTE: This does not apply to the two disappearing keyholders in The Congruent, as they are not part of Green Ending.
73 """
74 display_name = "Keyholder Sanity"
75
76
77class CyanDoorBehavior(Choice):
78 """
79 Cyan-colored doors usually only open upon unlocking double letters. Some panels also only appear upon unlocking
80 double letters. This option determines how these unlocks should behave.
81
82 - **Collect H2**: In the base game, H2 is the first double letter you are intended to collect, so cyan doors only
83 open when you collect the H2 pickup in The Repetitive. Collecting the actual pickup is still required even with
84 remote letter shuffle enabled.
85 - **Any Double Letter**: Cyan doors will open when you have unlocked any cyan letter on your keyboard. In letter
86 shuffle, this means receiving a cyan letter, not picking up a cyan letter collectable.
87 - **Item**: Cyan doors will be grouped together in a single item.
88
89 Note that some cyan doors are impacted by door shuffle (e.g. the entrance to The Tower). When door shuffle is
90 enabled, these doors won't be affected by the value of this option.
91 """
92 display_name = "Cyan Door Behavior"
93 option_collect_h2 = 0
94 option_any_double_letter = 1
95 option_item = 2
96
97
98class DaedalusRoofAccess(Toggle):
99 """
100 If enabled, the player will be logically expected to be able to go from the castle entrance to any part of Daedalus
101 that is open to the air. If disabled, the player will only be expected to be able to enter the castle, the moat,
102 Icarus, and the area at the bottom of the stairs. Invisible walls that become opaque as you approach them are added
103 to the level to prevent the player from accidentally breaking logic.
104 """
105 display_name = "Allow Daedalus Roof Access"
106
107
108class StrictPurpleEnding(DefaultOnToggle):
109 """
110 If enabled, the player will be required to have all purple (level 1) letters in order to get Purple Ending.
111 Otherwise, some of the letters may be skippable depending on the other options.
112 """
113 display_name = "Strict Purple Ending"
114
115
116class StrictCyanEnding(DefaultOnToggle):
117 """
118 If enabled, the player will be required to have all cyan (level 2) letters in order to get Cyan Ending. Otherwise,
119 at least J2, Q2, and V2 are skippable. Others may also be skippable depending on the options chosen.
120 """
121 display_name = "Strict Cyan Ending"
122
123
11class VictoryCondition(Choice): 124class VictoryCondition(Choice):
12 """Victory condition.""" 125 """
126 This option determines what your goal is.
127
128 - **Gray Ending** (The Colorful)
129 - **Purple Ending** (The Sun Temple). This ordinarily requires all level 1 (purple) letters.
130 - **Mint Ending** (typing EXIT into the keyholders in Control Center)
131 - **Black Ending** (The Graveyard)
132 - **Blue Ending** (The Words)
133 - **Cyan Ending** (The Parthenon). This ordinarily requires almost all level 2 (cyan) letters.
134 - **Red Ending** (The Tower)
135 - **Plum Ending** (The Wondrous / The Door)
136 - **Orange Ending** (the castle in Daedalus)
137 - **Gold Ending** (The Gold). This involves going through the color rooms in Daedalus.
138 - **Yellow Ending** (The Gallery). This requires unlocking all gallery paintings.
139 - **Green Ending** (The Ancient). This requires filling all keyholders with specific letters.
140 - **White Ending** (Control Center). This combines every other ending.
141 """
13 display_name = "Victory Condition" 142 display_name = "Victory Condition"
14 option_gray_ending = 0 143 option_gray_ending = 0
15 option_purple_ending = 1 144 option_purple_ending = 1
@@ -26,7 +155,26 @@ class VictoryCondition(Choice):
26 option_white_ending = 12 155 option_white_ending = 12
27 156
28 157
158class TrapPercentage(Range):
159 """Replaces junk items with traps, at the specified rate."""
160 display_name = "Trap Percentage"
161 range_start = 0
162 range_end = 100
163 default = 0
164
165
29@dataclass 166@dataclass
30class Lingo2Options(PerGameCommonOptions): 167class Lingo2Options(PerGameCommonOptions):
31 shuffle_doors: ShuffleDoors 168 shuffle_doors: ShuffleDoors
169 shuffle_control_center_colors: ShuffleControlCenterColors
170 shuffle_gallery_paintings: ShuffleGalleryPaintings
171 shuffle_letters: ShuffleLetters
172 shuffle_symbols: ShuffleSymbols
173 shuffle_worldports: ShuffleWorldports
174 keyholder_sanity: KeyholderSanity
175 cyan_door_behavior: CyanDoorBehavior
176 daedalus_roof_access: DaedalusRoofAccess
177 strict_purple_ending: StrictPurpleEnding
178 strict_cyan_ending: StrictCyanEnding
32 victory_condition: VictoryCondition 179 victory_condition: VictoryCondition
180 trap_percentage: TrapPercentage