server.properties

出自Minecraft Wiki
跳到: 導覽搜尋

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
content-log-file-enabled=false
compression-threshold=1
server-authoritative-movement=true
player-movement-score-threshold=20
player-movement-distance-threshold=0.3
player-movement-duration-threshold-in-ms=500
correct-player-movement=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 - 伺服器不會允許樹苗長成為樹木。

歷史[編輯 | 編輯原始碼]

Clock JE2 BE1.gif
此段落需要更新。

原因:一些設定並沒有首先介紹,且缺少了基岩版內容

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.0Beta 1.9 Prerelease 4加入了debugenable-queryenable-rconquery.portrcon.passwordrcon.port
1.111w49a加入了spawn-npcs
12w01a加入了level-type
release加入了generate-structures
1.2.112w07a加入了max-build-height
1.7.213w38a加入了announce-player-achievements
1.814w17a加入了generator-settings
14w28a加入了自訂網路壓縮選項。
1.1217w18a遊戲規則announceAdvancements取代選項announce-player-achievements
1.1418w48adifficultygamemode 設定使用字串,整數仍舊可以使用。
1.14.4pre4加入了function-permission-level 選項,可以控制函數的權限等級。
1.1620w14a加入了sync-chunk-writes選項,是否停用新的同步區塊寫入。
20w16aAdded enable-jmx-monitoring 選項,啟用將使MBean使用以毫秒為單位時間計時。
20w18a加入了enable-statusentity-broadcast-range-percentage 選項。
1.16.220w28a加入了rate-limit,設定資料包的速度限制。