Jump to content

Extra tools/ru: Difference between revisions

From DDraceNetwork
FuzzyBot (talk | contribs)
Updating to match new version of source page
No edit summary
 
(82 intermediate revisions by 2 users not shown)
Line 4: Line 4:


<span id="Getting_the_extra_tools"></span>
<span id="Getting_the_extra_tools"></span>
<div class="mw-translate-fuzzy">
== Получение дополнительных инструментов ==
== Получение дополнительных утилит ==
</div>


Эти утилиты '''не''' поставляются в комплекте с бинарными файлами DDNet со [https://ddnet.org/downloads/ страницы загрузки]. При этом дополнительные инструменты, связанные с маппингом, можно скачать для различных платформ на странице "Загрузки" под названием "Графические инструменты".
Эти утилиты '''не''' поставляются в комплекте с бинарными файлами DDNet со [https://ddnet.org/downloads/ страницы загрузки]. При этом дополнительные инструменты, связанные с маппингом, можно скачать для различных платформ на странице "Загрузки" под названием "Графические инструменты".
Line 13: Line 11:


<span id="List_of_extra_tools"></span>
<span id="List_of_extra_tools"></span>
<div class="mw-translate-fuzzy">
== Список дополнительных инструментов ==
== Список дополнительных утилит ==
</div>


Смотрите ниже список и описание инструментов.
Смотрите ниже список и описание инструментов.


<span id="config_retrieve"></span>
<span id="config_retrieve"></span>
<div class="mw-translate-fuzzy">
=== config_retrieve ===
=== config_retrieve ===
</div>


  config_retrieve ''Имя_карты''
  config_retrieve ''Имя_карты''
Line 31: Line 25:


<span id="config_store"></span>
<span id="config_store"></span>
<div class="mw-translate-fuzzy">
=== config_store ===
=== config_store ===
</div>


  config_store ''Имя_Карты''
  config_store ''Имя_Карты''
Line 44: Line 36:


<span id="crapnet"></span>
<span id="crapnet"></span>
<div class="mw-translate-fuzzy">
=== crapnet ===
=== crapnet ===
</div>


  crapnet
  crapnet
Line 52: Line 42:
Проверяет соединение, устанавливая локальное соединение клиент–сервер и запуская ping между ними. Сообщает об отброшенных пакетах с сообщением <code>dropped packet</code> и об успехах с <code>cfg = "number"</code>, где "number" варьируется от 0 до 2.
Проверяет соединение, устанавливая локальное соединение клиент–сервер и запуская ping между ними. Сообщает об отброшенных пакетах с сообщением <code>dropped packet</code> и об успехах с <code>cfg = "number"</code>, где "number" варьируется от 0 до 2.


<span id="demo_extract_chat"></span>
===demo_extract_chat===
<div class="mw-translate-fuzzy">
=== dilate ===
</div>


  <div class="mw-translate-fuzzy">
  demo_extract_chat ''демо_файл''
dilate ''Файл_изображения1'' [''Файл_изображения2'' ... ]
</div>


<div class="mw-translate-fuzzy">
Экспортирует все сообщения из демо-файла, вывод осуществляется в консоль.
Это графический инструмент, в основном полезный для мапперов. Он заботится о прозрачных областях, чтобы предотвратить появление черных/белых контуров вокруг ваших изображений в игре, что позволяет избежать проблем со смешиванием и мипмапом. Более подробную информацию смотрите в [http://wiki.polycount.com/wiki/Edge_padding Edge padding].
</div>


<div class="mw-translate-fuzzy">
chat: *** 'nameless tee' entered and joined the game
Обратите внимание, что это работает только в файлах изображений RGBA (например, PNG). В файлах JPEG это не сработает.
chat: nameless tee: Hello!
</div>
broadcast: Welcome!
teamchat: brainless tee: Hello team!
whisper: -> nameless tee: Hi!


<div class="mw-translate-fuzzy">
''Available since: DDNet 17.4''
=== dummy_map ===
</div>


<span id="dilate"></span>
===dilate===
<div class="mw-translate-fuzzy">
dummy_map
</div>


  <div class="mw-translate-fuzzy">
  dilate ''image_file1'' [''image_file2'' ... ]
Создает фиктивную, небольшую пустую карту, которая будет использоваться для запуска сервера. См. [https://github.com/ddnet/ddnet/blob/a66379918832e5ad93332bbe0475394b156b5c24/src/engine/shared/network_server.cpp#L371] для получения дополнительной информации.
</div>


<div class="mw-translate-fuzzy">
Это графический инструмент, в основном полезный для мапперов. Он заботится о прозрачных областях, чтобы предотвратить появление черных/белых контуров вокруг ваших изображений в игре, что позволяет избежать проблем со смешиванием и mipmap. Более подробную информацию можно найти в разделе [http://wiki.polycount.com/wiki/Edge_padding Edge padding].
=== fake_server ===
</div>


<div class="mw-translate-fuzzy">
Обратите внимание, что это работает только с файлами изображений RGBA (например, PNG файлы). В файлах JPEG это не будет работать.
fake_server
</div>


<span id="dummy_map"></span>
===dummy_map===
<div class="mw-translate-fuzzy">
Создает фальшивый(фейковый) сервер для тестирования.
</div>


  <div class="mw-translate-fuzzy">
  dummy_map
=== map_convert_07 ===
</div>


<div class="mw-translate-fuzzy">
Создаёт фиктивную, небольшую пустую карту, используемую для ванильной антиспуф-функции (<code>sv_vanilla_antispoof</code>). Подробнее можно посмотреть по ссылке: [https://github.com/ddnet/ddnet/blob/a66379918832e5ad93332bbe0475394b156b5c24/src/engine/shared/network_server.cpp#L371].
map_convert_07 ''путь_к_файлу_карты'' ''место_назначение_файла_карты''
</div>


<span id="map_convert_07"></span>
===map_convert_07===
<div class="mw-translate-fuzzy">
 
Делает <code>''dest_map_file''</code> совместимым с Teeworlds версии 7.x, иначе он был бы совместим '''только''' с Teeworlds версии 6.x. В случае успеха создается действительная 07-совместимая карта назначения; в противном случае возвращается одно из следующих значений:
map_convert_07 ''src_map_file'' ''dest_map_file''
</div>
 
Делает файл <code>''dest_map_file''</code> совместимым с версией Teeworlds 7.x, тогда как иначе он был бы совместим только с версией 6.x. В случае успешного выполнения создаётся корректная карта, совместимая с 07-версией; в противном случае возвращается одно из следующих значений:


<div class="mw-translate-fuzzy">
* Сообщение об использовании, если предоставлены неверные аргументы
* Сообщение об использовании, если предоставлены неверные аргументы
* <code>failed to open source map</code>, если при открытии карты источников произошла ошибка
* <code>failed to open source map</code>, если при открытии карты источников произошла ошибка
Line 115: Line 82:
* <code>failed to open image file</code> если произошла ошибка при открытии PNG-изображения
* <code>failed to open image file</code> если произошла ошибка при открытии PNG-изображения
* <code>invalid image format</code> при неправильном форматировании PNG.
* <code>invalid image format</code> при неправильном форматировании PNG.
</div>


<div class="mw-translate-fuzzy">
''Доступно с версии: DDNet 12.9''
''Доступно с версии: DDNet 12.9''
</div>
<div class="mw-translate-fuzzy">
=== map_diff ===
</div>
<div class="mw-translate-fuzzy">
map_diff ''файл_карты1'' ''файл_карты2''
</div>


<span id="map_create_pixelart"></span>
===map_create_pixelart===
<div class="mw-translate-fuzzy">
Сравнивает два файла карт, сообщая об одном из них:
* нет вывода diff, что означает, что карты одинаковые
* <code>different layer numbers</code>, если одна карта имеет больше слоев, чем другая
* <code>different tile layers</code>, если количество слоев одинаково, но хотя бы один слой отличается от другого
* наконец, позиции индекса и флагов, которые отличаются.
</div>


  <div class="mw-translate-fuzzy">
  map_create_pixelart <image.png> <img_pixelsize> <input_map> <layergroup_id> <layer_id> <pos_x> <pos_y> <quad_pixelsize> <output_map> [optimize=0|1] [centralize=0|1]
Если между картами нет разницы, возвращается 0; в противном случае возвращается 1.
</div>


<div class="mw-translate-fuzzy">
Создаёт карту с пиксель-артом на основе квадов из изображения.
=== map_extract ===
</div>


<div class="mw-translate-fuzzy">
Примечание: используйте тайлы слоя назначения для определения позиций и пиксели для размеров.
map_extract ''файл_Карты'' [''директория'']
</div>


<div class="mw-translate-fuzzy">
Примечание: установите значение img_pixelsize в 0, чтобы использовать максимально возможный размер.
Извлекает содержимое из ''map_file'' в ''directory''. Если дополнительный аргумент ''директория'' не указан, извлечение производится в текущую директорию.
</div>


<div class="mw-translate-fuzzy">
Примечание: установите значение quad_pixelsize в 0, чтобы использовать то же значение, что и img_pixelsize.
=== map_optimize ===
</div>


<div class="mw-translate-fuzzy">
Примечание: если у image.png нет идеальной пиксельной сетки, результат может быть некорректным; вручную измените img_pixelsize для улучшения.
map_optimize ''Исходный_путь_к_файлу_карты'' [''место_назначение_файла_карты'']
</div>


<div class="mw-translate-fuzzy">
Опция optimize пытается уменьшить общее количество квадов (по умолчанию: 1).
Оптимизирует файл карты в указанном <code>"source_map_file path"</code> (см. [https://github.com/ddnet/ddnet/pull/3201 как это работает]) и сохраняет выходные данные в заданном <code>"dest_map_filepath"</code>; если <code>"dest_map_filepath"</code> не задан, вывод путь по умолчанию равен <code>out/"source_map_filename".map</code>, удаляя путь и расширение исходного файла.
</div>


<div class="mw-translate-fuzzy">
Опции: centralize размещает все точки поворота (пивоты) в одной позиции (значение по умолчанию: 0).
Обратите внимание, что название оптимизированных встроенных изображений изменено с <code>"originalname"</code> на <code>"originalname"_cut_"newSHA256"</code> (где <code>"newSHA256"</code> - это новый sha256 встроенного оптимизированного изображения). Он переименован для того, чтобы было ясно, что он был оптимизирован, потому что этот инструмент "будет" вносить изменения в карты, используемые файлом карты.
</div>


<span id="map_diff"></span>
===map_diff===
<div class="mw-translate-fuzzy">
Если не удалось открыть исходный или целевой файл, возвращается -1.
</div>


  <div class="mw-translate-fuzzy">
  map_diff ''map_file1'' ''map_file2''
''Доступно с версии: DDNet 15.5.4''
</div>


<div class="mw-translate-fuzzy">
Сравнивает два файла карт и выводит один из следующих результатов:
=== map_replace_image ===
*нет отличий — означает, что карты идентичны
</div>
*<code>different layer numbers</code> — если в одной карте больше слоёв, чем в другой
*<code>different tile layers</code> — если количество слоёв совпадает, но хотя бы один слой отличается
*в противном случае — индексы и позиции флагов, которые различаются.


<div class="mw-translate-fuzzy">
Если карты идентичны, возвращает 0; в противном случае возвращает 1.
map_replace_image ''файл_карты1'' ''файл_карты2'' ''имя_изображения'' ''файл_изображения''
</div>


<span id="map_extract"></span>
===map_extract===
<div class="mw-translate-fuzzy">
Заменяет изображение ''imagename'', находящееся в файле карты с именем ''map_file1'', на изображение с файловым путем ''image_file'' и сохраняет в файл карты с именем ''map_file2.map''.
</div>


  <div class="mw-translate-fuzzy">
  map_extract ''map_file'' [''directory'']
Обратите внимание:
* Имена файлов обеих карт должны быть относительно папки DDNet по умолчанию пользователя.
* Путь к файлу нового изображения может быть абсолютным или относительным к текущему каталогу.
</div>


<div class="mw-translate-fuzzy">
Извлекает содержимое файла ''map_file'' в указанную ''directory''. Если дополнительный аргумент ''directory'' не указан, извлекает в текущую директорию.
=== map_resave ===
</div>


<span id="map_find_env"></span>
===map_find_env===
<div class="mw-translate-fuzzy">
map_resave ''файл_карты'' ''файл_изображения''
</div>


  <div class="mw-translate-fuzzy">
  map_find_env <input_map> <env_number>
Обновляет файл карты ''map_file.map'' с помощью предоставленного файла ''image_file''.
</div>


<div class="mw-translate-fuzzy">
Находит квады по заданной оболочке и выводит их индекс и позицию в консоль.
Статус ошибки 255 возвращается, если 1) предоставлено число аргументов, отличное от 2, 2) если файл ''map_file.map'' недопустим, или 3) если файл ''image_file'' не является допустимым файлом изображения (например, это текстовый файл); в противном случае возвращается 0.
</div>


<div class="mw-translate-fuzzy">
Примечание: позиции найденных квадов указаны относительно их слоёв.
=== packetgen ===
</div>


<span id="map_optimize"></span>
===map_optimize===
<div class="mw-translate-fuzzy">
packetgen
</div>


  <div class="mw-translate-fuzzy">
  map_optimize ''source_map_filepath'' [''dest_map_filepath'']
Генерирует и отправляет сетевые пакеты на 127.0.0.1:8303 (localhost, порт сервера по умолчанию) для проверки связи с локальным экземпляром сервера.
</div>


<div class="mw-translate-fuzzy">
Оптимизирует файл карты в указанном <code>''source_map_filepath''</code> (см. [https://github.com/ddnet/ddnet/pull/3201 как это работает]) и сохраняет результат в заданном <code>''dest_map_filepath''</code>; если <code>''dest_map_filepath''</code> не указан, путь по умолчанию — <code>out/''source_map_filename''.map</code>, с удалением пути и расширения исходного файла.
=== unicode_confusables ===
</div>


<div class="mw-translate-fuzzy">
Обрати внимание, что имя встроенных оптимизированных изображений изменяется с <code>''originalname''</code> на <code>''originalname''*cut*''newSHA256''</code> (где <code>''newSHA256''</code> — это новый sha256 встроенного оптимизированного изображения). Оно переименовывается, чтобы было понятно, что изображение было оптимизировано, потому что этот инструмент '''действительно''' вносит изменения в mapres, используемые файлом карты.
unicode_confusables ''строка1'' ''строка2''
</div>


<div class="mw-translate-fuzzy">
При неудачном открытии исходного или целевого файла возвращает -1.
Сравнивает ''string1'' со ''string2'' и сообщает, являются ли они "путаемыми", т.е. если символы "одинаковы" и могут вызвать путаницу. Чтобы это сработало, символы с акцентами или другими элементами вокруг них считаются "перепутанными" с базовым символом. Таким образом, ''aa'' и ''aá'' можно спутать ("á" считался как "a"), а ''aa'' и ''ab'' - нет.
</div>


<div class="mw-translate-fuzzy">
''Доступно с:'' DDNet 15.5.4
Если они перепутаны, возвращается <code>not_confusable=0</code>, в противном случае возвращается <code>not_confusable=1</code>.
</div>


<span id="map_replace_area"></span>
===map_replace_area===
<div class="mw-translate-fuzzy">
''Доступно с версии: DDNet 10.3.5''
</div>


  <div class="mw-translate-fuzzy">
  map_replace_area <from_map> <from_x> <from_y> <to_map> <to_x> <to_y> <width> <height> <output_map>
'''Новое в DDNet версии 12.9:''' Поддержка Unicode 12.0 и название инструмента было переименовано из ''confusables'' в ''unicode_confusables''.
</div>


<div class="mw-translate-fuzzy">
Заменяет область одной карты на область из другой карты.
=== uuid ===
</div>


<div class="mw-translate-fuzzy">
Примечание: используйте тайлы игрового слоя в качестве ориентира для координат и размеров.
uuid ''имя''
</div>


<span id="map_replace_image"></span>
===map_replace_image===
<div class="mw-translate-fuzzy">
Выводит uuid для указанного ''имя''.
</div>


  <div class="mw-translate-fuzzy">
  map_replace_image ''map_file1'' ''map_file2'' ''imagename'' ''image_file''
Система uuid была реализована таким образом, чтобы ее могли легко расширять независимые авторы без коллизий, чего не позволяла старая система - с возрастающими целыми числами. Это работает для сообщений движка и игры, предметов и событий снапшотов.
</div>


<div class="mw-translate-fuzzy">
Заменяет изображение ''imagename'', находящееся в карте с именем файла ''map_file1'', на изображение из файла ''image_file'' и сохраняет в карту с именем файла ''map_file2.map''.
Выходит со статусом ошибки 255, если не указано ''name''.
</div>


<div class="mw-translate-fuzzy">
Обрати внимание:
''Доступно с версии: DDNet 10.6.1''
*Оба имени файла карты должны быть указаны относительно папки DDNet по умолчанию пользователя
</div>
*Путь к новому изображению может быть абсолютным или относительным к текущему каталогу


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


  <div lang="en" dir="ltr" class="mw-content-ltr">
  map_resave ''source_map.map'' ''destination_map.map''
map_resave ''source_map.map'' ''destination_map.map''
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Считывает карту ''source_map.map'' и записывает её обратно в ''destination_map.map'' с использованием последнего формата карты.
Reads the map ''source_map.map'' and writes it back to ''destination_map.map'' using the latest map format.
</div>


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


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


<div lang="en" dir="ltr" class="mw-content-ltr">
Генерирует и отправляет сетевые пакеты на 127.0.0.1:8303 (localhost, в порт сервера по умолчанию) для проверки связи с локальным экземпляром сервера.
Generates and sends network packets to 127.0.0.1:8303 (localhost, in default server port) to test communication with a local server instance.
</div>


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


  <div lang="en" dir="ltr" class="mw-content-ltr">
  stun ''address''
stun ''address''
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Отправляет запрос [[wikipedia:STUN|STUN]] на сервер и проверяет ответ.
Sends [[wikipedia:STUN|STUN]] request to server and checks response.
</div>


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


<div lang="en" dir="ltr" class="mw-content-ltr">
  twping ''server''[:''port'']
  twping ''server''[:''port'']
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Измеряет пинг до сервера teeworlds, запрашивая информацию о сервере. Значение ''port'' по умолчанию — 8303.
Measures ping to a teeworlds server by requesting the server information. ''port'' defaults to 8303.
</div>


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


  <div lang="en" dir="ltr" class="mw-content-ltr">
  unicode_confusables ''string1'' ''string2''
unicode_confusables ''string1'' ''string2''
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Сравнивает ''string1'' с ''string2'' и сообщает, являются ли они «путающимися», то есть «равными» символами, которые могут вызвать путаницу. Для этого символы с акцентами или другими элементами вокруг них считаются «путающимися» с базовым символом. Таким образом, ''aa'' и ''aá'' являются путающимися (''á'' считается как ''a''), тогда как ''aa'' и ''ab'' — нет.
Compares ''string1'' with ''string2'' and report if they are "confusable", i.e. if the characters are "equal" and could cause confusion. For this to work, the characters with accents or other things around them are considered the "confusable" with the base character. Therefore, ''aa'' and ''aá'' are confusable (''á'' was considered as ''a''), while ''aa'' and ''ab'' are not.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Если они являются путающимися, возвращает <code>not_confusable=0</code>, в противном случае возвращает <code>not_confusable=1</code>.
If they are confusable, it returns <code>not_confusable=0</code>, otherwise, returns <code>not_confusable=1</code>.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
''Доступно с версии: DDNet 10.3.5''
''Available since: DDNet 10.3.5''
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
''Новое в DDNet 12.9:'' поддержка Unicode 12.0, и имя инструмента было переименовано с ''confusables'' в ''unicode_confusables''.
''New in DDNet 12.9:'' Unicode 12.0 support and the tool name was renamed from ''confusables'' to ''unicode_confusables''.
</div>


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


  <div lang="en" dir="ltr" class="mw-content-ltr">
  uuid ''name''
uuid ''name''
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Выводит uuid для заданного ''name''.
Prints uuid for the provided ''name''.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Система uuid была реализована так, чтобы её могли легко расширять независимые разработчики без коллизий, чего не позволяла старая система с возрастающими целыми числами. Это работает для сообщений движка и игры, элементов снимков и событий.
The uuid system was implemented to be easily extended by independent authors without collisions, something that the old system – with increasing integers – did not allow. This works for engine and game messages, snapshot items and events.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Завершает работу с кодом ошибки 255, если ''name'' не указан.
Exits with error status 255 if ''name'' is not provided.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
''Доступно с версии: DDNet 10.6.1''
''Available since: DDNet 10.6.1''
</div>

Latest revision as of 14:00, 15 June 2025

Дополнительные утилиты предназначены для некоторых задач, не связанных с игровым процессом, по типу оптимизации карт для мапперов, или отладки и тестирования для разработчиков. Эти утилиты должны запускаться из консольного интерфейса (вроде Командной строки в Windows или Терминала в системах на базе ядра Linux) либо путем добавления содержащего их каталога в системную переменную PATH, либо путем запуска непосредственно из содержащего каталога.

Получение дополнительных инструментов

Эти утилиты не поставляются в комплекте с бинарными файлами DDNet со страницы загрузки. При этом дополнительные инструменты, связанные с маппингом, можно скачать для различных платформ на странице "Загрузки" под названием "Графические инструменты".

Эти и другие дополнительные инструменты (перечисленные ниже) можно найти на GitHub в каталоге src/tools.

Список дополнительных инструментов

Смотрите ниже список и описание инструментов.

config_retrieve

config_retrieve Имя_карты

Извлекает конфигурацию, встроенную в файл карты DDNet map_file и сохраняет ее в файле конфигурации карты DDNet с тем же именем (например, "Kobra 4.map" возвращает "Kobra 4.cfg").

Доступно с версии: DDNet 9.0

config_store

config_store Имя_Карты

Сохраняет конфигурацию из файла конфигурации карты в файл map_file. Оба файла конфигурации и карты должны иметь одинаковое имя в одном каталоге, иначе операция завершится неудачей.

Если нет разницы между конфигурацией для сохранения и конфигурацией, встроенной в карту, то операция будет отменена с сообщением configs coincide, not updating map.

Доступно с версии: DDNet 9.0

crapnet

crapnet

Проверяет соединение, устанавливая локальное соединение клиент–сервер и запуская ping между ними. Сообщает об отброшенных пакетах с сообщением dropped packet и об успехах с cfg = "number", где "number" варьируется от 0 до 2.

demo_extract_chat

demo_extract_chat демо_файл

Экспортирует все сообщения из демо-файла, вывод осуществляется в консоль.

chat: *** 'nameless tee' entered and joined the game
chat: nameless tee: Hello!
broadcast: Welcome!
teamchat: brainless tee: Hello team!
whisper: -> nameless tee: Hi!

Available since: DDNet 17.4

dilate

dilate image_file1 [image_file2 ... ]

Это графический инструмент, в основном полезный для мапперов. Он заботится о прозрачных областях, чтобы предотвратить появление черных/белых контуров вокруг ваших изображений в игре, что позволяет избежать проблем со смешиванием и mipmap. Более подробную информацию можно найти в разделе Edge padding.

Обратите внимание, что это работает только с файлами изображений RGBA (например, PNG файлы). В файлах JPEG это не будет работать.

dummy_map

dummy_map

Создаёт фиктивную, небольшую пустую карту, используемую для ванильной антиспуф-функции (sv_vanilla_antispoof). Подробнее можно посмотреть по ссылке: [1].

map_convert_07

map_convert_07 src_map_file dest_map_file

Делает файл dest_map_file совместимым с версией Teeworlds 7.x, тогда как иначе он был бы совместим только с версией 6.x. В случае успешного выполнения создаётся корректная карта, совместимая с 07-версией; в противном случае возвращается одно из следующих значений:

  • Сообщение об использовании, если предоставлены неверные аргументы
  • failed to open source map, если при открытии карты источников произошла ошибка
  • failed to open destination map если при открытии карты назначения произошла ошибка
  • error loading storage если по какой-то причине не удалось открыть хранилище
  • failed to open image file если произошла ошибка при открытии PNG-изображения
  • invalid image format при неправильном форматировании PNG.

Доступно с версии: DDNet 12.9

map_create_pixelart

map_create_pixelart <image.png> <img_pixelsize> <input_map> <layergroup_id> <layer_id> <pos_x> <pos_y> <quad_pixelsize> <output_map> [optimize=0|1] [centralize=0|1]

Создаёт карту с пиксель-артом на основе квадов из изображения.

Примечание: используйте тайлы слоя назначения для определения позиций и пиксели для размеров.

Примечание: установите значение img_pixelsize в 0, чтобы использовать максимально возможный размер.

Примечание: установите значение quad_pixelsize в 0, чтобы использовать то же значение, что и img_pixelsize.

Примечание: если у image.png нет идеальной пиксельной сетки, результат может быть некорректным; вручную измените img_pixelsize для улучшения.

Опция optimize пытается уменьшить общее количество квадов (по умолчанию: 1).

Опции: centralize размещает все точки поворота (пивоты) в одной позиции (значение по умолчанию: 0).

map_diff

map_diff map_file1 map_file2

Сравнивает два файла карт и выводит один из следующих результатов:

  • нет отличий — означает, что карты идентичны
  • different layer numbers — если в одной карте больше слоёв, чем в другой
  • different tile layers — если количество слоёв совпадает, но хотя бы один слой отличается
  • в противном случае — индексы и позиции флагов, которые различаются.

Если карты идентичны, возвращает 0; в противном случае возвращает 1.

map_extract

map_extract map_file [directory]

Извлекает содержимое файла map_file в указанную directory. Если дополнительный аргумент directory не указан, извлекает в текущую директорию.

map_find_env

map_find_env <input_map> <env_number>

Находит квады по заданной оболочке и выводит их индекс и позицию в консоль.

Примечание: позиции найденных квадов указаны относительно их слоёв.

map_optimize

map_optimize source_map_filepath [dest_map_filepath]

Оптимизирует файл карты в указанном source_map_filepath (см. как это работает) и сохраняет результат в заданном dest_map_filepath; если dest_map_filepath не указан, путь по умолчанию — out/source_map_filename.map, с удалением пути и расширения исходного файла.

Обрати внимание, что имя встроенных оптимизированных изображений изменяется с originalname на originalname*cut*newSHA256 (где newSHA256 — это новый sha256 встроенного оптимизированного изображения). Оно переименовывается, чтобы было понятно, что изображение было оптимизировано, потому что этот инструмент действительно вносит изменения в mapres, используемые файлом карты.

При неудачном открытии исходного или целевого файла возвращает -1.

Доступно с: DDNet 15.5.4

map_replace_area

map_replace_area <from_map> <from_x> <from_y> <to_map> <to_x> <to_y> <width> <height> <output_map>

Заменяет область одной карты на область из другой карты.

Примечание: используйте тайлы игрового слоя в качестве ориентира для координат и размеров.

map_replace_image

map_replace_image map_file1 map_file2 imagename image_file

Заменяет изображение imagename, находящееся в карте с именем файла map_file1, на изображение из файла image_file и сохраняет в карту с именем файла map_file2.map.

Обрати внимание:

  • Оба имени файла карты должны быть указаны относительно папки DDNet по умолчанию пользователя
  • Путь к новому изображению может быть абсолютным или относительным к текущему каталогу

map_resave

map_resave source_map.map destination_map.map

Считывает карту source_map.map и записывает её обратно в destination_map.map с использованием последнего формата карты.

packetgen

packetgen

Генерирует и отправляет сетевые пакеты на 127.0.0.1:8303 (localhost, в порт сервера по умолчанию) для проверки связи с локальным экземпляром сервера.

stun

stun address

Отправляет запрос STUN на сервер и проверяет ответ.

twping

twping server[:port]

Измеряет пинг до сервера teeworlds, запрашивая информацию о сервере. Значение port по умолчанию — 8303.

unicode_confusables

unicode_confusables string1 string2

Сравнивает string1 с string2 и сообщает, являются ли они «путающимися», то есть «равными» символами, которые могут вызвать путаницу. Для этого символы с акцентами или другими элементами вокруг них считаются «путающимися» с базовым символом. Таким образом, aa и являются путающимися (á считается как a), тогда как aa и ab — нет.

Если они являются путающимися, возвращает not_confusable=0, в противном случае возвращает not_confusable=1.

Доступно с версии: DDNet 10.3.5

Новое в DDNet 12.9: поддержка Unicode 12.0, и имя инструмента было переименовано с confusables в unicode_confusables.

uuid

uuid name

Выводит uuid для заданного name.

Система uuid была реализована так, чтобы её могли легко расширять независимые разработчики без коллизий, чего не позволяла старая система с возрастающими целыми числами. Это работает для сообщений движка и игры, элементов снимков и событий.

Завершает работу с кодом ошибки 255, если name не указан.

Доступно с версии: DDNet 10.6.1