本站文本内容除另有声明外,均在知识共享 署名-非商业性使用-相同方式共享 3.0 协议下提供。(详情…本站文本内容除另有声明外,均在知识共享 署名-非商业性使用-相同方式共享 3.0 协议下提供。(详情…中文Minecraft Wiki是完全公开的。请勇于扩充与修正内容!中文Minecraft Wiki是完全公开的。请勇于扩充与修正内容!Minecraft中文Wiki微博正在更新!或许有兴趣去看看Minecraft中文Wiki微博正在更新!或许有兴趣去看看想与其他用户进行编辑上的沟通?社区专页正是为此创建的。想与其他用户进行编辑上的沟通?社区专页正是为此创建的。翻译或创建页面之前,不妨看看译名标准化Wiki条例页面。翻译或创建页面之前,不妨看看译名标准化Wiki条例页面。需要管理员的协助?在管理员告示板留言也许可以帮到您。需要管理员的协助?在管理员告示板留言也许可以帮到您。

server.properties

從 Minecraft Wiki
跳到: 導覽搜尋
此條目的部分內容由於太久沒更新而已過期。
你可以幫助我們來更新此條目。
Information icon.svg
此特性為Java版基岩版獨有。
用Notepad++打開的server.properties文件

server.properties為Minecraft服務端用於配置多人遊戲所有參數的文件。

如果您要編輯server.properties,儘管不同行之間的順序可以打亂,但請確保您使用和原始的文件相同的結構。每一行的等號之前的文本為變量名,您不應該修改。等號後面為變量的值,您可以按照規則自行編輯。以#開頭的一行為注釋,添加、修改或移除注釋行不會對服務端運行造成任何影響。

在編輯並保存server.properties的更改之後,服務端必須重新啟動以使更改生效。

如果server.properties文件未列出下文中所有的屬性(例如服務端版本更新加入新屬性,或 server.properties還未創建),那麼請先運行一下服務端程序。程序會補全缺失的屬性並將它們的值設為預設。

文件位置[編輯 | 編輯原始碼]

Java版[編輯 | 編輯原始碼]

本文件會在服務端第一次運行時自動生成(如果本來沒有的話)。

作業系統 文件位置 註解
Windows server.jar的相同目錄下
Linux

Unix Unix/Mac

工作目錄路徑(pwd)

如果你在你的home目錄下啟動(/home/yourname),服務端文件也會在/home/yourname下創建。請按照下列步驟確保服務端文件能夠如你希望地成功生成。

  • 準備一個完整的資料夾以存放所有服務端文件。(如果你不這麼做的話事情會一團糟
    • 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
#(File Modification Datestamp)
spawn-protection=
max-tick-time=
query.port=
generator-settings=
force-gamemode=
allow-nether=
enforce-whitelist=
gamemode=
broadcast-console-to-ops=
enable-query=
player-idle-timeout=
difficulty=
spawn-monsters=
broadcast-rcon-to-ops=
op-permission-level=
pvp=
snooper-enabled=
level-type=
hardcore=
enable-command-block=
max-players=
network-compression-threshold=
resource-pack-sha1=
max-world-size=
function-permission-level=
rcon.port=
server-port=
server-ip=
spawn-npcs=
allow-flight=
level-name=
view-distance=
resource-pack=
spawn-animals=
white-list=
rcon.password=
generate-structures=
max-build-height=
online-mode=
level-seed=
use-native-transport=
prevent-proxy-connections=
enable-rcon=
motd=

基岩版[編輯 | 編輯原始碼]

server-name=
# Used as the server name
# Allowed values: Any string

gamemode=
# Sets the game mode for new players.
# Allowed values: "survival", "creative", or "adventure"

difficulty=
# Sets the difficulty of the world.
# Allowed values: "peaceful", "easy", "normal", or "hard"

allow-cheats=
# If true then cheats like commands can be used.
# Allowed values: "true" or "false"

max-players=
# The maximum number of players that can play on the server.
# Allowed values: Any positive integer

online-mode=
# If true then all connected players must be authenticated to Xbox Live.
# Clients connecting to remote (non-LAN) servers will always require Xbox Live authentication regardless of this setting.
# If the server accepts connections from the Internet, then it's highly recommended to enable online-mode.
# Allowed values: "true" or "false"

white-list=
# If true then all connected players must be listed in the separate whitelist.json file.
# Allowed values: "true" or "false"

server-port=19132
# Which IPv4 port the server should listen to.
# Allowed values: Integers in the range [1, 65535]

server-portv6=19133
# Which IPv6 port the server should listen to.
# Allowed values: Integers in the range [1, 65535]

view-distance=
# The maximum allowed view distance in number of chunks.
# Allowed values: Any positive integer.

tick-distance=4
# The world will be ticked this many chunks away from any player.
# Allowed values: Integers in the range [4, 12]

player-idle-timeout=30
# After a player has idled for this many minutes they will be kicked. If set to 0 then players can idle indefinitely.
# Allowed values: Any non-negative integer.

max-threads=8
# Maximum number of threads the server will try to use. If set to 0 or removed then it will use as many as possible.
# Allowed values: Any positive integer.

level-name=world
# Allowed values: Any string

level-seed=
# Use to randomize the world
# Allowed values: Any string

default-player-permission-level=member
# Permission level for new players joining for the first time.
# Allowed values: "visitor", "member", "operator"

texturepack-required = ture
# Force clients to use texture packs in the current world
# Allowed values: "true" or "false"

Minecraft伺服器設定[編輯 | 編輯原始碼]

Java版[編輯 | 編輯原始碼]

屬性 類型 預設值 描述
allow-flight 布爾值 false 允許玩家在安裝添加飛行功能的 mod 前提下在生存模式下飛行。

允許飛行可能會使惡意破壞者更加常見,因為此設定會使他們更容易達成目的。在創造模式下本屬性不會有任何作用。

false - 不允許飛行。懸空超過5秒的玩家會被踢出伺服器。也會包括使用三叉戟的波濤附魔、時間很長的自由落體或是網絡卡頓導致的誤判。
true - 允許飛行。玩家得以使用飛行MOD飛行。
allow-nether 布爾值 true 允許玩家進入地獄
false - 地獄傳送門不會生效。
true - 玩家可以通過地獄傳送門前往地獄
announce-player-achievements 布爾值 true 玩家獲得成就時是否在伺服器中進行顯示。
false - 玩家獲得成就時的提示僅自己可見,不會向其他玩家進行顯示。
true - 玩家獲得成就時將在其他在線玩家的聊天欄進行提示。
例如:jeb_ 剛剛獲得了 [打開物品欄] 成就!
difficulty 字符串 easy 定義伺服器的遊戲難易度(例如生物對玩家造成的傷害,飢餓與中毒對玩家的影響方式等)。

如果設定了舊的數字ID,則會自動轉化為英文的難易度名稱

peaceful(0) - 和平
easy(1) - 簡單
normal(2) - 普通
hard(3) - 困難
enable-query 布爾值 false 允許使用GameSpy4協議的伺服器監聽器。它被用於收集伺服器信息。
enable-rcon 布爾值 false 是否允許遠程訪問伺服器控制台。
force-gamemode 布爾值 false 強制玩家加入時為預設遊戲模式
false - 玩家將以退出前的遊戲模式加入
true - 玩家總是以預設遊戲模式加入
gamemode 整數(0-3) 0 定義預設遊戲模式
0 - 生存模式
1 - 創造模式
2 - 冒險模式(僅在12w22a之後,或正式版1.3之後可用)
3 - 旁觀者模式(僅在14w05a之後,或正式版1.8之後可用)
generate-structures 布爾值 true 定義是否在生成世界時生成結構(例如村莊
false - 新生成的區塊中將不包含結構。
true - 新生成的區塊中將包含結構。

註: 即使設為 false,地牢和地獄要塞仍然會生成

generator-settings 字符串 空白 本屬性質用於自定義超平坦世界的生成。詳見超平坦世界自定義了解正確的設定及例子。
hardcore 布爾值 false 一旦啟用,玩家在死後會自動被伺服器封禁(即開啟極限模式)。
level-name 字符串 world 「level-name」的值將作為世界名稱及其資料夾名。你也可以把你已生成的世界存檔複製過來,然後讓這個值與那個資料夾的名字保持一致,伺服器就可以載入該存檔。
部分字符,例如 ' (單引號)可能需要在前面加反斜槓號 \ 才能被正常應用。
level-seed 字符串 空白 與單人遊戲類似,為你的世界定義一個種子
這裏有一些例子:minecraft,404,1a2b3c。
level-type 字符串 DEFAULT 確定地圖所生成的類型
DEFAULT - 標準的世界帶有丘陵,河谷,海洋等
FLAT - 一個沒有特色的平坦世界,適合用於建設
LARGEBIOMES - 如同方案世界,但所有生態系都更大(僅快照12w19a,或正式版1.3之後可用)
AMPLIFIED - 如同方案世界,但世界生成高度提高(僅快照13w36a,或正式版1.7.2之後可用)
CUSTOMIZED - 自快照14w21b以來,伺服器也支持自定義地形。使用方法是在generator-settings貼上代碼。
max-build-height 整數 256 玩家在遊戲中能夠建造的最大高度。地形生成算法並不會受這個值的影響。
max-players 整數(1-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 ,然而這樣的話破壞者也能夠使用任意假賬戶登錄伺服器。如果 Minecraft.net 伺服器下線,那麼開啟在線驗證的伺服器會因為無法驗證玩家身份而拒絕所有玩家加入。通常,這個值設為 true 的伺服器被稱為「正版伺服器」,設為 false 的被稱為「離線伺服器」或「盜版伺服器」。
true - 啟用。伺服器會認為自己具有 Internet 連接,並檢查每一位連入的玩家。
false - 禁用。伺服器不會檢查玩家。
op-permission-level 整數(1-4) 4 設定OP的權限等級
1 - OP可以無視重生點保護。
2 - OP可以使用單人遊戲作弊指令(除了/publish,因為不能在伺服器上使用,/debug也是)並使用指令方塊。指令方塊和領域服服主/管理員有此等級權限。
3 - OP可以使用幾乎所有多人遊戲限定的指令(除第4級專用指令)
4 - OP可以使用所有指令,包括/stop、/save-all、/save-on和/save-off。
player-idle-timeout 整數 0 如果不為0,伺服器將在玩家的空閒時間達到設定的時間(單位為分鐘)時將玩家踢出伺服器
例如:把player-idle-timeout設定為3,玩家空閒時間達到3分鐘就會被踢出伺服器。
註: 當伺服器接受到下列資料包之一時將會重置空閒時間:
prevent-proxy-connections 布爾值 false 如果伺服器發送的和Mojang的驗證伺服器的ISP/AS不一樣,玩家將會被踢出
true - 伺服器將會禁止玩家使用虛擬專用網絡或代理
false - 伺服器將不會禁止玩家使用虛擬專用網絡或代理
pvp 布爾值 true 是否允許PvP。玩家自己的箭也只有在允許PvP時才可能傷害到自己。
註: 來源於玩家的間接傷害,例如熔岩TNT等,還是會造成傷害。
true - 玩家可以互相殘殺。
false - 玩家無法互相造成傷害。
query.port 整數(1-65534) 25565 設定監聽伺服器的端口號(詳見enable-query)。
rcon.password 字符串 空白 設定遠程訪問的密碼(詳見enable-rcon)。
rcon.port 整數(1-65534) 25575 設定遠程訪問的端口號(詳見enable-rcon)。
resource-pack 字符串 空白 可選選項,可輸入指向一個資源包的URI。玩家可選擇是否使用該資源包
resource-pack-sha1 字符串 空白 資源包的SHA-1值,必須為小寫十六進制,建議填寫它,這還沒有用於驗證資源包的完整性,但是它提高了資源包緩存的有效性和可靠性。
註:下載到的伺服器資源包將保存在.minecraft\server-resource-packs下。
server-ip 字符串 空白 將伺服器與一個特定IP綁定。強烈建議你留空本屬性值!
留空,或是填入你想讓伺服器綁定的IP。
server-port 整數(1-65534) 25565 改變伺服器端口號。如果伺服器通過路由器與外界連接的話,該端口必須也能夠通過路由器。
snooper-enabled 布爾值 true 自1.3正式版之後,一旦啟用,將允許服務端定期發送統計數據到http://snoop.minecraft.net.
false - 禁用數據採集
true - 啟用數據採集
spawn-animals 布爾值 true 決定動物是否可以生成。
true - 動物可以生成。
false - 動物生成後會立即消失。
spawn-monsters 布爾值 true 決定攻擊型生物(怪獸)是否可以生成。
true - 可以。只要滿足條件的話怪物就會生成。
false - 禁用。不會有任何怪物。

如果difficulty = 0(和平)的話,本屬性值不會有任何影響。

spawn-npcs 布爾值 true 決定是否生成村民
true - 生成村民
false - 不會有村民。
spawn-protection 整數 16 通過將該值進行(x*2)+1的運算來決定出生點的保護半徑。設定為0將不會禁用出生點保護。設定為0將會保護位於出生點的1x1方塊區域,設定為1將會保護以出生點為中心的3x3方塊區域。設定為2會保護5x5的方塊區域,設定為3將會保護7x7的方塊區域,以此類推。 這個選項只會在第一個玩家進行伺服器時生成。如果伺服器沒有設定OP,這個選項將會自動禁用。
use-native-transport 布爾值 true 是否使用針對Linux平台的資料包收發優化,此選項僅會在Linux平台下生成。
true - 啟用
false - 禁用
view-distance 整數(3-15) 10 設定服務端傳送給客戶端的數據量,也就是設定玩家各個方向上的區塊數量 (是以玩家為中心的半徑,不是直徑)。 它決定了服務端的可視距離。(另見 視野距離)

預設/推薦設定為10,如果很卡的話,減少該數值。

white-list 布爾值 false 伺服器的白名單

當啟用時,只有白名單上的用戶才能連接伺服器。白名單主要用於私人伺服器,例如相識的朋友等。

- OP會自動被視為在白名單上。所以無需再將OP加入白名單。
false - 不使用白名單。
true - 從 whitelist.json 文件加載白名單。
enable-command-block 布爾值 false 是否啟用指令方塊
true - 啟用
false - 禁用
enforce-whitelist 布爾值 false 在伺服器上強制執行白名單。

當啟用後,不在白名單中的用戶將在伺服器重新加載白名單文件後從伺服器踢出。

true - 啟用
false - 禁用

在1.12之後的版本中,announce-player-achievements屬性被移除。如果已經在伺服器配置文件中設定了此條屬性,則遊戲規則announceAdvancements將自動更新,隨後從文件中刪除此條屬性。

基岩版[編輯 | 編輯原始碼]

屬性 可選值 預設值 何時生效 作用 備註
allow-cheats 布爾值 false 總是生效 是否允許作弊 如果為true,則伺服器將允許作弊行為(例如使用指令方塊)。
default-player-permission-level 字符串 member 總是生效 設定新玩家加入時的權限 visitor-新玩家不可破壞方塊

member-新玩家正常加入

operator-新玩家加入時即為OP

difficulty 字符串或整數(0-3) easy 總是生效 設定伺服器的遊戲難易度 peaceful (0)-和平

easy (1)-簡單

normal (2)-普通

hard (3)-困難

gamemode 字符串或整數(0-2) survival 總是生效或新玩家進入時 設定新玩家的遊戲模式 survival (0)-生存模式

creative (1)-創造模式

adventure (2)-冒險模式

level-name 字符串 level 總是生效 作為世界名稱以及資料夾名 可以將自己的存檔資料夾複製到這裏,並把資料夾名改為與之前的資料夾相同的名稱,以便在伺服器中加載自己的世界。每個世界在/world中都有單獨的資料夾。
level-seed 字符串 空白 生成地形時 為世界定義一個種子 留空將隨機選擇種子。
level-type 字符串 DEFAULT 生成地形時 設定地圖的類型 FLAT-超平坦

LEGACY-舊世界類型

DEFAULT-預設

max-players 正整數 10 總是生效 設定伺服器同時能容納的最大玩家數量 較高的值可能會影響伺服器性能。
max-threads 整數 8 總是生效 設定伺服器使用的最大線程數 如果設定為0,伺服器會儘可能多地使用所有線程。
online-mode 布爾值(true, false) true 總是生效 是否身份驗證 如果為true,則每個玩家都必須與Xbox進行身份驗證。
player-idle-timeout 整數 30 總是生效 設定空閒玩家被踢出的時間 單位為分鐘。玩家空閒時間到達設定值後將被踢出。
server-name 字符串 Dedicated Server 總是生效 作為伺服器的名稱 將作為伺服器在伺服器列表中顯示的名稱。
server-port 整數 19132 總是生效 設定伺服器的IPv4端口號
server-portv6 整數 19133 總是生效 設定伺服器的IPv6端口號
texturepack-required 布爾值 false 總是生效 是否強制加載資源包 如果為true,則當伺服器有資源包時,將強制客戶端使用。
tick-distance 整數(4-12) 4 總是生效 設定停止加載區塊的距離 當玩家遠離某個區塊的距離超過設定值後,該區塊會停止加載。較高的值可能會影響伺服器性能。
view-distance 整數 10 總是生效 設定玩家可視距離最大值 單位為區塊較高的值可能會影響伺服器性能。
white-list 布爾值 false 總是生效 是否有白名單 如果為true,則每個玩家都必須要在whitelist.json文件中才能登錄伺服器。

Minecraft Classic伺服器屬性[編輯 | 編輯原始碼]

屬性 類型 預設值 描述
verify-names 布爾值 true 驗證玩家的IP是否與其連接Minecraft.net的IP相同。如果啟用,會在內部網絡中造成問題。
true - 啟用。
false - 禁用。
admin-slot 布爾值 false 允許OP在伺服器人滿時也能加入遊戲。
public 布爾值 伺服器是否顯示在伺服器列表裏。
true - 伺服器會顯示在伺服器列表裏,任何人都能看到。
false - 伺服器不會對外廣播。只有掌握伺服器地址的人才能加入。
server-name 字符串 伺服器名稱,會顯示在伺服器名單上。
  • 單行文本。部分字符,例如'(單引號)可能需要在前面加反斜槓號\才能正確應用。
max-players 整數(0-256) 伺服器同時在線的最大玩家人數。伺服器OP不被計算在內。
max-connections 整數(1-3) 同一個IP允許的最大連接數。
motd 字符串 motd是玩家加入伺服器時顯示的信息。
grow-trees 布爾值 是否允許樹苗長成為樹木。
true - 允許樹苗長成為樹木。
false - 不允許樹苗長成為樹木。