View source for Extra tools/zh

<languages/>
'''额外工具'''用于执行玩家游玩行为之外的其他任务，例如地图作者对地图进行优化，或是开发者进行测试和故障排除。不管是先添加它们的路径到PATH变量还是直接输入路径，这些工具都必须通过命令行（例如Windows的cmd界面或是Linux的Terminal终端）运行。

<span id="Getting_the_extra_tools"></span>
== 获取额外工具 ==

这些工具'''不'''会在DDNet游戏内或[https://ddnet.org/downloads/ 游戏下载页]中出现。制图相关工具可以在下载页面的Graphics Tools子页面找到不同平台的版本。

这些额外工具可以在[https://github.com/ddnet/ddnet DDNet源码]下的[https://github.com/ddnet/ddnet/tree/master/src/tools src/tools]路径内找到。

<span id="List_of_extra_tools"></span>
== 额外工具列表 ==

下面是这些工具的详细说明。

=== config_retrieve ===

 示例：config_retrieve ''map_file''

检索DDNet地图文件''map_file''内置的参数，然后写入保存到与地图名字相同的一个配置文件。例如对地图文件Kobra 4.map使用会将它的参数写入到Kobra 4.cfg。

* 自DDNet 9.0版本后可用

=== config_store ===

 示例：config_store ''map_file''

从配置文件将参数写入保存到地图文件''map_file''，如果配置文件和地图文件名字不同或者不在同一路径下将会操作失败。

如果两个文件的参数原本就一致，则不会执行操作并显示<code>configs coincide, not updating map</code>。

* 自DDNet 9.0版本后可用

=== crapnet ===

 示例：crapnet

用于测试客户端和服务器的本地连接和传送请求（ping）。掉包会显示<code>dropped packet</code>，而成功则显示<code>cfg = ''number''</code>，其中''number''取值为0到2。


=== dilate ===

 示例：dilate ''image_file1'' [''image_file2'' ... ]

这个图形工具对地图作者比较友好。它可以为游戏内图片描边和锐化，防止混淆不同地图结构。更多信息请查阅[http://wiki.polycount.com/wiki/Edge_padding Edge padding]。

注意：这只对RGBA格式的图片生效。例如PNG文件可用而JPEG文件不可用。

=== dummy_map ===

  示例：dummy_map

创建一个空的分身小地图来启动服务器。更多信息请参阅[https://github.com/ddnet/ddnet/blob/a66379918832e5ad93332bbe0475394b156b5c24/src/engine/shared/network_server.cpp#L371 github]。

=== fake_server ===

 示例：fake_server

为测试创建一个临时的虚拟服务器。

=== map_convert_07 ===

 示例：map_convert_07 ''src_map_file'' ''dest_map_file''

对于那些只能兼容Teeworlds的6.x版本的地图文件<code>''src_map_file''</code> ，使用这一命令可以将文件转变为兼容7.x版本并保存为<code>''dest_map_file''</code> 。这一命令在不同情况下执行失败则会有不同回显：

* 如果提供的参数不正确会显示用法示例；
* 如果在打开源文件<code>''src_map_file''</code> 时出错则会显示<code>failed to open source map</code> ；
* 如果在打开目标文件<code>''dest_map_file''</code> 时出错则会显示<code>failed to open destination map</code> ；
* 如果磁盘空间不足或有其他存储问题则会显示<code>error loading storage</code> ；
* 如果在打开PNG图片时出错则会显示<code>failed to open image file</code> ；
* 如果图片格式错误则会显示<code>invalid image format</code> 。

''自DDNet 12.9版本后可用''

=== map_diff ===

 示例：map_diff ''map_file1'' ''map_file2''

对比两个地图文件并根据对比结果输出报告：
* 地图相同则显示no diff output ；
* 如果两个地图的图层数不一样则显示<code>different layer numbers</code> ；
* 如果层数一致但是层中实体不一样则显示<code>different tile layers</code> ；
* 其他情况则显示指标和旗帜位置的差异。

当地图之间没有差异时返回0，否则返回1。

=== map_extract ===

 示例：map_extract ''map_file'' [''directory'']

提取地图文件''map_file'' 中的目录到路径参数''directory''，如果没有设置参数''directory'' 则会提取到当前路径。

=== map_optimize ===

 示例：map_optimize ''source_map_filepath'' [''dest_map_filepath'']

优化地图文件<code>''source_map_filepath''</code> （参见[https://github.com/ddnet/ddnet/pull/3201 工作原理（how it works）]），然后将输出保存到<code>''dest_map_filepath''</code> 。如果没有设置参数<code>''dest_map_filepath''</code> 则将默认输出保存到路径文件<code>out/''source_map_filename''.map</code> 。

注意优化后地图中嵌入的图片文件名会从<code>''originalname''</code> 改为<code>''originalname''_cut_''newSHA256''</code> （此处<code>''newSHA256''</code> 是嵌入地图的图片优化时采用的sha256算法）。这一重命名旨在提醒使用者：地图文件中使用的mapres'''会'''在优化时被更改。

<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>

=== map_replace_image ===

 示例：map_replace_image ''map_file1'' ''map_file2'' ''imagename'' ''image_file''

<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>

=== map_resave ===

 示例：map_resave ''map_file'' ''image_file''

<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>

=== packetgen ===

 示例：packetgen

<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>

=== unicode_confusables ===

 示例：unicode_confusables ''string1'' ''string2''

<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>

=== uuid ===

 示例：uuid ''name''

<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>