Levels

Each level unit represents one map in your campaign. Clicking on one and either pressing its UI button or pressing Ctrl + Spacebar will switch to that map. Opening its script settings will allow you to change various attributes about the level:

• TITLE: The name of the level
• DESCRIPTION: The description shown below the title when clicked on
• START_MSG_CHANNEL: The name of an ADA message channel to show when the level is switched into (only works outside of edit mode)
• COMPLETE_MSG_CHANNEL: The name of an ADA message channel to show when the level is completed.
  • The completion message is shown as a game message (A text box on top of the screen), not an ADA message, to disincentivize excessive ADA message spam.
• COMPLETE_MSG_BUTTON: The text shown on the button below the level's ending game message.
• UNIT_UNLOCKS: A formatted string determining the level's unit unlocks.

• If APPLY_UNLOCKS_ON_LOAD is 1 (the default value), then unit unlocks will be given to the player when they start the level, but removed if they leave without beating it. If this value is 0, unlocks will only be given when the level is completed.
• CUSTOM_COMPLETE_EFFECTS is a way for completing levels to grant custom forms of meta-progression to the player.

Transitions

Transitions are how you add paths to your campaign, and objectives to your levels. They are placed by dragging them between two levels, instead of placing them down. Once placed, you can click on them and use their unit UI to select objective types and add them to that path. More than one objective can be added to a single transition. Objectives can be reclaim, collect, totems, nullify, time, or custom. All objectives other than time work the same as in vanilla Creeper World 4, and the time objective simply activates after a certain amount of time has passed, if the rift lab has not left the map (similar to a hold objective).

Modifying Objectives

Each transition's script settings has options that let you customize your objectives a little more than the base game lets you:

• If REQUIRE_ALL is set to 0, the transition will count as complete if any objective added to it is completed. If set to anything else, all objectives in the transition will be required.
• RECLAIM_REQ functions the same as the “reclaim %” number in the editor's “Game” tab. It's description is as follows:
  • “The percent of peak creeper that the creeper must fall below to get the reclaim objective. Set to 0 for total creeper elimination.”
• RECLAIM_CHARGE is the number of frames (30 frames = 1 second) it takes for the reclaim objective to charge. The default value of 450 frames means 15 seconds.
• COLLECT_NUM, TOTEM_NUM, and NULLIFY_NUM all use the same format, for the collect, totems, and nullify objectives:
  • 0 means to require all infocaches, totems, or enemies
  • A positive number means to collect, activate, or nullify/destroy that many (COLLECT_NUM of 2 means “collect at least 2 infocaches”)
  • A negative number means to collect, activate, or nullify/destroy ALL EXCEPT that many (NULLIFY_NUM of -2 means “nullify all enemies except for 2”)
• TIME is the number of frames (30 frames = 1 second) since the start of the level for the time objective to complete. The default value of 18000 means 10 minutes.
• The rest is info for the custom objective, which is explained in its own tab.

Custom Objectives Overview (4RPL)

Each transition can have one custom objective on it. It is updated by an external script through the 4RPL SendMsg API. Each custom objective has a few settings that must be set in the transition unit's settings:

• CUSTOM_GOAL: If the transition is fed any number greater than or equal to this number, it will complete the custom objective.
• CUSTOM_START_TEXT: A string that shows up as the objective description when the level is loaded into, before the player unpauses.
• CUSTOM_RUNNING_TEXT: A string that is shown when the level is running. This can be changed directly with SetScript1Var, or will automatically update itself by these rules:
  • Any instance of “<percentage>” in the string will be replaced by an automatically calculated percent complete (last value given / CUSTOM_GOAL * 100), with the % sign included.
  • Any instance of “<amtleft> will be replaced by [CUSTOM_GOAL - last value given]. Useful for “Do something X times” types of goals.
  • Any instance of ”<rawval>“ will be replaced by the last value given, whether it is a string, number, list, or anything else.
• CUSTOM_CHANNEL is the message channel used to communicate objective progress with this transition.

Goals

Goals are special types of levels that will complete the custom objective (beat the game) when they are unlocked. They show script settings like any other level, but they will ignore all of them. There can be any number of goal squares, and only one must be reached to win.

Thumbnails

Thumbnails are a special type of level that allow you to have a custom thumbnail for a colonies map that is not the first level of your campaign. This is done by saving a level that is switched out of immediately when loaded into.

To make one, add a thumbnail unit to your level, add a transition from it to the first level of your campaign, and make the thumbnail level like any other level. Just remember to finalize on the thumbnail before you upload it!

Help (unit)

The help unit that shows up on the layout editor can be used as a quick guide in-game at any time. It has basic, essential information on what things do, and will redirect you back to this page on mouseover. It will delete itself when you exit the layout editor.