Clones Level Editor Guide

Table of Contents

  1. Overview
  2. Screenshots
  3. Clones Level Editor Architecture and Features
  4. Creating a Simple Clones Level
  5. Description of the Level Editor Interface
  6. Editing Area and Description of Shortcut Keys
  7. Scrolling/Viewing Level
  8. Methods for Selecting Objects in the Level Editor
  9. Editing an Object
  10. Mirroring/Flipping/Flopping
  11. Copying
  12. Rotation
  13. Scaling
  14. Tinting and Alpha Blending
  15. Measurement
  16. Terrain Primitive Object Description and Blending Operations
  17. Shortcut Key Reference
  18. Guidelines and Best Practices
  19. Level Settings
  20. Editor Options
  21. Tournament Configuration
  22. Contraptions (also known as Traps)
  23. Group Settings
  24. Clone
  25. Conclusion
[back to top]

Overview

Clones (the game) contains a fully featured built-in level editor that enables one to create custom multiplayer and singleplayer levels as well as new CloneMaster maps.

This guide will:

  • Show you what can be done using the level editor
  • Provide a tutorial on how to create a simple level
  • Describe the function of each of the buttons on the level editor interface
  • Describe each of the objects that are available in the editor and their essential configuration parameters
  • List all keyboard shortcuts which help power users to quickly create levels
  • Provide guidelines and best practices when creating singleplayer and multiplayer levels
[back to top]

Screenshots

Here are some screenshots of the level editor in action!!

Triggers can be used to create very complex and interactive events!Adding images to the level is done by browsing thumbnails of imagesThis magnificent tutorial level is annotated to help the player learn the game!Group Settings allows control over the number of morphs available for each clone groupLevel Settings can be tweaked to your heartExample of a popup configuration windowMultiple objects can be selected and edited simulaneously!The clone cannon has prediction mode to perfectly align it
[back to top]

Clones Level Editor Architecture and Features

The Clones Level editor is a tool that gives you the freedom to create completely new levels or modify existing levels. It is a WYSIWYG (What You See Is What You Get) editor which means that the level you are creating will look exactly like it does when you are playing the level. A typical level is built from individual objects known as primitives (which are simply images such as rocks, or beams, for example), traps (which are interactive elements of the level), and Clones (which are pre-positioned in the level). All level objects appear graphically in the editor, but are not necessarily visible when the level is played (based on the type of object and its configuration). By arranging many of these level objects and modifying their properties you can create dozens of totally awesome and unique levels!

Notable Features of the Clones Level Editor

  • Undo/redo functionality
  • Copy and paste
  • Quick level testing
  • Intuitive methods for selecting of map objects
  • Select and edit a group of objects at once
  • Context sensitive right-click pop up editor for all objects
  • Snap-to-grid functionality
  • Multi-layer support
  • Real-time image transformation such as scaling, rotation, tinting
  • Destination and source sensitive blending and carving modes
  • Many advanced stacking, mirroring, and flipping operations that allow for quick creation of symmetrical levels
  • Super cool alpha blending support
  • Extensive and flexible trigger and event system
  • Lots more!

With the Clones Level editor it is possible to quickly create balanced (i.e. symmetric) multiplayer levels. The game is designed to efficiently handle large sparse level designs of up to 16384 x 16384 pixels in size as well as very long or very tall levels.

Terrain primitives are the basic building blocks for creating the landscape of the level. They are nothing but simple PNG graphic files. A large selection of these are supplied with the game. The powerful layering and image transformation capabilities permit a large number of different looking levels to be created from a very limited number of primitives. For example, it is possible to use simple shapes to carve contours out of existing primitive groups, or use the blending operations to ‘paint’ onto the existing landscape.

Clones Level Editor supports several extra objects called traps. These objects may provide non-interactive eye-candy for the game, visible interactive game elements, game rules and triggers, or level modifiers to name a few. Nearly all the game-play modification and configuration is done by adding and modifying these trap objects. The right combination of traps can drastically change the dynamics of the game!

The pre-positioned Clones allow the level designer to add Clones of a certain group at a specific position on the level. This is required for the Capture the Clone tournament mode, but can also be used in other tournaments. For example, placing clones in a quarantined area that need to be saved, or as a way to handicap one group of clones!

[back to top]

Creating a Simple Clones Level

This section will take you through the process of creating a very simple level.

  1. Start Clones Game
  2. From the Main Menu, click on the Extras Button
  3. Click on the Level Editor Icon
  4. To create a new, blank level, click on the ‘New’ button on the bottom right. This will load a sample level
  5. To remove everything in the level and start from scratch, press CTRL+A to select all, then press the DELETE button on the keyboard. You should now see a blank screen for the level.
  6. First, lets configure the global level properties
    1. Click on the level settings button (or press F2)
    2. Enter the level name, your name as the author, and setup the level size, and description
  7. Add the sky
    1. The sky is implemented as a trap. Click on Add Contraption icon (or press F4), then click on the "Environment" tab, then click on the “Sky” (looks like the sun with sunglasses)
    2. Right click on the Sky trap to bring up the properties
    3. Let’s set the sky trap image by clicking on the ‘Set Image’ button
    4. Browse to the ‘Backtiles’ folder as this one contains the images that are suitable for the sky
    5. Let’s pick ‘clouds.jpg’ as the sky image. Click Ok. The background sky should how be in effect.
    6. Let’s modify the sky properties so that the sky is moving. Click on the Vel. X text box and change the value to ‘2.0’. Click on the level to close the properties window (or press ESC) and apply the changes. The sky should now be moving horizontally, slowly
  8. Add the Start
    1. The Start is implemented as a trap. Click on the Add Trap icon (or press F4), then click on the "Machines" tab, then click on the ‘Start’ trap
    2. By default, this start will be configured for blue group.
    3. Select the start by clicking on it (if it isn’t selected already). Selected object will be highlighted with a yellow border.
    4. Drag the start to the top left corner of the level by clicking and dragging it, or you can also move it by the arrow keys on the keyboard (CTRL+Arrow keys for bigger movements, CTRL+SHIFT+Arrow for even bigger movements)
  9. Add the exit
    1. The Exit is implemented as a trap. Click on the Add Trap icon (or press F4), then click on the "Machines" tab, then click on the ‘Exit’ trap
    2. By default, this exit will be configured for the blue group.
    3. In a similar fashion to the start, move the exit trap to the top right corner of the level
    4. When the exit trap is selected, you will see a white box appear. This indicates the area below the exit where the clone get beamed in.
  10. For the sake of this example, we will create a simple platform to get the clones to walk from the start to the exit. To make the platform we need to add some terrain primitives
    1. Click on the ‘Add Terrain’ Button (or press F3)
    2. Browse to the file Graphics\primitives\Virtual\Tiles\mech_tile_scratched_bolted.png. Click Ok.
    3. Click and drag the terrain primitive so that is is located below the start
    4. Now we are going to copy the terrain multiple times to form a bridge.
      1. First left click on the terrain primitive to select it.
      2. Move your cursor to the right of the primitive. We do this because when we perform the copy operation, it will place the copy of the object in the direction of the cursor (stacking it).
      3. Press CTRL+C to copy the selected object.
      4. The copy is now selected. You can press CTRL+C to copy it again (take note of the relative position of the cursor with respect to the object you are copying – ensure your cursor is to the right of the object).
      5. Do this a few times so that the bridge created by the terrain spans the length of the level so that it is now underneath the exit.
  11. Reposition the exit
    1. Click on the exit and make sure that the bottom of the white box lines up with the top of the terrain primitives. This makes sure that the clones will be able to get beamed up when the walk on the terrain.
  12. Congratulations! You have successfully created your first single player level! You can either click on the ‘Save’ button and exit the level editor, or you can click on the ‘Test’ button to test your level. After you test your level and you exit the test, it will take you back to the level editor so that you can continue to make your changes and tweaks.
[back to top]

Description of the Level Editor Interface

Here is a break down of the various buttons and items you will find on the level editor interface. There are two basic regions: The main editing area where you can view and edit the level, and the panel on the bottom edge of the screen.

The buttons on the bottom panel are:

  • Help (F1) – Provides a list of shortcut keys and basic editor operations
  • Level Settings (F2) – Here you can modify the global settings of the level
  • Add Terrain (F3) – Brings up a browser so that you can add a terrain primitive to the level
  • Add Contraption (F4) – Brings up a browser so that you can add a trap to the level
  • Group Settings (F5) – Allows you to configure the number of morphs available for each group
  • Editor Options (F6) – Allows you to modify how the editor behaves and load backups
  • Editor Tools (F7) – Allows access to Restore Backup, Select Similar and Reset Shadows
  • Test Level (F8) – Allows you to play the level that is currently being edited. When you exit the level, it will return you back to the editor
  • Save (F9) - Saves the current level to file. It uses the level name when saving
  • Open Backup (F10) – Allows you to load backups
  • Exit (F12) – Exits the level editor and returns back to the main menu

On the bottom right of the panel, you will see a thumbnail of the object that is currently selected. Please refer to this to remind you which object is selected.

Just above the bottom panel, you will see an information bar that displays information about the currently selected object or group of objects. This includes information such as object size, position, cursor position, object source filename, number of objects selected.

[back to top]

Editing Area and Description of Shortcut Keys

The level editing area shows a WYSIWYG representation of the level. It is very close to what the level will actually look like when played, but not exactly. This is because when the level is actually loaded the game rasterizes and flattens all the images to make an optimal representation of the level. This should be kept in mind when creating levels and be sure to always test your levels.

[back to top]

Scrolling/Viewing Level

The bounds of the level are defined by a white rectangle. You can change the size of the level in the level properties pane. When nothing is selected (press CTRL+D or ESCAPE to deselect all) , you can use the PAGE UP, and PAGE DOWN keys to zoom in and out of the level. To get an entire view of the level hold onto the SPACEBAR key. While holding the SPACEBAR key you can use the mouse to select an object and after releasing the SPACEBAR key the view will zoom into the new selection. This is very useful for quickly going from one area of the level to another.

The editor supports the ability to provide axis lines and grid lines to assist in creating symmetrical and aligned levels. The grid size can be adjusted in size, and the snap-to-grid option will cause the object that you move with the mouse to snap to the nearest grid edge. The axis lines are lines that are drawn on the vertical center, the horizontal center, and across both diagonals. These lines are often useful as reference lines.

[back to top]

Methods for Selecting Objects in the Level Editor

All the objects in the level can be selected and edited. There are multiple ways and multiple modes for modifying the current selection.

  • Single left clicking or Single right clicking on an object with the cursor will immediately select it.
  • Single right clicking on an object with the CTRL key pressed will either add or remove the object clicked to the selection. If the object was previously selected, then it will remove the object from the selection, and likewise if the object was previous not selected, it will add the object to the selection
  • Right click and drag will create a selection box that will add multiple objects to the selection. There are two modes of selection with a box. If you create a selection box by dragging from left to right, then any object that touches or is contained in the box is selected. If you create the selection box by dragging right to left, then only objects that are completely contained by the selection box are selected. This is sometimes very useful when you want to select multiple small object that are overlayed against a large background object.
  • Right click and drag and CTRL will add/remove multiple objects at a time

The primary object in a selection is identified by a yellow highlight. All other objects in a selection are highlighted with a white rectangular outline. In addition, the bounds of the selection are identified by a yellow rectangle. The primary object in a selection is important when editing the selection (see editing section for additional information).

You can also select ALL objects using the CTRL+A shortcut key. Likewise to remove all objects from the selection, press CTRL+D or ESCAPE key. You can also select the ‘next’ and ‘previous’ object using the ] and [ keys respectively. The next object will be the next object of the same base type (ie. terrain primitive, trap, or clone). When there are multiple objects in the selection, then the next/previous object will change which object is the primary object in the selection.

Whenever you move the mouse over any object a red rectangle will appear around it indicating that it is the one that will be selected if you single right click on it (or single left click on it – assuming that the object is outside the bounds of the existing selection). Sometimes multiple objects will be overlapping in the same area, so in order to select a specific object, you can press the TAB key. The tab key will cycle through all the object currently underneath the cursor and select each one, one at a time. Remember to keep the cursor over the location of the object you want to select as you continue to press the TAB key.

There is an editor option that allow you to include or exclude traps when using the selection box to multiselect objects. It is useful to exclude traps from the selection when creating symmetrical levels and you only need to select and edit the terrain primitives.

[back to top]

Editing an Object

There are numerous ways to edit an object. Some editing can be done graphically by manipulating the object with the mouse, and other editing can only be done via the properties window. Before any editing can be done on an object, it must be first selected (see section on how to select an object).

The editor supports undo and redo functionality that allows you to revert your changes and restore the level to a previous state. Pressing CTRL+Z is for undo and CTRL+Y is for redo. A complete undo history is stored, thus you can undo all the way back to how the level was when it was opened. You can delete selected objects by pressing the DELETE key. If you accidentally delete an object, you can undo this operation.

All of the objects in the level support a properties window that can be displayed by first selecting on the object, then right clicking within the selection bounds. The properties window will display near the object. You can then change the properties in the window. When editing some of the properties you will see immediate changes to the object, while other properties are only applied to the object when the properties window is closed. To close the properties window, you can right or left click anywhere outside of the properties window or press the ESCAPE key (or click on the close button in the upper right corner). When multiple object are selected, the properties window will only be shown for the primary object that is selected (see object selection for a description of the primary object) and only the primary object is edited. To apply the properties to all common types of objects in the selection, hold down the SHIFT key while closing the properties window.  In this case, only the modified properties will be applied to all objects of the same type as the primary object.

Moving an object or a selection can be done by any one of many methods. The simplest way is by left clicking within the bounds of the selection and dragging it to its new location. Holding the SHIFT key while dragging the selection will cause the move operation to be orthogonal (ie. Move perfectly horizontally or perfectly vertically). You can also move the selection with the keyboard using the arrow keys (up, down, left, and right arrows). Normally, the arrow keys will only move the selection by 1 unit at a time. Hold down CTRL key at the same time to move the selection by 10 units at a time, and SHIFT to move the selection by100 units at a time. To center the selection horizontally, press the X key on the keyboard, and to vertically center, press the Y key. Pressing both X and Y in sequence, will center the selection in the middle of the level. You can also move objects by stacking them next to each other. To do this, you must first select a single object (this operation doesn’t work with multiple objects selected). Then hold the S key and single left click on the target object that you want to stack to the right of the reference object. If the sizes of the two objects are not the same, then the objects will be vertically aligned with each other. To stack to the left of the reference object, simply hold SHIFT+S before left clicking on the target object. Likewise, you may stack vertically using the D, and SHIFT+D for stack down and stack up respectively. The editor supports snap to grid functionality and this is very useful when you want to align objects along orthogonal lines. Under editor options, check the “Enable Grid” and “Snap to Grid” options. When enabled, the current selection preferentially align it’s edge with the nearest grid line only when the selection is moved with the mouse. Movement of the selection using the keyboard ignores any of the grid snap rules. In some cases, you want to get the currently selected primitive object to “fall” down to the landscape below it. This is useful when you want to quickly place an object on top of existing terrain based on the collision point. First select the object that you want to “drop” then press L. Holding SHIFT and/or control while pressing L will drop the primitive in different directions.  This only works for the primitive base type.

[back to top]

Mirroring/Flipping/Flopping

This section will deal with mirroring and flipping that does not make a copy of the original section first. Please refer to the “Copying” section if you want to copy before the mirror/flip operation. Also note, that not all objects support these operations. The mirror/flip/flop operations are most applicable to the terrain primitive types of objects. To flip the selection horizontally in place, press the H key. Likewise a vertical ‘flop’ is performed by pressing the V key. To mirror about the vertical axis, hold the SHIFT key prior to pressing H or V for horizontal mirror, or vertical mirror respectively. If you have two objects that are on the screen and you want them exactly equidistant from the vertical or horizontal center then you can do this by selecting the first object (that will act as a reference), then hold down the M key while you left click on the second object. The second object will be moved exactly opposite the vertical center from the reference object. Likewise, holding the N key while clicking on the secondary object will position it in the mirrored vertical direction. No copies of the reference or target are made. You may also mirror objects with respect to the diagonals lines going from the top-right to the bottom-left, and from the top-left going to the bottom-right by pressing K or J respectively.

[back to top]

Copying

There are numerous ways of performing copies of objects, many of which are combined with the mirroring/flipping/flopping operations for convenience. The most basic copy operation begins with selecting an object or a group of objects. Then move the cursor in the direction you want the copy to be place relative to the selection, then press CTRL+C. When this is done, the new copy is “stacked” in the direction that was suggested by the cursor, and the new copy becomes the current selection, so that the process can be repeated again. In this way, it is very fast and easy to make levels from tiled objects (such as bricks, tiles or rectangular stones). If instead you press CTRL+SHIFT+C when copying, the the resulting copied selection will be mirrored in the direction it was copied (either mirrored vertically or horizontally). Pressing CTRL+V on a selection will copy and mirror it vertically about the vertical center. Pressing CTRL+H will copy and mirror the selection about the horizontal center. Pressing CTRL+J will copy and mirror the selection about the top-left to bottom-right diagonal, and CTRL+B will copy and mirror the selection about the top-right to bottom-left diagonal.

[back to top]

Rotation

You may rotate a complete selection of objects or just an individual object. Rotation is performed about the center of the selection. This means that the objects will be translated in order for all the objects within the selection to keep their relative orientations. Rotation can be invoked by holding the F key while moving the mouse up and down. This will rotate the object 15 degrees at a time (locked). For finer rotation adjustment, hold SHIFT+F while moving the mouse up and down. You can also open up the properties window for the selected object and enter the rotation value directly (for those objects that support rotation). Some object may not support rotation, but rather an orientation. For example, when you rotate a cloning chamber (start point), it will graphically rotate, but will only change the gravity of the clones from the chamber when the rotation exceeds 45 degrees. To rotate the selection by 90 degrees clockwise, press the “PERIOD” key, and to rotate counter clockwise, press the “COMMA” key.

[back to top]

Scaling

Scaling with the mouse is only supported for terrain primitives. Scaling can be performed on a single primitive, or a selection of primitive (with some restrictions). With the current selection, press and hold the W key to enable scaling mode, then left click and drag within the selection bounds. Dragging up and down will change the scaling of all objects within the selection, keeping the relative positions of the objects consistent. Holding down CTRL+W during scaling will make the scaling resolution finer so as to achieve better control of the final scaled size. The scaling process keeps the aspect ratio at unity unless the SHIFT button is held down. Holding down SHIFT+W will enable scaling of the X and Y relative to the objects local axis (orientation). Because it is relative to the local object, this mode of scaling is only active when one object is selected (a multiselection deactivates this scaling mode). This is a fundamental limitation of the way primitives are transformed in the editor. Scaling values can also be directly entered into the property text values on the properties configuration window. A negative scaling value is valid and represents a horizontal flip or a vertical flop of the object. Keyboard driven scaling is performed using the MINUS key [-] to scale down by 0.5, and the EQUAL key [=] to scale up by 2. Some traps can be scaled if the keyboard is used.

[back to top]

Tinting and Alpha Blending

Tinting can be performed on all terrain primitives and some traps (that support it). You can adjust the red, green, and blue channels separately to obtain varying effects on the image. For example, if there is water nearby, you may want to apply a blueish tint to the object to make it look like there is a glow coming off the water. The tint operation can only increase the color channel by a maximum of 127 or decrease it by a maximum of 127 from the current pixel value (channels are 8bit per color giving a dynamic range of 255). Dynamically modifying the tint can be performed by first selecting the object to modify, then holding the R, G, or B key for red, green, and blue respectively, then moving the mouse up or down to change the tint value. By modifying all three channels simultaneously, the brightness can be adjusted. Holding down the O key while moving the mouse will modify the brightness of the object. Alternatively, you can open the properties window of the selected object and use the slider bars to adjust the tint. Check off the “Adjust Brightness” option to lock all three channels. Right click on the slider bar to toggle between the following three states: minimum value, maximum value, and middle value. Right clicking is a fast way to reset the tint back to the default (no tint). Only terrain primitives support adjustable alpha values. The range of alpha values goes from 0 (meaning completely transparent) to 100 (completely opaque). The alpha value of an object can be modified by first selecting it and holding the A key while moving the mouse up and down. Alternatively, you can also open the properties editor (by right clicking on the object), then changing the alpha value with the slider bar. It is important to note the blending behaviour of terrain primitives as the alpha values are modified. If the object is flagged as “low quality”, then it will not be blended to the air unless it has 100 alpha, or if it there is existing land beneath it. Please refer to the terrain primitive blending operations document section for detailed explanation of all the blending rules.

[back to top]

Measurement

During level design, it is often important to determine if certain parts of the landscape are the correct dimensions and position according to the rules of the game-play. For this reason, you can press and hold the / (forward slash) key to display a regular sized clone at the current cursor position. This is a useful method for measuring the height of tunnels or overhangs, or getting a feeling for the relative dimensions of the level with respect to the clone’s size. Another measurement tool, known as the critical fall distance, is display at the cursor’s position when you press and hold the E key. The critical fall distance is the maximum height from which a clone can fall without atomizing when it hits the ground. Use this tool when creating cliffs to determine if they are safe to fall from.

[back to top]

Terrain Primitive Object Description and Blending Operations

The terrain primitive object (let’s just call it the primitive) is one of the most important objects in the level editor. Primitives are small images that are imported into the level, and used to create the landscape that the clones interact with in the game. The primitives can be transformed by rotation, scaling, tinting, and blended with the existing landscape in various ways through alpha blending (additive), overlaying, and carving for example. By using all these transformation and blending tools available to you, it is possible to create many different and exciting looking levels using a small number of primitives. The supported file format for the source images for primitives are: PNG files, with alpha channel support, and JPG files. There are already hundreds of available images that can be used as primitives that are available in the core Clones installation.

To add new primitive to the level, you can press the F3 key (or click on the ‘Add Terrain’ button in the menu bar at the bottom of the screen). This will display an image browser that will allow you to navigate through the folder structure (folder names categorizes the images into different themes, and functions). Clicking on a filename, will display a preview of the image. Click ‘OK’ to add the primitive. The primitive will be added to the center of the viewable area.

Primitives support different land types that affect how blending operations occur, as well as how Clones interact to that portion of the landscape. All the possible types of land and their functions are described below:

Land Type Description
Soil (Default) It supports the weight of the Clones, but the Clones can also Clob, Drill, Gulp, and Nova it. This is the primary substance of the landscape.
Clonium It supports the weight of the Clones, but the Clones cannot destroy this material. Only the mutant dark clone can destroy it when it goes nova. Clonium makes a virtually indestructible barrier and its good for making divisions in the level.
Air When a primitive is the air type, it will remove all soil, clonium, and bridge land types beneath it.
Bridge It allows the clone to walk through it, as well as walk on top of it (supports the clones’ weight).

The z-order of the primitives is very important to how the blending operations occur. When a primitive is selected in the editor, a number is displayed in the upper left hand corner where 0 is the farthest primitive, and increasing positive numbers indicate the primitives that are more “in front”. The blending operation starts at primitive 0 and subsequently blends each one. Whenever a new primitive is added, it gets placed to the top of the blending order. The z-order can be changed by pressing the HOME key to bring the primitive to the front-most position, and the END key to take the primitive to the back-most position. Decreasing the z-order is done by pressing PAGE DOWN and increasing the z-order is done by pressing PAGE UP.

Soil, Clonium and Bridge land types add to the existing landscape, while Air removes from the existing landscape. Air is used as a “eraser” or a carving tool.

Each primitive has the option to control which landscape to modify. This is in reference to the landscape that is there just before the blending operation occurs. The options are:

Land To Modify Description
Any Land (Default) Blends the entire primitive to the landscape (ignoring what was there)
Air Only Leaves all existing land intact, and only blends to the area where there is Air only. This gives the illusion that the primitive is being rendered behind the landscape.
Land Only This option avoids the Air, and blends to the visible portions of the landscape. It is very useful for blending overlays, and decorations on the existing landscape.

In the properties editor, you will also notice two additional options called: Bash On Load, and High Quality. Bash On Load is checked by default, but in some cases you want to exclude a primitive from being added to the landscape when the level is loaded, and unchecking this option will do this. This is mostly done when enabling dynamic landscape operations (through triggers and events) with the Modify Land Trap where the “hidden” primitive can materialize when a certain event occurs (see the description of this trap for more details). The “High Quality” option is most relevant when the primitive has a lot of alpha in the image and/or if the primitive has it’s global alpha set to a value other than 100. In these two cases, it is advantageous to set the “high quality” option so that the primitive gets rendered with all it’s alpha intact. The “High Quality” option incurs a slight performance hit, which is the reason why the low quality is the default. Without High Quality enabled, if the primitive has an alpha less than 100, then the primitive will not be blended against the Air (it disappears), but will blend against existing landscape. This is by design.

[back to top]

Shortcut Key Reference

Key Combination Description
Global
F1 Help
F2 Level Settings
F3 Add Terrain
F4 Add Contraption
F5 Group Settings
F6 Editor Options
F7 Editor Tools
F8 Test Level
F9 Save
F10
Open Backup
F12 Exit
Scrolling/Viewing
PAGE UP Zoom In
PAGE DOWN Zoom Out
SPACE Preview Entire Level
B
Lock View to level extents
Selecting
CTRL+D or ESC Select None
CTRL+A Select All
LEFT CLICK or RIGHT CLICK Select Object
CTRL+RIGHT-CLICK Add/Remove From Selection
RIGHT CLICK+DRAG LEFT Select Multiple Objects (Fully Contained)
RIGHT CLICK+DRAG RIGHT Select Multiple Objects (Partially Contained)
] Select Next Object
[ Select Previous Object
TAB Select Alternate Object Under Cursor
Editing
CTRL+Z Undo
CTRL+Y Redo
DELETE Delete Selection
ESCAPE Close properties window
SHIFT+{Close Properties Window} Apply properties too selection
Positioning
LEFT CLICK+DRAG {On selection} Move Selection
LEFT CLICK+SHIFT+DRAG {On Selection} Move Selection Orthogonally
ARROW KEYS Move Selection by 1 unit
CTRL+ARROW KEYS Move Selection by 10 units
SHIFT+ARROW-KEYS Move Selection by 100 units
X Center the selection horizontally in the level
Y Center the selection vertically in the level
(SHIFT+)S+LEFT CLICK {reference is selected, click on target} Stack to the right (left) of the reference object
(SHIFT+)D+LEFT CLICK {reference is selected, click on target} Stack to the bottom (top) of the reference object
(LEFT SHIFT+)L Stack all objects selected
(RIGHT SHIFT+)L Drop object(s) down (up)
(SHIFT+)CTRL+-L Drop object right (left)
HOME Front most Z-Order
END Back most Z-Order
PAGE UP (single selection) Increase z-order
PAGE DOWN (single selection) Decrease z-order
(SHIFT+)I
Align All Selected Controls (Bottom)Top
CTRL+(SHIFT+)I
Align All Selected Controls (Right)Left
Mirror/Flip/Flop
H Flip Selection In Place
V Flop Selection In Place
SHIFT+H Mirror about the central vertical axis
SHIFT+V Mirror about the central horizontal axis
M+LEFT CLICK {ref is selected, click on target} Mirror target about the vertical center
N+LEFT CLICK {ref is selected, click on target} Mirror target about the horizontal center
K Mirror about top-right to the bottom-left diagonal
J Mirror about the top-left to the bottom-right diagonal
Copying and Mirroring
CTR+C Copy Selection {copy in direction of cursor}
CTRL+SHIFT+C Copy and Flip/Flop {in the direction of cursor}
CTRL+V Copy and Mirror Selection about vertical center
CTRL+H Copy and Mirror Selection about horizontal center
CTRL+J Copy and mirror the selection about the top-left to bottom-right diagonal
CTRL+B Copy and mirror the selection about the top-right to bottom-left diagonal
Rotation
F + {Mouse Up/Down} Rotate selection (15 degree intervals)
F + SHIFT + {Mouse Up/Down} Rotate selection (1 degree intervals)
PERIOD Rotate 90 degrees clockwise
COMMA Rotate 90 degrees counter clockwise
Scaling
W + {Mouse Up/Down} Scale selection
CTRL + W + {Mouse Up/Down} Scale selection (finer resolution)
SHIFT+W Scale x and y independently
MINUS Scale down by one half
EQUAL Scale up by two
Tinting/Alpha Blending
R + {Mouse Up/Down} Modify Red Channel Tint
G + {Mouse Up/Down} Modify Green Channel Tint
B + {Mouse Up/Down} Modify Blue Channel Tint
O + {Mouse Up/Down} Modify Brightness
A + {Mouse Up/Down} Modify Alpha Channel
Measurement
/ Draw regular size clone
E Draw critical fall distance bar
[back to top]

Guidelines and Best Practices

The level editor is a very powerful tool and there are certain guidelines that will help you to create levels that provide a more enjoyable gaming experience. It is strongly recommended that you consider these guidelines before making a lot of levels.

Become an efficient level designer

As you will quickly find out, many of the editing functionality is performed using the keyboard and mouse (in combination, or separately). It is recommended that you learn all the keyboard shortcuts as it will definitely increase the speed at which you create levels.  Note that some of the functionality can only be performed using the shortcut keys. The default key shortcuts have been all carefully thought out to make it easier to remember the keys. Please refer to this document, or the inline help in the editor (press F1) for a complete listing of all the shortcut keys.

Making levels is fun and easy. One of the fastest ways to build up a level is to take advantage of all the different modes of copy and paste functionalities (with mirroring). If you want to add an object, and that object already exists somewhere in the level, it is fastest to copy it, then tweak its properties as desired. In order to make the multiplayer levels fair they should be symmetric. It is recommended that only half of the level be created (either right or left, top or bottom), and simply mirror-copy to the other half when completed. This saves a lot of time, and ensures that the level is completely symmetrical.

Load Times - Optimization

When creating your own image files, it is best to try to keep them small and focus on reusing existing images to create your levels. Clones has an optimized landscape generation engine that is able to quickly load and render your levels within the game. However, if you want your levels to load faster, follow these recommendations:

  • Avoid lots of odd rotations and try to stick to rotations of 90, 180, or 270 degrees (as these are fast). If you do have an odd rotation, then any 90, 180, or 270 degree rotation of that one is also fast compared to another odd angle.
  • Avoid lots of scaling. Although scaling is a lot faster than rotation, you may want to avoid excess scaling. Scaling of 2x, 4x, 0.5x, and 0.25x are basically free, as these are accelerated in the engine.
  • Tinting does not slow down level load times significantly
  • Try re-using existing primitives that are already in the level. The fewer files that the level references, the faster that it will load
  • Smaller files will load faster, and render faster

Level Design

When designing a level, first take a few moments to consider the following questions that will affect how you want the level to play:

  • How long do you want a game session to be?
    • Typically larger levels will result in a longer game play session. Also, the closer each of the groups exits are, then shorter the session will be, as the clones will confront each other sooner.
    • Levels where the exit is below the clone chamber will also be much faster to play, as it is much easier to travel downward (with gravity), than upward.
    • The tournament style can significantly affect the length of the game session. In particular, care must be taken in designing Capture the Clone levels as it can be extremely difficult for either team to get an advantage over the other.
  • Who is my target gamer? What is the difficulty level I am trying to achieve?
    • Level difficulty can be controlled based on the existence of hazards such as dangerous cliffs, water, lava, and black-holes to name a few. If you want to design the level for beginner players, it is recommended to make the levels smaller and more contained. Likewise, simpler levels allow for lots of time between the required actions. Placing solid clonium below the cloning chamber and the exit is also recommended for beginner levels. If the target gamer is an experienced clones player, then the level can be made much more complex, and reduce the number of morphs available to the player.
  • What mood do I want to set?
    • It is recommended that when you design your level, follow a common theme. Choose your setting as being underground, in space, etc, and try to choose the landscape to fit the theme. Doing so will create a more compelling environment and make your levels seem more realistic
    • You can also adjust the mood by regulating the cloning rate of the clone chamber. A very quick cloning rate will dramatically change the tone of the game-play to a hectic one because any small mistake can affect a very large number of clones.
  • What are going to be the defensive and offensive strategies?
    • By planning for multiple different strategies for the level, you can ensure that the level will be very fun to play as it increases the re-playability of the level. For example, you may want to consider designing the level for three obvious paths to the exit (instead of one), each path offering some advantages and disadvantages.
  • What is the core concept that is to be demonstrated?
    • Often it helps to first decide on the fundamental goal of the level or in other words, the lesson that you want the player to learn. The lesson can be of various sorts: planning, speed, strategy, problem solving, or training. An example, if you want to emphasize the importance of keeping good spacing between all your clones, you can design the level such that grouping your clones together makes the level very difficult to complete. As you design the level, keep the fundamental goal in mind, as it will help you make the right decisions to create a level that is truly unique and fun to play.
  • What tournament style and game type are you going to create?
    • Deciding if the level is intended for singleplayer or multiplayer action is important for game design. For example, many multiplayer levels are designed symmetrically in order to make the game-play fair for all players (although it doesn’t have to be). Deciding on the type of tournament also important as it can affect the relative spacing of the start and exits, for example.

Level design is truly an art form and answering some of the questions above will help you get a head start on quality level creation. With some thought, and lots of creativity, you will be quickly on your way with making outstanding multiplayer and singleplayer levels!

Publishing Levels

After you create a level, we encourage you to publish your level to the ClonesGame.com website so that others can play and enjoy your creation. Here are a few recommendations to follow if you plan to publish levels.

  • Take care when adding content
    • Try to use the graphics set from the base installation as much as possible. When you do include your own graphics please consider the size of the images. The level package will include them making it larger and slower to download.
  • Use descriptive level name and level descriptions
    • The better the level name and description, the easier it will be for other players to find your level and remember it when they play it
  • Avoid questionable themes
    • Do not publish levels that contain suggestive racial issues, pornographic content, libelous material, copyrighted symbols or material, or obvious advertising material. Published levels are all moderated and any level that contains questionable material will have the associated CloneStats account deactivated.
  • Test levels before publishing
    • When saving a level in the editor, basic checks are made to ensure that the level is valid and doesn’t contain obvious errors. However, it does not check the playability of the level, so it is up to you to play the level to make sure that it plays the way you intended. Once satisfied with the playability, then you should publish it on ClonesGame.com

Tips and Tricks

To create 8 way symmetry, use the following method:

  • Ensure that the level dimensions are square (ie. Height=width)
  • Select the initial set of object(s)
  • Press CTRL+J to mirror diagonally
  • Add the original set of object(s) to the current selection by hold down CTRL while right click dragging, so that the initial set and the mirrored copy are both now selected
  • Press the following keys in sequence: CTRL+H, CTRL+V, CTRL+H
  • You will now have an arrangement that is symmetrical in all 8 directions.
[back to top]

Level Settings

Press F2 to view the level setting screen. Here you can set various global options for the level. When creating a new level, you should always configure the global options first. Give the level a descriptive name, and try to be unique as possible. The level name that you use will be used as part of the filename when you save the level. Entering your name as the author allows you to indicate to others that you have made this level.

The level description is used to give additional information about the level, either its location, its purpose, or to set the tone of what is to be expected. In addition to the description, it is advised to configure the tags for the level. Tags are used to provide additional information for the level so that it can be later search and organized according to the tags supplied. The more relevant the tags, the better your level will be found on the ClonesGame.com level sharing platform. You can add as many tags as you wish, but only add the tags that are relevant.

The level size can be increased in height, as well as in width from a minimum of 1024x768 to a maximum of 16384x 16384 in increments of 128 block sizes. The current architecture of the clones rendering engine allows for very sparse level designs (ie. No memory is allocated for portions of the level that contain no graphical detail. So don’t be afraid to make large levels!

The level type can be of single player or multiplayer. Its important to decide what type of level you are going to be designing before you start. When configuring for single player mode, you have the option of setting a time limit for the level. The time limit is specified in seconds. This is useful if you want to force the player to solve the level in a certain amount of time.

Level permissions allow you to control how wish your level to be used. If you want to restrict people from editing your level, then be sure to select ‘Play Only’ as the permission. If you don’t want to impose any restrictions, then leave it to ‘None’.

Specifying the difficulty of the level will help other players identify levels that are appropriate for their skill level. Please configure the difficulty to the best of your ability. Sometimes you have to play the level (or let others play the level), before you can decide on the difficulty rating.

The tournament style are also configurable from the level settings screen. See the Tournament Configuration section for detailed description of each option.

[back to top]

Editor Options

The editor options control how the editor behaves, and how the certain elements are rendered.

Normally when objects are selected, a number appears in the upper left hand corner indicating the z-ordering of the objects. A larger number means that it is more “In Front”, and a value of 0 is the “Farthest Away”. If you do not wish to display the z-order, you can disable this by unchecking the box.

Highlighting clonium objects allows you to quickly see what parts of the level are clonium. This is indicated by a series of MMMM rendered on top of all the elements of the level that are clonium. It is advised that this option be normally left off.

For increased rendering performance in the editor, you may want to disable the background. When this is done, the background is rendered as black.

Snapping to grid is also an option in the editor. You can control the grid size, and the control the display of the grid points. When grid snapping is enabled, the selected object will snap to the nearest grid when moved with the mouse. This is useful when aligning certain elements.

Object hotspots indicate where the center of rotation is. This is a useful visual aid when manipulating lots of objects with the mouse.

When designing symmetrical multiplayer levels, it is useful to display the axis. When enabled the following lines are drawn: vertical center, horizontal center, upper left to lower right division, and upper right to lower left divisions.

Normally when you are selecting multiple objects using the right click – drag method, only the primitives will be selected. If you want to include traps and clones into the selection box, then enable the multi-select traps option.

Smart Stack option is normally recommended, and it is used to stack primtives together based on their actual pixel boundaries instead of the bounding box boundaries.  This is mostly useful for primitives that are rotated, or are of odd shapes.  This affects the copy/paste operations as well as the stack operations (S and D).

It is important to save the level often. The editor can save a backup copy of your level whenever you save. Simply check the Perform Backups option to enable this.  Hold SHIFT while clicking on Open (F9) to load an exsting backup.  You may want to load an existing backup if you made a serious editing error in the current level (that was already saved).

[back to top]

Tournament Configuration

Setting the type of tournament is performed on the “Level Settings” screen. Once selected, you can edit the tournament options to tweak the default settings. The default settings will be loaded when the level is loaded, but in a multiplayer game, the server host has the option to override these settings.

Common Options
Option Description
Statues Allows players to place a statue to block opponent clones.
Allow Stunning The clone will be stunned (and not move) when an explosion occurs nearby
Double Fall Allow falling from twice the height before atomizing


Procure The Particle
Option Description
Allow control of particle carrier When a clone has a particle, you can either disable the ability for the clone accept morph command or not. Disabling the control of that clone typically leads to longer game play sessions.
Allow particle hand off When enabled the clone with the particle will give up the particle to the clone what just walked by.
Allow particle dropping You can explicitly drop the particle when this is enabled by pressing on the shortcut key to drop.
Allow inter group hand off When enabled, the particle will be handed off to a clone of another group, if they walk by
Lost particle stays lost When enabled, the particle will not return back to the initial point if it gets lost.


Quantum Quarrel
Option Description
Friendly Fire Allow your clones to inflict damage on clones in the same group.
Self Hurt If enabled, the clone performing the attack will be susceptible to damage as well.

Multiverse Match
Option Description
Sabotage Clone Allow the generation of a sabotage clone when the level starts
Big Clone Configure the sabotage clone to be a big clone (2x normal size).
[back to top]

Contraptions (also known as Traps)

All the dynamic interactive elements of the level are designated as contraptions. They can be used in many different ways to make the levels interesting and fun. There are five basic types of traps: Hazards, Machines, Environment, Logic, and Map. This section will describe each trap in detail and explain each of their configuration options.

Many of the traps contain common properties, and all of them are represented visually in the level editor. Some of the traps, however, are not visually displayed when the level is played, but instead perform some control mechanisms. The control mechanisms allow for a level of scriptability and dynamic response based on the triggers and event mechanism for each of the traps. Each trap supports one or more events that can be used to trigger the activation of other traps. These triggers and events can be chained and linked together to form very complex actions.

Each trap has a position, and it can be moved by any of the object positioning commands, or by dragging the object in the editor. To edit the trap properties, select the trap then open the configuration window by right clicking on it.

Many of the traps also have the option to modify it’s the rendering layer (how it is displayed in the game). If you want trap to appear behind the clones, then check the “Behind Clone” option. Likewise, if you want the trap to appear behind the landscape, the check the “Behind Landscape” option. It is possible to configure any combination of the two rendering options. However, there are certain traps that will always render to the background irregardless of the rendering options. Also, certain traps will permanently modify the landscape in its vicinity (eg. The cloning chamber will bash itself as clonium when the level starts (so as the clones cannot go through it).

Many traps also have a rotation parameter to modify the angle at which the graphic is rendered. Certain traps will modify its behaviour when the rotation is set to certain angles. For example, the cloning chamber will start producing clones with a different gravity if the angle is larger than 45 degrees from 0. Any special rotational dependencies will be mentioned when describing the trap in detail.

Brightness and tint can also be adjusted for most of the traps. This is to allow for tweaking the default graphic to accommodate the theme of the level. Checking off the brightness adjust option will lock the red,green, and blue tint values so that when one is changed, they all change.

Some of the traps also support pick up mode options. This is an alternate mode allows you to place a bonus item on the level that performs the same functionality of the trap, but can be limited to a finite set of uses (configured in the pickups edit box). The pickup is displayed as a animated sphere with an icon inside it. The two modes for pickup is the “on the ground” mode and the “floating” mode. The floating mode is useful when placing the pickup in the air, whereas the “ground” mode will produce an icon that bounces on the ground. It is important to properly place the “ground” pickup, so that the bouncing effect looks realistic. This can be done by placing the lower bound of the pickup so that it lines up with the underlying landscape. It is recommended that “ground” pickups be placed on level surfaces.

For the traps where the group can be specified, valid values are from 0 to 7. These correspond to the following group colors:

Group ID Color
0 Blue
1 Green
2 Red
3 Grey
4 White
5 Yellow
6 Orange
7 Purple

Clone sizes can be specified as 0.5 (for small), 1 (for regular) and 2 (for large).

Hazards

Hazards are traps that clones typically want to avoid because they impede or destroy clones in some fashion.

Water

The water trap contains three rendering modes: water, lava, and acid. They are hazards that is typically placed at the bottom of the level and whenever a clone falls in, they perish. The trap can be extended horizontally by increasing the number of “sections” such that the total width will always be a multiple of the width of one section. The water trap can be configured to contain a high tide and low tide with preconfigured timings between these tidal events. The flow rate parameter adjusts the animation speed of the graphic to simulate relaxing atmosphere (slow water movement), or intense (fast water animation).

To control tidal activity use the following parameters:

  • High Tide – specify the height of the high tide
  • High Time – the number of game updates to remain in high tide
  • Low Time – the number of game updates to remain in low tide
  • Change Time – the number of game update for the transition from high to low tide

Drown Event – When a clone downs in the water, the target is activated.

Shock

The shock hazard electrocutes any clones that walk nearby. It can be increased in size by modifying the “Section” parameter. In addition, the trap can be rotated by any angle. When a clone is electrocuted, the trap fires the “Shock Event”.

MushBomb

This trap sends off a ring of energy that modifies any clone within its activation radius. There are six basic modifiers for the bomb:

  • Atomize – Atomizes the clone – back into elementary particles
  • Solidify – Converts the clones into solid structures
  • Ice – freezes the clones in place
  • Gravity (up,down,left,right) – Modifies the gravitational orientation of the clone
  • Shrink/Grow – Increases or decreases the size of the clones

The size of the activation radius can be adjusted as well as its speed of “explosion”. If you wish to configure the explosion to happen on a regular basis, then set the “Period” parameter to a non-zero value. The units is in number of game updates.

When the mush bomb explodes, it fires the explode event. When the trap is activated, then it will cause an explosion to occur.

Black Hole

The black hole hazard will suck up any clones that come too close to its center. Other than the common basic configuration options, there are no other advanced parameters for this trap. When a clone gets sucked into the black hole, the “Melt” event is fired.

Machines

Machines are contraptions that clones can interact with directly on the level. The are mostly mechanical in nature and they can be used for various different purposes.

Teleport

Teleport trap teleports the clones from its current location to another location on the level. To configure the destination point, click the “Set Destination” button and click on the point in the level where you want to clones to be teleported. There are three modes of teleportation: Absolute, Relative to Clone, and Relative to trap. The mode determines how the final destination point of the clone is computed. When in Absolute mode, the destination point is the point you clicked on (when setting the destination), and will stay at this point even if the teleport trap is moved, or copied. When set to “Relative to Trap”, the destination point is computed relative to the current position of the trap. When the trap moves, or is copied, then the teleport position also moves. When “Relative to Clone”, it behaves similar to “Relative to Trap” except the destination point will be dependent on the direction the clone is facing. This way you can configure the teleport to computer the destination point “in front”, or “behind” the clone. This last mode is useful for creating symmetric multiplayer levels.

When a clone teleports, it will fire the “Teleport Event”.

Swap

The swap trap is primarily used in multiplayer levels but can be used in single player levels as well when properly integrated. The swap trap will change the group of any clones that walk by. It has an activation range very near the center of the trap. When a clone is swapped, it will fire the Swap event.

Size

The size trap is a special chamber that changes the size of clones that walk through it. It can be used to convert clones from any combination of small (1/2 size), to medium (nominal size), to large (2x size).

When a clone is resized, it fires the “Resize Event”

AntiGrav

The antigrav trap is designed to change the gravitational direction of clones that walk into it. It operates based on the originating orientation of the clone such that the trap can be configured to change the gravity of clones from right side up to up side down for example. To setup a rule, click the input orientation, then the output orientation, then click on the “Add Rule” button. You can add as many rules as you want. By default, any input orientation is accepted. If you want to reset the rules, click on the “Clear Rules” button.

When the “Use Area” property is set, then the trap becomes a hidden antigravity area. This is useful for getting clones to spontaneously walk on walls for example.

When a clone changes it gravity, the “Gravitize Event” is called.

AcidRain

The acid rain trap ejects particles that fall onto the ground and interferes with the actions of clones by either etching away at the landscape or adding additional particles to the landscape. You can control the frequency of ejection, the size of the ejected particle, and the number of bounces that each acid particle is allowed to bounce before it expires.

This trap does not contain any events.

Bridge

The bridge is made up of multiple (configurable) sections that can open and close based on a timer or based on the number of clones that are currently on the bridge. Setting the “Max Clones” parameter to 0 indicates that the bridge can hold any number of clones. The “Time Closed” and “Time Open” parameters are specified in the number of updates and specifying 0 for these times will disable the timer.

The bridge supports the “Opening Event” and the “Closing Event” for triggers.

SlingShot

The sling shot shoots a gust of air and propels the clone up into the air. It can be rotated in any direction and the magnitude of the air gust can be configured so that the clones can be pushed further away. You can check the “Flip Graphic” parameter to change the orientation of the graphic. To help in configuring the magnitude and rotation of the trap so that the clone will land at a certain position, click on the “Set Destination” button then click on the point the level. The editor will automatically compute the parameters for you.

When a clone is propelled, the “Sling Event” is fired.

Start

The cloning chamber produces clones of a certain (configurable) group. The quantity of clones in the chamber can be set from a minimum of 0 to a maximum of 999. The release rate (specified in ms) controls the delay between clone spawns. The “Facing” parameter controls the direction that the clones face when they spawn. The default of 0 (auto) will cause the clones to face the direction of the first exit. The scaling parameter can be adjusted from (0.5, 1, or 2x). The “Protection” parameter indicates that when the game starts a layer of protection metal should be added below that start point. This is to prevent fatal sabotaging of the start trap. When the “Default On” parameter is set, it indicates that the trap should be enabled by default when the level start. Otherwise, the player hosting the game must specifically enable this start point.

When a clone spawns, the “Spawn Event” is fired and when there are no more clones left in the chamber, the “Empty Event” is fired.

Exit

The exit trap is the device that allows the group to score points. When a clone is below the exit trap, it will get beamed into the trap. Like the start trap, the exit trap also supports the configuration of the group, the scale, protection, and the default on parameters (see Start Trap for details). The “Min Clones” parameter specifies the minimum number of clones that need to be captured so that the game state will evaluate to “Pass”. This is normally used for singleplayer mode. The “Max Clones” parameter indicates the maximum number of clones that the exit can capture before it becomes disabled. The “Bogus” option sets the trap to become a false exit and instead any clones that walk under it will be crushed. The “Exclusive” parameter, when set, only allows clones of that group to be captured by the trap.

When the clone is captured the “Beamed Event” is fired. When a clone is crushed with the Bogus option, then the “Crushed Event” is fired.

Blaster

This machine allows the player to shoot chunks of ice or fire when a clone walks into it. You can rotate and fire the gun using the controls that appear below. When a chunk of ice touches a clone, the clone will freeze. Fire will burn the clone.

When a clone walks into the trap, the “Clone In Event” is fired. When the fire or ice is shot, then the “Blast Event” is fired.

Entanglement Trap

The entanglement trap captures two clones in its chambers then entangles them so that whatever morph commands are given to one, the same command is given to the other. Only one use of the morph is counted, even though two clones are affected.

When a clone is captured by the by the entanglement chamber, then the “Grab Clone Event” is fired. When the clones are entangled, then the “Entangle Event” is fired.

Environment Contraptions

These contraptions modify the way the level looks, behaves, and responds.

Actions

This is a bonus pickup item that can be placed anywhere on the level. When a clone touches the item, then additional morphs are given to the player. You can specify the quantity of the morphs and the morph type.

When a clone picks up the actions, then the “Grabbed Event” is fired.

Speed

When a clone touches a speed trap, it will modify the speed of certain clones based on the rules for that trap. It can be configured to modify just the clone that touched it, the entire group of the clone, all other groups, and all clones. This speed modifier only affects the clones that are currently on screen. The “Speed Time” parameter controls the length of the speed acceleration (in game updates), and the “Speed Factor” controls the speed multiplication (supported values of 2x, 4x, and 8x).

When a clone touches the speed trap, the “Grabbed Event” is fired.

Frozen

The frozen trap contains a clone inside of it and it can be thawed and freed when a clone walks by. The group any be set to any of the valid group ids as well as 255 to indicate the “free for all group”. In this case, the frozen clone will match the group color of the clone that thawed it out. The trap also has the option to mark the frozen clone as a “Dark Clone”.

When the trap starts thawing, then the “Thawing Event” is fired.

Slug

This is a little slug creature that crawls along the ground, sticking to the walls as it moves. It can be made as dangerous (a hazard) if the “Kill Clones” parameter is checked. Otherwise, it doesn’t really interact with the clones and is for graphical purposes only. The creature can be configured to move clockwise or counterclockwise by the “Clockwise” parameter.

When the hazardous slug kills a clone, then the “Melt Clone” event is fired.

Particle

The particle trap is primarily used for the “Capture the Particle” tournament style. Usually the group id is set to 255 to indicate any group can capture the particle, but the trap can also be configured so that only a specific group can pick it up.

When the particle is picked up by a clone, the the “Grabbed Event” is fired. When the particle is dropped, then the “Dropped Event” is fired.

Camera

You can use the camera to pan, zoom or rotate the view of the level. Typically these options are activated by a proximity trap. It can also be set to go to an initial camera position automatically when the level starts.

This trap does not support any events.

Background

This trap is one of the most common traps as it is used to decorate the level with non-interactive images and animation. This trap typically does not change the gameplay (completely non-interactive). The image or animation can be set to any PNG file (with alpha channel) or JPG image. The graphic’s z distance can be changed to give the illusion of depth. A positive distance is father away from the viewer, whereas a negative distance is closer to the viewer. A distance of 0 is where the landscape and other traps are rendered.

You can specify the tiling so that the image repeats in the x or y directions. If the source image is an animated sprite, then check off the “Animated” checkbox and specify the frame size of each frame of animation. If “Play on Load” is checked, then the animation will start playing when the level starts, otherwise it will only play when activated by some other trap.

This trap does not support any events.

Sky

This trap controls the very far background image of the level. It must be a JPG, and it should tile nicely it order to look good in the level. Use the “Set Image” button to specify the background tile. The background tile can be animated as well using the various parameters producing various effects:

Velocity X/Y – The movement in the x and y direction

Rotation – The speed of rotation

Rotation Axis X/Y – The point of rotation

This trap does not support any events.

Sound

It is possible to play a sound when a certain event occurs in the level. When the sound trap is activated, it will either play a sound effect, or change the background music. Use “Set Sound” button to set the sound file. You can also preview the sound by clicking on the “Play Sound” and “Stop Sound” buttons. By default, it will play the sound as an effect. Use the “Set Background” property to indicate that it should change the background music.

This trap does not support any events.

Chat

This trap, when activated, will send the pre-configured chat message to all players. It is a very good way to broadcast certain warning or informational messages.

This trap does not support any events.

Logic

Logic traps are designed to provide state information, control how and when certain events occur, as well as modify other traps or other features of the landscape.

Proximity

This trap provides a dual role: one is to detect the proximity of clones when they walk into the proximity area (Proximity Mode), and the other is to control other traps via the comprehensive list of actions (Event Dispatch Mode). When operating in “Proximity Mode”, be sure that “Can Trigger” is enabled, and the “Width” and “Height” properties are set. When a clone is detected in the bounds of the proximity area, then the trap is activated (all events fire).

When configured as an “Event Dispatch Mode”, the trap is set as the target of another trap’s internal event. As opposed to other traps than can only Activate other traps when some sort of internal event occurs, the proximity trap can perform the following to other traps: Enable, Disable, Activate, Deactivate, Show, and Hide. Therefore, if you want any trap to perform any of these additional actions, then you must pair it up with a proximity trap. When the proximity trap is Activated, it will fire its entire list of assigned actions.

To add an action, first selection the action you want to add, then click on the “Add Action” button. Then select the target trap that the action should be performed on. To remove an action, select the bound action, then click on remove. Advanced options allow the action to be delayed by a predefined number of game updates before events are fired as well as a delay between triggering of the trap. In addition, you can limit the number of times the proximity trap can be used, and the group that can use it. By default, the proximity trap is enabled, and by unchecking the “Enabled” checkbox, the proximity trap will start in the disabled state. This is useful when certain events must happen before the trap is enabled.

When the clone walks into the tutorial trap, the “Read Event” is fired.

WinLose

When a clone walks into the bounds of the WinLose trap, then a suggestion is made to the current game mode (tournament) that a loss or win has occurred. It is then up to the rules of the tournament to decide if an actual win or loss has occurred. To suggest a win state, ensure that the “Trigger Win” checkbox is enabled.

Path

This trap is used to force the player to follow a certain order of events. The trap can be activated by a clone being within the bounds of the trap, but can also be activated by other traps. If a path node is activated without the others activated first, then a loss condition is suggested to the game. If the final node in the path is activated, and all others were activated in the correct order, then a win condition is suggested to the game logic.

The ordinal number indicates the order at which the path must be activated. Be sure not to have two path nodes with the same ordinal. You can also make the path graphic not display by unchecking the “Visible on Level” parameter.

When a clone enters the bounds of the path trap, it will fire the “Grabbed Target Event”.

ModifyLand

This is a very power and flexible trap that can allow the simulated real-time transformation of landscape objects in the level. For example, it is possible to add or remove certain areas of the landscape or you can rotate and move landscape objects. The activation area can be controlled with the width and height parameters, and the trigger area is only used when the “Can Trigger” is set.

The trap can be activated by a clone being within the bounds of the trap, or by an external activation event. First, you must add the primitive using the “Add Terrain” method (F3) in the editor. Modify its properties to your liking. In many cases, you do not want the primitive to appear with the level loads, so be sure to uncheck the “Bash on Load” in the primitive properties. Once you have your primitive ready, then you can open the ModifyLand trap properties and click on the “Add Terrain” button, then click on the primitive you want to dynamically bash. The advanced properties: “Liquid Bash” and “Liquid Add” are only relevant when you are bashing the primitive as air. When bashing as air you have the option of converting the primitive into particles and controlling if the particles are added to the landscape.

The transformation parameters allow for x scaling, y scaling, rotation, and translation of the primitive from its current state in the level, to its final state. Leaving the increment values at 0 will disable that particular transformation. Larger increment values will cause the transformation to occur faster. By default, a modification will be performed every update, but it can be adjusted to perform every N updates with the “Mod. Speed” parameter. The “Overwrite” parameter, when checked, will not erase the existing primitive before bashing the transformed one. This is typically checked when scaling upwards, and unchecked when scaling downwards.

The the modification is complete, the “Modify Done Event” is fired.

Gravitize

This landscape modifier will pull any landscape pixels within its bounds downward. It is a special effect than can be used to simulate melting/wet land. Use with caution as it is computationally expensive and can cause the game to run very slowly! The install fall mode means that the particles will fall immediate (you will not see any animations). “Circle Mode” will cause the affected area to be a circle contained within the bounds, instead of the bounds itself!

ModifyPos

This allows the movement of other traps whenever the modifypos trap is activated. The movement is by default specified by a delta amount (in x and y), but can also be specified as absolute coordinates (uncheck “Delta” parameter).

ModifyFrame

The ModifyFrame trap is typically paired up with background traps that are animated (contain multiple frames). Click on the “Set Target” button then click on a background trap. There are different modes of operation for this trap: Goto frame will cause the target animation to goto the frame specified under the “Goto Frame” field. Next Frame/Previous Frame will simply advance the frame by 1, if at the end of the animation sequence, the frame will loop back to frame 0 (for next, and last frame from previous). The “Animate” option will cause the trap to set the animation to the start frame with the trap is triggered, then advance through the frames until the end frame is reached at which the animation then stops. The “FPS” parameter controls the frames per second rate. You may speed up or slow down the animations.

Annotation

Annotation is a way to display messages while references certain areas of the level. Type in the message you want the annotation to display. If the “Clickable” property is set, the annotation will close when you click on it. By default, the annotation is enabled, but you can disable it and enable it at runtime using a proximity trap. Click on the “Set Destination” button to specify where the arrow should be pointing to.

When the annotation is displayed, the “Appear Event” is fired. When the annotation closes, the “Close Event” is fired.

[back to top]

Group Settings

You can open the group settings screen by pressing F6 or clicking on the group settings button in the menu. Here you can configure all the morphs for each of the 8 groups. In most cases you want to synchronize the group morphs so be sure to keep the “Sync Groups” checked in. The first step is to select the group that you want to modify, then at the bottom of the window you will see a listing of all the morphs and their current settings. To enable/disable the morph, click on the upper left icon. When enabled, you can increase or decrease the number of morphs from a minimum of 0 to a maximum of 99. The checkbox at the upper right corner allows you to set the quantity to infinite, meaning that the player will never run out of those morphs.

Note that in multiplayer, these morphs can be overrided by the host in the pre-game configuration screen. In this case, the configuration in the level editor will be the default values. In singleplayer mode, the morph settings cannot be changed.

[back to top]

Clone

It is possible to place preconfigured clones in the level. To add a preconfigured clone, open the group settings screen and click on the “Add Clone” button. This is useful for some singleplayer level designs as it allows you fine control over where all the clones start.

  • Scale – small (0.5), medium(1), and large(2)
  • Group from 0 to 7
  • Step Size – controls how much the clone moves forward on each update
  • Face Left – controls the clones initial facing direction
  • Start Gravity – Choose one of the initial starting gravitational directions
  • Style – Either Normal, Light or Dark – these are the clone mutations
  • Capturable – indicates that this clone is the target clone for the Capture the Clone tournament style. This clone cannot be controlled by any group!

[back to top]

Conclusion

Congratulations!  You have now completed the entire clones level editor guide and you should now have all the tools and knowledge to create fantastic and exciting levels!  If you have any ideas, level editing tips, comments, then please log onto post them in the forums at http://forums.ClonesGame.com.  There is a section specifically for level editing.  Godspeed Clone Master!!!