SERVER / DEPLOYMENT

遊戲伺服器開服配置手冊

涵蓋 TOKEN 申請、環境變數、伺服器類型、大廳可見性與開服示例的完整配置指南。

本手冊整理了開服時最常用的環境變數、授權申請流程與大廳可見性規則。文中所有內容均來自既有的伺服器配置文件，已轉為適合站內閱讀的指南頁面。

1. 概述

本手冊說明如何透過環境變數（.env 檔案）配置並啟動自己的遊戲伺服器。伺服器啟動後會自動向官方大廳註冊，並依照您的配置決定可見性與伺服器類型。

注意：所有以 GAME_ 開頭、且類型屬於「存在檢測」的變數，只要有定義就會視為啟用，不論值為何。若要關閉某項功能，請直接刪除該變數，或不要定義它。

2. 準備工作

必須：向官方申請有效的 遊戲授權 TOKEN（GAME_TOKEN），沒有 TOKEN 就無法開啟公開伺服器（授權服／官服）。
準備一台具有公網 IP 的伺服器，或一台位於區域網路中的主機（若僅做區域網路連線，可不需要公網 IP）。
安裝 Docker 與 Docker Compose（建議），或確認伺服器運行環境符合遊戲要求。
申請 TOKEN 時，請將郵件寄到：team@nextindie.cn。

TOKEN 申請範本

主旨：申請 TOKEN - IP：127.0.0.1（請填寫你的公網 IP）
內容：
使用者 UID：你的遊戲帳號使用者 ID（必須填寫正確，有助於加快審核）
公網 IP：你的公網 IP 位址（必須可被 ping 到，否則將被拒絕）
申請用途：請填寫你的伺服器用途（例如：個人開服、社群伺服器等）
伺服器地區：請填寫伺服器所在區域（例如：亞洲、北美等）

請務必確認提供的資訊正確無誤。審核通過後，我們會將 TOKEN 寄送至你的信箱。一般審核時間為 3 至 7 個工作日。
申請伺服器 TOKEN 即表示你同意遵守我們的伺服器規範，並同意在必要時接受對違規伺服器的處置（例如刪除 TOKEN、從大廳移除等）。請勿將 TOKEN 洩露給他人，否則可能導致伺服器被濫用或遭到攻擊。

3. 全部可配置參數

3.1 基礎與授權

變數名稱	類型	預設值	說明
`GAME_NAME`	字串	`The Mesozic`	伺服器名稱，玩家會在大廳列表中看到這個名稱
`GAME_TOKEN`	字串	空	遊戲授權 TOKEN，必須向官方申請。若沒有有效 TOKEN，將無法註冊為公開伺服器（授權或官方類型），詳見第 4 節。
`GAME_AUTO_RESTART`	存在檢測	無	啟用後伺服器每天會自動重啟一次，以維持長時間運行的穩定性
`GAME_ADMINS`	字串	無	伺服器管理員的使用者 ID，多個請用英文逗號分隔，例如 `100001,10002,100003`。

3.2 網路與連線類型

變數名稱	類型	預設值	說明
`GAME_IP`	字串	`127.0.0.1`	伺服器的公網 IP 位址，請務必填寫正確，否則其他玩家將無法連線
`GAME_HOST`	存在檢測	無	僅用於區域網路模式。定義後，伺服器會自動取得本機區域網路 IP，並忽略 `GAME_IP`。啟用後伺服器類型會變成 LAN，不會出現在公網伺服器列表。
`GAME_PORT`	整數	`26666`	伺服器監聽埠（UDP），請確認防火牆已放行
`GAME_MAX_PLAYERS`	整數	`64`	允許同時在線的最大玩家數
`GAME_GLOBAL`	布林	`true`	是否使用全球匹配節點，通常建議維持 true
`GAME_PUBLIC`	存在檢測	false	決定伺服器是否公開。若未定義，伺服器為私密服（需密碼或僅好友可見）；若有定義，則會成為公開伺服器，並顯示在大廳中（前提是符合 TOKEN 與 Link 類型要求）。
`GAME_LINK`	存在檢測	false	強制宣告為私密伺服器（PRIVACY）。若要建立需要密碼才能加入的私密房間，請定義此變數。私密伺服器通常不公開，或僅對特定玩家可見。
`GAME_NODE`	字串	`AS`	伺服器所在的區域節點，供玩家參考延遲。可選值：`AS`（亞洲）、`CN`（中國）、`NA`（北美）、`SA`（南美）、`EU`（歐洲）、`ME`（中東）

連線類型優先順序與組合

若定義了 GAME_LINK，伺服器就會是私密服（PRIVACY）；即使同時開啟 GAME_PUBLIC，也只會作為需密碼加入的私密房間存在。

若沒有定義上述特殊變數，且開啟了 GAME_PUBLIC 並提供有效的 GAME_TOKEN，伺服器會被註冊為授權伺服器（AUTHORIZE），這是一般玩家架設公開伺服器的主要方式。

若未定義 GAME_PUBLIC，則不論 TOKEN 是否存在，伺服器都會維持私密狀態，不會顯示在公網列表中。

3.3 遊戲規則

變數名稱	類型	預設值	說明
`GAME_DEAD_TIME`	整數（秒）	`1800`	屍體腐敗後消失的時間
`GAME_START_GROWTH`	浮點	`0.1`	新角色的初始成長值（0.0 ~ 1.0）
`GAME_MAX_GROWTH`	浮點	`1.0`	角色可達到的最大成長值
`GAME_SPEED_GROWTH`	浮點	`1.0`	成長速度倍率
`GAME_TEAM`	整數	`6`	隊伍最大成員數
`GAME_CHILD`	整數	`0`	允許玩家同時擁有的後代／隨從數量，0 代表禁用後代
`GAME_SAFE`	整數（秒）	`0`	新角色出生保護時間
`GAME_TEAM_DAMAGE`	存在檢測	開啟	啟用隊友傷害。若不希望誤傷隊友，請刪除此變數
`GAME_HATCH`	存在檢測	開啟	允許邀請孵化（與其他玩家合作繁殖）
`GAME_EVOL`	存在檢測	開啟	允許蛋進化（透過蛋跨階段進化）
`GAME_PK`	存在檢測	關閉	啟用玩家間主動決鬥功能
`GAME_ALT_TURN`	存在檢測	開啟	允許原地轉身
`GAME_MALE_REBIRTH`	存在檢測	開啟	允許使用雄性角色復活
`GAME_SINGLE_BREED`	存在檢測	關閉	允許單人孵化（無需伴侶）
`GAME_ERA_REBIRTH`	存在檢測	關閉	允許跨時代復活（代際復活）
`GAME_DOWNGRADE_REBIRTH`	存在檢測	關閉	允許降級復活（退回較低進化階段）
`GAME_LEARN`	存在檢測	開啟	允許學習基因
`GAME_CHILD_ATTRIBUTE_INHERIT`	存在檢測	關閉	後代是否繼承父母屬性（可能導致屬性無限成長）

3.4 AI 與生態

變數名稱	類型	預設值	說明
`GAME_MAX_AI`	存在檢測	開啟	是否生成 AI 生態恐龍。若關閉，地圖上只會有玩家
`GAME_AI_MATE`	存在檢測	關閉	是否允許 AI 伴侶跟隨並協助玩家

3.5 基因與熟練度

變數名稱	類型	預設值	說明
`GAME_CRAZY`	存在檢測	開啟	允許出現狂暴基因
`GAME_GENE_SKILLFUL`	存在檢測	開啟	允許基因熟練度系統
`GAME_KILL_SKILLFUL`	存在檢測	關閉	擊殺其他玩家是否獲得熟練度

3.6 遊戲模式（三選一）

變數名稱	類型	說明
`GAME_MODE_SANDBOX`	存在檢測	沙盒模式：玩家可自由選擇種族，並禁用狂暴基因
`GAME_MODE_EVOL`	存在檢測	進化模式：限制初始可選種族、強制允許蛋進化，並逐步解鎖更高階生物
`GAME_MODE_PRIMEVAL`	存在檢測	原始模式：強制開啟狂暴基因、降級復活與單人孵化，但禁用基因熟練度

請只啟用一種模式；若同時定義多種模式，後定義的會覆蓋先前的設定。

3.7 難度設定

變數名稱	類型	預設值	說明
`GAME_SIMPLE`	存在檢測	關閉	啟用簡單難度（同時開啟代際／降級復活與單人孵化，並禁用邀請孵化）
`GAME_NORMAL`	存在檢測	關閉	啟用普通難度（僅啟用代際復活）
`GAME_HARD`	整數	`0`	直接指定難度等級，會覆蓋前兩個標識。可選值：`0`=普通、`1`=簡單、`2`=非常容易、`3`=困難、`4`=硬核

3.8 PVP / PVE（二選一）

變數名稱	類型	說明
`GAME_PVP`	存在檢測	開啟 PVP 模式（玩家可彼此攻擊）
`GAME_PVE`	存在檢測	開啟 PVE 模式（禁止玩家間傷害，但允許決鬥）

建議只選擇其中一種，不要同時定義。

3.9 地圖

變數名稱	類型	預設值	說明
`GAME_MAP`	字串	遊戲內建第一張地圖的 Tag	地圖標識，例如 `Oasis`。可用地圖請查閱官方地圖列表

3.10 MOD 載入

變數名稱	類型	預設值	說明
`GAME_MODS`	字串	無	需要載入的 MOD 名稱，多個請用英文逗號分隔，例如 `ModA,ModB`。請確認這些 MOD 已正確安裝至伺服器的 `Data/Mods` 目錄。

4. 伺服器類型與大廳可見性

伺服器類型	需要設定的環境變數	特點
區域網路伺服器（LAN）	定義 `GAME_HOST`	僅可在區域網路內連線，不會顯示於公網大廳
私密伺服器（PRIVACY）	定義 `GAME_LINK` 即可，無需 TOKEN	需要密碼才能加入。預設為私密，也可透過其他方式讓好友直連，不會出現在大廳公開列表中
授權伺服器（AUTHORIZE）	定義 `GAME_PUBLIC` 並填寫有效的 `GAME_TOKEN`，且不要定義 `GAME_HOST`、`GAME_LINK`、`GAME_OFFICIAL`	這是大多數玩家架設公開伺服器的方式。伺服器會顯示在大廳列表中，並標記為「授權服」，排序僅次於官服

關鍵提示

若你希望伺服器顯示於大廳並能被所有玩家搜尋到，必須同時滿足：① 啟用 GAME_PUBLIC、② 填寫有效的 GAME_TOKEN、③ 不要啟用 GAME_HOST 或 GAME_LINK。
若公開伺服器沒有有效 TOKEN，註冊時會被攔截，並提示「伺服器 TOKEN 無效或已過期」。
伺服器啟動後，會每 90 秒向大廳發送一次心跳以維持在線狀態。若超時未送出心跳，伺服器將從列表中移除，但不影響已連線的玩家。

5. 配置範例

5.1 公網授權伺服器（推薦個人開服）

# 基礎
GAME_TOKEN=從官方申請的TOKEN
GAME_NAME=The Mesozoic Dawn
GAME_AUTO_RESTART=1
GAME_ADMINS=100001,100002

# 網路：公網 IP 與連接埠
GAME_IP=203.0.113.10
GAME_PORT=26666
GAME_MAX_PLAYERS=100
GAME_PUBLIC=1
GAME_NODE=AS

# 規則（可依需求調整）
GAME_CHILD=2
GAME_SAFE=30
GAME_TEAM=4
GAME_DEAD_TIME=1200
GAME_EVOL=1
GAME_AI_MATE=1

# 模式：沙盒
GAME_MODE_SANDBOX=1

# 地圖
GAME_MAP=Oasis