wesnoth/doc/man/zh_TW/wesnoth.6

.\" 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 \- 韋諾之戰，一個回合制奇幻風格的策略遊戲
.
.SH 摘要
.
\fBwesnoth\fP [\fIOPTIONS\fP] [\fIPATH_TO_DATA\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 事件最後跳過 [story] 畫面及對話框。
.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 檔案的差異，但不會預處理它們（要處理的話，先透過 \fB\-p\fP 執行它們）。以 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
在螢幕一角顯示遊戲目前是以多少每秒影格數來運行，並且將這些數值寫進存放在使用者資料目錄內的一個檔案中。
.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
在 Windows 系統下，當使用 \-\-no\-log\-to\-file 時，會將輸出寫入 cerr/cout 而不是 CONOUT。否則，不會有任何作用。
.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
有新的 WIP 物件工具，這個選項會啟用它。這個功能非常地具有實驗性，大部分的 Bug 是已知的，所以請勿回報任何
Bug。部分函式庫被認為是穩定的，即使不開啟這個選項也會動作。
.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
輸出到指定的檔案。適合用於差異操作。
.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
檔將會被寫入至指定的目標目錄中。如果有指定目錄，將會遞迴地按照已知的預處理規則預先處理。「data/core/macros」目錄裡的共用巨集將在指定資源之前被預先處理。例如：\fB\-p ~/wesnoth/data/campaigns/tutorial ~/result.\fP。關於預先處理器的細節請參閱：https://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
將亂數產生器的種子設定為 \fInumber\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
（實驗性）\fIfile\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
在小型測試章節中執行遊戲。該章節應是有用一個 \fB[test]\fP WML 標籤定義的章節。預設為 \fBtest\fP。\fB[micro_ai]\fP
的展示功能可以用 \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。
.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)底下設定使用者資料目錄為 \fIname\fP 。你也可以為使用者資料目錄設定一個在 $HOME
或「我的文件\我的遊戲」之外的絕對路徑。在 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 格式。
.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 格式來驗證。
.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 設定 \fIlabel\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 <davidnwhite@verizon.net>編寫。
.br
經 Nils Kneuper <crazy\-ivanovic@gmx.net>, ott <ott@gaon.net>
and Soliton <soliton.de@gmail.com> 更動。
.br
這個手冊最早由 Cyril Bouthors <cyril@bouthors.org> 編寫。
.br
拜訪官方網站：http://www.wesnoth.org/
.
.SH 著作權
.
Copyright \(co 2003\-2024 David White <davidnwhite@verizon.net>
.br
這是一個自由軟體，這個軟體採用由自由軟體協會(FSF)所發佈的GPLv2授權協議。沒有保證，甚至對「可銷售性」和「對某一特定目的的適用性」也沒有保證。本段翻譯文字不具法律效力，如有需要請參閱原文或者是
GPLv2 授權條款。
.
.SH 參見
.
\fBwesnothd\fP(6)