SERVER / DEPLOYMENT

遊戲伺服器開服配置手冊

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

本手冊整理了開服時最常用的環境變數、授權申請流程與大廳可見性規則,並已依最新伺服器配置文件更新為適合站內閱讀的格式。

1. 概述

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

注意:標記型變數(例如 GAME_HOSTGAME_LINKGAME_AUTO_RESTART)只要有定義就會視為啟用;其餘 bool/布林型變數請明確填寫 true/false1/0

2. 準備工作

  • 必須是雲伺服器(阿里雲、騰訊雲、 AWS 等)或者 VPS 虛擬機。
  • 必須:向官方申請有效的 遊戲授權 TOKENGAME_TOKEN),沒有 TOKEN 就無法開啟公開伺服器。
  • 準備一台具有公網 IP 的伺服器(必須可被 ping 通和訪問),否則審核會不通過。
  • 安裝 Docker 與 Docker Compose(建議),或確認伺服器運行環境符合遊戲要求。
  • 申請 TOKEN 時,請將郵件寄到:team@nextindie.cn

TOKEN 申請範本 · 《遊戲許可及服務協議》

Text
一、申請人基本資訊
使用者 UID:[請填寫您的遊戲帳號使用者 ID]
伺服器綁定公網 IP:[請填寫唯一的固定公網 IP 位址,須可被 ping 到]
伺服器物理地區:[例如:亞洲、北美等]
申請用途與社群規模簡述:[例如:個人開服、特定玩家社群伺服器等]
二、【重要】非營利性運營承諾與合規提示
作為幕後開服運營者,我已詳細閱讀並誓必嚴格遵守《遊戲許可及服務協議》第十章之規定,在此鄭重做出以下法律承諾:

【純粹非盈利性質】:本伺服器將保持純粹的非盈利性質。
【僅允許無償捐贈】:本伺服器僅接受玩家出於對社群熱愛而進行的自願、無償、無任何對價回報的捐贈。所有贊助資金將且僅能用於貼補伺服器硬體租賃、網路頻寬、DDoS 防禦等物理託管的直接成本。
【嚴禁販賣遊戲資產與數值】:本伺服器絕不直接、間接或變相售賣遊戲內的任何虛擬生物/恐龍、角色數據、等級、屬性加成、武器裝備、建築材料、遊戲代幣或任何影響數值平衡的虛擬道具。
【嚴禁變相特權交換】:本伺服器絕不以「贊助抽獎」、「贊助滿贈」、「充值定制角色/生物」、「進入伺服器的付費門檻/入群費」等名義,將遊戲內的虛擬物品或遊戲特權作為贊助的交換條件。
【禁止博彩機制】:本伺服器內及關聯社群(如 QQ 群、Discord 等)中,絕不設立針對遊戲虛擬物資的盲盒、抽獎、輪盤或帶有賭博性質的充值返利機制。
三、隱私隔離與安全知情
我知悉並同意,官方收集此伺服器 IP 及生成 TOKEN 是出於「安全防作弊與履行合同所必需」,此數據處理符合隱私合規規範。
我承諾妥善保管配發的授權 TOKEN,絕不以任何形式轉讓、出租或洩露給第三方。因 TOKEN 或 IP 配置管理不當引發的違規後果,由我本人承擔全部責任。
本人明白,向官方傳送此開服申請郵件,即構成了對《遊戲許可及服務協議》所有法律條款的數字簽名與絕對認可。若違反上述任何一項紅線,官方有權在不進行事先通知的情況下,一鍵註銷授權 TOKEN、將 IP 列入黑名單,並對違規帳號執行全平台封號與設備拉黑處理。

3. 全部可配置參數

3.1 基礎與授權

變數名稱類型預設值說明
GAME_NAME字串The Mesozoic伺服器名稱,會顯示在房間列表中
GAME_ANNOUNCEMENT字串伺服器公告,玩家進入時會以彈窗顯示。支援 \n 換行
GAME_PASSWORD字串伺服器密碼;留空代表不設密碼
GAME_TOKEN字串遊戲授權 TOKEN,必須向官方申請。若沒有有效 TOKEN,將無法註冊為公開伺服器,詳見第 4 節。
GAME_AUTO_RESTART標記存在即啟用伺服器自動重啟,以維持長時間運行的穩定性
GAME_ADMINS字串普通管理員的使用者 ID 列表,多個請用英文逗號分隔,例如 100001,100002,100003

多語言公告(GAME_ANNOUNCEMENT_XX)

伺服器會根據玩家客戶端語言自動匹配對應的公告內容。支援 16 種語言後綴:ZH(簡體中文)、ZHTW(繁體中文)、EN(English)、JA(日本語)、KO(한국어)、PT(Português)、PTBR(Português Brasil)、RU(Русский)、ES(Español)、FR(Français)、DE(Deutsch)、AR(العربية)、TH(ไทย)、VI(Tiếng Việt)、ID(Bahasa Indonesia)、TR(Türkçe)。

設定方式:在 .env 中定義 GAME_ANNOUNCEMENT_XX=公告內容,例如 GAME_ANNOUNCEMENT_EN=Welcome to the server!。未設定對應語言時,自動使用 GAME_ANNOUNCEMENT 的預設值。

修改公告後,服主可使用 /reloadAnnounce 命令熱刷新,無需重啟伺服器。

3.2 網路與連線類型

變數名稱類型預設值說明
GAME_IP字串127.0.0.1伺服器綁定的 IP 位址。若要讓外網玩家連線,請填寫正確的公網 IP
GAME_HOST標記僅用於區域網路模式。定義後,伺服器會自動取得本機區域網路 IP,並忽略 GAME_IP。啟用後伺服器類型會變成 LAN,不會出現在公網伺服器列表。
GAME_PORT整數26666伺服器監聽埠(UDP),請確認防火牆已放行
GAME_MAX_PLAYERS整數64允許同時在線的最大玩家數
GAME_GLOBAL布林true是否註冊到全球房間列表,通常建議維持 true
GAME_PUBLIC布林false設為 true 時標記為公開伺服器;若維持 false,則為私密服或僅好友可見
GAME_LINK標記強制宣告為私密伺服器(PRIVACY)。若要建立需要密碼才能加入的私密房間,可定義此變數並搭配 GAME_PASSWORD
GAME_NODE字串AS伺服器所在的區域節點,供玩家參考延遲。可選值:AS(亞洲)、CN(中國)、NA(北美)、SA(南美)、EU(歐洲)、ME(中東)

連線類型優先順序與組合

若定義了 GAME_LINK,伺服器就會是私密服(PRIVACY);即使同時將 GAME_PUBLIC 設為 true,也只會作為需密碼加入的私密房間存在。

若未啟用上述特殊變數,且將 GAME_PUBLIC 設為 true 並提供有效的 GAME_TOKEN,伺服器會被註冊為授權伺服器(AUTHORIZE),這是一般玩家架設公開伺服器的主要方式。

GAME_PUBLICfalse,或未提供有效 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布林true是否允許隊友傷害
GAME_HATCH布林true允許邀請孵化(與其他玩家合作繁殖)
GAME_EVOL布林true允許種族產出的卵出現進化蛋;若關閉,則永遠只會產出當前種族的蛋
GAME_PK布林false設為 true 允許玩家主動發起決鬥
GAME_ALT_TURN布林true允許原地轉身
GAME_MALE_REBIRTH布林false允許雄性角色復活
GAME_SINGLE_BREED布林false允許單人孵化(無需伴侶)
GAME_ERA_REBIRTH布林false允許跨代際復活
GAME_DOWNGRADE_REBIRTH布林false允許降級復活(成長值回調)
GAME_LEARN布林false允許學習基因。子規則:GAME_MAX_LEARN(整數,預設 10 = 不限制)設定角色可學習的基因數量上限
GAME_MAX_LEARN整數1角色可通過學習獲得的基因數量上限。0 = 不限制(但仍受角色自身的基因槽位上限約束)。GAME_LEARN 的子規則
GAME_CHILD_ATTRIBUTE_INHERIT布林false允許後代繼承父母的屬性。子規則:GAME_CHILD_SIZE_INHERIT_MAX_MULTIPLIERGAME_CHILD_ATTR_INHERIT_MAX_MULTIPLIER 限制最大成長倍數
GAME_CHILD_SIZE_INHERIT_MAX_MULTIPLIER浮點1.5後代體型相對於種族基礎體型的最大可繼承倍數。GAME_CHILD_ATTRIBUTE_INHERIT 的子規則
GAME_CHILD_ATTR_INHERIT_MAX_MULTIPLIER浮點1.5後代屬性(生命/攻擊/防禦/速度/消耗)相對於種族基準的最大可繼承倍數。GAME_CHILD_ATTRIBUTE_INHERIT 的子規則
GAME_HABITAT布林false是否啟用棲息地占領系統。設為 true 後,玩家可占領地圖上的棲息地,占領方獲得成長增益

3.3.1 寫實與進階規則

變數名稱類型預設值說明
GAME_REALISM布林false啟用完整寫實 PVE 預設:關閉 PVP、使用寫實難度,並開啟食性敵對、生態規則、決鬥、狂暴基因、PVE 人機預設攻擊、巢穴保護、邀請保護、蛋保護與全部寫實規則;後續相關變數可覆寫預設值
GAME_REALISM_PK布林未設定覆寫寫實預設中的決鬥規則;設為 true 允許玩家發起決鬥
GAME_REALISM_CRAZY布林未設定覆寫寫實預設中的狂暴基因規則;設為 true 啟用狂暴基因
GAME_INVITE_PROTECTION布林false啟用組隊或孵化邀請保護;邀請雙方在保護期間不能主動攻擊,確認決鬥或有效自衛時不受影響
GAME_EGG_PROTECTION布林false啟用後,其他玩家不能直接摧毀或進食你的蛋;巢穴按正常規則受傷或摧毀時,仍會照常銷毀巢內全部蛋
GAME_REALISM_CARNIVORE_RACE_TEAM_LIMIT布林false肉食性生物僅允許同種族組隊,植食性、雜食和水生不受此限
GAME_REALISM_CORPSE_NEARBY_SAN_PENALTY布林false附近存在屍體時,肉食性生物擊殺其他玩家會受到 SAN 懲罰
GAME_REALISM_PVE_DIET_HOSTILE布林falsePVE 模式下不同食性生物預設為敵對關係,無需決鬥即可攻擊
GAME_PVE_AI_DEFAULT_ATTACK布林false啟用後,PVE 模式下玩家與野生 AI 生物可直接互相攻擊,無需發起決鬥;保護期、隊友、伴侶、主人與親屬限制仍然有效
GAME_REALISM_HERBIVORE_PICKUP_CORPSE布林false控制植食性生物叼拿屍體的限制;目前程式在此值為 true 時禁止叼拿
GAME_REALISM_HERBIVORE_CORPSE_FEAR布林false植食性生物待在屍體偵測範圍內會觸發壓力
GAME_REALISM_DYNAMIC_TEAM_WEIGHT布林false啟用遊戲規則「動態組隊權重」:依生物等級計算隊伍總權重,超過上限時不能繼續組隊
GAME_REALISM_REVENGE布林false玩家被擊殺後,在保護結束前不能主動攻擊擊殺者;對方先攻擊時仍可自衛
GAME_REALISM_CARCASS_CLAIM布林false肉食性玩家擊殺後認領屍體;屍體吃完或認領者遠離過久前,認領者不能主動攻擊其他玩家
GAME_REALISM_NEST布林false啟用遊戲規則「巢穴保護」:禁止破壞其他玩家的巢穴;PVE 原有規則也可能獨立禁止破壞他人巢穴
GAME_REALISM_KILL_COOLDOWN布林false擊殺後限制再次主動攻擊同一玩家或同一裝置;雙方隊友也會獲得較短冷卻
GAME_REALISM_BAITING布林false玩家進食時、完整巢穴或已佔領棲息地附近,非親友/非隊友的靠近者會觸發挑釁;受保護方可限時反擊
GAME_REALISM_TEAM_LEAVE布林false主動離隊或被踢出隊伍後,暫時禁止主動攻擊離隊前的隊友
GAME_REALISM_HUNGER_HUNT布林false肉食性玩家饑餓度低於觸發比例時,可突破 PVE 食性限制獵殺一次;進食至重置比例後才能再次使用
GAME_REALISM_RACE_CHAT_ISOLATION布林false啟用後,世界與附近聊天僅對同種族玩家可見;隊伍聊天不受影響
GAME_DISABLED_RACES字串使用英文種族 ID、英文逗號分隔,例如 trex,mapu,velo;列出的種族不可建立、選擇或孵化
GAME_WORLD_CHAT_COOLDOWN_SECONDS整數(秒)15世界聊天每則訊息之間須等待指定秒數;設為 0 可關閉冷卻。開發者、服主與管理員不受此冷卻限制
變數名稱類型預設值說明
GAME_REALISM_CORPSE_NEARBY_SAN_MULTIPLIER浮點3屍體附近擊殺玩家時扣除的 SAN 倍率
GAME_REALISM_CORPSE_NEARBY_RANGE浮點(公尺)50屍體附近規則的偵測範圍
GAME_REALISM_MAX_TEAM_WEIGHT整數12遊戲規則「隊伍總權重上限」的數值;絕對人數上限仍由 GAME_TEAM 決定
GAME_INVITE_PROTECTION_SECONDS整數(秒)1800組隊或孵化邀請後,邀請雙方互不主動攻擊的保護時長
GAME_REALISM_REVENGE_SECONDS整數(秒)1800被擊殺者對擊殺者的主動攻擊保護時長
GAME_REALISM_KILL_SECONDS整數(秒)1500擊殺者再次主動攻擊同一玩家或同一裝置的冷卻時長
GAME_REALISM_TEAM_FIGHT_SECONDS整數(秒)900發生有效傷害後,雙方當時隊伍成員之間的攻擊冷卻時長;解散重組不解除
GAME_REALISM_TEAM_LEAVE_SECONDS整數(秒)900離隊者主動攻擊離隊前隊友的冷卻時長
GAME_REALISM_CARCASS_ABANDON_RANGE浮點(公尺)200認領隊伍全員離開屍體超過此距離後,開始計算放棄時間
GAME_REALISM_CARCASS_ABANDON_SECONDS浮點(秒)60認領隊伍持續遠離屍體達到此時間後,自動釋放屍體認領
GAME_REALISM_BAITING_RANGE浮點(公尺)30進食挑釁和護巢挑釁的偵測半徑
GAME_REALISM_BAITING_THRESHOLD浮點(秒)15持續處於挑釁偵測範圍達此時間後觸發反擊許可(進食挑釁、護巢挑釁與棲息地防禦挑釁共用)
GAME_REALISM_BAITING_PERMISSION_SECONDS浮點(秒)60挑釁觸發後受保護方可限時反擊的有效秒數(進食挑釁、護巢挑釁與棲息地防禦挑釁共用)
GAME_REALISM_HUNGER_HUNT_THRESHOLD浮點(比例)0.2肉食性玩家的飽食度低於 20% 時,可獲得一次突破 PVE 食性限制的獵殺權限
GAME_REALISM_HUNGER_HUNT_RESET_THRESHOLD浮點(比例)0.8使用獵殺權限後,飽食度必須恢復至 80% 才能重新獲得權限

寫實預設的覆寫順序: GAME_REALISM=true 先套用完整寫實配置,之後各個 GAME_REALISM_*GAME_PVE_AI_DEFAULT_ATTACKGAME_INVITE_PROTECTIONGAME_EGG_PROTECTIONGAME_INVITE_PROTECTION_SECONDS 變數再覆寫對應規則。未啟用預設時,寫實與保護開關沿用一般預設值。

3.4 AI 與生態

變數名稱類型預設值說明
GAME_MAX_AI布林true是否允許 AI 生物生成;若關閉,地圖上只會有玩家
GAME_AI_MATE布林false是否允許 AI 伴侶 跟隨並協助玩家

3.5 基因與熟練度

變數名稱類型預設值說明
GAME_CRAZY布林true允許狂暴基因
GAME_GENE_SKILLFUL布林true允許基因熟練度系統
GAME_KILL_SKILLFUL布林false擊殺其他玩家是否增加基因熟練度

3.6 遊戲模式(三選一)

變數名稱類型說明
GAME_MODE_SANDBOX布林設為 true 開啟沙盒模式,玩家可自由選擇種族,並禁用狂暴基因
GAME_MODE_EVOL布林設為 true 開啟進化模式,僅允許進化玩法
GAME_MODE_PRIMEVAL布林設為 true 開啟原始模式,啟用狂暴基因、降級復活,並禁用基因熟練度

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

3.7 難度設定

變數名稱類型預設值說明
GAME_SIMPLE布林false設為 true 開啟簡單模式:代際復活 + 降級復活 + 單人孵化,並禁用邀請孵化
GAME_NORMAL布林false設為 true 開啟普通模式:僅啟用代際復活
GAME_HARD整數0困難模式等級(數值越大越難),會覆蓋前兩個布林預設

3.8 PVP / PVE(二選一)

變數名稱類型說明
GAME_PVP布林設為 true 開啟 PVP 模式(玩家可彼此攻擊)
GAME_PVE布林設為 true 開啟 PVE 模式(禁止玩家間傷害,但允許決鬥)

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

3.9 地圖

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

3.10 社交與聊天

變數名稱類型預設值說明
GAME_WORLD_CHAT布林true世界聊天頻道的初始開關。設為 false 時,所有玩家初始都無法使用世界頻道;服主仍可在運行時使用 /worldchat 切換

3.11 MOD 載入

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

布林型參數寫法

所有布林型變數請使用 true/false1/0。例如:GAME_PVP=trueGAME_WORLD_CHAT=false。標記型變數則是只要存在就會生效。

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

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

關鍵提示

  • 若你希望伺服器顯示於大廳並能被所有玩家搜尋到,必須同時滿足:① 將 GAME_PUBLIC 設為 true② 填寫有效的 GAME_TOKEN③ 不要啟用 GAME_HOSTGAME_LINK
  • 若你要建立有密碼的私密房間,可同時使用 GAME_LINKGAME_PASSWORD。這類伺服器不會顯示在大廳公開列表中。
  • 若公開伺服器沒有有效 TOKEN,註冊時會被攔截,並提示「伺服器 TOKEN 無效或已過期」。
  • 伺服器啟動後,會每 90 秒向大廳發送一次心跳以維持在線狀態。若超時未送出心跳,伺服器將從列表中移除,但不影響已連線的玩家。

5. 配置範例

5.1 沙盒模式伺服器

INI
# 遊戲授權 TOKEN(向官方申請,公開伺服器必填)
GAME_TOKEN=
# 伺服器名稱
GAME_NAME=The Sandbox
# 公網 IP(127.0.0.1 僅供本機測試;請填寫真實公網 IP,其他玩家才能連線)
GAME_IP=203.0.113.10
# 伺服器連接埠(UDP)
GAME_PORT=26666

# 屍體消失時間(秒)
GAME_DEAD_TIME=600
# 後代數量:0=禁用,1=允許 1 個,2=允許 2 個……
GAME_CHILD=1

# 啟用沙盒模式
GAME_MODE_SANDBOX=true

# 註冊到全球伺服器列表
GAME_GLOBAL=true
# 最大玩家數
GAME_MAX_PLAYERS=50
# 伺服器節點(僅供玩家判斷所在地區,無實際作用)
GAME_NODE=AS
# 公開伺服器
GAME_PUBLIC=true

# 允許基因熟練度
GAME_GENE_SKILLFUL=true
# 允許擊殺獲得熟練度
GAME_KILL_SKILLFUL=true
# 允許學習基因
GAME_LEARN=true
# 遊戲難度(數值越大越難)
GAME_HARD=1
# 關閉進化蛋(卵永遠只產出當前種族)
GAME_EVOL=false

# 地圖名稱
GAME_MAP=Oasis
# 允許 AI 伴侶
GAME_AI_MATE=true

5.2 進化模式伺服器

INI
# 遊戲授權 TOKEN(向官方申請,公開伺服器必填)
GAME_TOKEN=
# 伺服器名稱
GAME_NAME=The Evolution
# 公網 IP(127.0.0.1 僅供本機測試;請填寫真實公網 IP,其他玩家才能連線)
GAME_IP=203.0.113.10
# 伺服器連接埠(UDP)
GAME_PORT=26666

# 屍體消失時間(秒)
GAME_DEAD_TIME=1200
# 後代數量:0=禁用,1=允許 1 個,2=允許 2 個……
GAME_CHILD=1

# 啟用進化模式
GAME_MODE_EVOL=true
# 允許卵中出現進化蛋(這不是進化模式開關)
GAME_EVOL=true
# 啟用原始模式
GAME_MODE_PRIMEVAL=true

# 註冊到全球伺服器列表
GAME_GLOBAL=true
# 最大玩家數
GAME_MAX_PLAYERS=50
# 伺服器節點(僅供玩家判斷所在地區,無實際作用)
GAME_NODE=AS
# 公開伺服器
GAME_PUBLIC=true

# 遊戲難度(數值越大越難)
GAME_HARD=0
# 允許 AI 伴侶
GAME_AI_MATE=true