View source for Extra tools/es

<languages/>
<div lang="en" dir="ltr" class="mw-content-ltr">
'''''Extra tools''''' are available for running some non-gaming-related tasks, like map optimization by mappers, or debugging and testing by developers. These tools must be run from command-line interface (e.g. Command Prompt on Windows or Terminal on Linux) either by adding their containing directory to the PATH variable or by running directly from the containing directory.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Getting the extra tools ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
These tools are '''not''' provided in the binary DDNet game in the [https://ddnet.org/downloads/ Downloads page]. Having that said, extra tools mapping-related can be download for different platforms in the Downloads page, under the name "Graphics Tools".
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
These and other extra tools (listed below) can be found on the [https://github.com/ddnet/ddnet DDNet source code] under [https://github.com/ddnet/ddnet/tree/master/src/tools src/tools] directory.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== List of extra tools ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
See below the list and description of the tools.
</div>

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

 <div lang="en" dir="ltr" class="mw-content-ltr">
config_retrieve ''map_file''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Retrieves configuration embedded in a DDNet map file ''map_file'' and stores it in a DDNet map configuration file with same filename (e.g. "Kobra 4.map" returns "Kobra 4.cfg")
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
''Available since: DDNet 9.0''
</div>

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

 <div lang="en" dir="ltr" class="mw-content-ltr">
config_store ''map_file''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Stores configuration from a map's configuration file into the ''map_file''.  Both configuration and map files must have the same filename in the same directory, otherwise the operation will fail.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
If there is no difference between the configuration to stored and the configuration embedded in the map, then operation will be canceled with message <code>configs coincide, not updating map</code>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
''Available since: DDNet 9.0''
</div>

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

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

<div lang="en" dir="ltr" class="mw-content-ltr">
Tests connection by setting a client–server connection locally and running ping between them. Reports dropped packets with message <code>dropped packet</code> and successes with <code>cfg = ''number''</code>, where ''number'' varies from 0 to 2.
</div>


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

 <div lang="en" dir="ltr" class="mw-content-ltr">
dilate ''image_file1'' [''image_file2'' ... ]
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
It is a graphics tool, mainly useful for mappers. It takes care of transparent areas to prevent black/white outlines around your images ingame, therefore avoiding blending and mipmap issues. See [http://wiki.polycount.com/wiki/Edge_padding Edge padding] for more info.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Note this works only in RGBA image files (e.g. PNG files). So, it will fail in e.g. JPEG files.
</div>

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

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

<div lang="en" dir="ltr" class="mw-content-ltr">
Creates a dummy, small empty map to be used to start a server. See [https://github.com/ddnet/ddnet/blob/a66379918832e5ad93332bbe0475394b156b5c24/src/engine/shared/network_server.cpp#L371] for more info.
</div>

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

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

<div lang="en" dir="ltr" class="mw-content-ltr">
Creates a fake server for testing.
</div>

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

 <div lang="en" dir="ltr" class="mw-content-ltr">
map_convert_07 ''src_map_file'' ''dest_map_file''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Makes <code>''dest_map_file''</code> compatible with Teeworlds version 7.x that otherwise it would be compatible '''only''' with Teeworlds version 6.x. If successfully, it creates a valid 07-compatible destination map; otherwise, it returns one of the following:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* an usage message if incorrect arguments are provided
* <code>failed to open source map</code> if an error happens when opening the source map
* <code>failed to open destination map</code> if an error happens when opening the destination map
* <code>error loading storage</code> if failed to open storage for some reason
* <code>failed to open image file</code> if error happens on opening PNG image
* <code>invalid image format</code> if incorrectly formatted PNG.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
''Available since: DDNet 12.9''
</div>

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

 <div lang="en" dir="ltr" class="mw-content-ltr">
map_diff ''map_file1'' ''map_file2''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Compares two map files, reporting one of the follow:
* no diff output, meaning the maps are the same
* <code>different layer numbers</code>, if one map has more layers than another
* <code>different tile layers</code>, if the number of layers is the same, but at least one layer is different
* lastly, the index and flags positions that differ.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
If there is no difference between maps, returns 0; otherwise, returns 1.
</div>

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

 <div lang="en" dir="ltr" class="mw-content-ltr">
map_extract ''map_file'' [''directory'']
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Extracts contents from ''map_file'' into the ''directory''. If optional argument ''directory'' is not provided, extracts to the current directory.
</div>

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

 <div lang="en" dir="ltr" class="mw-content-ltr">
map_optimize ''source_map_filepath'' [''dest_map_filepath'']
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Optimizes the map file in the <code>''source_map_filepath''</code> given (see [https://github.com/ddnet/ddnet/pull/3201 how it works]) and stores the output in the given <code>''dest_map_filepath''</code>; if <code>''dest_map_filepath''</code> is unset, output path defaults to <code>out/''source_map_filename''.map</code>, stripping the path and the extension of the source file.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Note the name of the embedded images optimized is changed from <code>''originalname''</code> to <code>''originalname''_cut_''newSHA256''</code> (where <code>''newSHA256''</code> is the new sha256 of the embedded optimized image). It is renamed is to make clear it was optimized because this tool '''will''' make changes in the mapres used by the map file.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
If failed to open source or target file, returns -1.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
''Available since:'' DDNet 15.5.4
</div>

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

 <div lang="en" dir="ltr" class="mw-content-ltr">
map_replace_image ''map_file1'' ''map_file2'' ''imagename'' ''image_file''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Replaces the image ''imagename'' currently inside the map filename ''map_file1'' with the image filepath ''image_file'', and save into the map filename ''map_file2.map''.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Please note:
* Both map filenames must be relative to user default DDNet folder
* New image filepath can be absolute, or relative to the current directory
</div>

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

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

<div lang="en" dir="ltr" class="mw-content-ltr">
Updates the map file ''map_file.map'' with the provided file ''image_file''.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
The error status 255 is returned if 1) a number of arguments different from 2 is provided, 2) if the ''map_file.map'' is not valid, or 3) if ''image_file'' is not a valid image file (e.g. it is a text file); otherwise, return 0.
</div>

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

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

<div lang="en" dir="ltr" class="mw-content-ltr">
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">
=== unicode_confusables ===
</div>

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

<div lang="en" dir="ltr" class="mw-content-ltr">
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">
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">
''Available since: DDNet version 10.3.5''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
''New in DDNet version 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 ===
</div>

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

<div lang="en" dir="ltr" class="mw-content-ltr">
Prints uuid for the provided ''name''.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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">
Exits with error status 255 if ''name'' is not provided.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
''Available since: DDNet 10.6.1''
</div>