Triggers

Triggers are special objects in the level editor that are used to change levels, introduced in Update 2.0. There are twenty-one different types of them: Color, Move, Pulse, Toggle, Spawn, Secondary Trail (unofficial name), Transition (unofficial name), Stop, Rotation, Follow, Follow Player, Shake, Animation, Touch-Toggle, Count, Instant Count, Pickup, Collision, On-Death, Show, Hide, Background Effect On, and Background Effect Off. Triggers can be selected in the 12th tab, which is represented by a currently non-existent background trigger icon.

Updates 2.0 and Below
Color Triggers=

Color triggers can color the background (indicated by a BG), the ground (indicated by GRND), a secondary color of the ground (GRND 2), the line between the ground and the background (indicated by Line), the default outline of hitboxes on objects (Obj), the default color of three-dimensional line (indicated by 3DL), and any color that is used in decoration (indicated by Col).

To change a color using a color trigger, press the Edit Object button at the right of the screen. A screen titled "Select Color" will pop up. The color circles in the middle are used to change the color. The outer circle selects the hue, while the inner circle controls the tone and value. The fade time is the amount of time it will take to fade from the previous color to the one the player are currently selecting. The player can use the slide bar beneath it to change it or type the number in. The time value ranges from 0.00 to 10.00 seconds but can be set for more than that manually. The Player Color 1 checkbox and the Player Color 2 checkbox make the trigger ignore the colour circles, and will then change the color to the player's primary/secondary colour, for whoever plays the level. The Copy and Paste buttons in the top-right copies the colour currently displayed, which then can be pasted into another color trigger. The Copy Color option allows the player to take any other channel and change its hue, saturation, or brightness. It will also cause the channel to change with its source. The Copy Opacity option will cause the channel to have the same opacity value as its source. Touch trigger and Spawn Trigger will be discussed further down on this page.

These next few features only appear in the Col, Line, and 3DL colour triggers. In the right side of the screen, there is an opacity slider which determines how transparent/opaque the colour is. Similar to it is the Blending option, which allows the colour to stack with others, with darker colours being more transparent. Move Trigger=

Move triggers are triggers that move certain groups of objects around in a level. To use this the player will have to know how to group objects under a specific group.

Once the player has given the group of objects a group ID, they may open the "Edit Object" menu while the move trigger is selected. The player will get a Move X input, a Move Y input, 2 checkboxes labelled "Lock to player X/Y", an Easing option, a moving time, a target Group ID, and the touch-triggered and spawn-triggered checkboxes.

The Target Group ID controls which group of objects the player are currently going to be moving. Set the number equal to the number of the group that the player want to move. The player can then change the Move X and the Move Y to control the amount of movement the group will move. Putting a 10 into the X will move the group 1 unit right. Putting a 1 in the X will not move the group 1 unit right, but rather 1/10 of a unit. If X is positive the group moves right. If X is negative, the group will move left. If Y is positive the group will move upwards, and if Y is negative, the group will move downwards. The player can put a number in for both X and Y to make it move diagonally. The slider allows movement from -100 to 100, but the actual range is -999 to 999, as the player can input 3-digit numbers outside that range as well.

The "Lock to Player X/Y" checkboxes will ignore the number inputted above them and will instead move the group perfectly to any move the player makes. It will look like the object is moving at the same speed of the player, or is just not moving at all depending on how much of the level the player see. Applying two locking to player X's will make the objects move twice the speed of the player, and if enough objects are in the group and they are used correctly, can make it seem like the player is moving backwards through the level.

The easing controls the distribution of movement across time. Some are easy to understand, such as “bounce”, but others are not as straightforward and if used creatively can achieve special effects (for example, the sine easing allows circular motion of objects).

The move time controls how long it will take to complete the movement. As soon as that much time has elapsed, the group will be at the target destination and will stop moving, unless there is another move trigger. Similar to color triggers, the time range is from 0.00s to 10.00s and can be set for more than that manually.

Triggers and speed portals can only be moved vertically. Form portals' grids will not move with the portals, making it possible to make an offset of the grid. Pulse Triggers= Pulse Triggers will change a colour channel or group to one colour temporarily.

In the bottom-right of the screen, there should be a field marked "Channel ID". Right above it are two buttons, one labelled "Channel" and one labelled "Group". The channel button will cause all objects using or copying the specified channel to pulse, while the group button will do the same except it will affect all objects using a group.

Above those two are two more buttons, one reading "Color" and the other "HSV". Color should be automatically selected and will cause the colour wheel to appear. A colour may be chosen from there to cause the specified group/channel to pulse the chosen color. The HSV is for selecting colours similar to another and will change when the source colour is changed.

Below the HSV options/colour wheel, there are three sliders, one "Fade-In," one "Hold," and one "Fade-Out." These are self-explanatory; the values in the fields should match the time in seconds the color should fade in, stay, and fade out respectively.

Similar to Colour Triggers, there are two buttons labelled Copy and Paste in the top-right, both serving the same function.

This trigger appears as yellow in the level editor. Alpha Triggers= Alpha triggers are triggers that affect the transparency of a group of objects. Under the Group ID field, there are two sliders: FadeTime and Opacity. FadeTime is the time in seconds it should take for the specified group to reach the opacity selected using the Opacity slider.

This trigger appears as light blue in the level editor.

Toggle Triggers= Toggle triggers completely (de)activate a group of objects. If the tick box "Activate Group" is left unticked, the group will immediately disappear when passing by the trigger and the player can go through any platforms or obstacles in this particular group. If it is ticked, then the opposite will happen: the group will reappear and the player will not be able to pass through the hazards and static objects.

Note that toggle triggers can take on two different colours in the editor depending on whether they are set to on or off. When it activates a group, it appears green. When it deactivates a group, it appears red. In the editor, it appears as default red. Spawn Trigger= Spawn triggers activate a certain group of triggers that are marked "Spawn Triggered." Unlike the others, spawn triggers are automatically marked as touch triggered. When activated, the group to be activated will be triggered at the same time, regardless of horizontal placement. However, in Update 2.1 there will be an option to delay the group's activation with a slider. The triggers activated by a spawn trigger can only be triggered once, even if the player passes by multiple spawn triggers activating the same triggers.

This trigger appears as teal in the level editor. Trail Triggers= File:Trail Triggers.png Trail Triggers enable or disable the secondary trail left by the player. The secondary trail is a copy of the player's primary color in the shape of the icon at its current position that is repeated as the other copies fade away behind the player.

These triggers are pretty straightforward with no parameters needed. They are indicated by a cube leaving a trail. There are two triggers for this: Enable and Disable. Enable will enable the secondary trail. Disable will disable the secondary trail. Transition Triggers= File:Transition Triggers.png The player may have noticed animations at the edges of the screen as objects come onto the screen before. These triggers control such animations. These triggers are indicated by a default block with some annotations around it. The annotations are designed to tell the player what the animation is, but some of them are difficult to discern what they are. Here are the descriptions in order of the triggers’ appearance in the editor:
 * No transition.
 * Blocks will appear moving downwards and disappear moving upwards.
 * Blocks will appear moving upwards and disappear moving downwards.
 * Blocks will appear moving to the right and disappear moving from the right.
 * Blocks will appear moving to the left and disappear moving from the left.
 * Blocks will shrink to the left and grow from the right.
 * Blocks will grow to the right and shrink from the left.
 * Blocks will implode in front of the player and explode behind the player.
 * Blocks will explode in front of the player and implode behind the player.
 * Blocks will appear by moving inwards from the top and bottom and disappear by moving outwards from the bottom and top.
 * Blocks will appear by moving outwards from the top and bottom and disappear by moving inwards from the bottom and top.



Update 2.1
The 14 triggers that were added in Update 2.1 include: Stop Trigger= The stop trigger cancels the function of all triggers within a selected group. To do this, the player must input the group ID of a trigger they wish to stop in the text box labelled "Group ID," and place the trigger in a convenient position.

This trigger incorporates the Spawn-Triggered and Touch-Triggered options and appears as magenta in the level editor.

Rotation Trigger= The Rotation Trigger is a trigger to be introduced in Update 2.1 that allows the player to rotate objects in levels. In this triggers edit menu, the player will a degrees slider, a Times 360 slider, 3 checkboxes labelled "Target Group ID," "Center Group ID," and "Lock Object Rotation," an easing option, a moving time, and the touch-triggered and spawn-triggered checkboxes.

The "Target Group[ ID]" is the object the player wishes to rotate, whereas the "Center Group[ ID]" is the object(s) the player wants the target object(s) to rotate around. However, selecting the "Lock Object Rotation" tick box will nullify anything inputted into the "Center Group ID" text box, as it makes the target group rotate around its own axis.

The "degrees" slider determines how many degrees the object will rotate, and the "times 360" slider determines how many times the object will rotate by 360 degrees.

The easing controls the distribution of movement across time. Some are easy to understand, such as “bounce”, but others are not as straightforward and if used creatively can achieve special effects (for example, the sine easing allows circular motion of objects).

The move time controls how long it will take to complete the movement. As soon as that much time has elapsed, the group will be at the target destination and will stop moving, unless there is another rotation trigger. Similar to move triggers, the time range is from 0.00s to 10.00s and can be set for more than that manually.

This trigger includes the Spawn-Triggered and Touch-Triggered options and appears as light-blue in the level editor.

Follow Trigger= The follow trigger allows specific objects to follow other objects that are being moved with the move trigger. This trigger's edit menu includes 3 sliders and 2 selectors: "X Mod," "Y Mod," "Move Time," & "Target Group ID," and "Follow Group ID."

The follow group is the group of objects that is to be followed by the target group. "X Mod" and "Y Mod" is used to modify the position of the target group in the X-axis and Y-axis as they follow the follow group.

The move time controls how long it will take to complete the movement. As soon as that much time has elapsed, the group will be at the target destination and will stop moving, unless there is another follow trigger. Similar to color, move and rotation triggers, the time range is from 0.00s to 10.00s and can be set for more than that manually.

This trigger includes the Spawn-Triggered and Touch-Triggered options and appears as hot-pink in the level editor.

Shake Trigger= Shake triggers shake the view of the screen. Upon editing this trigger the player will see 3 selectors: Shake, Interval, and Duration. These allow the player to alter how intense the shaking is, the rate at which the shaking gets more intense, and how long the shaking lasts.

This trigger includes the Spawn-Triggered and Touch-Triggered options. It also looks very distinctive from the other triggers; it appears in the level editor as a zig-zagged line with the word "Shake" above it (most likely relating it to seismographic data).

Animation Trigger= This trigger grants the manipulation of animations' movements. In this trigger's edit menu, there are 2 selectors: "Group ID" and "Animation ID." The Group ID is the animation(s) that the player wants to animate (this trigger does not work on non-animated objects). Animation IDs are numbers assigned to specific animated object's movements; editing this changes said an animated object's movement. Below is a list of animation IDs for each animated object:

Bat

 * 1) The bat's default animation
 * 2) The bat does one mock.
 * 3) The bat appears angry for approximately 1 second.
 * 4) The bat spits a fireball.
 * 5) The bat opens its mouth and keeps it open.
 * 6) The bat closes its mouth (Continuation of the above)
 * 7) The bat stops flying and falls asleep.
 * 8) The bat's sleeping animation on loop.
 * 9) The bat wakes up (Continuation of the above).

Monster (Big Beast)

 * 1) The monster's default animation.
 * 2) The monster's mouth opens and keeps it open.
 * 3) The monster goes to the default animation (Continuation of the above)
 * 4) The monster's mouth closes

This trigger includes the Spawn-Triggered and Touch-Triggered options and appears as amber in the level editor.

Follow Player Y Trigger= This trigger is a variation of the Follow Trigger; it allows selected objects to follow the player in the Y-axis. In this trigger's edit menu, there are 3 sliders, 2 input boxes, and 1 selector: "Speed," "Delay," "MoveTime," "Offset," "Max Speed," "Target Group ID,".

The Speed slider is the multiplier of the target group's velocity when following the Player's Y axis position, the max being the player's Y velocity.

The Delay slider controls how much time it should pass before the target group goes to the Player's Y-Axis current position.

The "Move time" slider is how long the function should take effect.

The "Offset" input box tells what position the target group should be (Positive number being above the player, negative being below)

This trigger includes the Spawn-Triggered and Touch-Triggered options and appears as vanilla in the level editor.

Touch Trigger= The Touch Trigger is a trigger the player may configure to make tapping/holding the screen activate or deactivate a group of objects. In this trigger's edit menu, there is 1 selector and 4 tick boxes: "Group ID," "Dual Mode," "Hold Mode," "Toggle On," & "Toggle Off."

If the "Dual Mode" tick box is left unticked, the trigger works for both of the icons if the player is in dual mode. If it is not, the trigger only works with the original icon.

If the player checks the tick box labelled "Hold Mode," the trigger functions as long as the player is holding down on their mouse, screen, or spacebar, and the player's icon is past the trigger or within it (if the touch-triggered tick box is ticked).

"Toggle On" and "Toggle Off" determines whether or not holding/tapping/clicking will toggle the specified group on or off.

This trigger includes the Spawn-Triggered and Touch-Triggered options and appears as cyan in the level editor.

Count Trigger=

Count triggers are used to trigger actions after the player has collected a specific amount of items. In this trigger's edit menu, there are 3 selectors and 2 tickboxes: "Item ID," "Target ID," "Target Count," and "Activate Group," and "Multi Activate."

The target group is the group that is to be (de)activated; the item group is the group of items that are deemed the collectables; the target count is the amount of items needed to (de)activate the target group.

The player may select whether or not achieving the target count deactivates or activates the target group with the "Activate Group" tick box (ticked = activates; unticked = deactivates).

In correspondence with this trigger, there is a live object counter that shows the player's progress regarding how many of the specific items they have collected.

This trigger includes the Spawn-Triggered and Touch-Triggered options and appears as light-pink in the level editor.

Instant Count Trigger= The Instant Count Trigger serves as a secondary, conditional Count Trigger. This trigger's edit menu is almost identical to that of the Count Trigger's, there are 3 selectors and 4 tick boxes: "Item ID," "Target ID," "Target Count," and "Activate Group," "Equals," "Larger," & "Smaller."

The target group is the group that is to be (de)activated; the item group is the group of items that are deemed the collectables; the target count is the number of items that determines when the target group will be (de)activated.

The tick boxes, "Equals," "Larger," and "Smaller", determine when the target group will be (de)activated.
 * If "equals" is selected, the player must achieve the exact target count to (de)activate the target group.
 * If "larger" is selected, the player must gain more objects than the target count to (de)activate the target group.
 * If "smaller" is selected, the target group will be (de)activated until the player reaches the target goal or gains more than thereof.

The player may select whether or not achieving the target count deactivates or activates the target group with the "Activate Group" tick box (ticked = activates; unticked = deactivates).

This trigger includes the Spawn-Triggered and Touch-Triggered options and appears as pink in the level editor.

Pickup Trigger= The pickup trigger serves as a secondary count trigger. There are 2 selectors in this trigger's edit menu: "Item ID" and "Count." The item ID is the ID given to an object counter and the "count" selector defines which number the counter should begin counting on.

This trigger includes the Spawn-Triggered and Touch-Triggered options and appears as orange in the level editor.

Collision Trigger= The collision trigger sets off an action upon two selected collision block's encounter. It uses a special block called "Collision block"

The player is to assign IDs to 2 blocks (block A/B), which are the blocks that are to collide. Keep in note that one of the said blocks must have the "Dynamic Block" box checked in order to work.

The player may determine whether block A and B's collision shall make the target objects activate or deactivate. The player must also input the "Target ID," which is the Group ID of the object(s) the player wishes to (de)activate.

If the "Trigger On Exit" tick box is checked, the trigger will function when both blocks were but are no longer within each other's hitbox.

When the trigger functions, the target group will be (de)activated, and it will work as a Spawn trigger to the same group; every "Spawn-Triggered" trigger in the group will be activated (if the player chose to activate the target group).

This trigger includes the Spawn-Triggered and Touch-Triggered options and appears as dark blue in the level editor.

On Death Trigger= The On Death Trigger triggers an action upon the player's icon's death. The player must first entitle the trigger to a group of objects with an ID. Then, the player may choose to either activate or disable the group of objects.

This trigger includes the Spawn-Triggered and Touch-Triggered options and appears as pink in the level editor.

Show/Hide Player Triggers= The Hide Player trigger is a simple trigger makes the player transparent, whereas the Show Player Trigger nullifies that effect. The player is unable to edit this trigger.

The Show Player Trigger appears as the 1st main icon with the word "Show" above it. The Hide Player Trigger appears as the outline of the 1st main icon with the word "Hide" above it.

Background Effect On/Off Triggers= Background Effect Off triggers eliminate the particles the player's cube (if grounded), ship, UFO, and/or wave exert; the Background Effect On trigger nullifies the elimination thereof. This trigger is not editable, thus the only thing the player must do is place this trigger in a convenient position.

The Background Effect On and Off triggers include the Spawn-Triggered and Touch-Triggered options, they appear in the editor as the words "BG Effect" followed by "On" & "Off" and are green & red, respectively.

Touch Triggered and Spawn Triggered
18 out of the 22 triggers will have a checkbox labelled "Touch Triggered." Enabling this will give a trigger a hitbox; the trigger will be activated only if the player enters the hitbox. The Spawn Trigger will never activate if this is turned off, even if the player touches the very coordinates the trigger sits at.

Every trigger mentioned hereinbefore excluding 4 also have a checkbox labelled "Spawn Triggered." Enabling this will make the trigger not activate at all (not even if the player goes past it) until it is spawned using a Spawn trigger.