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 目錄下啟動(
|
基岩版[編輯 | 編輯原始碼]
本檔案會與bedrock_server.exe
一同下載。
作業系統 | 檔案位置 |
---|---|
Windows | bedrock_server.exe 的相同目錄下
|
Linux | bedrock_server 的相同目錄下
|
server.properties[編輯 | 編輯原始碼]
新安裝的Minecraft伺服器具有以下預設設定:
Java版[編輯 | 編輯原始碼]
#Minecraft server properties
#(文件修改时间戳)
spawn-protection=16
max-tick-time=60000
query.port=25565
generator-settings=
sync-chunk-writes=true
force-gamemode=false
allow-nether=true
enforce-whitelist=false
gamemode=survival
broadcast-console-to-ops=true
enable-query=false
player-idle-timeout=0
text-filtering-config=
difficulty=easy
broadcast-rcon-to-ops=true
spawn-monsters=true
op-permission-level=4
pvp=true
entity-broadcast-range-percentage=100
snooper-enabled=true
level-type=default
enable-status=true
hardcore=false
enable-command-block=false
network-compression-threshold=256
max-players=20
max-world-size=29999984
resource-pack-sha1=
function-permission-level=2
rcon.port=25575
server-port=25565
server-ip=
spawn-npcs=true
require-resource-pack=false
allow-flight=false
level-name=world
view-distance=10
resource-pack=
spawn-animals=true
white-list=false
rcon.password=
generate-structures=true
online-mode=true
level-seed=
prevent-proxy-connections=false
use-native-transport=true
enable-jmx-monitoring=false
motd=A Minecraft Server
rate-limit=0
enable-rcon=false
基岩版[編輯 | 編輯原始碼]
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前提下在生存模式下飛行。
允許飛行可能會使惡意破壞者更加常見,因為此設定會使他們更容易達成目的。在創造模式下無作用。
|
allow-nether | 布林值 | true | 允許玩家進入地獄。 |
broadcast-console-to-ops | 布林值 | true | 向所有線上OP發送所執行指令的輸出。 |
broadcast-rcon-to-ops | 布林值 | true | 向所有線上OP發送透過RCON執行的指令的輸出。 |
difficulty | 字串 | easy | 定義伺服器的遊戲難易度(例如生物對玩家造成的傷害,飢餓和中毒對玩家的影響方式等)。
如果設定了舊的數字ID,則會自動轉化為英文的難易度名稱。
|
enable-command-block | 布林值 | false | 是否啟用指令方塊。 |
enable-jmx-monitoring | 布林值 | false | 暴露一個具有對象名net.minecraft.server:type=Server 的MBean 和兩個屬性averageTickTime 和tickTimes 用於暴露以毫秒為單位的tick時間。
|
enable-query | 布林值 | false | 允許使用GameSpy4協議的伺服器監聽器。用於取得伺服器資訊。 |
enable-rcon | 布林值 | false | 是否允許遠程訪問伺服器控制台。 |
enable-status | 布林值 | true | 使伺服器在伺服器列表中看起來是「線上」的。 |
enforce-whitelist | 布林值 | false | 在伺服器上強制執行白名單。
當啟用後,不在白名單(前提是啟用)中的使用者將在伺服器重新載入白名單檔案後從伺服器踢出。
|
entity-broadcast-range-percentage | 整數(10-1000) | 100 | 此選項控制實體需要距離玩家有多近才會將資料包發送給客戶端。更高的數值意味著實體可以在更遠的地方就被渲染,同時也可能提高增加延遲的機率。
|
force-gamemode | 布林值 | false | 強制玩家加入時為預設遊戲模式。
|
function-permission-level | 整數(1-4) | 2 | 設定函數的預設權限等級。
4個等級的詳情見 #op-permission-level。 |
gamemode | 字串 | survival | 定義預設遊戲模式。
如果值是舊用的數字,會靜默轉換為對應遊戲模式的英文名稱。
|
generate-structures | 布林值 | true | 定義是否能生成結構(例如村莊)。
註:即使設為false,地牢仍然會生成。 |
generator-settings | 字串 | 空白 | 本屬性質用於自訂世界的生成。詳見超平坦世界和自訂了解正確的設定及例子。 |
hardcore | 布林值 | false | 如果設為 true,伺服器難易度的設定會被忽略並且設為 hard(困難),玩家在死後會自動切換至旁觀者模式。 |
level-name | 字串 | world | 「level-name」的值將作為世界名稱及其資料夾名。你也可以把你已生成的世界存檔複製過來,然後讓這個值與那個資料夾的名字保持一致,伺服器就可以載入該存檔。
|
level-seed | 字串 | 空白 | 與單人遊戲類似,為你的世界定義一個種子。
|
level-type | 字串 | default | 確定地圖所生成的類型
|
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)
|
max-world-size |
整數(1-29999984) | 29999984 | 設定可讓世界邊界獲得的最大半徑值,單位為方塊。透過成功執行的指令能把世界邊界設定得更大,但不會超過這裡設定的最大方塊限制。如果設定的 max-world-size 超過預設值的大小,那將不會起任何效果。
例如:
|
motd | 字串 | A Minecraft Server | 本屬性值是玩家客戶端的多人遊戲伺服器列表中顯示的伺服器資訊,顯示於名稱下方。 |
network-compression-threshold |
整數 | 256 | 預設會允許n-1位元組的資料包正常發送, 如果資料包為n字節或更大時會進行壓縮。所以,更低的數值會使得更多的資料包被壓縮,但是如果被壓縮的資料包字節太小將反而使壓縮後字節更大。
註:乙太網規範要求把小於64位元組的資料包填充為64位元組。因此,設定一個低於64的值可能沒有什麼好處。也不推薦讓設定的值超過MTU(通常為1500位元組)。 |
online-mode | 布林值 | true | 是否讓伺服器對比Minecraft帳號資料庫驗證登入資訊。只有在你的伺服器並未與 Internet 連接時,才將這個值設為false。如果設為false,駭客就能夠使用任意假帳號連接伺服器!如果minecraft.net伺服器宕機或不可訪問,那麼該值設為true的伺服器會因為無法驗證玩家身份而拒絕所有玩家加入。通常,這個值設為true的伺服器被稱為「正版伺服器」。故意設定該變數為false的伺服器稱為「破解伺服器」,這類伺服器允許擁有未授權的Minecraft副本的玩家加入。
|
op-permission-level | 整數(1-4) | 4 | 設定使用/op 指令時OP的權限等級。所有存檔會從之前的存檔繼承能力和指令。
|
player-idle-timeout | 整數 | 0 | 如果不為0,伺服器將在玩家的空閒時間達到設定的時間(單位為分鐘)時將玩家踢出伺服器 |
prevent-proxy-connections | 布林值 | false | 如果伺服器發送的ISP/AS和Mojang的驗證伺服器的不一樣,玩家將會被踢出。
|
pvp | 布林值 | true | 是否允許PvP。也只有在允許PvP時玩家自己的箭才會受到傷害。
|
query.port | 整數(1-65534) | 25565 | 設定監聽伺服器的埠號(參見 enable-query)。 |
rate-limit | 整數 | 0 | 設定玩家被踢出伺服器前,可以發送的資料包數量。
|
rcon.password | 字串 | 空白 | 設定RCON遠程訪問的密碼(參見enable-rcon)。RCON:能允許其他應用程式透過網際網路與Minecraft伺服器連接並互動的遠程控制台協議。 |
rcon.port | 整數(1-65534) | 25575 | 設定RCON遠程訪問的埠號。 |
require-resource-pack[新增:JE 1.17] | 布林值 | false | 當此選項啟用(設為true)時,玩家會被提示作出選擇(是否啟用伺服器資源包)。如果玩家拒絕則會被伺服器斷開連接。 |
resource-pack | 字串 | 空白 | 可選選項,可輸入指向一個資源包的URI。玩家可選擇是否使用該資源包。
注意若該值含":"和"="字元,需要在其前加上反斜線(\),例如 http\://somedomain.com/somepack.zip?someparam\=somevalue 資源包大小理應不能超過
注意,下載成功或失敗由客戶端記錄,而非伺服器。 |
resource-pack-sha1 | 字串 | 空白 | 資源包的SHA-1值,必須為小寫十六進位,建議填寫它。這還沒有用於驗證資源包的完整性,但是它提高了資源包緩存的有效性和可靠性。 |
server-ip | 字串 | 空白 | 將伺服器與一個特定IP綁定。強烈建議留空該屬性值!
|
server-port | 整數(1-65534) | 25565 | 改變伺服器(監聽的)埠號。如果伺服器在使用NAT的網路中執行,該埠必須被轉發(在你有家用路由器/抗火牆的前提下)。 |
snooper-enabled | 布林值 | true | 是否允許伺服器定期發送統計數據到http://snoop.minecraft.net。
|
spawn-animals | 布林值 | true | 決定動物是否可以生成。
提示:如果你有嚴重的卡頓,可以設為false。 |
spawn-monsters | 布林值 | true | 決定攻擊型生物(怪物)是否可以生成。
如果difficulty=0(即難易度設定為和平)的話,該屬性值不會有任何影響。 提示:如果你有嚴重的卡頓,可以設為false。 |
spawn-npcs | 布林值 | true | 決定是否生成村民。
|
spawn-protection | 整數 | 16 | 透過將該值進行2x+1的運算來決定出生點的保護半徑。設定為1會保護以出生點為中心的3x3方塊的區域,2會保護5x5方塊的區域,3會保護7x7方塊的區域,以此類推。這個選項不在第一次伺服器啟動時生成,只會在第一個玩家加入伺服器時出現。如果伺服器沒有設定OP,這個選項會自動停用。
|
sync-chunk-writes | 布林值 | true | 啟用後區塊檔案以同步模式寫入。 |
text-filtering-config | [需要更多資訊] | [需要更多資訊] | [需要更多資訊] |
use-native-transport | 布林值 | true | 是否使用針對Linux平台的資料包收發優化。此選項僅會在Linux平台上生成。
|
view-distance | 整數(3-32) | 10 | 設定伺服器發送給客戶端的世界數據量,也就是設定玩家各個方向上的區塊數量(是以玩家為中心的半徑,不是直徑)。它決定了伺服器的可視距離。(另見視野距離)
預設/推薦設定為10,如果有嚴重卡頓的話,減少該數值。 |
white-list | 布林值 | false | 啟用伺服器的白名單。
當啟用時,只有白名單上的使用者才能連接伺服器。白名單主要用於私人伺服器,例如提供給相識的朋友、透過應用流程謹慎選擇的陌生人等。
注: OP會自動被視為在白名單上,所以無需再將OP加入白名單。 |
在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。除非上述情況發生,建議啟用該屬性。
|
admin-slot | 布林值 | false | 允許OP在伺服器人滿時也能加入遊戲。 |
public | 布林值 | 伺服器是否顯示在伺服器列表裡。
| |
server-name | 字串 | 伺服器名稱,會顯示在伺服器名單上及有人正加入伺服器時。
| |
max-players | 整數(0-256) | 伺服器同時線上的最大玩家人數。注意,伺服器上玩家越多,伺服器使用的資源越多。同樣注意,伺服器管理員的連接不算在內。 | |
max-connections | 整數(1-3) | 同一個IP允許的最大連接數。
注: 如果你嘗試設定的值大於3,它會被改回3。 | |
motd | 字串 | MOTD 是Message of the day(每日一句)的簡寫,儘管你不用每天變更。MOTD是玩家加入伺服器時顯示的資訊。 | |
grow-trees | 布林值 | 是否允許樹苗長成為樹木。
|
歷史[編輯 | 編輯原始碼]
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-pre4 | 加入了debug ,enable-query ,enable-rcon ,query.port ,rcon.password 和rcon.port 。 | |||
1.1 | 11w49a | 加入了spawn-npcs 。 | |||
12w01a | 加入了level-type 。 | ||||
正式版 | 加入了generate-structures 。 | ||||
1.2.1 | 12w07a | 加入了max-build-height 。 | |||
1.4.2 | 12w40a | 加入了spawn-protection 。 | |||
1.5 | 13w05a | 將spawn-protection 設定為0會把出生點保護關閉了,而不是像以前一樣保護1×1的範圍(MC-666)。 | |||
1.7.2 | 13w38a | 加入了announce-player-achievements 。 | |||
1.8 | 14w17a | 加入了generator-settings 。 | |||
14w28a | 加入了自訂網路壓縮選項。 | ||||
1.11 | 16w38a | 加入了prevent-proxy-connections 。 | |||
1.12 | 17w18a | 遊戲規則announceAdvancements 取代選項announce-player-achievements 。 | |||
1.14 | 18w48a | difficulty 和gamemode 設定使用字串,整數仍舊可以使用。 | |||
1.14.4 | pre4 | 加入了function-permission-level 選項,可以控制函數的權限等級。 | |||
1.15 | pre5 | 將伺服器資源包的大小上限提升到100MB。 | |||
1.16 | 20w14a | 加入了sync-chunk-writes 選項,是否停用新的同步區塊寫入。 | |||
20w16a | 加入了enable-jmx-monitoring 選項,啟用將使MBean使用以毫秒為單位時間計時。 | ||||
20w18a | 加入了enable-status 和entity-broadcast-range-percentage 選項。 | ||||
1.16.2 | 20w28a | 加入了rate-limit ,設定資料包的速度限制。 | |||
1.16.4 | pre1 | 加入了text-filtering-config 。 | |||
Java版(即將到來) | |||||
1.17 | 20w45a | 加入了require-resource-pack ,用於強制使使用者接受伺服器資源包。 |
版本 | |||||||
---|---|---|---|---|---|---|---|
開發週期 |
| ||||||
技術 |
| ||||||
多人遊戲 |
| ||||||
遊戲訂製 |