Combo trigger options#
Every option in the Combo Trigger Editor, grouped by the editor tab it’s in. For how they fit together, read Combo triggers first.
The Kind column says what each option does to the trigger:
Cause: fires the trigger. A trigger needs at least one.
Condition: must be true for the trigger to do anything, but never fires it.
Effect: happens when the trigger fires.
Weapon effect: happens to the weapon that fired the trigger.
Setting: a value or switch that other options on the trigger use.
Options that only some versions have are marked with the versions that have them, like
3.0. In 2.55 a combo has a single trigger, edited in the Combo Editor’s Triggers tab,
and the options are spread across different tabs (see
Differences in 2.55). A few also have different names
there: Invert Prox. Req is Invert Proximity Req,
and Spawned Item Pickup is four checkboxes (Hold Up Item, Time Out Item,
Item Triggers Secrets and Can Hook Item).
The trigger’s Label 3.0, at the top of the editor, names it in the Combo Editor’s
trigger list. A P button next to a field opens a list to pick its values from.
Weapons#
LWeapons#
Option |
Kind |
What it does |
|---|---|---|
Sword, Sword Beam, Boomerang, Bomb Boom, Super Bomb Boom, Placed Bomb, Placed Super Bomb, Arrow, Fire, Whistle, Bait, Wand, Magic, Wind, Refl. Magic, Refl. Fireball, Refl. Rock, Refl. Arrow, Refl. Fire, Refl. Fire 2, Hammer, Hookshot, Sparkle, Byrna, Refl. Beam, Stomp, Thrown, Quake Hammer, S. Quake Hammer, Custom Weapon 1-10 |
Cause |
Fires when a player weapon (LWeapon) of this type touches the combo. |
|
Condition |
The LWeapon’s level must be at least this. Applies to every LWeapon type above. |
|
Setting |
Makes |
EWeapons#
Option |
Kind |
What it does |
|---|---|---|
Fireball, Arrow, Boomerang, Sword, Rock, Magic, Bomb Blast, SBomb Blast, Lit Bomb, Lit SBomb, Fire Trail, Flame, Wind, Flame 2, Custom Weapon 1-10 |
Cause |
Fires when an enemy weapon (EWeapon) of this type touches the combo. |
Other (weapons)#
Option |
Kind |
What it does |
|---|---|---|
|
Cause |
Fires when a weapon (player or enemy) burning with this strength of fire touches the combo.
Much of the engine’s own fire, like a candle’s flame, always counts as |
|
Condition |
Only weapons on the ground (Z = 0) count. Has no effect in sideview. |
Weapon Effects#
Option |
Kind |
What it does |
|---|---|---|
|
Weapon effect |
Destroys the weapon. Doesn’t work on swords or hammers. |
|
Weapon effect |
Once a weapon has fired the trigger, that weapon doesn’t fire it again. The combo’s other triggers aren’t affected (see Weapons). |
|
Weapon effect |
Makes the weapon burn with that strength of fire, so it fires triggers with the matching burning cause. |
|
Setting |
The |
|
Setting |
When a weapon fires the trigger, only the weapon effects happen, and the trigger’s
conditions and |
Other#
Option |
Kind |
What it does |
|---|---|---|
|
Cause |
Fires when the player presses one of the |
|
Setting |
Which buttons the |
|
Setting |
A combo shown near the player when they’re in position to press the button. |
|
Setting |
The prompt shown when the trigger’s conditions fail. |
|
Setting |
Where the prompt is drawn, relative to the player. |
|
Setting |
Which light beam |
|
Cause |
Fires the trigger every n frames, until the combo changes. |
|
Setting |
How many frames the player has to push before |
|
Cause |
Fires every frame the player stands on the combo. |
|
Cause |
Like |
|
Cause |
Fires every frame a light beam matching |
|
Cause |
Fires every frame no matching light beam hits the combo. |
|
Cause |
Fires every frame a Lens of Truth item with |
|
Cause |
Fires every frame no such lens is in use. |
|
Cause |
Fires when the player pushes against the combo, and again every |
|
Cause |
Fires when the combo, as a pushblock, finishes moving into its new position. |
|
Cause |
Fires every frame the player dives on the combo. With the sensitive version, even one pixel of overlap counts. |
|
Cause |
Fires every frame the player swims on the combo. With the sensitive version, even one pixel of overlap counts. |
|
Cause |
Fires when the screen (or region) loads, after its LevelStates and ExStates are applied. |
|
Cause |
Fires when the screen (or region) unloads. For a warp this is after the warp effect, and for scrolling it’s before the scroll starts. |
|
Cause |
Fires every frame. Only on layer 0 and FFCs, unless the |
|
Cause |
Fires when the screen’s shutters open. |
|
Cause |
Fires when the screen’s secrets are triggered. |
|
Cause |
Fires when the combo type’s own event happens, such as the player falling into a pitfall or drowning in liquid. Grayed out for combo types that don’t have one. |
|
Cause |
Fires when the player lands on the combo from a jump. |
|
Cause |
Fires when the player lands from a jump anywhere on the screen. |
|
Cause |
Fires when a pushblock is about to settle on top of this combo, replacing it. |
|
Cause |
Fires when a pushblock is about to settle at this combo’s position, on any layer. |
|
Cause |
Fires every frame once all the screen’s enemies are defeated. |
Effects#
Misc#
Option |
Kind |
What it does |
|---|---|---|
|
Effect |
Plays this music. |
|
Effect |
Changes when the engine next tries to replay the screen’s music. The mode goes back to
|
|
Effect |
Changes the combo by this much: 1 is the next combo, -1 the previous one. |
|
Setting |
|
|
Effect |
Changes the combo’s CSet by this much. |
|
Setting |
|
|
Effect |
Triggers the screen’s secrets. They’re permanent if the DMap and screen allow it and the
screen’s |
|
Effect |
Toggles whether the screen is dark, until the player leaves it. |
|
Effect |
Restarts the combo’s animation. If the combo changed, the new combo’s animation restarts. |
|
Effect |
The combo’s triggers below this one don’t fire for this cause. |
|
Effect |
Does what the combo type does on its own, like opening a chest or showing a sign’s string. Grayed out for combo types that don’t have an effect. |
|
Effect |
Kills every enemy on the screen, like the “kill all enemies” item. |
|
Effect |
Removes every enemy from the screen. |
|
Effect |
Removes every player weapon from the screen. |
|
Effect |
Removes every enemy weapon from the screen. |
|
Effect |
Runs this generic script in its “Frozen” mode (see |
|
Effect |
Shows this message string. |
|
Effect |
Shows this message string when the trigger fires but its conditions fail. |
|
Effect |
Sets the screen’s gravity and terminal velocity to |
|
Effect |
Puts the screen’s gravity back to its editor settings. |
|
Setting |
The values |
Player#
Option |
Kind |
What it does |
|---|---|---|
|
Effect |
Moves the player by this much along that axis. |
|
Setting |
The matching |
|
Setting |
The matching |
|
Effect |
Makes the player jump with this force. Negative values make them fall. |
|
Effect |
Turns the player to face this direction. |
|
Effect |
Sets how long the player has this status: -2 does nothing, -1 lasts until cured, 0 cures it, and any other value lasts that many frames. |
|
Effect |
Applies this |
|
Effect |
Sets the player’s ice physics velocity. |
|
Effect |
Makes this combo’s position the player’s hazard respawn point. Until |
|
Effect |
Lets the hazard respawn point follow safe ground again. |
SFX#
Option |
Kind |
What it does |
|---|---|---|
|
Effect |
Plays this sound. |
|
Setting |
-1 pans the sound by the combo’s position on the screen. 0-255 sets the pan, with 128 centered. |
|
Setting |
Percentage of the sound’s normal volume. |
|
Setting |
Frequency in Hz to play the sound at, or -1 for its normal frequency. |
|
Setting |
The sound loops until something stops it. |
|
Setting |
If the sound is already playing, keep it playing (updating its pan, volume and frequency) instead of starting it over. |
|
Setting |
Stops the sound instead of playing it. |
Conditions#
General#
Option |
Kind |
What it does |
|---|---|---|
|
Setting |
After firing, the trigger can’t fire again for this many frames. Its weapon effects still
happen. Unlike a failed condition, it doesn’t show the |
|
Condition |
The trigger only fires n out of m times it otherwise would, using the game’s random number generator. |
|
Condition |
The combo must be at least partly inside the viewport, extended on each side by
|
|
Condition |
The combo must be entirely outside the viewport, extended on each side by
|
|
Setting |
How far past the viewport’s edges |
|
Condition |
The screen must be dark. The quest rule |
|
Condition |
The screen must not be dark. |
|
Condition |
The player must be standing on the ground. Works in sideview too. |
|
Condition |
The player must not be standing on the ground. |
|
Condition |
The trigger only fires in the map view (the spacebar map). |
|
Condition |
The trigger never fires in the map view. |
Player Position#
Option |
Kind |
What it does |
|---|---|---|
|
Setting |
The values the |
|
Condition |
The player’s X (or Y) must be at least |
|
Condition |
The player’s X (or Y) must be at most |
|
Setting |
|
|
Condition |
The player’s Z must be at least this. |
|
Setting |
The player’s Z must be below |
|
Setting |
The value the |
|
Condition |
The player’s jump value must be at least |
|
Condition |
The player’s jump value must be at most |
|
Condition |
The player must be within this many pixels of the combo. It applies even when a copycat fires the trigger, so put it on the trigger that starts a copycat chain. |
|
Setting |
The player must be farther away than |
|
Setting |
|
|
Setting |
|
|
Condition |
The player must be facing one of these directions. |
Counter / Item / Enemy#
Option |
Kind |
What it does |
|---|---|---|
|
Setting |
The counter and amount the counter options use. |
|
Condition |
The counter must have at least |
|
Condition |
The counter must have less than |
|
Setting |
|
|
Setting |
|
|
Effect |
Takes |
|
Setting |
|
|
Setting |
|
|
Setting |
|
|
Effect |
Spawns this enemy. |
|
Setting |
The trigger’s |
|
Condition |
The player must have this item. |
|
Setting |
The player must not have |
|
Effect |
Takes |
|
Effect |
Spawns this item. A negative value drops from that dropset instead. |
|
Setting |
Pickup flags for the spawned item. |
|
Setting |
The spawned item is the screen’s special item, so it doesn’t spawn again once collected. |
|
Setting |
The player collects the spawned item right away. |
|
Setting |
The trigger’s |
States#
Option |
Kind |
What it does |
|---|---|---|
|
Effect |
Sets this ExState (0-31) of the screen. While it’s set, the combo reapplies its change when the screen loads (see States). |
|
Setting |
Unsets |
|
Effect |
Sets this extra door state, and the matching one on the neighboring screen. Works like
|
|
Setting |
Unsets the ExDoor state instead. |
|
Cause and effect |
Combos with the same |
|
Setting |
Other combos’ copycats don’t fire this trigger. It still fires them. |
|
Setting |
Which LevelState (0-31) or GlobalState (0-255) the state options use. |
|
Cause |
Fires when the state is toggled, and when the player enters a screen while it’s on. |
|
Effect |
Toggles the state. |
|
Setting |
If above 0, |
|
Setting |
Counts this combo toward |
|
Setting |
The group (0-255) and the value the |
|
Cause |
Fires every frame the group’s count is less than |
|
Cause |
Fires every frame the group’s count is greater than |
|
Setting |
The large-combo copycat number the two options below use. |
|
Effect |
Fires the |
|
Cause |
Fires when another combo of this large combo fires a |
|
Condition |
These GlobalStates must all be on. Like |
|
Condition |
These GlobalStates must all be off. |
Graphics#
Option |
Kind |
What it does |
|---|---|---|
|
Effect |
Tints the palette, like the script |
|
Effect |
Clears all tint, like |
|
Effect |
Loads this level palette over the current one. -1 does nothing, -2 loads the screen’s own palette. |
|
Effect |
Loads this extra sprite palette (0-29) into the boss CSet (CSet 14). -1 does nothing. |
|
Effect |
Shakes the screen for this many frames. -1 does nothing. |
|
Effect |
Makes the screen wavy for this many frames. -1 does nothing. |
Level / Screen Based#
Option |
Kind |
What it does |
|---|---|---|
|
Setting |
The level the Level Items options and the LevelState conditions use. -1 is the current DMap’s level. |
|
Setting |
The level items (map, compass, boss key, …) the options below use. |
|
Condition |
The level must have all of |
|
Condition |
The level must be missing at least one of |
|
Effect |
Gives the level |
|
Effect |
Takes |
|
Condition |
These LevelStates of |
|
Condition |
These LevelStates of |
|
Setting |
The screen the screen state, ExState and ExDoor conditions check. Map 0 is the combo’s own screen. |
|
Condition |
These screen states (secrets, item, …) must all be set. |
|
Condition |
These screen states must all be unset. |
|
Condition |
These ExStates must all be set. |
|
Condition |
These ExStates must all be unset. |
|
Condition |
These ExDoor states, picked per direction, must all be set. |
|
Condition |
These ExDoor states must all be unset. |
|
Setting |
Which of the combo position’s 8 states (0-7) the options below use. |
|
Condition |
The position state must be set. With |
|
Condition |
The position state must not be set. |
|
Cause |
While the position state is set, the combo reapplies its change, like an |
|
Effect |
Sets the position state. With |
|
Effect |
Unsets the position state. |