.\" This program is free software; you can redistribute it and/or modify .\" it under the terms of the GNU General Public License as published by .\" the Free Software Foundation; either version 2 of the License, or .\" (at your option) any later version. .\" .\" This program is distributed in the hope that it will be useful, .\" but WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the .\" GNU General Public License for more details. .\" .\" You should have received a copy of the GNU General Public License .\" along with this program; if not, write to the Free Software .\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA .\" . .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH WESNOTH 6 2022 wesnoth 韦诺之战 . .SH 名称 wesnoth \- 韦诺之战（Battle for Wesnoth），一款回合制奇幻策略游戏 . .SH 摘要 . \fBwesnoth\fP [\fI选项\fP] [\fI数据路径\fP] . .SH 描述 . 韦诺之战（Battle for \fBWesnoth\fP）是一个回合制奇幻策略游戏。 用精心挑选的部队打败所有的敌方首领，管理好您的金币和村庄。所有单位都有自己的优势和缺陷：要取得胜利，必须发挥出您的部队的优势，同时阻止您的对手这么做。随着单位获得经验，他们会学会新的技能，变得更强大。使用您的语言进行游戏，通过与聪明的计算机对手对抗来测试自己的技能，当然也可以加入韦诺的在线玩家大社区。您还可以创建自己的单位，场景和战役，并与其他玩家分享。 . .SH 选项 . .TP \fB\-\-all\-translations\fP 在游戏中的语言选择列表中显示所有翻译，哪怕这些翻译被认为不够完整，也一样显示。 .TP \fB\-c[\fP\fIid_campaign\fP\fB],\ \-\-campaign[\fP\fI=id_campaign\fP\fB]\fP 直接进入ID为 \fIid_campaign\fP 的战役。如果没有指定ID，则会出现选择菜单。 .TP \fB\-\-campaign\-difficulty[\fP\fI=difficulty\fP\fB]\fP 指定战役的难度（从1到该战役的最大难度）。如果没有指定，则会出现战役难度选择界面。 .TP \fB\-\-campaign\-scenario\fP\fI\ id_scenario\fP 指定战役中的场景ID。默认为第一幕场景。 .TP \fB\-\-campaign\-skip\-story\fP 在\fBstart\fP事件最后跳过[故事]画面和对话框。 .TP \fB\-\-clock\fP Adds the option to show a clock for testing the drawing timer. Also adds the option for showing the GUI Test Dialog. .TP \fB\-\-core\fP\fI\ id_core\fP 使用指定ID对应的核心作为应读取的核心。 .TP \fB\-\-data\-dir\fP\fI\ directory\fP 使用指定的目录作为数据目录 .TP \fB\-\-data\-path\fP 打印数据目录的路径并退出。 .TP \fB\-d, \-\-debug\fP 在游戏中启用额外的命令模式选项。（关于命令模式的更多信息请参阅wiki页面：http://www.wesnoth.org/wiki/CommandMode） .TP \fB\-\-debug\-lua\fP 启用一些Lua调试机制 .TP \fB\-\-strict\-lua\fP 禁用已废弃的Lua API调用 .TP \fB\-D,\ \-\-diff\fP\fI\ left\-file\fP\fB\ \fP\fIright\-file\fP 产生这两个WML文件的diff，不会对这两个文件先进行预处理（若要进行预处理，请对它们执行\fB\-p\fP命令）。将diff以DiffWML格式输出到标准输出或由\fI\-\-output\fP指定的文件中。 .TP \fB\-e[\fP\fIfile\fP\fB],\ \-\-editor[\fP\fI=file\fP\fB]\fP 直接启动游戏内置的地图编辑器。如果指定了\fIfile\fP，则和 \fB\-l\fP \fB\-\-load\fP.等价。 .TP \fB\-\-fps\fP 在屏幕的一角显示游戏当前的每秒帧数（FPS），并将这些数值写入玩家数据目录中的一个文件里。 .TP \fB\-f, \-\-fullscreen\fP 使用全屏模式运行游戏。 .TP \fB\-h, \-\-help\fP 在标准输出上显示命令行选项的概述，并退出。 .TP \fB\-l,\ \-\-load\fP\fI\ file\fP 从标准游戏存档目录读取存档 \fIfile\fP 。如果与 \fB\-e\fP 或 \fB\-\-editor\fP 选项同时使用，则启动地图编辑器并打开来自 \fIfile\fP 的地图。如果是一个目录，则编辑器启动后自动打开读取地图对话框并定位到该目录。 .TP \fB\-L,\ \-\-language\fP\fI\ lang\fP 在本次游戏期间使用语言 \fIlang\fP （符号）。例如： \fB\-\-language ang_GB@latin\fP .TP \fB\-\-log\-\fP\fIlevel\fP\fB=\fP\fIdomain1\fP\fB,\fP\fIdomain2\fP\fB,\fP\fI...\fP 设置日志域的严重度级别。\fBall\fP可以用来匹配任意日志域。可选的级别有：\fBerror\fP，\ \fBwarning\fP，\ \fBinfo\fP，\ \fBdebug\fP, \ \fBnone\fP。对大多数日志域而言，默认日志级别是\fBwarning\fP，但\fBdeprecation\fP的默认级别是\fBnone\fP，除非和\fB\-d\fP选项并用。 .TP \fB\-\-log\-precise\fP 在日志输出中显示更高精度的时间戳。 .TP \fB\-\-log\-strict\fP\fI\ level\fP sets the strict \fIlevel\fP of the logger. Any messages sent to log domains of this \fIlevel\fP or more severe will cause the unit test to fail regardless of the victory result. Only relevant when used with \fB\-u\fP. .TP \fB\-\-logdomains[\fP\fI=filter\fP\fB]\fP 列出游戏中定义的日志域（如果使用了 \fIfilter\fP 则只列出饱含该字符串的日志域）而后退出 .TP \fB\-\-no\-log\-to\-file\fP prevents redirecting logged output to a file. The environment variable WESNOTH_NO_LOG_FILE can also be set as an alternative. Log files are created in the logs directory under the userdata folder. .TP \fB\-\-log\-to\-file\fP log output is written to a file. Cancels the effect of \-\-no\-log\-to\-file whether implicit or explicit. .TP \fB\-\-no\-log\-sanitize\fP disables the anonymization that's normally applied when logging, for example replacing usernames with USER. .TP \fB\-\-wnoconsole\fP For Windows, when used with \-\-no\-log\-to\-file, results in output being written to cerr/cout instead of CONOUT. Otherwise, does nothing. .TP \fB\-\-max\-fps\fP\fI\ fps\fP 游戏每秒能显示的帧数，这个值应该在\fB1\fP和\fB1000\fP之间，默认为显示器的刷新率。 .TP \fB\-m, \-\-multiplayer\fP 运行一次多人游戏。有更多选项可以与 \fB\-\-multiplayer\fP 一起使用，详见下述。 .TP \fB\-\-mp\-test\fP 读取测试用多人游戏场景。 .TP \fB\-\-new\-widgets\fP 现在有一个正在制作中的窗口部件工具库，此选项将启用此工具库。这个工具库还处在很早期的试验阶段，请不要发起缺陷报告，因为大多数缺陷是已知的。库的一部分被认为是稳定的，即使不使用本开关也会启用。 .TP \fB\-\-noaddons\fP 禁止读取用户附加组件。 .TP \fB\-\-nocache\fP 禁止建立游戏数据的缓存。 .TP \fB\-\-nogui\fP 运行游戏，但不运行图形界面。只能与 \fB\-\-multiplayer\fP 或 \fB\-\-screenshot\fP 或 \fB\-\-plugin\fP 组合使用。 .TP \fB\-\-nobanner\fP 跳过启动时的封面图像。 .TP \fB\-\-nomusic\fP 以无音乐的方式运行游戏。 .TP \fB\-\-noreplaycheck\fP 不尝试检查单元测试录像的有效性。只有在和 \fB\-u\fP 共同使用时才有意义。 .TP \fB\-\-nosound\fP 以无音乐和音效的方式运行游戏。 .TP \fB\-\-output\fP\fI\ file\fP 输出到指定的文件中。对diff操作适用。 .TP \fB\-\-password\fP\fI\ password\fP 在连接服务器时使用 \fIpassword\fP ，忽略其他首选项。不安全。 .TP \fB\-\-plugin\fP\fI\ script\fP （实验性）读取定义了韦诺插件的 \fIscript\fP。与\fB\-\-script\fP类似，但Lua文件应返回一个函数，该函数将作为协程运行，并周期性地使用更新地参数唤起。 .TP \fB\-P,\ \-\-patch\fP\fI\ base\-file\fP\fB\ \fP\fIpatch\-file\fP 将DiffWML补丁应用到WML文件上，不会预处理这两个文件中的任何一个。将打过补丁的WML输出到标准输出或由\fI\-\-output\fP指定的文件中。 .TP \fB\-p,\ \-\-preprocess\fP\fI\ source\-file/folder\fP\fB\ \fP\fItarget\-directory\fP 预处理指定的文件/文件夹。针对每个文件，一个未处理的.cfg文件和一个处理过的.cfg文件会被写入指定的目标目录中。如果指定的是个文件夹，那么将根据已知的预处理器规则递归地预处理之。“data/core/macros”目录中的常用宏会在指定的资源之前被预处理。例如： \fB\-p ~/wesnoth/data/campaigns/tutorial ~/result.\fP 有关预处理器的详情请见：http://wiki.wesnoth.org/PreprocessorRef#Command\-line_preprocessor。 .TP \fB\-\-preprocess\-string\fP\fI\ source\-string\fP preprocesses a given string and writes the output to stdout. .TP \fB\-\-preprocess\-defines=\fP\fIDEFINE1\fP\fB,\fP\fIDEFINE2\fP\fB,\fP\fI...\fP comma separated list of defines to be used by the \fB\-\-preprocess\fP or \fB\-\-preprocess\-string\fP command. If \fBSKIP_CORE\fP is in the define list the "data/core" directory won't be preprocessed. .TP \fB\-\-preprocess\-input\-macros\fP\fI\ source\-file\fP used only by the \fB\-\-preprocess\fP or \fB\-\-preprocess\-string\fP command. Specifies a file that contains \fB[preproc_define]\fPs to be included before preprocessing. .TP \fB\-\-preprocess\-output\-macros[\fP\fI=target\-file\fP\fB]\fP used only by the \fB\-\-preprocess\fP command (But not by the \fB\-\-preprocess\-string\fP command). Will output all preprocessed macros in the target file. If the file is not specified the output will be file \&'_MACROS_.cfg' in the target directory of preprocess's command. The output file can be passed to \fB\-\-preprocess\-input\-macros\fP. This switch should be typed before the \fB\-\-preprocess\fP command. .TP \fB\-r\ \fP\fIX\fP\fBx\fP\fIY\fP\fB,\ \-\-resolution\ \fP\fIX\fP\fBx\fP\fIY\fP 设定屏幕分辨率。例如：\fB\-r\fP \fB800x600\fP。 .TP \fB\-\-render\-image\fP\fI\ image\fP\fB\ \fP\fIoutput\fP 以一个合法的包含图像路径函数的韦诺“图像路径字符串”作为传入值，并输出一个.png文件。图像路径函数的文档位于https://wiki.wesnoth.org/ImagePathFunctionWML。 .TP \fB\-R,\ \-\-report\fP 初始化游戏目录，打印适用于缺陷报告的构建信息，并退出。 .TP \fB\-\-rng\-seed\fP\fI\ number\fP 使用 作为随机数生成器的种子。例如：\fB\-\-rng\-seed\fP \fB0\fP。 .TP \fB\-\-screenshot\fP\fI\ map\fP\fB\ \fP\fIoutput\fP 将 \fImap\fP 的截图存入 \fIoutput\fP 而不初始化屏幕显示。 .TP \fB\-\-script\fP\fI\ file\fP （试验性）指定一个\fB文件\fP，其中包含了用于控制客户端的Lua脚本。 .TP \fB\-s[\fP\fIhost\fP\fB],\ \-\-server[\fP\fI=host\fP\fB]\fP 如果指定了主机的话，连接到指定的主机。否则，连接到首选项中的第一个服务器。例如：\fB\-\-server\fP \fBserver.wesnoth.org\fP。 .TP \fB\-\-showgui\fP 以有图形界面的方式运行游戏，此选项将覆盖所有隐含的 \fB\-\-nogui\fP 。 .TP \fB\-\-strict\-validation\fP 将验证错误视为致命错误。 .TP \fB\-t[\fP\fIscenario_id\fP\fB],\ \-\-test[\fP\fI=scenario_id\fP\fB]\fP runs the game in a small test scenario. The scenario should be one defined with a \fB[test]\fP WML tag. The default is \fBtest\fP. A demonstration of the \fB[micro_ai]\fP feature can be started with \fBmicro_ai_test\fP. .TP \fB\-\-translations\-over\fP\fI\ percent\fP 将确认翻译是否足够完整的判断标准设为\fIpercent\fP，合法的值为0到100。 .TP \fB\-u,\ \-\-unit\fP\fI\ scenario\-id\fP 将指定的测试场景作为单元测试运行。此选项隐含 \fB\-\-nogui\fP 。 .TP \fB\-\-unsafe\-scripts\fP 使得\fBpackage\fP包在Lua脚本中可用，这样一来Lua脚本就可以载入任意包了。请不要对不可信的脚本使用此选项！此操作将赋予Lua与韦诺可执行文件相同的权限。 .TP \fB\-S,\ \-\-use\-schema\fP\fI\ path\fP sets the WML schema for use with \fB\-V,\ \-\-validate\fP. .TP \fB\-\-userdata\-dir\fP\fI\ name\fP 设置用户数据目录为$HOME或者Windows下“我的文档\我的游戏（My Documents\eMy Games）”下的\fIname\fP目录。也可以为配置目录指定一条绝对路径，此路径可以在$HOME或者“My Documents\eMy Games”之外。在Windows下，也可以使用以“.\e”或“..\e”开头的路径来指定相对于游戏进程工作目录的目录。 .TP \fB\-\-userdata\-path\fP 打印用户数据目录的路径并退出。 .TP \fB\-\-username\fP\fI\ username\fP 在连接服务器时使用 \fIusername\fP ，忽略其他首选项。 .TP \fB\-\-validate\fP\fI\ path\fP 使用WML schema来验证文件。 .TP \fB\-\-validate\-addon\fP\fI\ addon_id\fP 在游戏过程中，验证指定附加组件的WML。 .TP \fB\-\-validate\-core\fP 在游戏过程中，验证核心WML。 .TP \fB\-\-validate\-schema\fP\fI\ path\fP 验证文件是否为合法的WML schema。 .TP \fB\-\-validcache\fP 假定缓存是有效的。（因此不进行缓存验证，危险） .TP \fB\-v, \-\-version\fP 显示版本号并退出。 .TP \fB\-\-simple\-version\fP 仅显示版本号而不显示其他信息，之后退出。 .TP \fB\-w, \-\-windowed\fP 使用窗口模式进入游戏。 .TP \fB\-\-with\-replay\fP 通过和\fB\-\-load\fP选项一起使用，播放游戏录像。 . .SH \-\-multiplayer的额外选项 . 多人游戏中特定于某一个阵营的选项用\fInumber\fP标记。\fInumber\fP要用代表某个阵营的数字替换。这个数字一般是1或者2，不过这取决于所选定场景中的玩家数量。 .TP \fB\-\-ai\-config\fP\fI\ number\fP\fB:\fP\fIvalue\fP 为该阵营的AI控制者选择一个配置文件来读取。 .TP \fB\-\-algorithm\fP\fI\ number\fP\fB:\fP\fIvalue\fP 为该阵营的AI控制者选择一个非标准的算法。该算法以 \fB[ai]\fP 标签定义，可以是在核心游戏的“data/ai/ais”或“data/ai/dev”中定义的算法，也可以是在附加组件中定义的算法。可选值有：\fBidle_ai\fP 和 \fBexperimental_ai\fP。 .TP \fB\-\-controller\fP\fI\ number\fP\fB:\fP\fIvalue\fP 选择该阵营的控制者。可选值有：\fBhuman\fP，\fBai\fP和\fBnull\fP。 .TP \fB\-\-era\fP\fI\ value\fP 使用这个选项来选择一个时代以代替\fB默认\fP时代。所选时代由id确定。时代信息在\fBdata/multiplayer/eras.cfg\fP文件中描述。 .TP \fB\-\-exit\-at\-end\fP 当场景结束时直接退出游戏，而不显示通常需要用户点击“结束场景”的胜利/失败对话框。这也可以用来进行脚本化的性能基准测试。 .TP \fB\-\-ignore\-map\-settings\fP 不使用地图设置，而使用默认值。 .TP \fB\-\-label\fP\fI\ label\fP 设定AI的\fB标签\fP。 .TP \fB\-\-multiplayer\-repeat\fP\fI\ value\fP 重复进行多人游戏\fIvalue\fP次。最好与\fB\-\-nogui\fP同用于可脚本化的性能测试。 .TP \fB\-\-parm\fP\fI\ number\fP\fB:\fP\fIname\fP\fB:\fP\fIvalue\fP 为该阵营设定附加参数。这个参数依赖于\fB\-\-controller\fP和\fB\-\-algorithm\fP的配置情况。这个选项应该只对自己设计AI的人比较有用。（目前还没有完整的文档） .TP \fB\-\-scenario\fP\fI\ value\fP 通过id选择多人游戏地图。默认地图id是\fBmultiplayer_The_Freelands\fP。 .TP \fB\-\-side\fP\fI\ number\fP\fB:\fP\fIvalue\fP 为当前阵营选择当前时代中的一个派系。所选派系由id决定。派系在文件data/multiplayer.cfg文件中描述。 .TP \fB\-\-turns\fP\fI\ value\fP 设置所选场景的回合数限制。默认无限制。 . .SH 退出状态码 . 正常退出时的状态码为0。退出状态码1代表发生了（SDL、视频、字体等）初始化错误。退出状态码2代表命令行选项中有错误。 .br 运行单元测试（使用 \fB\ \-u\fP 时），退出状态码是不同的。退出状态码0代表测试通过，而1代表测试失败。退出状态码3代表测试通过，但生成了无效的录像文件。退出状态码4代表测试通过，但录像中产生了错误。后两个状态码仅在不传入 \fB\-\-noreplaycheck\fP 参数时才会返回。 . .SH 作者 . 由David White 编写。 .br 经Nils Kneuper ，ott 和 Soliton 编辑。 .br 这个手册页最初由 Cyril Bouthors 编写。 .br 请访问官方主页：https://www.wesnoth.org/ . .SH 版权 . Copyright \(co 2003\-2024 David White .br 这是一款自由软件，使用由自由软件基金会发布的GPL版本2协议授权。使用本软件时*不*提供任何保证，甚至没有对“可销售性”和“针对某一特别目的之可用性”的保证。本段中文翻译不具有法律效力，只有GPL英文原本才具有法律效力。 . .SH 参见 . \fBwesnothd\fP(6)