Man page - wesnoth-1.18(6)

Packages contains this manual

Package: wesnoth-1.18
apt-get install wesnoth-1.18

Manuals in package:

Available languages:

en fr pt_BR es it ca cs tr sk bg ja en_GB ru zh_TW zh_CN de

Manual

WESNOTH

名称
摘要
描述
选项
--multiplayer的额外选项
退出状态码
作者
版权
参见

名称

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调试机制

--strict-lua

禁用已废弃的 Lua API调用

-D,--diff left-file right-file

产生这两个 WML文件的 diff，不会对这两个文件先进行预处理（若要进行预处理，请对它们执行 -p 命令）。将 diff以 DiffWML格式输出到标准输出或由 --output 指定的文件中。

-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 则只列出饱含该字符串的日志域）而后退出

--no-log-to-file

prevents redirecting logged output to a file. Log files are created in the logs directory under the userdata folder.

--log-to-file

log output is written to a file. Cancels the effect of --no-log-to-file whether implicit or explicit.

--wnoconsole

For Windows, when used with --no-log-to-file, results in output being written to cerr/cout instead of CONOUT. Otherwise, does nothing.

--max-fps fps

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

-m, --multiplayer

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

--mp-test

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

--new-widgets

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

--nodelay

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

--noaddons

禁止读取用户附加组件。

--nocache

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

--nogui

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

--nobanner

跳过启动时的封面图像。

--nomusic

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

--noreplaycheck

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

--nosound

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

--output file

输出到指定的文件中。对 diff操作适用。

--password password

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

--plugin script

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

-P,--patch base-file patch-file

将 DiffWML补丁应用到 WML文件上，不会预处理这两个文件中的任何一个。将打过补丁的 WML输出到标准输出或由 --output 指定的文件中。

-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 命令之前。

-r X x Y , --resolution X x Y

设定屏幕分辨率。例如： -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 ]

runs the game in a small test scenario. The scenario should be one defined with a [test] WML tag. The default is test . A demonstration of the [micro_ai] feature can be started with micro_ai_test .

--translations-over percent

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

-u, --unit scenario-id

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

--unsafe-scripts

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

-S,--use-schema path

设置 -V,--validate 所使用的 WML schema。

--userconfig-dir name

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

--userdata-path

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

--username username

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

--validate path

使用 WML schema来验证文件。

--validate-addon addon_id

在游戏过程中，验证指定附加组件的 WML。

--validate-core

在游戏过程中，验证核心 WML。

--validate-schema path

验证文件是否为合法的 WML schema。

--validcache

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

-v, --version

显示版本号并退出。

--simple-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代表命令行选项中有错误。
运行单元测试（使用 -u 时），退出状态码是不同的。退出状态码 0代表测试通过，而 1代表测试失败。退出状态码 3代表测试通过，但生成了无效的录像文件。退出状态码 4代表测试通过，但录像中产生了错误。后两个状态码仅在不传入 --noreplaycheck 参数时才会返回。

作者

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

版权

参见

wesnothd (6)