Documentation - Editing - Basics
- Getting Started
- The Basics of Cube Manipulation
- Materials
- Lighting
- Remip & calclight
- Mapmodels
- Editor Panels
- More on map editing
Red Eclipse makes use of the Tesseract engine, which utilizes an octree node for its level geometry. This allows for a shallow learning curve where anyone can quickly start making their own maps / levels to share with others. The editor itself is also contained within the game as its own game mode, meaning that you can create an entire map without the need of additional tools/software like most other 3D games. You can also join an online server to edit maps with others in realtime multiplayer map editing.
Getting Started
To make your first map, you will want to enter the editing game mode. This can be done by selecting editing from the map selection menu, or alternatively you can type /edit <mapname> at the in-game console.
Once you have loaded the editing game mode. You can start a new map, by typing /newmap. This gives you an empty world to start from.
Due to the nature of real time editing, you can hop in and out of the edit camera by pressing F2. Meaning you are able to run around your map at any time, whilst also able to quickly toggle into edit mode when you want to make changes.
If you wish to save any changes you’ve made to your map, simply type /savemap <mapname>.
The Basics of Cube Manipulation
The level geometry in Red Eclipse is made up of cubes for the most part. They can be easily added or removed from the world with the scroll wheel, whilst using the edit camera.
On a new map, you only need to select an area on the floor, and start using your scroll wheel to see how this functions. You can click & drag to select an area and extrude multiple cube faces simultaneously.
Right clicking different sides of the selection grid allows you to change which cube face you will be extruding cubes from.
You can also change the size of the grid selection, by using G + scroll or by typing /gridpower <value> into the in-game console.
Here’s some of the basic methods you can use to manipulate cubes within the map;
| Default Key/Mouse bind | Description |
|---|---|
| Left Mouse | Select a cube |
| Right Mouse | Select the active cube face |
| Middle Mouse | Select the active corner of a cube |
| G + SCROLL | Adjust the size of the selection grid |
| R + SCROLL | Rotate the selected cubes |
| Q + SCROLL | Push and pull the selected edges of a cube |
| F + SCROLL | Push and pull the selected cube faces |
| Y + SCROLL | Change the texture slot number |
| C | Copy the selection |
| V | Paste the selection |
| X | Flip the cube selection |
| Z | Undo |
| O | Redo |
| + | Toggle outline |
| - | Toggle allfaces |
| B | Toggle fullbright |
Materials
Materials can be used to add visual effects and help with the design / flow of your map. These are similar to cube geometry, but cannot be manipulated in the same ways.
They appear as translucent volumes; their visibility while editing can be toggled with Ctrl+M (M in legacy binds) or /showmat [0|1].
You can open the Materials panel by pressing F7, apply the active material with M, or apply materials directly using the default keypad binds or console commands:
| Default Keybind | Command | Material Name | Description |
|---|---|---|---|
| NUMPAD 1 | /air |
Air (none) | Clears any existing material |
| NUMPAD 2 | /alpha |
Alpha | Makes geometry translucent (/valpha [front] [back], 0.0 invisible to 1.0 opaque) |
| NUMPAD 3 | /water |
Water | Creates water (water2–water4 for extra variants) |
| NUMPAD 4 | /lava |
Lava | Creates lava that burns players (lava2–lava4 for extra variants) |
| NUMPAD 5 | /clip |
Clip | Stops players from passing through |
| NUMPAD 6 | /noclip |
Noclip | Allows players and projectiles to pass through cubes |
| NUMPAD 7 | /aiclip |
AI Clip | Stops bots from passing through |
| NUMPAD 8 | /death |
Death | Kills players immediately when their feet enter it |
| NUMPAD 9 | /ladder |
Ladder | Allows players to climb vertical geometry |
| — | /glass |
Glass | Renders refractive glass surfaces (glass2–glass4 for extra variants) |
| — | /volfog |
Volumetric Fog | Creates volumetric fog (volfog2–volfog4 for extra variants) |
| — | /hurt |
Hurt | Damages players whose feet enter it using /hurtdamage (HP is out of 1000) and /hurtresidual |
| — | /nogi |
No GI | Excludes cubes from global illumination calculations |
Lighting
Red Eclipse supports realtime dynamic lighting. Meaning you can add a light entity to the map and instantly see your changes by moving the light entity around.
To add a new light entity, press F6 to open the Entities panel (Ctrl+E for the quick Entity placer, or Ctrl+N to add at the cursor), and select light. Alternatively, type /newent light into the console. The entity appears at your current grid selection.
Most importantly, you will want to set the colour and radius of the light entity. A list of attribute values appears above the entity itself. You can adjust parameters in the Entities panel (F6), directly with . (/entset), or by selecting the entity (left-click) and scrolling the mouse wheel while holding the corresponding number key:
| Key/Mouse bind | Parameter |
|---|---|
| 1 + SCROLL | Radius |
| 2 + SCROLL | Red |
| 3 + SCROLL | Green |
| 4 + SCROLL | Blue |
You can also add global directional lighting by setting the sunlight variable.
This can be adjusted from the Environment Settings panel by pressing F5.
Alternatively, you can type /sunlight 140 150 160 into the console, to instantly add light to the world. This command takes the values R G B (0-255).
Remip & calclight
When editing a map, you will often need to remip and re-calculate lighting. A calclight will optimize the number of polygons used by cube geometry, and will also re-calculate the normal maps of textures.
You can do this by simply running /calclight in the console (this command also performs a remip).
Mapmodels
A mapmodel is a polygon mesh that can be placed anywhere without restrictions; they can even intersect cube geometry. These are useful for adding details to a map where it may be hard or unconvincing to create a certain shape with cube geometry. Press F6 to open the Entities panel (or Ctrl+E for the Entity placer), select mapmodel, and browse the model list to place one.
You can also use the console to add mapmodels to your map by typing /newent mapmodel.
Similar to the light entity, you can hold 1 + SCROLL to cycle through the mapmodel index, or choose models visually in the Entities panel.
Editor Panels
Red Eclipse features several editor panels for adjusting map settings while in edit mode. Ensure you have pressed F2 to enter edit mode to access the following:
Texture Browser (F4)
Pressing F4 opens the texture browser, which lets you apply a texture to your current grid selection. Scroll through the list and click a texture to apply it. You can press - to toggle allfaces, which controls whether textures apply only to the selected face or to all faces of the selected cubes.
Environment Settings (F5)
Pressing F5 opens Environment Settings, where you can configure world lighting, sunlight, fog, skybox layers, cloud layers, and map sound settings.
Entities Panel & Placer (F6 / Ctrl+E)
Pressing F6 opens the Entities panel to create, browse, and edit entities — including lights, mapmodels, sounds, particles, triggers, and game objects. Pressing Ctrl+E opens the quick Entity placer.
Materials Panel (F7)
Pressing F7 opens the Materials panel to choose and apply material volumes, and Ctrl+M toggles material volume overlays.
Search Actions (F3) & Toolbar (Tab)
Pressing F3 in edit mode opens the action search dialog. Pressing Tab switches to cursor mode so you can click icons in the editor toolbar directly, and /help <command> prints command or variable usage in the console. Moving the cursor to the top edge of the screen, or pressing Alt on its own, shows the menu bar, which lists every editor action by name with its key, and F1 opens the documentation of the Tool panel under the cursor. See Interface.
More on map editing
Blendmaps - Overlapping, and blend textures together. Waypoints - Letting bots navigate around the map. Entities - Managing particles, lighting, game specific objects, and more. General FX - General effects when map making. Particle FX - Using particle effects on map Other FX - More effects to using on maps. Level FX - How to increasing performance for users on lower settings. Models - How to import 3D models for use in redeclipse Model Editor - Lining up a model’s attachments and tags while you watch