server.properties

  「whitelist」重新導向至此。關於相應的指令，詳見「指令/whitelist」。

Java版預設的server.properties檔案。

server.properties是儲存多人遊戲（Minecraft或Minecraft Classic）伺服器所有設定的檔案。

在編輯server.properties時，就算不同行之間的順序可以打亂，確保其與原始的檔案有相同的結構也很重要。每一行的等號之前的文本為變數名，您不應該修改這些內容。等號後面為變數的值，您可以按照規則自行編輯。以#開頭的行為注釋，添加、修改或移除注釋行不會對遊戲造成影響。

保存了server.properties的更改之後，伺服器必須重新啟動才能使更改生效。

如果server.properties檔案未列出下文中所有的屬性（例如伺服器版本更新加入新屬性，或該檔案還未創建），那麼伺服器在啟動時會重寫server.properties補全缺失的屬性，並將缺失的屬性值設為預設值。

檔案位置

Java版

該檔案會在伺服器第一次執行時自動生成（如果本來沒有的話）。

作業系統	檔案位置	註解
Windows	server.jar 的相同目錄下
Linux Unix Unix/Mac	工作目錄路徑（pwd）	如果你在你的 home 目錄下啟動（/home/用户名），伺服器檔案也會在/home/用户名下創建。請按照下列步驟確保伺服器檔案能夠如你預期地正確生成。 準備一個完整的資料夾來存放所有伺服器檔案。（如果你不這麼做的話事情會一團糟） 把server.jar放置（複製、移動）進去。 使用這個腳本指導設定你的Minecraft伺服器啟動腳本。 確保它位於你的可執行目錄 $PATH 確保你具有啟動腳本的執行權限（chmod +x 檔案名，或使用資料夾管理器） minecraft_server.sh

基岩版

本檔案會與bedrock_server.exe一同下載。

作業系統	檔案位置
Windows	bedrock_server.exe的相同目錄下
Linux	bedrock_server的相同目錄下

server.properties

新安裝的Minecraft伺服器具有以下預設設定：

Java版

#Minecraft server properties
#（文件修改时间戳）
broadcast-rcon-to-ops=true
view-distance=10
max-build-height=256
server-ip=
level-seed=
rcon.port=25575
gamemode=survival
server-port=25565
allow-nether=true
enable-command-block=false
enable-rcon=false
enable-query=false
sync-chunk-writes=true
op-permission-level=4
prevent-proxy-connections=false
generator-settings=
resource-pack=
level-name=world
rcon.password=
player-idle-timeout=0
motd=A Minecraft Server
query.port=25565
force-gamemode=false
hardcore=false
white-list=false
broadcast-console-to-ops=true
pvp=true
spawn-npcs=true
generate-structures=true
spawn-animals=true
snooper-enabled=true
difficulty=easy
function-permission-level=2
network-compression-threshold=256
level-type=default
spawn-monsters=true
max-tick-time=60000
enforce-whitelist=false
use-native-transport=true
max-players=20
resource-pack-sha1=
spawn-protection=16
online-mode=true
allow-flight=false
max-world-size=29999984

基岩版

server-name=Dedicated Server
gamemode=survival
difficulty=easy
allow-cheats=false
max-players=10
online-mode=true
white-list=false
server-port=19132
server-portv6=19133
view-distance=32
tick-distance=4
player-idle-timeout=30
max-threads=8
level-name=Bedrock level
level-seed=
default-player-permission-level=member
texturepack-required=false

Minecraft伺服器屬性

Java版

屬性	類型	預設值	描述
allow-flight	布林值	false	允許玩家在安裝添加飛行功能的mod前提下在生存模式下飛行。 允許飛行可能會使惡意破壞者更加常見，因為此設定會使他們更容易達成目的。在創造模式下無作用。 false - 不允許飛行。懸空超過5秒的玩家會被踢出伺服器。 true - 允許飛行。玩家得以使用任何能飛行的mod飛行。
allow-nether	布林值	true	允許玩家進入地獄。 false - 地獄傳送門不會生效。 true - 玩家可以通過地獄傳送門前往地獄。
difficulty	字符串	easy	定義伺服器的遊戲難易度（例如生物對玩家造成的傷害，飢餓和中毒對玩家的影響方式等）。 如果設定了舊的數字ID，則會自動轉化為英文的難易度名稱。 peaceful (0) - 和平 easy (1) - 簡單 normal (2) - 普通 hard (3) - 困難
enable-command-block	布林值	false	是否啟用指令方塊
enable-query	布林值	false	允許使用GameSpy4協議的伺服器監聽器。用於獲取伺服器信息。
enable-rcon	布林值	false	是否允許遠程訪問伺服器控制台。
force-gamemode	布林值	false	強制玩家加入時為預設遊戲模式。 false - 玩家將以退出前的遊戲模式加入 true - 玩家總是以預設遊戲模式加入
function-permission-level	整數 (1-4)	2	設定函數的預設權限等級。 4個等級的詳情見 #op-permission-level。
gamemode	字符串	survival	定義預設遊戲模式。 如果值是舊用的數字，會靜默轉換為對應遊戲模式的英文名稱。 survival (0) - 生存模式 creative (1) - 創造模式 adventure (2) - 冒險模式 spectator (3) - 旁觀者模式
generate-structures	布林值	true	定義是否能生成結構（例如村莊）。 false - 新生成的區塊中將不包含結構。 true - 新生成的區塊中將包含結構。 註：即使設為false，地牢仍然會生成。
generator-settings	字符串	空白	本屬性質用於自訂世界的生成。詳見超平坦世界和自訂了解正確的設定及例子。
hardcore	布林值	false	如果設為 true，伺服器難易度的設定會被忽略並且設為 hard（困難），玩家在死後會自動切換至旁觀者模式。
level-name	字符串	world	「level-name」的值將作為世界名稱及其資料夾名。你也可以把你已生成的世界存檔複製過來，然後讓這個值與那個資料夾的名字保持一致，伺服器就可以載入該存檔。 部分字符，例如 ' （單引號）可能需要在前面加反斜槓號 \ 才能被正常應用。
level-seed	字符串	空白	與單人遊戲類似，為你的世界定義一個種子。 這裡有一些例子：minecraft，404，1a2b3c。
level-type	字符串	default	確定地圖所生成的類型 default - 帶有丘陵，河谷，海洋等的標準的世界。 flat - 一個沒有特性的平坦世界，可用generator-settings修改。 largebiomes - 如同預設（default）世界，但所有生態域都更大。 amplified - 如同預設世界，但世界生成高度提高。 buffet - 如同預設世界，但generator-settings設定後不同。
max-build-height	整數	256	玩家在遊戲中能夠建造的最大高度。可能會在該值較小時生成超過該值的地形。
max-players	整數（0-2147483647）	20	伺服器同時能容納的最大玩家數量。請注意，線上玩家越多，對伺服器造成的負擔也就越大。同樣注意，伺服器的OP具有在人滿的情況下強行進入伺服器的能力：找到在伺服器根目錄下叫ops.json的檔案並打開，將需要此能力的OP下的bypassesPlayerLimit選項設定為true即可（預設值為false），這意味著OP將不需要在伺服器人滿時等待有玩家離開後再加入。過大的數值會使客戶端顯示的玩家列表崩壞。
max-tick-time	整數（0–(2^63 - 1)）	60000	設定每個tick花費的最大毫秒數。超過該毫秒數時，伺服器看門狗將停止伺服器程序並附帶上信息：伺服器的一個tick花費了60.00秒（最長也應該只有0.05秒）；判定伺服器已崩潰，它將被強制關閉。遇到這種情況的時候，它會調用 System.exit(1)。 譯者註：如果你監測服務程序的返回代碼，此時返回代碼會為1。（習慣上，程序正常退出應當返回0） -1 - 完全停用看門狗（這個停用選項在 14w32a 快照中添加）
max-world-size	整數（1-29999984）	29999984	設定可讓世界邊界獲得的最大半徑值，單位為方塊。通過成功執行的指令能把世界邊界設定得更大，但不會超過這裡設定的最大方塊限制。如果設定的 max-world-size 超過預設值的大小，那將不會起任何效果。 例如： 設定 max-world-size為1000將會有2000x2000的地圖邊界。 設定 max-world-size為4000將會有8000x8000的地圖邊界。
motd	字符串	A Minecraft Server	本屬性值是玩家客戶端的多人遊戲伺服器列表中顯示的伺服器信息，顯示於名稱下方。 MOTD 支持樣式代碼。 MOTD 支持特殊符號，比如"♥"。然而，這些符號需要轉換為Unicode轉義字符。你可以在這裡找到一個轉換器。 如果MOTD超過59個字符，伺服器列表很可能會返回「通訊錯誤」。
network-compression-threshold	整數	256	預設會允許n-1位元組的資料包正常發送, 如果資料包為n字節或更大時會進行壓縮。所以，更低的數值會使得更多的資料包被壓縮，但是如果被壓縮的資料包字節太小將反而使壓縮後字節更大。 -1 - 完全禁用資料包壓縮 0 - 壓縮全部資料包 註：乙太網規範要求把小於64位元組的資料包填充為64位元組。因此，設定一個低於64的值可能沒有什麼好處。也不推薦讓設定的值超過MTU（通常為1500位元組）。
online-mode	布林值	true	是否讓伺服器對比Minecraft帳戶資料庫驗證登錄信息。只有在你的伺服器並未與 Internet 連接時，才將這個值設為false。如果設為false，駭客就能夠使用任意假帳戶連接伺服器！如果minecraft.net伺服器宕機或不可訪問，那麼該值設為true的伺服器會因為無法驗證玩家身份而拒絕所有玩家加入。通常，這個值設為true的伺服器被稱為「正版伺服器」。故意設定該變數為false的伺服器稱為「破解伺服器」，這類伺服器允許擁有未授權的Minecraft副本的玩家加入。 true - 啟用。伺服器會認為自己具有 Internet 連接，並檢查每一位連入的玩家。 false - 禁用。伺服器不會嘗試檢查玩家。
op-permission-level	整數（1-4）	4	設定使用/op指令時OP的權限等級。所有存檔會從之前的存檔繼承能力和指令。 1 - OP可以繞過重生點保護。 2 - OP可以使用所有單人遊戲作弊指令（除了/publish，因為不能在伺服器上使用；/debug也是）並使用指令方塊。指令方塊和領域服服主/管理員有此等級權限。 3 - OP可以使用大多數多人遊戲中獨有的指令，包括 /debug，以及管理玩家的指令（/ban，/op等等）。 4 - OP可以使用所有指令，包括 /stop, /save-all, /save-on 和 /save-off。
player-idle-timeout	整數	0	如果不為0，伺服器將在玩家的空閒時間達到設定的時間（單位為分鐘）時將玩家踢出伺服器 註：當伺服器接受到下列資料包之一時將會重置空閒時間： 點擊窗口 附魔物品 更新告示牌 玩家挖掘方塊 玩家放置方塊 更換拿著的物品 動畫(揮動手臂) 實體動作 客戶端狀態 聊天信息 使用實體
prevent-proxy-connections	布林值	false	如果伺服器發送的ISP/AS和Mojang的驗證伺服器的不一樣，玩家將會被踢出。 true - 啟用。伺服器將會禁止玩家使用虛擬專用網路或代理。 false - 禁用。伺服器將不會禁止玩家使用虛擬專用網路或代理。
pvp	布林值	true	是否允許PvP。也只有在允許PvP時玩家自己的箭才會受到傷害。 true - 玩家可以互相殘殺。 false - 玩家無法互相造成傷害（也稱作玩家對戰環境（PvE））。 註：由玩家造成的間接傷害（例如熔岩，火，TNT等，某種程度上還有水，沙和礫石）還是會傷害其他玩家。
query.port	整數（1-65534）	25565	設定監聽伺服器的埠號（參見 enable-query）。
rcon.password	字符串	空白	設定RCON遠程訪問的密碼（參見enable-rcon）。RCON：能允許其他應用程式通過網際網路與Minecraft伺服器連接並交互的遠程控制台協議。
rcon.port	整數（1-65534)	25575	設定RCON遠程訪問的埠號。
resource-pack	字符串	空白	可選選項，可輸入指向一個資源包的URI。玩家可選擇是否使用該資源包。 注意若該值含":"和"="字符，需要在其前加上反斜線(\)，例如 http\://somedomain.com/somepack.zip?someparam\=somevalue 資源包大小理應不能超過50 MiB（≈ 50.4 MB）。注意，下載成功或失敗由客戶端記錄，而非伺服器。
resource-pack-sha1	字符串	空白	資源包的SHA-1值，必須為小寫十六進位，建議填寫它。這還沒有用於驗證資源包的完整性，但是它提高了資源包緩存的有效性和可靠性。
server-ip	字符串	空白	將伺服器與一個特定IP綁定。強烈建議留空該屬性值！ 留空，或是填入你想讓伺服器綁定（監聽）的IP。
server-port	整數（1-65534）	25565	改變伺服器（監聽的）埠號。如果伺服器在使用NAT的網路中執行，該埠必須被轉發（在你有家用路由器/抗火牆的前提下）。
snooper-enabled	布林值	true	是否允許伺服器定期發送統計數據到http://snoop.minecraft.net。 false - 禁用數據採集 true - 啟用數據採集
spawn-animals	布林值	true	決定動物是否可以生成。 true - 動物可以正常生成。 false - 動物生成後會立即消失。 提示：如果你有嚴重的卡頓，可以設為false。
spawn-monsters	布林值	true	決定攻擊型生物（怪物）是否可以生成。 true - 啟用。怪物會生成於夜晚和黑暗處。 false - 禁用。不會有任何怪物。 如果difficulty=0（即難易度設定為和平）的話，該屬性值不會有任何影響。 提示：如果你有嚴重的卡頓，可以設為false。
spawn-npcs	布林值	true	決定是否生成村民。 true - 啟用。生成村民。 false - 禁用。不會有村民。
spawn-protection	整數	16	通過將該值進行2x+1的運算來決定出生點的保護半徑。設定為0將不會禁用出生點保護，但會保護位於出生點的那一個方塊。設定為1會保護以出生點為中心的3x3方塊的區域，2會保護5x5方塊的區域，3會保護7x7方塊的區域，以此類推。這個選項不在第一次伺服器啟動時生成，只會在第一個玩家加入伺服器時出現。如果伺服器沒有設定OP，這個選項會自動禁用。
sync-chunk-writes	布林值	true	啟用後區塊檔案以同步模式寫入。
use-native-transport	布林值	true	是否使用針對Linux平台的資料包收發優化。此選項僅會在Linux平台上生成。 true - 啟用。啟用Linux資料包收發優化。 false - 禁用。禁用Linux資料包收發優化。
view-distance	整數（3-32）	10	設定伺服器發送給客戶端的世界數據量，也就是設定玩家各個方向上的區塊數量（是以玩家為中心的半徑，不是直徑）。它決定了伺服器的可視距離。（另見視野距離） 預設/推薦設定為10，如果有嚴重卡頓的話，減少該數值。 注:該值小於9時會對伺服器上的生物生成有顯著影響，詳見bugMC-2536。
white-list	布林值	false	啟用伺服器的白名單。 當啟用時，只有白名單上的用戶才能連接伺服器。白名單主要用於私人伺服器，例如提供給相識的朋友、通過應用流程謹慎選擇的陌生人等。 false - 不使用白名單。 true - 從whitelist.json檔案載入白名單。 注: OP會自動被視為在白名單上，所以無需再將OP加入白名單。
enforce-whitelist	布林值	false	在伺服器上強制執行白名單。 當啟用後，不在白名單（前提是啟用）中的用戶將在伺服器重新載入白名單檔案後從伺服器踢出。 true - 不在白名單上的用戶會被踢出。 false - 不在白名單上的線上用戶不會被踢出。

在Java版1.12之前的版本中，announce-player-achievements 布林值（預設為true）屬性用於切換是否成就要廣播給所有玩家。該屬性已被移除，但如果已經設定了這條屬性，則遊戲規則announceAdvancements將自動更新，隨後從檔案中刪除這條屬性。

基岩版

屬性名稱	可選值	預設值	何時生效	作用	備註
gamemode	survival (0), creative (1), adventure (2)	survival	總是生效或新玩家進入時	設定新玩家的遊戲模式。	survival (0) - 生存模式 creative (1) - 創造模式 adventure (2) - 冒險模式
difficulty	peaceful (0), easy (1), normal (2), hard (3)	easy	總是生效	設定世界的遊戲難易度。	peaceful (0) - 和平 easy (1) - 簡單 normal (2) - 普通 hard (3) - 困難
level-type	FLAT, LEGACY, DEFAULT	DEFAULT	生成地形時	決定生成的地圖的類型。	FLAT-超平坦 LEGACY-舊世界類型 DEFAULT-預設
server-name	任意字符串	Dedicated Server	總是生效	用作伺服器的名稱	作為伺服器在遊戲內伺服器列表中顯示的名稱。
max-players	正整數	10	總是生效	設定伺服器同時能容納的最大玩家數量。	這是應該能在伺服器上遊戲的玩家的最大數量。較高的值可能會影響伺服器性能。
server-port	任意整數	19132	總是生效	設定伺服器監聽的IPv4埠號。
server-portv6	任意整數	19133	總是生效	設定伺服器監聽的IPv6埠號。
level-name	任意字符串	level	總是生效	該值用於世界的名稱以及資料夾名。你也可以複製你的存檔到這裡，並把該值修改成資料夾的名稱，以此替換伺服器載入的存檔。	使用/生成的存檔名稱。每個存檔在/worlds中都有單獨的資料夾。
level-seed	任意字符串	空白（th34f1ju34facjn5f871df312h）	生成地形時	用於將世界隨機化	為世界定義一個種子。留空將隨機選擇種子。
online-mode	true, false	true	總是生效	是否身份驗證	如果為true，則每個連接的玩家都必須與Xbox Live進行身份驗證。
white-list	true, false	false	總是生效	是否開啟白名單	如果為true，則玩家都必須要在whitelist.json檔案中才能登錄伺服器。
allow-cheats	true, false	false	總是生效	是否允許作弊	如果為true，則伺服器將允許作弊行為（例如使用指令）。
view-distance	任意整數	10	總是生效	設定玩家可視距離最大值	單位為區塊。較高的值可能會影響伺服器性能。
player-idle-timeout	任意整數	30	總是生效	設定空閒玩家被踢出的時間	單位為分鐘。玩家空閒時間到達設定值後將被踢出，如果設定為0或被移除。
max-threads	整數	8	總是生效	設定伺服器嘗試使用的最大線程數	伺服器會儘可能多地使用線程。
tick-distance	範圍[4, 12]內的整數	4	總是生效	設定停止載入區塊的距離	當玩家遠離某個區塊的距離超過設定值後，該區塊會停止載入。較高的值可能會影響伺服器性能。
default-player-permission-level	visitor, member, operator	member	總是生效	設定新玩家加入時的權限	visitor-新玩家不可破壞方塊 member-新玩家正常加入 operator-新玩家加入時即為OP
texturepack-required	true, false	false	總是生效	是否強制載入資源包	如果為 true，則當伺服器有資源包時，將強制客戶端使用。
content-log-file-enabled	true,false	false		是否啟用錯誤日誌

Minecraft Classic 伺服器屬性

屬性	類型	預設值	描述
verify-names	布林值	true	驗證玩家的IP是否與其連接Minecraft.net的IP相同。如果啟用，在一台電腦上同幸運行伺服器和客戶端的人會出現問題，伺服器看見的是本地IP（127.0.0.1），而Minecraft.net看到的是外部IP。除非上述情況發生，建議啟用該屬性。 true - 啟用。伺服器會和Minecraft.net檢查所有的名字。 false - 禁用。伺服器會確保IP吻合。
admin-slot	布林值	false	允許OP在伺服器人滿時也能加入遊戲。
public	布林值		伺服器是否顯示在伺服器列表裡。 true - 伺服器會顯示在伺服器列表裡，任何人都能看到。 false - 只有掌握伺服器 URL（可以在externalurl.txt中找到）的人和掌握IP和埠的人才能加入。
server-name	字符串		伺服器名稱，會顯示在伺服器名單上及有人正加入伺服器時。 單行文本。部分字符，例如 '（單引號）可能需要在前面加反斜槓號\才能正確應用。
max-players	整數（0-256）		伺服器同時線上的最大玩家人數。注意，伺服器上玩家越多，伺服器使用的資源越多。同樣注意，伺服器管理員的連接不算在內。
max-connections	整數（1-3）		同一個IP允許的最大連接數。 注: 如果你嘗試設定的值大於3，它會被改回3。
motd	字符串		MOTD 是Message of the day（每日一句）的簡寫，儘管你不用每天更改。MOTD是玩家加入伺服器時顯示的信息。
grow-trees	布林值		是否允許樹苗長成為樹木。 true - 伺服器會允許樹苗長成為樹木。 false - 伺服器不會允許樹苗長成為樹木。

歷史

Java版（Classic）
伺服器1.5					加入了 max-connections，限制一個IP位址的最大連接數。
伺服器1.9.1					加入了 grow-tree， 除非將其設定為true，否則樹苗將不會長成樹木。
伺服器1.10					加入了verify-names 禁用時的警告。
					加入了admin-slot，關閉它將使OP無法在伺服器人滿時加入遊戲。
Java版（Alpha）
伺服器0.2.0					加入了monsters選項，如果設定為true將生成怪物。
伺服器0.2.4					加入了no-animals 選項，如果設定為true則不會生成動物。
伺服器0.2.5					加入了pvp選項，禁用或者啟用玩家對戰（PVP）。
					將monsters重命名為spawn-monsters 並將預設設定為true。
					將no-animals重命名為spawn-animals 。
Java版（Beta）
1.6					加入了allow-nether ，如果設定為false則會禁止進入地獄。
					加入了view-distance ，設定了大視距。
Java版
1.0.0		Beta 1.9 Prerelease 4			加入了debug，enable-query，enable-rcon，query.port，rcon.password 和rcon.port。
1.1		11w49a			加入了spawn-npcs。
		12w01a			加入了level-type。
		release			加入了generate-structures。
1.2.1		12w07a			加入了max-build-height。
1.7.2		13w38a			加入了announce-player-achievements。
1.8		14w17a			加入了generator-settings。
		14w28a			加入了自訂網路壓縮選項。
1.12		17w18a			遊戲規則announceAdvancements取代選項announce-player-achievements 。
1.14		18w48a			difficulty和gamemode 設定使用字符串，整數仍舊可以使用。
1.14.4		pre4			加入了function-permission-level 選項，可以控制函數的權限等級。
1.16		20w14a			添加了sync-chunk-writes選項，是否禁用新的同步區塊寫入。
		20w16a			Added enable-jmx-monitoring 選項，啟用將使MBean使用以毫秒為單位時間計時。
		20w18a			加入了enable-status 和entity-broadcast-range-percentage 選項。
1.16.2		20w28a			加入了rate-limit，設定資料包的速度限制。