WESNOTHD(6)

命名
wesnothd - 韋諾之戰 Wesnoth 多人游戲伺服器

摘要
wesnothd [-dv] [-c path] [-p port] [-t number] [-T number]
wesnothd -V

描述
控制韋諾之戰多人遊戲。 官方wiki上的ServerAdministration頁面上取得更多可以經由韋諾之戰客戶端或者socket在伺服器上運行的指令。連結wiki: http://www.wesnoth.org/wiki/ServerAdministration

選項

-c path, --config path
    指定韋諾找到的檔案配置目錄。下面的SERVER CONFIG通過發送SIGHUP信號給伺服器程序可以重新裝載檔案配置。

-d, --daemon
    以安全模式執行韋諾。

-h, --help
    顯示指令的功用。

--log-level=domain1,domain2,...
    設定日誌記錄的類別。all可以用來支援任何日誌域的類別。可選的類別有：error, warning, info, debug。預設的類別是error，對server域預設類別是info。

-p port, --port port
    設定伺服器到指定的埠。如果不指定埠將使用15000。

-t number, --threads number
    設定網路I/O的最大等待工作流程數為 n (預設值為5， 最大值為 30)。

-T number, --max-threads number
    允許創造最大等待工作流程數。如果設定為0則不限制流程數（預設值：0）

-V, --version
    顯示版本並退出。

-v, --verbose
    開啟偵測日誌記錄。

伺服器設定

  常用語法是:

[tag]

    key="value"

    key="value,value,..."

[/tag]

  全球關鍵字:

allow_remote_shutdown
    如果設置為 no （預設值），shut_down（關閉）和restart（重啟）請求將被忽略，除非這些請求來自於fifo。如果設為 yes 則允許管理員透過 /query 遠程關閉。

ban_save_file
    一個伺服器可讀可寫的（經gzip壓縮的）檔案的完整路徑或相對路徑。封禁訊息會自動保存在這個檔案裡，並在伺服器啟動時讀取。

compress_stored_rooms
    指定房間檔案是否應該以壓縮形式讀寫。預設值為yes。

connections_allowed
    同一IP允許的連接數。(預設值：5)

disallow_names
    伺服器不允許使用的使用者名稱／暱稱。支援使用 *和?這兩個萬用字元。更多資料請查看 glob(7) 。預設值(如果使用者沒有指定則自動使用)是：*admin*,*admln*,*server*,ai,ai?,computer,human,network,player.。

fifo_path
    伺服器所使用的fifo檔案的路徑（與在wesnoth中使用 /query 功能相同），您可以從該檔案內ECHO伺服器命令。如果不指定，則預設為編譯時指定的路徑（預設值：/var/run/socket/wesnothd/socket）。

max_messages
    messages_time_period中允許存在的訊息數。 (默認值: 4)

messages_time_period
    訊息檢測間隔(秒)。 (預設值: 10 秒)

motd
    當日訊息。

new_room_policy
    指定誰能在伺服器上創建新房間。可選值為 everyone、registered、admin、和nobody，分別代表所有人、註冊用戶、管理員、或者禁止創建新房間。預設值為 everyone。

passwd
    取得管理員權限的密碼(透過 /query admin password 來取得權限)。

replay_save_path
    伺服器用於存放遊戲錄影的目錄。（不要忘了以/結尾！）預設為`'（空），意思是本遊戲啟動時的當前目錄。

restart_command
    這是伺服器通過restart命令開啟新伺服器進程時使用的命令。（只能通過fifo來調用。參見allow_remote_shutdown設置。）

room_save_file
    指定存放房間訊息的檔案的路徑。這個檔案在伺服器啟動時讀取，之後會寫入。如果設為空或者不設置，則房間不會被讀取或保存。

save_replays
    設置伺服器是否自動保存遊戲錄影。（預設值：false）

versions_accepted
    用逗號分隔的伺服器接受版本列表。支援使用 * 和?這兩個萬用字元。（預設為相同版本）
    例如: versions_accepted="*" 允許所有版本連接。

user_handler
    希望使用的用戶處理程序的名稱。目前可選的有forum（將wesnothd與phpbb論壇的資料庫連接起來）和sample（一個用戶處理介面的執行樣本，如果您真的在實際中使用它，那您一定是瘋了）。預設值是forum，同時您必須添加一個[user_handler]小節，請看下面。

  全球標籤:

[redirect] 伺服器用來重定向特定客戶端版本的標簽。

    host
        重定向到的伺服器地址。

    port
        連接埠口

    version
        重定向用逗號分隔列表的版本。顯示同樣的模式包括versions_accepted在符號模式。

[ban_time] 這個標籤用於定義一些方便的關鍵字，以對應一些常用的臨時封禁時間長度。

    name
        用於參照封禁時間的名字。

    time
        時間長度定義。 格式為：%d[%s[%d%s[...]]] 其中%s是s（秒），m（分鐘），h（小時），D（天），M（月），Y（年），%d是一個數字。如果不指定時間單位，預設為分鐘（m）。例如：time= 代表的是1天12小時30分的封禁。

[proxy] 這個標簽告訴伺服器扮演代理伺服器角色，把使用者連接重定向到另一台伺服器。與[redirect]接受一樣的參數。

[user_handler] 配置用戶處理程序。可設置的主鍵取決於通過user_handler設置的用戶資料處理器是哪一個。如果配置檔案中沒有[user_handler]小節，則伺服器在運行中將不提供任何暱稱註冊服務。

    db_host
        （如果user_handler=forum）資料庫伺服器的主機名

    db_name
        （如果user_handler=forum）資料庫名

    db_user
        （如果user_handler=forum）資料庫登錄用戶名

    db_password
        （如果user_handler=forum）這個用戶的密碼

    db_users_table
        （如果user_handler=forum）phpbb 論壇中存放用戶資料的表名。很可能是<table-prefix>_users（例如phpbb3_users）。

    db_extra_table
        （如果user_handler=forum）wesnothd存放自用的用戶資料的表名。您必須自己手動創建這個表，例如：CREATE TABLE <table-name>(username VARCHAR(255) PRIMARY KEY, user_lastvisit INT UNSIGNED NOT NULL DEFAULT 0, user_is_moderator TINYINT(4) NOT NULL DEFAULT 0);

    user_expiration
        （如果user_handler=sample）註冊暱稱的失效時間（單位是天數）。

[mail] 設置一個SMTP伺服器，通過用戶處理程序可以發送郵件。目前只在樣本用戶處理程序中使用。

    server
        郵件伺服器的主機名。

    username
        登錄到郵件伺服器的用戶名。

    password
        使用者密碼。

    from_address
        您的電子信箱的回覆地址。

    mail_port
        郵件伺服器的埠口。預設值為25。

退出狀態碼
正常退出時狀態碼為0，此時伺服器正常關閉。狀態碼2代表命令行選項中有錯誤。

作者
由 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>編寫。
官方網站：http://www.wesnoth.org/；繁體中文翻譯團隊：http://wesnoth-tw.blogspot.com/

版權
Copyright © 2003-2013 David White <davidnwhite@verizon.net>
這是一個免費遊戲；使用由FSF發布的GPL v2協議授權。原文如下：This is Free Software; this software is licensed under the GPL version 2, as published by the Free Software Foundation. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

參見
wesnoth(6).