English
Personal tools
Namespaces

Variants
Actions

Map Editor

From Tanki Online Wiki
(Difference between revisions)
Jump to: navigation, search
(Added download link to Alternativa Editor - report #1235)
 
(12 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 +
__NOEDITSECTION__ {{RandomText}}
 +
{{see also|Other}}<br />
 +
 
==Introduction==
 
==Introduction==
AlternativaEditor allows you to create levels (maps) for Tanki Online using special 3D-elements called props. Props are complete 3D-objects or its component parts, that you can use to create game locations.
+
AlternativaEditor allows you to create levels (maps) for Tanki Online using special 3D-elements called props. Props are complete 3D-objects or its component parts, that you can use to create game locations.<br><br>
  
<gallery>
+
[[File:Pic11.png|200px|link=]]
File:Pic11.png
+
[[File:Pic12.png|200px|link=]]
File:Pic12.png
+
[[File:Pic13.png|200px|link=]]<br><br>
File:Pic13.png
+
</gallery>
+
  
 
Props are loaded into the editor in libraries. Props can be rotated around a vertical axis. The angle of rotation can be user-defined (any angle) or a multiple of 90 degrees.
 
Props are loaded into the editor in libraries. Props can be rotated around a vertical axis. The angle of rotation can be user-defined (any angle) or a multiple of 90 degrees.
  
 
==Installation==
 
==Installation==
Editor is made as an Adobe AIR application. So you need to download and install [http://get.adobe.com/ru/air/ Adobe AIR].
+
You can download the program [[Media:AlternativaEditor.zip|by clicking here]].
 +
 
 +
Editor is made as an Adobe AIR application. So you need to download and install [https://get.adobe.com/air/ Adobe AIR].
  
Then you need to download and install a file called AlternativaEditor.air. After the installation, you will see a shortcut on your desktop.
+
Then you need to download, unpack a zip archive and install a file called AlternativaEditor.air. After the installation, you will see a shortcut on your desktop.
  
 
==Editor review==
 
==Editor review==
Line 29: Line 32:
 
** preview;
 
** preview;
 
** props divided into categories and groups;
 
** props divided into categories and groups;
* Properties of selected prop.
+
* Properties of selected prop.<br><br>
  
<gallery widths=500px heights=379px>
+
[[File:Pic10.png|500px|link=]]<br><br>
File:Pic10.png
+
</gallery>
+
  
To begin you need to load prop library. You can do that by going to Library → Clean and Load and specifying the root folder of the library.
+
To begin you need to load prop library. You can do that by going to Library → Clear and Load and specifying the root folder of the library.<br><br>
  
<gallery widths=273px heights=108px>
+
[[File:Pic6.png|273px|link=]]<br><br>
File:Pic6.png
+
</gallery>
+
  
Once the library is loaded, on the right in the pop-down menu you will see categories and groups of props.  
+
Once the library is loaded, on the right in the pop-down menu you will see categories and groups of props.<br><br>
  
<gallery widths=305px heights=504px>
+
[[File:Pic4.png|305px|link=]]<br><br>
File:Pic4.png
+
</gallery>
+
  
 
===Approximate structure of the library===
 
===Approximate structure of the library===
Prop library is presented as a structure of folders containing files of models (3DS) and textures (JPG) as well as library.xml files.  
+
The prop library is presented as a structure of folders containing files of models (3DS) and textures (JPG) as well as library.xml files.  
  
 
There is the following hierarchy in the library:
 
There is the following hierarchy in the library:
Line 59: Line 56:
 
'''Geometric props'''
 
'''Geometric props'''
  
Geometric props describe fixed geometry of a level. They are 3ds-objects that have rectangular cross section in the base. The sides of it should be multiples of grid horizontal spacing (5 meters). If props contain terrain slopes the height difference between the borders should be equal to grid vertical spacing. Each geometric prop can contain a child object defining the geometry for collisions with tanks. This kind of object should be a box, a center of which is located at the origin of the local coordinate system. The axis of the box should be directed along the axis of its local coordinate system.  
+
Geometric props describe fixed geometry of a level. They are 3DS-objects that have rectangular cross section in the base. The sides of it should be multiples of grid horizontal spacing (5 meters). If props contain terrain slopes the height difference between the borders should be equal to grid vertical spacing. Each geometric prop can contain a child object defining the geometry for collisions with tanks. This kind of object should be a box, a center of which is located at the origin of the local coordinate system. The axis of the box should be directed along the axis of its local coordinate system.  
One prop can have several textures which you can choose in the[[Map_Editor#Interface|settings menu]].
+
One prop can have several textures which you can choose in the [[Map_Editor#Interface|settings menu]].<br><br>
  
<gallery widths=288px heights=377px>
+
[[File:Pic9.png|288px|link=]]<br><br>
File:Pic9.png
+
</gallery>
+
  
'''Спрайты'''
+
'''Sprites'''
  
Для экономии памяти некоторые пропы представлены в виде спрайтов — плоских объектов, всегда развёрнутых к камере. Например, деревья и кустарники.
+
In order to save memory some props are represented as sprites – flat objects that are always deployed to the camera. For example trees and bushes.  
  
При построении карты спрайты следует добавлять в последнюю очередь. Для начала нужно протестировать основную геометрию на отсутствие [[Редактор_карт#Нюансы_и_проблемные_места|проблемных мест и учесть все нюансы]].
+
When constructing a map, sprites should be added last. First you need to test the main geometry to make sure  [[Map_Editor#Nuances_and_difficulties|there are no problem areas and take into account all the nuances]].<br><br>
  
 +
[[File:Pic15.png|251px|link=]]<br><br>
  
<gallery widths=251px heights=232px>
+
By default, all elements are snapped to the grid. This may be an obstacle in case of sprites and functional elements. You can turn it off by clicking on magnet icon on the toolbar ([[File:Pic16.png|link=]]). Sprites may disappear on subsequent boots.  This is due to the problems with sorting in the editor. It may happen that they will be displayed under the surface of which they are placed.
File:Pic15.png
+
</gallery>
+
  
 +
This problem may be solved as follows:
 +
# Choose [[File:Pic17.png|link=]] in the upper bar;
 +
# Select all sprites;
 +
# Drag them while holding {{keys|'''V'''}} (vertical movement) to find the ideal position.
  
По-умолчанию, все элементы снапятся (примагничиваются) по сетке. Для спрайтов и функциональных элементов эта опция может только мешать. Отключить её можно при помощи кнопки с магнитом в панели инструментов ([[File:Pic16.png]]). Спрайты при последующих загрузках могут «исчезнуть». Это связано с проблемами при сортировке в редакторе. Может получиться так, что они будут отображаться «под» поверхностью на которой стоят. Спрайт окажется на одном уровне с поверхностью, на которую его поставят.  
+
Just to make sure it doesn't happen you can add several sprites for each height level. Then you can adjust the height as it was stated before and simply copy sprites. The correct height will be saved. When doing this it’s necessary to switch off the snap function.<br><br>
  
Решить проблему можно следующим образом:
+
[[File:800px-Pic18.png|500px|link=]]<br><br>
# выбрать в верхнем баре [[File:Pic17.png]];
+
# выделить все спрайты;
+
# зажав V (вертикальное перемещение) потаскать их вверх-вниз, найдя нужное положение.
+
  
Для того, чтобы подстраховаться можно сделать так: добавить для каждой высоты уровня несколько спрайтов. Затем вышеописанным способом настроить высоты. Затем можно просто их копировать. При этом нужная высота сохранится. При этом нужно отключать снап.
+
'''Spawn points and bonus zones'''
  
<gallery widths=500px heights=337px>
+
Spawn points define where tanks appear and which way they are facing. There are three types of spawn points: yellow which are used for DM battles as well as blue and red which are used to specify the places where tanks of two opposing team appear in team battles (TDM, CTF, CP modes). Spawn points must be placed on the ground level.<br><br>
File:800px-Pic18.png
+
</gallery>
+
  
'''Spawn-точки и бонусные регионы'''
+
[[File:Pic4.png|305px|link=]]<br><br>
  
Spawn-точки указывают место появления и ориентацию танка. Могут быть трёх видов: жёлтые, использующиеся для определения мест появления в режиме DM, а также синие и красные, использующиеся для указания мест появления танков разных команд в командной игре (режимы TDM, CTF, CP). Должны стоять на уровне земли.
+
Bonus zones indicate areas where bonuses may appear and define the types of possible bonuses. The zones should be rectangular with sides which are multiples of grid horizontal spacing. The type of dropped items is defined in the [[Map_Editor#Interface|properties window]]. Bonus zones should be located above ground, higher by 1-2 spaces. It is also recommended to create 25% more double speed drop zones than double armor and double damage ones.
  
<gallery widths=305px heights=504px>
+
==Method of work==
File:Pic4.png
+
===Adding a prop to a map===
</gallery>
+
# Choose the prop you need to add. You will see a green translucent cursor showing where the prop will be placed;
 +
# Move the cursor to the required place using mouse or arrow keys on your keyboard;
 +
# You can raise or lower the prop to a desired level using {{keys|'''W'''}} and {{keys|'''S'''}} keys;
 +
# The prop can be rotated around its axis using {{keys|'''X'''}} and {{keys|'''Z'''}} keys;
 +
# Press {{keys|'''spacebar'''}} to place a prop.
  
Бонусные регионы указывают области, в пределах которых могут появиться бонусы, а также возможный тип этих бонусов. Имеют прямоугольное сечение в плане со сторонами, кратными горизонтальному шагу сетки. Тип выпадающих элементов из бонусных регионов задается в [[Редактор_карт#Интерфейс|окне свойств]]. Бонусные регионы должны быть строго над поверностью земли. Выше на 1-2 шага. Регионов с кристаллами должно быть 3-4 на уровень. Рекомендуется делать количество зон выпадения бонуса ускорения больше на 25 процентов, чем увеличения брони и урона.
+
Once you've added a prop, the cursor will become red. Two props can't overlap each other (occupy the same section of the grid).
  
==Порядок работы==
+
You can choose next element for adding or edit the current one.
===Добавление пропа на карту===
+
# выбрать нужный проп для вставки. На поле появляется зеленый полупрозрачный курсор, показывающий куда будет вставлен проп;
+
# переместить курсор в нужное место при помощи мышки или стрелок клавиатуры;
+
# поднять/опустить на нужный уровень при помощи кнопок W и S;
+
# повернуть вокруг своей оси можно кнопками X и Z;
+
# для установки пропа на место нужно нажать пробел.
+
  
После добавления пропа, курсор станет красным. Два пропа не могут пересекаться (занимать одну и ту же клетку).
+
===Editing a prop on a map===
 +
To do that you need to click on the prop. After doing that it will be highlighted in red. Now using mouse and keyboard you can move and rotate it or delete it by pressing {{keys|'''Delete'''}} or {{keys|'''C'''}}. To copy a prop drag it while holding {{keys|'''Shift'''}}. Press {{keys|'''K'''}} to move a prop half a segment.
  
Можно выбрать следующий элемент для вставки, либо отредактировать текущий.
+
Also you can choose a texture for each prop. To do that you need to select a prop that you've added to the map, open the settings menu and choose a texture.<br><br>
  
===Редактирование пропа на карте===
+
[[File:Pic14.png|243px|link=]]<br><br>
Для этого нужно кликнуть на нужный проп. При этом он окрасится в красный цвет. Теперь с помощью мыши или клавиатуры его можно передвигать и вращать, либо его можно удалить нажав Delete или C. Для копирования пропа нужно использовать мышь с зажатой кнопкой Shift (Drag+shift). Для того, чтобы сдвинуть проп на половину клетки, нужно нажать клавишу K.
+
  
Также для пропа можно подбирать разные текстуры. Для этого нужно выбрать добавленный на карту проп, открыть окно настроек и выбрать нужную текстуру.
+
Tile props that are used to construct the level's terrain often have different textures.
  
<gallery widths=243px heights=427px>
+
If we add several identical props and apply a texture to one of them, you will be able to apply the same texture to other selected props by pressing spacebar. The last selected texture will apply to it.
File:Pic14.png
+
</gallery>
+
  
Разные текстуры чаще всего бывают у [http://ru.wikipedia.org/wiki/Тайловая_графика тайловых] пропов, из которых строится поверхность уровня.  
+
Now a little more about the structure of these textures. All of them are made seamless. So they can be joined together without seams in any direction. There are 1x1 tiles (5x5 meters) as well as 2x2 (10x10 meters), 2x1, 3x1, 3x2 and 3x3 ones.  
  
Если мы добавляем несколько одинаковых пропов и применяем к одному из них ту или иную текстуру, то при выборе другого пропа текстуру можно назначать при помощи кнопки пробел. Последняя выделенная текстура применится и к нему.  
+
===Navigation===
 +
To move the camera you can use the middle button on your mouse. To rotate the camera use {{keys|'''Alt'''}} '''+''' middle button. Use the scroll wheel to zoom in and out. When you choose a particular prop the wheel is more sensitive while the rotation is done around the highlighted object. To get back to the insert cursor without selecting a prop use {{keys|'''Ctrl'''}} '''+''' click combination. You can select several objects in a frame, make sure you hold {{keys|'''Ctrl'''}} not to select a prop under the cursor and not to drag it. You can add an item to selected ones using {{keys|'''Shift'''}} '''+''' click, or remove it from selected by using {{keys|'''Alt'''}} '''+''' {{keys|'''Shift'''}} '''+''' click.
  
Немного об устройстве этих текстур. Все они сделаны бесшовными, то есть стыкуются друг с другом без швов в любом направлении. Можно без проблем вращать проп, чтобы нужным боком повернуть, например, стык двух разных типов поверхности. Есть 1х1 тайлы (5х5 метров), есть 2х2 (10х10 метров), 2х1, 3х1, 3х2, 3х3.
+
You can't put two elements on one place. If it happened accidentally while dragging you will see an error window with a suggestion to undo the last action. Also you can check whether any elements are overlapped by pressing {{keys|'''Q'''}}. The conflicting elements will be highlighted in red. You can  undo the last action and go a step forward using {{keys|'''CTRL'''}} '''+''' {{keys|'''Z'''}} and {{keys|'''Ctrl'''}} '''+''' {{keys|'''Y'''}}.
  
===Навигация в пространстве===
+
===Exporting / importing a map file===
Для перемещения камеры в пространстве можно пользоваться средней кнопкой мыши. Поворот камеры: Alt+средняя кнопка. Для приближения и отдаления камеры используется колесо мыши. Когда выделен конкретный проп, колесо работает резче, а вращение выполняется вокруг выделения. Для того, чтобы вернуть курсор вставки, не выделяя пропа, нужно воспользоваться комбинацией клавиш Ctrl+click. Выделять можно рамкой, лучше при этом зажать Ctrl, чтобы не выделить проп под курсором и не потащить его. Добавить к выделению Shift+click, убрать из выделения Alt+Shift+click.
+
You can convert a map into XML at any moment. You can do it in the main menu File→Export Tanks map 1.x or by using {{keys|'''Ctrl'''}} '''+''' {{keys|'''T'''}}. When exporting a map you need to specify its name and add .xml format.  
  
Два элемента на одно место ставить нельзя. Если перетаскивании это случайно произошло, то будет показано окно с ошибкой и предложением отменить последнее действие. Также проверить на пересечения элементов можно при помощи клавиши Q. При этом конфликтующие элементы будут подсвечены красным. Отменить последнее действие и перейти на шаг вперёд в истории можно при помощи клавиш Ctrl+Z и Ctrl+Y.
+
In order to import a map into the editor use File→Import from tanks or {{keys|'''Ctrl'''}} '''+''' {{keys|'''T'''}}.
  
===Экспорт/импорт файла карты===
+
===Testing a map in TanksTestingTool===
Карты в любой момент работы можно экспортировать в формат XML. Это делается при помощи главного меню File→Export Tanks map 1.x, либо сочетания клавиш Ctrl+T. При экспорте нужно указывать имя карты и обязательно добавлять расширение .xml .
+
Before testing your map make sure there is at least one spawn point (a place where tank appears) for DM mode.  
  
Для импорта карты в редактор нужно воспользоваться пунктами главного меню File→Import from tanks, либо сочетания клавиш Ctrl+T.
+
In order to test the results of your work you can open your map in TanksTestingTool. To do that you need to:
 +
# Convert a map to XML;
 +
# Call it map.xml;
 +
# Move the file you got to Library folder with TanksTestingTool.swf file;
 +
# Launch TanksTestingTool.swf
  
===Тестирование карты в просмотровике TanksTestingTool===
+
If everything has been done correctly, the map will be displayed.
Для того, чтобы протестировать результаты работы можно загрузить карту в просмотровик Tanks Testing Tool. Для этого карту нужно:
+
# экпортировать карту в формат XML;
+
# назвать map.xml;
+
# положить полученный файл в папку с Library и файлом TanksTestingTool.swf.
+
# запускаем TanksTestingTool.swf
+
  
Если все сделано правильно, полученная карта отобразится.
+
'''Tank Testing Tool controls'''
 
+
'''Управление в Tank Testing Tool'''
+
  
 
{|class="wikitable"
 
{|class="wikitable"
 
  |-
 
  |-
  |Перемещение по уровню в режиме полёта.  
+
  |Move around the level in flight mode.  
  |WASD, Q,E, Mouse Drag
+
  |{{keys|'''WASD'''}}, {{keys|'''Q'''}}, {{keys|'''E'''}}, Mouse Drag
 
  |-
 
  |-
  |Ускорение
+
  |Speed-up
  |Shift
+
  |{{keys|'''Shift'''}}
 
  |-
 
  |-
  |Переключение режимов «Свободный полёт»/«Вид из танка»
+
  |Switch between flight mode and tank mode
  |F
+
  |{{keys|'''F'''}}
 
  |-
 
  |-
  |Добавить/удалить танки
+
  |Add/delete tanks
  |Insert/Delete
+
  |{{keys|'''Insert'''}} '''/''' {{keys|'''Delete'''}}
 
  |-
 
  |-
  |Переключение между танками
+
  |Switch between tanks
  |N, Shift+N
+
  |{{keys|'''N'''}}, {{keys|'''Shift'''}} '''+''' {{keys|'''N'''}}
 
  |-
 
  |-
  |valign="top"|Переключиться между разными Spawn-точками
+
  |valign="top"|Switch between different spawn points
  |T - тип точки
+
  |{{keys|'''T'''}} - type of point
  
Y - следующая точка
+
{{keys|'''Y'''}} - Next point
 
  |-
 
  |-
  |Выбор пушки
+
  |Select turret
  |Numpad 7, Numpad 9
+
  |{{keys|'''Numpad 7'''}}, {{keys|'''Numpad 9'''}}
 
  |-
 
  |-
  |Выбор корпуса
+
  |Select hull
  |Numpad 4, Numpad 6
+
  |{{keys|'''Numpad 4'''}}, {{keys|'''Numpad 6'''}}
 
  |-
 
  |-
  |Выбор краски
+
  |Select paint
  |Numpad 1, Numpad 3
+
  |{{keys|'''Numpad 1'''}}, {{keys|'''Numpad 3'''}}
 
  |}
 
  |}
  
==Нюансы и проблемные места==
+
==Nuances and difficulties==
В первую очередь размещается основная геометрия уровня (террейн, здания, мосты и др.). После этого устанавливаются спрайты (растительность) и функциональные элементы (spawn-точки, бонусные зоны, флаги и др.).
+
First of all you need to place main geometry of a level (terrain, buildings, bridges, etc.). After that you install sprites (vegetation) and functional elements (spawn points, bonus zones, flags, etc.).
 +
 
 +
When placing spawn zones always make sure that the biggest hull won’t get trapped at the spawn point.
 +
 
 +
In the process of rendering the level is divided into blocks along the boundaries of props forming a hierarchy (level → large blocks (buildings, land, etc.) → even smaller groups in each block → individual props). At this point some difficulties may occur.
 +
 
 +
To avoid them, you need to ensure that there are at least several “joints” (boundaries between props) going through the whole level that are not interrupted by other props:<br><br>
  
При установке spawn-зон следует проверять, чтобы самый большой по размерам корпус не застревал в уровне при респауне.
+
[[File:tree_1.png|500px|link=]]<br><br>
  
В процессе отрисовки уровень разделяется на блоки по границам пропов, образуя иерархию (уровень → крупные блоки (дома, земля и т.п.) → еще более мелки группы в каждом блоке → Отдельные пропы). В этот момент могу возникать проблемы.
+
Black lines are "joints", the yellow line is not.
  
Чтобы их избежать, нужно следить за тем, чтобы через весь уровень проходило хотя бы несколько «швов» (границ между пропами), не прерывающихся другими пропами:
+
The more of these joints are on the map the better.
* правильно<br><gallery widths=500px heights=128px>File:800px-Pic19.png</gallery>
+
* неправильно<br><gallery widths=500px heights=107px>File:800px-Pic20.png</gallery>
+
Чем больше таких швов, тем лучше. Но совсем «квадратно-гнездовым» уровень делать не надо.
+
  
Если «швы», пущеные вдоль проблемных зданий через весь уровень утыкаются в другие пропы на периферии, то есть два выхода:
+
If joints that go along problematic buildings through the entire map interfere with other props, there are two ways to solve this problem:
# заменить эти здания стенами, блоками или скалами (которые имеют ограниченную высоту, укладываются в сетку по вертикали и достаточно мелкие по горизонтали);
+
# Instead of these buildings put walls, blocks or rocks (that have limited height and are within the grid limits vertically and are quite small horizontally);
# постараться выстроить вдоль этих крупных зданий «швы» через весь уровень.
+
# Try to make joints going along these large buildings through the entire level.
  
Для того, чтобы убедиться, что иерархия выстроилась правильно, нужно воспользоваться debug-режимом (сочетание клавиш Сtrl+B) в Tanks Testing Tool (зеленым обозначается объединившееся в группы, красным — проблемные места). Если что-то подсвечено красным, то:
+
To make sure that the hierarchy is correct use the debug mode ({{keys|'''Ctrl'''}} '''+''' {{keys|'''B'''}}) in Tanks Testing Tool (props joined into groups are marked with green, problematic places are red). If something is highlighted in red, it means that:
* есть проблемы с сортировкой, описанные выше;
+
* There are problems with sorting which were described before;
* в этом месте стоит танк или спрайт (поэтому спрайты стоит добавлять в последнюю очередь, когда основная геометрия уже построена и оттестирована).
+
* There is a tank or a sprite in this place (that's why sprites must be added last, when the main geometry has already been built and tested).

Latest revision as of 19:34, 12 November 2019

User icon.png  Did you know that...Refresh icon.png

Contents

Introduction

AlternativaEditor allows you to create levels (maps) for Tanki Online using special 3D-elements called props. Props are complete 3D-objects or its component parts, that you can use to create game locations.

Pic11.png Pic12.png Pic13.png

Props are loaded into the editor in libraries. Props can be rotated around a vertical axis. The angle of rotation can be user-defined (any angle) or a multiple of 90 degrees.

Installation

You can download the program by clicking here.

Editor is made as an Adobe AIR application. So you need to download and install Adobe AIR.

Then you need to download, unpack a zip archive and install a file called AlternativaEditor.air. After the installation, you will see a shortcut on your desktop.

Editor review

Interface

The interface of the editor consists of several parts:

  • Main menu;
    used to perform basic operations (import / export, editing, loading prop libraries, help, etc.)
  • Toolbar;
    used for switching the main options on and off:
    • snapping;
    • physical geometry;
    • grid;
    • properties window;
    • hiding props;
  • Workspace;
  • Prop selection panel:
    • preview;
    • props divided into categories and groups;
  • Properties of selected prop.

Pic10.png

To begin you need to load prop library. You can do that by going to Library → Clear and Load and specifying the root folder of the library.

Pic6.png

Once the library is loaded, on the right in the pop-down menu you will see categories and groups of props.

Pic4.png

Approximate structure of the library

The prop library is presented as a structure of folders containing files of models (3DS) and textures (JPG) as well as library.xml files.

There is the following hierarchy in the library:

  • Categories of props (buildings, fences, terrain, etc.)
    • Groups of props - component parts of complex elements (bridges, groups of rocks, etc.)
      • Separate props

Props overview

Geometric props

Geometric props describe fixed geometry of a level. They are 3DS-objects that have rectangular cross section in the base. The sides of it should be multiples of grid horizontal spacing (5 meters). If props contain terrain slopes the height difference between the borders should be equal to grid vertical spacing. Each geometric prop can contain a child object defining the geometry for collisions with tanks. This kind of object should be a box, a center of which is located at the origin of the local coordinate system. The axis of the box should be directed along the axis of its local coordinate system. One prop can have several textures which you can choose in the settings menu.

Pic9.png

Sprites

In order to save memory some props are represented as sprites – flat objects that are always deployed to the camera. For example trees and bushes.

When constructing a map, sprites should be added last. First you need to test the main geometry to make sure there are no problem areas and take into account all the nuances.

Pic15.png

By default, all elements are snapped to the grid. This may be an obstacle in case of sprites and functional elements. You can turn it off by clicking on magnet icon on the toolbar (Pic16.png). Sprites may disappear on subsequent boots. This is due to the problems with sorting in the editor. It may happen that they will be displayed under the surface of which they are placed.

This problem may be solved as follows:

  1. Choose Pic17.png in the upper bar;
  2. Select all sprites;
  3. Drag them while holding V (vertical movement) to find the ideal position.

Just to make sure it doesn't happen you can add several sprites for each height level. Then you can adjust the height as it was stated before and simply copy sprites. The correct height will be saved. When doing this it’s necessary to switch off the snap function.

800px-Pic18.png

Spawn points and bonus zones

Spawn points define where tanks appear and which way they are facing. There are three types of spawn points: yellow which are used for DM battles as well as blue and red which are used to specify the places where tanks of two opposing team appear in team battles (TDM, CTF, CP modes). Spawn points must be placed on the ground level.

Pic4.png

Bonus zones indicate areas where bonuses may appear and define the types of possible bonuses. The zones should be rectangular with sides which are multiples of grid horizontal spacing. The type of dropped items is defined in the properties window. Bonus zones should be located above ground, higher by 1-2 spaces. It is also recommended to create 25% more double speed drop zones than double armor and double damage ones.

Method of work

Adding a prop to a map

  1. Choose the prop you need to add. You will see a green translucent cursor showing where the prop will be placed;
  2. Move the cursor to the required place using mouse or arrow keys on your keyboard;
  3. You can raise or lower the prop to a desired level using W and S keys;
  4. The prop can be rotated around its axis using X and Z keys;
  5. Press spacebar to place a prop.

Once you've added a prop, the cursor will become red. Two props can't overlap each other (occupy the same section of the grid).

You can choose next element for adding or edit the current one.

Editing a prop on a map

To do that you need to click on the prop. After doing that it will be highlighted in red. Now using mouse and keyboard you can move and rotate it or delete it by pressing Delete or C. To copy a prop drag it while holding Shift. Press K to move a prop half a segment.

Also you can choose a texture for each prop. To do that you need to select a prop that you've added to the map, open the settings menu and choose a texture.

Pic14.png

Tile props that are used to construct the level's terrain often have different textures.

If we add several identical props and apply a texture to one of them, you will be able to apply the same texture to other selected props by pressing spacebar. The last selected texture will apply to it.

Now a little more about the structure of these textures. All of them are made seamless. So they can be joined together without seams in any direction. There are 1x1 tiles (5x5 meters) as well as 2x2 (10x10 meters), 2x1, 3x1, 3x2 and 3x3 ones.

Navigation

To move the camera you can use the middle button on your mouse. To rotate the camera use Alt + middle button. Use the scroll wheel to zoom in and out. When you choose a particular prop the wheel is more sensitive while the rotation is done around the highlighted object. To get back to the insert cursor without selecting a prop use Ctrl + click combination. You can select several objects in a frame, make sure you hold Ctrl not to select a prop under the cursor and not to drag it. You can add an item to selected ones using Shift + click, or remove it from selected by using Alt + Shift + click.

You can't put two elements on one place. If it happened accidentally while dragging you will see an error window with a suggestion to undo the last action. Also you can check whether any elements are overlapped by pressing Q. The conflicting elements will be highlighted in red. You can undo the last action and go a step forward using CTRL + Z and Ctrl + Y.

Exporting / importing a map file

You can convert a map into XML at any moment. You can do it in the main menu File→Export Tanks map 1.x or by using Ctrl + T. When exporting a map you need to specify its name and add .xml format.

In order to import a map into the editor use File→Import from tanks or Ctrl + T.

Testing a map in TanksTestingTool

Before testing your map make sure there is at least one spawn point (a place where tank appears) for DM mode.

In order to test the results of your work you can open your map in TanksTestingTool. To do that you need to:

  1. Convert a map to XML;
  2. Call it map.xml;
  3. Move the file you got to Library folder with TanksTestingTool.swf file;
  4. Launch TanksTestingTool.swf

If everything has been done correctly, the map will be displayed.

Tank Testing Tool controls

Move around the level in flight mode. WASD, Q, E, Mouse Drag
Speed-up Shift
Switch between flight mode and tank mode F
Add/delete tanks Insert / Delete
Switch between tanks N, Shift + N
Switch between different spawn points T - type of point

Y - Next point

Select turret Numpad 7, Numpad 9
Select hull Numpad 4, Numpad 6
Select paint Numpad 1, Numpad 3

Nuances and difficulties

First of all you need to place main geometry of a level (terrain, buildings, bridges, etc.). After that you install sprites (vegetation) and functional elements (spawn points, bonus zones, flags, etc.).

When placing spawn zones always make sure that the biggest hull won’t get trapped at the spawn point.

In the process of rendering the level is divided into blocks along the boundaries of props forming a hierarchy (level → large blocks (buildings, land, etc.) → even smaller groups in each block → individual props). At this point some difficulties may occur.

To avoid them, you need to ensure that there are at least several “joints” (boundaries between props) going through the whole level that are not interrupted by other props:

Tree 1.png

Black lines are "joints", the yellow line is not.

The more of these joints are on the map the better.

If joints that go along problematic buildings through the entire map interfere with other props, there are two ways to solve this problem:

  1. Instead of these buildings put walls, blocks or rocks (that have limited height and are within the grid limits vertically and are quite small horizontally);
  2. Try to make joints going along these large buildings through the entire level.

To make sure that the hierarchy is correct use the debug mode (Ctrl + B) in Tanks Testing Tool (props joined into groups are marked with green, problematic places are red). If something is highlighted in red, it means that:

  • There are problems with sorting which were described before;
  • There is a tank or a sprite in this place (that's why sprites must be added last, when the main geometry has already been built and tested).