WESNOTH(6)

名称
wesnoth - 韦诺之战（Battle for Wesnoth），一个回合制奇幻策略游戏

摘要
wesnoth [选项] [数据路径]

描述
韦诺之战（Battle for Wesnoth）是一个回合制奇幻策略游戏。 用精心挑选的部队打败所有的敌方首领，管理好您的金币和村庄。所有单位都有自己的优势和缺陷：要取得胜利，必须发挥出您的部队的优势，同时阻止您的对手这么做。随着单位获得经验，他们会学会新的技能，变得更强大。使用您的语言进行游戏，通过与聪明的计算机对手对抗来测试自己的技能，当然也可以加入韦诺的在线玩家大社区。您还可以创建自己的单位，场景和战役，并与其他玩家分享。

选项

--all-translations
    在游戏中的语言选择列表中显示所有翻译，哪怕这些翻译被认为不够完整，也一样显示。

--bunzip2 infile.bz2
    解压缩应为bzip2格式的文件，解压后去掉.bz2后缀。文件infile.bz2将被删除。

--bzip2 infile
    将infile压缩为bzip2格式文件，文件名为infile.bz2。文件infile将被删除。

-c[id_campaign], --campaign[=id_campaign]
    直接进入ID为 id_campaign 的战役。如果没有指定ID，则会出现选择菜单。

--campaign-difficulty[=difficulty]
    指定战役的难度（从1到该战役的最大难度）。如果没有指定，则会出现战役难度选择界面。

--campaign-scenario id_scenario
    指定战役中的场景ID。默认为第一幕场景。

--campaign-skip-story
    在start事件最后跳过[故事]画面和对话框。

--clock
    增加一个选项，显示一个时钟，用于测试画面绘制计时器。

--config-dir name
    已废弃，请使用--userdata-dir。

--config-path
    已废弃，请使用--userdata-path。

--core id_core
    使用指定ID对应的核心作为应读取的核心。

--data-dir directory
    使用指定的目录作为数据目录

--data-path
    打印数据目录的路径并退出。

-d, --debug
    在游戏中启用额外的命令模式选项。（关于命令模式的更多信息请参阅wiki页面：http://www.wesnoth.org/wiki/CommandMode）

--debug-lua
    启用一些Lua调试机制

-e[file], --editor[=file]
    直接启动游戏内置的地图编辑器。如果指定了file，则和 -l --load.等价。

--fps
    在屏幕的一角显示游戏当前的每秒帧数（FPS）。

-f, --fullscreen
    使用全屏模式运行游戏。

--gunzip infile.gz
    解压缩应为gzip格式的文件，解压后去掉.gz后缀。文件infile.gz将被删除。

--gzip infile
    将infile压缩为gzip格式文件，文件名为infile.gz。文件infile将被删除。

-h, --help
    在标准输出上显示命令行选项的概述，并退出。

-l, --load file
    从标准游戏存档目录读取存档 file 。如果与 -e 或 --editor 选项同时使用，则启动地图编辑器并打开来自 file 的地图。如果是一个目录，则编辑器启动后自动打开读取地图对话框并定位到该目录。

-L, --language lang
    在本次游戏期间使用语言 lang （符号）。例如： --language ang_GB@latin

--log-level=domain1,domain2,...
    设置日志域的严重度级别。all可以用来匹配任意日志域。可选的级别有：error， warning， info， debug, none。对大多数日志域而言，默认日志级别是warning，但deprecation的默认级别是none，除非和-d选项并用。

--log-precise
    在日志文件中显示更高精度的时间戳。

--log-strict
    设置日志记录器的严格度等级。若有任何信息记入此等级或更高等级日志域，则不论测试结果如何，单元测试都将失败。只有在和 -u 共同使用时才有意义。

--logdomains[=filter]
    列出游戏中定义的日志域（如果使用了 filter 则只列出饱含该字符串的日志域）而后退出

--max-fps fps
    游戏每秒能显示的帧数，这个值应该在1和1000之间，默认为显示器的刷新率。

-m, --multiplayer
    运行一次多人游戏。有更多选项可以与 --multiplayer 一起使用，详见下述。

--mp-test
    读取测试用多人游戏场景。

--new-widgets
    现在有一个正在制作中的窗口部件工具库，此选项将启用此工具库。这个工具库还处在很早期的试验阶段，请不要发起缺陷报告，因为大多数缺陷是已知的。库的一部分被认为是稳定的，即使不使用本开关也会启用。

--nodelay
    无延迟地运行游戏，以执行图像基准测试。使用 --nogui 时会自动启用本选项。

--noaddons
    禁止读取用户附加组件。

--nocache
    禁止建立游戏数据的缓存。

--nogui
    运行游戏，但不运行图形界面。只能与 --multiplayer 或 --screenshot 或 --plugin 组合使用。

--nomusic
    以无音乐的方式运行游戏。

--noreplaycheck
    不尝试检查单元测试录像的有效性。只有在和 -u 共同使用时才有意义。

--nosound
    以无音乐和音效的方式运行游戏。

--password password
    在连接服务器时使用 password ，忽略其他首选项。不安全。

--plugin script
    （试验性）读取定义了韦诺插件的 script。与--script类似，但Lua文件应返回一个函数，该函数将作为协程运行，并周期性地使用更新地参数唤起。

-p, --preprocess source-file/folder target-directory
    预处理指定的文件/文件夹。针对每个文件，一个未处理的.cfg文件和一个处理过的.cfg文件会被写入指定的目标目录中。如果指定的是个文件夹，那么将根据已知的预处理器规则递归地预处理之。“data/core/macros”目录中的常用宏会在指定的资源之前被预处理。例如： -p ~/wesnoth/data/campaigns/tutorial ~/result. 有关预处理器的详情请见：http://wiki.wesnoth.org/PreprocessorRef#Command-line_preprocessor。

--preprocess-defines=DEFINE1,DEFINE2,...
    由逗号分隔的定义列表，用于 --preprocess 指令。如果SKIP_CORE在定义列表中，则“data/core”目录不会被预处理。

--preprocess-input-macros source-file
    仅供 --preprocess 命令使用。用于指定一个包含了一个或多个 [preproc_define] 的文件，其中的定义将在预处理开始前生效。

--preprocess-output-macros[=target-file]
    仅供 --preprocess 命令使用。将会输出目标文件中所有经过了预处理的宏。如果没有指定文件，那么目标文件将是preprocess命令所指定的目标目录中的“_MACROS_.cfg”。输出文件可传递给 --preprocess-input-macros 。这个开关选项必须出现在 --preprocess 命令之前。

--proxy
    启用代理服务器来进行网络连接。

--proxy-address address
    指定代理服务器的地址。

--proxy-port port
    指定代理服务器的端口。

--proxy-user username
    指定用于登录代理服务器的用户名。

--proxy-password password
    指定用于登录代理服务器的密码。

-r XxY, --resolution XxY
    设定屏幕分辨率。例如：-r 800x600。

--render-image image output
    以一个合法的包含图像路径函数的韦诺“图像路径字符串”作为传入值，并输出一个.png文件。图像路径函数的文档位于https://wiki.wesnoth.org/ImagePathFunctionWML。

-R, --report
    初始化游戏目录，打印适用于缺陷报告的构建信息，并退出。

--rng-seed number
    使用 <arg> 作为随机数生成器的种子。例如：--rng-seed 0。

--screenshot map output
    将 map 的截图存入 output 而不初始化屏幕显示。

--script file
    （试验性）指定一个文件，其中包含了用于控制客户端的Lua脚本。

-s[host], --server[=host]
    如果指定了主机的话，连接到指定的主机。否则，连接到首选项中的第一个服务器。例如：--server server.wesnoth.org。

--showgui
    以有图形界面的方式运行游戏，此选项将覆盖所有隐含的 --nogui 。

--strict-validation
    将验证错误视为致命错误。

-t[scenario_id], --test[=scenario_id]
    在小型测试场景中运行游戏。该场景应使用 [test] WML标签定义。默认为 test 。可使用 micro_ai_test 启动对 [micro_ai] 特性的演示。此选项隐含 --nogui 。

--translations-over percent
    将确认翻译是否足够完整的判断标准设为percent，合法的值为0到100。

-u, --unit scenario-id
    将指定的测试场景作为单元测试运行。此选项隐含 --nogui 。

--unsafe-scripts
    使得package包在Lua脚本中可用，这样一来Lua脚本就可以载入任意包了。请不要对不可信的脚本使用此选项！此操作将赋予Lua与韦诺可执行文件相同的权限。

--userconfig-dir name
    设置用户配置目录为$HOME或者Windows下“我的文档我的游戏（My Documents\My Games）”下的name目录。也可以为配置目录指定一条绝对路径，此路径可以在$HOME或者“My Documents\My Games”之外。在Windows下，也可以使用以“.\”或“..\”开头的路径来指定相对于游戏进程工作目录的目录。在X11下，配置目录默认为$XDG_CONFIG_HOME或者$HOME/.config/wesnoth。在其他系统上，配置目录默认为用户数据目录。

--userconfig-path
    输出用户配置目录的路径并退出。

--userdata-dir name
    设置用户数据目录为$HOME或者Windows下“我的文档我的游戏（My Documents\My Games）”下的name目录。也可以为配置目录指定一条绝对路径，此路径可以在$HOME或者“My Documents\My Games”之外。在Windows下，也可以使用以“.\”或“..\”开头的路径来指定相对于游戏进程工作目录的目录。

--userdata-path
    打印用户数据目录的路径并退出。

--username username
    在连接服务器时使用 username ，忽略其他首选项。

--validcache
    假定缓存是有效的。（因此不进行缓存验证，危险）

-v, --version
    显示版本号并退出。

-w, --windowed
    使用窗口模式进入游戏。

--with-replay
    通过和--load选项一起使用，播放游戏录像。

--multiplayer的额外选项
多人游戏中特定于某一个阵营的选项用number标记。number要用代表某个阵营的数字替换。这个数字一般是1或者2，不过这取决于所选定场景中的玩家数量。

--ai-config number:value
    为该阵营的AI控制者选择一个配置文件来读取。

--algorithm number:value
    为该阵营的AI控制者选择一个非标准的算法。该算法以 [ai] 标签定义，可以是在核心游戏的“data/ai/ais”或“data/ai/dev”中定义的算法，也可以是在附加组件中定义的算法。可选值有：idle_ai 和 experimental_ai。

--controller number:value
    选择该阵营的控制者。可选值有：human，ai和null。

--era value
    使用这个选项来选择一个时代以代替默认时代。所选时代由id确定。时代信息在data/multiplayer/eras.cfg文件中描述。

--exit-at-end
    当场景结束时直接退出游戏，而不显示通常需要用户点击“结束场景”的胜利/失败对话框。这也可以用来进行脚本化的性能基准测试。

--ignore-map-settings
    不使用地图设置，而使用默认值。

--label label
    设定AI的标签。

--multiplayer-repeat value
    重复进行多人游戏value次。最好与--nogui同用于可脚本化的性能测试。

--parm number:name:value
    为该阵营设定附加参数。这个参数依赖于--controller和--algorithm的配置情况。这个选项应该只对自己设计AI的人比较有用。（目前还没有完整的文档）

--scenario value
    通过id选择多人游戏地图。默认地图id是multiplayer_The_Freelands。

--side number:value
    为当前阵营选择当前时代中的一个派系。所选派系由id决定。派系在文件data/multiplayer.cfg文件中描述。

--turns value
    设置所选场景的回合数限制。默认无限制。

退出状态码
正常退出时的状态码为0。退出状态码1代表发生了（SDL、视频、字体等）初始化错误。退出状态码2代表命令行选项中有错误。
When running unit tests (with -u), the exit status is different. An exit status of 0 indicates that the test passed, and 1 indicates that the test failed. An exit status of 3 indicates that the test passed, but produced an invalid replay file. An exit status of 4 indicates that the test passed, but the replay produced errors. These latter two are only returned if --noreplaycheck is not passed.

作者
由David White <davidnwhite@verizon.net> 编写。
经Nils Kneuper <crazy-ivanovic@gmx.net>，ott <ott@gaon.net> 和 Soliton <soliton.de@gmail.com> 编辑。
这个手册页最初由 Cyril Bouthors <cyril@bouthors.org> 编写。
请访问官方主页：https://www.wesnoth.org/

版权
版权所有 © 2003-2018 David White <davidnwhite@verizon.net>
这是一款自由软件，使用由自由软件基金会发布的GPL版本2协议授权。使用本软件时*不*提供任何保证，甚至没有对“可销售性”和“针对某一特别目的之可用性”的保证。本段中文翻译不具有法律效力，只有GPL英文原本才具有法律效力。

参见
wesnothd(6)