server.properties 是 Minecraft Java 伺服器的文字設定檔。想改伺服器名稱、遊戲模式、白名單或連接埠時,先正常停止伺服器,再編輯對應欄位並重新啟動。不同 Minecraft 核心和版本可能新增、移除或改變設定,以下以常見 Java 伺服器欄位為主;修改前請對照目前核心文件。
修改前先做這些事
- 在主控台輸入
stop正常關閉伺服器,等程序停止。 - 下載或複製目前的
server.properties;重要世界也應保留備份。 - 用純文字編輯器開啟檔案,每一行通常是
設定名稱=值,不要把等號改成冒號,也不要把設定值包在引號裡。 - 儲存後重新啟動伺服器,再從主控台確認載入正常。
若你使用託管面板,可以在「檔案管理」找到設定檔。面板也可能有專用設定表單;若表單和檔案內容不同,以服務商的面板文件為準。
常用 Java server.properties 欄位
| 欄位 | 用途 | 修改提醒 |
|---|---|---|
motd |
伺服器清單中顯示的簡短介紹 | 只改顯示文字,不會改遊戲內世界名稱 |
gamemode |
新玩家的預設遊戲模式 | 常見值為 survival、creative、adventure、spectator;已建立玩家的模式可能不會只因修改此欄而改變 |
difficulty |
世界難度 | 常見值為 peaceful、easy、normal、hard |
max-players |
同時可連線的名額上限 | 改大只是提高欄位上限,不保證主機資源能穩定支援該人數 |
white-list |
是否限制只有名單玩家可加入 | 開啟後還要使用白名單指令新增玩家 |
online-mode |
是否驗證 Minecraft 帳戶 | 公開伺服器通常應保持 true;不要把停用驗證當成解決登入問題的方式 |
server-port |
Java 伺服器監聽連接埠 | 預設為 25565;改值後防火牆與路由器規則也要一致 |
server-ip |
伺服器綁定的本機網路介面 | 多數情況留空即可;不要填外部 IP |
view-distance |
伺服器傳送給玩家的世界視距 | 調高會增加伺服器負載,需依世界與玩家情況測試 |
simulation-distance |
生物及部分世界活動的模擬距離 | 與玩家看到的視距不同;調高同樣可能增加負載 |
level-name |
世界資料夾名稱 | 改它會讓伺服器尋找另一個世界資料夾;操作前先確認資料位置 |
level-seed |
建立新世界時使用的種子 | 對已載入的既有世界不會重新生成地形 |
PaperMC 的server.properties 參考表列有目前支援的欄位、預設值和用途。基岩版 BDS 使用另一套 server.properties;例如其預設伺服器連接埠、白名單欄位和遊戲模式欄位都不同,請看 Microsoft Learn 的 BDS 設定文件。
欄位改好後,可用主控台指令指南安全停止並檢查伺服器;若調整 server-port 是為了讓家中架設的 Java 伺服器接受外網連線,還要依路由器連接埠轉發教學設定防火牆和路由器。
三個容易改錯的設定
把 server-ip 填成外部 IP。 這個欄位控制伺服器要綁定的本機介面,不是朋友要連線的對外位址。Paper 文件指出,多數情況應留空;若綁定錯誤,可能出現無法監聽連接埠的問題。
把 max-players 當成效能保證。 它控制可同時加入的名額,不會自動增加 RAM 或 CPU 資源。若想估算資源需求,請另外看伺服器 RAM 選擇指南和主機方案選購指南。
為了解決驗證問題停用 online-mode。 這會改變帳戶驗證行為,不能修復錯誤密碼、版本不合或 Xbox/Microsoft 權限限制;優先排查帳戶登入和伺服器日誌。
改完設定但遊戲裡沒變?
確認伺服器是停止後才編輯,儲存的是正在使用的那份設定檔,且已重新啟動。某些欄位只影響新玩家或新世界;核心文件會說明欄位的適用範圍。
要把基岩版伺服器的設定填在同一份檔案嗎?
不要直接照抄。BDS 也使用 server.properties 檔名,但欄位和預設值可能不同。請按基岩版伺服器設定參考核對 Microsoft 的 BDS 文件。
若這次修改與遊戲版本更新一起進行,先備份再核對核心相容性;詳細步驟見伺服器安全更新指南。