Export translations

Settings

Group

Language

Format

Export for off-line translation

Export in native format

Export in CSV format

{{MigrateTranslation}}
<languages />

<div lang="en" dir="ltr" class="mw-content-ltr">
'''Mapping''' is the process of building and creating [https://ddnet.org/releases/ maps], the basis of DDNet's (and other modes') gameplay. Maps can be created by anyone, given they have the will and creativity to do so.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Mapping also allows users to add their own design, sound, and aesthetic to maps, and can also be used for entities backgrounds, main menu themes, and more.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
DDNet allows players to submit their own race maps on the [https://ddnet.org/discord DDNet Discord], where respective rules and guidelines can also be found.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Players can access the map editor interface by clicking on the editor in the main menu.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
From any in-game screen, pressing {{key press|ctrl|shift|E}} will also take you directly to the map editor screen.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Overview of the Editor Interface==
{{Todo|Update the interface section with visuals and instructions for the new editor visuals}}
</div>

[[File:Editor 3.png|800x800px|<div lang="en" dir="ltr" class="mw-content-ltr">
Map editor within DDNet
</div>]]

<div lang="en" dir="ltr" class="mw-content-ltr">
Each labeled button in the editor interface has the following functionalities:
</div>

[[File:Editor file.png|right|thumb|<span lang="en" dir="ltr" class="mw-content-ltr">File drop-down menu content</span>]]

<div lang="en" dir="ltr" class="mw-content-ltr">
Opens a drop-down menu to create, load and save map files.
</div>

*<span lang="en" dir="ltr" class="mw-content-ltr">New {{key press|ctrl|N}}: new map file.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Load {{key press|ctrl|I}}: loads a map file.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Load Current Map {{key press|ctrl|alt|I}}: loads the current map, given the player is currently in-game or viewing a demo.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Append {{key press|ctrl|A}}: adds all the design elements from a selected map file to the current map.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Save {{key press|ctrl|S}}: saves the current map under its current name.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Save As {{key press|ctrl|shift|S}}: saves the current map under another file name, while continuing to edit the map under that file name.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Save Copy {{key press|ctrl|shift|alt|S}}: saves the current map under another file name, but continues to edit the map under the original file name. When the map name used when saving a copy duplicates an existing file, the map will continue to be edited with that file name after completing the save.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Exit {{key press|ctrl|shift|E}}: Exit the editor interface.</span>
<div style="clear:both;"></div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Displays the name of the map file currently being edited as well as its file save path.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===[3] Editor state info===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Displays the attributes of the current map editor.
</div>

*<span lang="en" dir="ltr" class="mw-content-ltr">X, Y: indicates the current tile position of the map editor where the mouse cursor is located, with (0, 0) being the top left corner.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Z: indicates the scale value of the current map, which defaults to 200 on first load.</span> 
*<span lang="en" dir="ltr" class="mw-content-ltr">A: indicates the playback speed of the current map animation, default is 1.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">G: indicates the size of the current map grid lines, default is 1.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">10:18: local time.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
Exit the editor interface. {{key press|ctrl|shift|E}}
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===[5] Display functions===
Changes how the map is displayed.
</div>

*<span lang="en" dir="ltr" class="mw-content-ltr">HD (Show High Details) {{key press|ctrl|H}}: preview the appearance of the current map in high quality mode.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Anim (Show animation) {{key press|ctrl|M}}: previews the animation effect set by the current map.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Proof (Show field of view boundary) {{key press|ctrl|P}}: previews the maximum field of view of the player in the default zoom level.</span>    
**<span lang="en" dir="ltr" class="mw-content-ltr">blue circle: indicates the player's actual position</span>
**<span lang="en" dir="ltr" class="mw-content-ltr">the red box line and green box line indicate the maximum range that can be observed at different resolutions</span>
**<span lang="en" dir="ltr" class="mw-content-ltr">the white box line indicates the maximum range that can be observed with dynamic view turned on.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Zoom: preview what the player sees in the actual game.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Grid {{key press|ctrl|G}}: turns on grid lines.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Info {{key press|ctrl|I}}: previews the details of the entity or texture, including but not limited to the ID of the entity or texture, the texture animation track, and the texture deformation.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">(Unused) {{key press|ctrl|U}}: allows placement of unused mappings in the map, a feature not commonly used in modern maps anymore.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Color: previews the color set by the current brush, after closing the brush will show the original color match, but does not affect the color set by the placed mapping.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Entities: select the category of entity layer that needs to be used for the current map. Depending on the game mode applied to the map, the entity layer selected in the editor should also be different.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
===[6] Zoom===
Field of view adjustment functionality, descriptions in order from left to right.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Expanding or scaling the field of view by clicking buttons or pressing shortcut keys has no maximum and minimum scale value, and the scale value can even reach negative values. When the scale value is negative, the map as a whole is upside down.
</div>

*<span lang="en" dir="ltr" class="mw-content-ltr">ZO (Zoom out) {{key press|numpad-}}: expands the field of view of the operation area by 50 points of scale value each time.</span>    
**<span lang="en" dir="ltr" class="mw-content-ltr">Scrolling the mouse wheel down also expands the field of view by 20 scale points per scroll, expanding the field of view in this way up to a maximum of 2000 scale points.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">1:1 {{key press|numpad*}}: restores the field of view to the default scale value.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">ZI (zoom in) {{key press|numpad+}}: reduces the field of view of the operation area by 50 points of scale value at a time.</span>    
**<span lang="en" dir="ltr" class="mw-content-ltr">Roll the mouse wheel upward to also reduce the field of view by 20 scale points per scroll frame, and reduce the field of view in this way up to 10 scale points.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
===[7] Brush functionality===
Descriptions from left to right:
</div>

*<span lang="en" dir="ltr" class="mw-content-ltr">X/X (Horizontal flip) {{key press|N}}: flips the contents of the brush horizontally.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Y/Y (Vertical flip) {{key press|M}}: flips the contents of the brush vertically.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">90° (Rotation angle): the angle at which the content in the brush is turned each time it is rotated, which can be modified by holding down this button and sliding the mouse left and right, holding down {{key press|shift}} during the modification process for more precise modification.</span>    
**<span lang="en" dir="ltr" class="mw-content-ltr">You can only choose from 90°, 180° and 270° angles.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">CCW (Counterclockwise rotation) {{key press|R}}: rotates the contents of the brush counterclockwise at an angle.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">CW (Clockwise rotation) {{key press|T}}: rotates the content in the brush clockwise at a certain angle.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
===[8] Layers/Images/Sounds management===
In this area you can manage different groups of layers including the physics layer.
By clicking on the top button "Layers", you can add images and sound resources to the map.
Layer management area, here is responsible for managing the map's layer groups and layers, as well as the invocation of the mapping material, picture material, and sound material.
Pressing {{key press|→}} will also switch to the image management interface, or pressing {{key press|←}} will switch to the sound management interface
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
====Layers====
</div>

*<span lang="en" dir="ltr" class="mw-content-ltr">Layers (left click) {{key press|→}}: Switch to Image management</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Layers (right click) {{key press|←}}: Switch to Sound management</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Click "Add group" at the bottom to add a new group.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Right-click a group to set the parameters of that group</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Right-click a layer to set the parameters of that layer</span>

====Images====

*<span lang="en" dir="ltr" class="mw-content-ltr">Images (left click) {{key press|→}}: Switch to Sound management</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Images (right click) {{key press|←}}: Switch to Layer management</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Click the Add button to add image clips from the default clip folder to the map file.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Embedded area means the clips of this series have been embedded in the map file, when downloading the map, this kind of file will be included in the map file volume.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">External area means that the material of this series is located outside the map, it is the default material in the game, when downloading the map, this kind of file will not be counted in the map file volume. When the map needs to call the image material of this area, it will directly call the file with the same name from the player's local default material library.</span>    
**<span lang="en" dir="ltr" class="mw-content-ltr">Regardless of the location of the clip, when the clip file is white or red (selected), it means the clip is being used by the map; when the clip file is blue or purple (selected), it means the clip is not yet used by the map.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Left-click on a file that has been added to preview the image in the right workspace, and right-click on the file to perform the following actions.</span>    
**<span lang="en" dir="ltr" class="mw-content-ltr">Readd: Overwrite the clip by calling a file with the same name directly from the default clip library.</span>
**<span lang="en" dir="ltr" class="mw-content-ltr">Replace: select a clip file to overwrite the clip.</span>
**<span lang="en" dir="ltr" class="mw-content-ltr">Remove: removes the clip file.</span>
**<span lang="en" dir="ltr" class="mw-content-ltr">When right-clicking on a file in the External area, an additional Embed option will appear to move the file into the Embedded area.</span>

===Sounds===

*<span lang="en" dir="ltr" class="mw-content-ltr">Sounds (left click) {{key press|→}}: Switch to Layer management</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Sounds (right click) {{key press|←}}: Switch to Image management</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Click the Add button to add sound clips from the default clip folder to the map file. Currently DDNet game editor only accepts opus format audio files.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Right-click on a file to perform the following actions.</span>    
**<span lang="en" dir="ltr" class="mw-content-ltr">Readd: Overwrite a clip by calling a file with the same name directly from the default clip library.</span>
**<span lang="en" dir="ltr" class="mw-content-ltr">Replace: select a clip file to overwrite the clip.</span>
**<span lang="en" dir="ltr" class="mw-content-ltr">Remove: Remove the clip file.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
===[9] Context dependent actions===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Additional buttons that will change depending on the selected layer.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
====On all layers====
</div>

When any layer is selected, the following buttons appear:

*<span lang="en" dir="ltr" class="mw-content-ltr">Refocus {{key press|home}}: immediately focuses the view to the upper left corner of the map.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Goto XY: immediately focuses the view to a specific coordinate of the map. Clicking this button sets the coordinate in its drop-down menu, and then clicking the Go button focuses the view to that coordinate.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">Destructive mode {{key press|ctrl|D}}: When Destructive mode is enabled, the area the brush passes over will be completely covered and the texture of this area will be replaced; when Destructive mode is disabled, the area the brush passes over will only be filled with the location that is not filled with the texture.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">When Game or Tile layer is selected: Add Border: Adds a two-tile wide border to the current layer, using the texture of the selected layer's No. 2 map.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">When Switch layer is selected: '''Switch''' {{Key press|ctrl|A}}: Set the number of the next placed switch layer entity. In the drop-down menu: Number is used to set the number, Delay is used to set the number of additional information, and F (shortcut: {{Key press|ctrl|F}}) is used to automatically set the unused number.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">When Speedup layer is selected: '''Speedup''' {{Key press|ctrl|A}}: Set the parameters for the next placement of the speedup entity. In the drop-down menu, Force is used to set how much speed the belt can provide, Max Speed is used to set the maximum speed you can have at the belt, and Angle is used to set the direction of the belt.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">When the Tele layer is selected: '''Tele''' {{Key press|ctrl|A}}: Sets the number of the next entity to be placed in the transmission area. The drop-down menu: Number is used to set the number, and F (shortcut: {{Key press|ctrl|F}}) is used to automatically set the unused number.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">When Tune layer is selected: '''Tune''' {{Key press|ctrl|A}}: Set the number of the next placed adjustment zone entity. In its drop-down menu, Zone is used to set the number.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">When the Quads layer is selected: '''Add Quad''' {{Key press|ctrl|Q}}: Adds a picture set by the current layer to the workspace. If no picture is set for that layer, a plain white square of 2*2 grid size is added by default.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">When the Sounds layer is selected. '''Add Sound''' {{Key press|ctrl|Q}}: Adds a sound set by the current layer to the workspace.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
===[10] Mapping area===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Workspace, where all the components needed for the map are placed.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
{{todo|Explain in more detail}}
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
When the mouse hovers over a button, the hint area will appear with the function of the button and a keyboard shortcut for the button function.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===[12] Server setting===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You can change [[Settings_and_Commands#Map_Settings|Map settings]] to change server behavior. For example setting a map to be a solo map.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
{{todo|Explain in more detail}}
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===[13] Envelopes===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Envelope animation: this is responsible for setting the animation effect in the map.
</div>

{{todo|
Explain in detail what is marked "to be explained in detail" above.
Full explanation of the features in the editor.
Discuss the similarities and differences between modern maps and traditional and classical maps, or discuss their backstories.
Write a short tutorial on mapping.}}

<div lang="en" dir="ltr" class="mw-content-ltr">
==External Resources==
</div>

*<span lang="en" dir="ltr" class="mw-content-ltr">[https://forum.ddnet.org/viewtopic.php?f=35&t=2419 Mapping ABC] by Index</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">[https://forum.ddnet.org/viewtopic.php?f=16&t=2420 Link list]  including lots of mapping resources by Index</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">[https://www.youtube.com/watch?v=t0ljtNtiijU DDRaceNetwork - How to Use the Map Editor] by Nick Joy</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">[https://www.youtube.com/watch?v=UXZnF17TgEQ Teeworlds - How to map a DDRACE map. - Part 1] by Aoe</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">[https://www.youtube.com/watch?v=tKuv4nn3nIo Teeworlds - How to map a DDRACE map. - Part 2] by Aoe</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">[https://www.teeworlds.com/forum/viewtopic.php?id=11094 Maps Envelope Tutorial] by 2gethR</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">[https://forum.ddnet.org/viewtopic.php?t=2428 Automapper Tutorial] by timakro</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">[https://forum.ddnet.org/viewtopic.php?f=9&t=722 Mapper rules] for DDNet map testing process by jao</span>