The Minecraft Wiki is no longer considered as official by Microsoft and therefore several changes are required to be made, including to the wiki’s logo. Please read this announcement for more information.
server.properties
The default server.properties file for Java Edition.
server.properties is the file that stores all the settings for a multiplayer (Minecraft or Minecraft Classic) server.
When editing server.properties, it is important that the same structure as the original is used, although the order of the lines is arbitrary. The text before the equal sign is the key, which should not be changed. The text after the equal sign is the property’s value, which can be edited. Lines that begin with # are comments – altering or removing these lines has no effect on the game.
After changes are made to the server.properties file, the server must be restarted for them to take effect. Another option is to use the /reload command in the server console or in-game, which will also allow changes to be reloaded.
If the server.properties file does not list all properties (such as if a new version of the server adds new properties, or if the file does not exist), then on startup, the server rewrites the server.properties file with the new properties listed and set them to their default values.
The server.properties file is simply a normal text file with UTF-8 encoding, despite its extension, and can therefore be edited with any text editor such as Notepad for Windows, TextEdit for Mac, or nano and vim for Linux.
Contents
File location
Java Edition
This file is automatically generated upon the first start of the server (if it does not exist).
If the player starts it from their home directory ( /home/name ) the server files are created in /home/name. Follow these guidelines for ensuring that the server files are generated where the player would expect them.
Bedrock Edition
This file is downloaded with bedrock_server.exe
OS
File Location
Windows
Same directory as bedrock_server.exe
Linux
Same directory as bedrock_server
server.properties
These are the default settings for a newly installed Minecraft server:
Java Edition
Bedrock Edition
Minecraft server properties
Java Edition
Key
Type
Default Value
Description
allow-flight
boolean
false
Allows users to use flight on the server while in Survival mode, if they have a mod that provides flight installed.
With allow-flight enabled, griefers may become more common, because it makes their work easier. In Creative mode, this has no effect.
If a legacy difficulty number is specified, it is silently converted to a difficulty name.
peaceful (0) easy (1) normal (2) hard (3)
enable-command-block
boolean
false
Enables command blocks
enable-jmx-monitoring
boolean
false
Exposes an MBean with the Object name net.minecraft.server:type=Server and two attributes averageTickTime and tickTimes exposing the tick times in milliseconds.
In order for enabling JMX on the Java runtime you also need to add a couple of JVM flags to the startup as documented here.
If set to false, it will suppress replies from clients. This means it will appear as offline, but will still accept connections.
See permission level for the details on the 4 levels.
gamemode
string
survival
Defines the mode of gameplay.
If a legacy gamemode number is specified, it is silently converted to a gamemode name.
Note:Dungeons still generate if this is set to false.
Note:The Ethernet spec requires that packets less than 64 bytes become padded to 64 bytes. Thus, setting a value lower than 64 may not be beneficial. It is also not recommended to exceed the MTU, typically 1500 bytes.
Note:Indirect damage sources spawned by players (such as lava, fire, TNT and to some extent water, sand and gravel) still deal damage to other players.
Note that (in some versions before 1.15.2), the «:» and «=» characters need to be escaped with a backslash (\), e.g. http\://somedomain.com/somepack.zip?someparam\=somevalue
The resource pack may not have a larger file size than 250 MiB [only upcoming Java Edition 1.18] (Before 1.18: 100 MiB (≈ 100.8 MB)) (Before 1.15: 50 MiB (≈ 50.4 MB)). Note that download success or failure is logged by the client, and not by the server.
Optional, adds a custom message to be shown on resource pack prompt when require-resource-pack is used.
Expects chat component syntax, can contain multiple lines.
resource-pack-sha1
string
blank
Optional SHA-1 digest of the resource pack, in lowercase hexadecimal. It is recommended to specify this, because it is used to verify the integrity of the resource pack.
Note: If the resource pack is any different, a yellow message «Invalid sha1 for resource-pack-sha1» appears in the console when the server starts. Due to the nature of hash functions, errors have a tiny probability of occurring, so this consequence has no effect.
If the player has major lag, it is recommended to turn this off/set to false.
This setting has no effect if difficulty = 0 (peaceful). If difficulty is not = 0, a monster can still spawn from a spawner.
If the player has major lag, it is recommended to turn this off/set to false.
10 is the default/recommended. If the player has major lag, this value is recommended to be reduced.
white-list
boolean
false
Enables a whitelist on the server.
With a whitelist enabled, users not on the whitelist cannot connect. Intended for private servers, such as those for real-life friends or strangers carefully selected via an application process, for example.
Note:Ops are automatically whitelisted, and there is no need to add them to the whitelist.
enforce-whitelist
boolean
false
Enforces the whitelist on the server.
When this option is enabled, users who are not present on the whitelist (if it’s enabled) get kicked from the server after the server reloads the whitelist file.
Bedrock Edition
Option name
Possible values
Default value
When is it used
Use
Notes
server-name
Any string
Dedicated Server
Always
Used as the server name. Cannot contain a «:» (colon).
This is the server name shown in the in-game server list.
gamemode
survival, creative, adventure
survival
Always
Sets the game mode for new players.
This is applied at the time the player first joins the server. Changing this setting will not change the gamemode for existing players.
Values correlate to the integer gamemodes as follows:
force-gamemode
true, false
false
Always
False (or not defined) prevents the server from sending to the client gamemode values other than the gamemode value saved by the server during world creation even if those values are set in server.properties after world creation. True forces the server to send to the client gamemode values other than the gamemode value saved by the server during world creation if those values are set in server.properties after world creation.
difficulty
peaceful, easy, normal, hard
easy
Always
Sets the difficulty of the world.
Values correlate to the integer gamemodes as follows:
Minecraft Classic server properties
Note:If set higher than 3, it is changed back to 3.
server.properties is the file stores all the settings for a multiplayer (Minecraft or Minecraft Classic) server.
When editing server.properties it is important that the same structure as the original is used, although the order of the lines is arbitrary. The text before the equal sign is the key, which should not be changed. The text after the equal sign is the property’s value, which can be edited. Lines that begin with # are comments – altering or removing these lines has no effect on the game.
After changes are made to the server.properties file, the server must be restarted for them to take effect. Another option is to use the /reload command in the server console, which will also allow changes to be made.
If the server.properties file does not list all properties (such as if a new version of the server adds new properties, or if the file does not exist), then on startup, the server rewrites the server.properties file with the new properties listed and set them to their default values.
Contents
File location [ edit | edit source ]
Java Edition [ edit | edit source ]
This file is automatically generated upon the first start of the server (if it doesn’t exist).
OS
File Location
Notes
Windows
Same directory as server.jar
Linux
Bedrock Edition [ edit | edit source ]
OS
File Location
Windows
Same directory as bedrock_server.exe
Linux
Same directory as bedrock_server
server.properties [ edit | edit source ]
These are the default settings for a newly installed Minecraft server:
Java Edition [ edit | edit source ]
Bedrock Edition [ edit | edit source ]
Minecraft server properties [ edit | edit source ]
Java Edition [ edit | edit source ]
Key
Type
Default Value
Description
allow-flight
boolean
false
Allows users to use flight on the server while in Survival mode, if they have a mod that provides flight installed.
With allow-flight enabled, griefers may become more common, because it makes their work easier. In Creative mode, this has no effect.
If a legacy difficulty number is specified, it is silently converted to a difficulty name.
See #op-permission-level for the details on the 4 levels.
gamemode
string
survival
Defines the mode of gameplay.
If a legacy gamemode number is specified, it is silently converted to a gamemode name.
Note:Dungeons still generate if this is set to false.
Note:The Ethernet spec requires that packets less than 64 bytes become padded to 64 bytes. Thus, setting a value lower than 64 may not be beneficial. It is also not recommended to exceed the MTU, typically 1500 bytes.
Note:Indirect damage sources spawned by players (such as lava, fire, TNT and to some extent water, sand and gravel) still deal damage to other players.
query.port
integer (1-65534)
25565
Sets the port for the query server (see enable-query).
rcon.password
string
blank
Sets the password for RCON: a remote console protocol that can allow other applications to connect and interact with a Minecraft server over the internet.
rcon.port
integer (1-65534)
25575
Sets the RCON network port.
resource-pack
string
blank
Optional URI to a resource pack. The player may choose to use it.
Note that (in some versions before 1.15.2), the «:» and «=» characters need to be escaped with a backslash (\), e.g. http\://somedomain.com/somepack.zip?someparam\=somevalue
The resource pack may not have a larger file size than 50 MiB (≈ 50.4 MB). Note that download success or failure is logged by the client, and not by the server.
resource-pack-sha1
string
blank
Optional SHA-1 digest of the resource pack, in lowercase hexadecimal. It is recommended to specify this, because it is used to verify the integrity of the resource pack.
Note: If the resource pack is any different, a yellow message «Invalid sha1 for resource-pack-sha1» appears in the console when the server starts. Due to the nature of hash functions, errors have a tiny probability of occurring, so this consequence has no effect.
If the player has major lag, it is recommended to turn this off/set to false.
This setting has no effect if difficulty = 0 (peaceful). If difficulty is not = 0, a monster can still spawn from a spawner.
If the player has major lag, it is recommended to turn this off/set to false.
10 is the default/recommended. If the player has major lag, this value is recommended to be reduced.
Note:A value less than 9 has a big impact on mob spawning on the server, as noted in bug Template:Bug.
white-list
boolean
false
Enables a whitelist on the server.
With a whitelist enabled, users not on the whitelist cannot connect. Intended for private servers, such as those for real-life friends or strangers carefully selected via an application process, for example.
Note:Ops are automatically whitelisted, and there is no need to add them to the whitelist.
enforce-whitelist
boolean
false
Enforces the whitelist on the server.
When this option is enabled, users who are not present on the whitelist (if it’s enabled) get kicked from the server after the server reloads the whitelist file.
In versions prior to Java Edition 1.12, the announce-player-achievements boolean property (default true) was used to toggle whether achievements were broadcasted to all players. This property no longer exists, but if it is set, the announceAdvancements gamerule is automatically updated to match, and the property is removed.
Bedrock Edition [ edit | edit source ]
Minecraft Classic server properties [ edit | edit source ]
Note:If set higher than 3, it is changed back to 3.
Файл server.properties по умолчанию для Java Edition.
server.properties — это файл, в котором хранятся все настройки для многопользовательского ( Minecraft или Minecraft Classic) сервера.
Если server.properties не перечисляет все свойства (например, если новая версия сервера добавляет новые свойства или файл не существует), то при запуске сервер перезаписывает файл server.properties с новыми перечисленными свойствами и установите для них значения по умолчанию.
Файл server.properties представляет собой обычный текстовый файл с кодировкой UTF-8, несмотря на то, что он расширение, и поэтому его можно редактировать с помощью любого текстового редактора, такого как Блокнот для Windows, TextEdit для Mac или nano и vim для Linux.
Расположение файла
Java Edition
Этот файл автоматически создается при первом запуске сервера (если он не существует).
OS
Местоположение файла
Примечания
Windows
Тот же каталог, что и serve r.jar
Linux
Если проигрыватель запускает его из своего домашнего каталога ( /home/name ) файлы сервера создаются в/home/name. Следуйте этим рекомендациям, чтобы убедиться, что файлы сервера генерируются там, где их ожидал игрок.
Bedrock Edition
Этот файл загружается с помощью bedrock_server.exe
OS
Местоположение файла
Windows
Тот же каталог, что и bedrock_server.exe
Linux
Тот же каталог, что и bedrock_server
server.properties
Это настройки по умолчанию для недавно установленного Minecraft server:
Java Edition
По умолчанию с 20w28a.
Bedrock Edition
По умолчанию с 1.16.100.04.
Minecraft свойства сервера
Java Edition
Ключ
Тип
Значение по умолчанию
Описание
allow-flight
boolean
false
Позволяет пользователям используйте полет на сервере в режиме выживания, если у них установлен мод, обеспечивающий полет.
При включенном разрешении полета гриферы могут стать более распространенными, потому что это облегчает их работу. В творческом режиме это не действует.
Если указан прежний номер сложности, он автоматически преобразуется в название сложности.
мирный (0) easy (1) normal (2) жесткий (3)
enable-command-block
boolean
false
Включает блоки команд
enable-jmx-monitoring
boolean
false
Предоставляет объект MBean с именем объекта net.minecraft.server: type = Server и двумя атрибутами averageTickTime и tickTimes с указанием времени тика в миллисекундах.
Чтобы включить JMX в среде выполнения Java, вам также необходимо добавить пару флагов JVM в запуск, как описано здесь.
enable-rcon
boolean
false
Разрешает удаленный доступ к консоли сервера.
sync-chunk-write
логический an
true
Включает синхронную запись фрагментов.
enable- status
boolean
true
Заставляет сервер отображаться как «в сети» в списке серверов.
Если установлено значение false, ответы от клиентов будут подавляться. Это означает, что он будет отображаться как офлайн, но по-прежнему будет принимать соединения.
enable-query
boolean
false
Включает прослушиватель сервера протокола GameSpy4. Используется для получения информации о сервере.
force-gamemode
boolean
false
Заставить игроков присоединиться в игровом режиме по умолчанию. false — Игроки присоединяются в игровом режиме, в котором они вышли. true — игроки всегда присоединяются в игровом режиме по умолчанию.
уровень-разрешения-функции
целое число (1-4)
2
Устанавливает уровень разрешений по умолчанию для функций.
Подробнее о 4 уровнях см. # Op-permission-level.
gamemode
string
Survival
Определяет режим игрового процесса.
Если указан устаревший номер игрового режима, он автоматически преобразуется в название игрового режима.
Определяет, могут ли конструкции (например, деревни) быть сгенерировано. false — структуры не создаются в новых блоках. true — Структуры создаются в новых блоках.
Примечание.Подземелья все равно генерируются, если для этого параметра установлено значение false.
Примечание:Спецификация Ethernet требует, чтобы пакеты размером менее 64 байтов дополнялись до 64 байтов. Таким образом, установка значения ниже 64 может оказаться невыгодной. Также не рекомендуется превышать MTU, обычно 1500 байт.
Примечание:Непрямые источники урона, создаваемые игроками (такие как лава, огонь, тротил и в некоторой степени вода, песок и гравий), все еще наносят ущерб другим игрокам.
query.port
integer (1- (2 ^ 16-2))
25565
Устанавливает порт для сервера запросов (см. enable-query ).
rate-limit
целое число
0
Устанавливает максимальное количество пакетов, которое пользователь может отправить до того, как его выкинут. Значение 0 отключает эту функцию.
rcon.password
string
blank
Устанавливает пароль для RCON: протокола удаленной консоли, который может позволить другим приложениям подключаться и взаимодействовать с Сервер Minecraft через Интернет.
rcon.port
целое число (1- (2 ^ 16-2))
25575
Устанавливает сетевой порт RCON.
resource-pack
string
blank
Необязательный URI для пакета ресурсов. Игрок может использовать его.
Обратите внимание, что (в некоторых версиях до 1.15.2) символы «:» и «=» необходимо экранировать обратной косой чертой (), например http ://somedomain.com/somepack.zip? someparam = somevalue
Размер файла пакета ресурсов не может превышать 100 МБ (до версии 1.15: 50 МБ (≈ 50,4 МБ) ). Обратите внимание, что успех или сбой загрузки регистрируется клиентом, а не сервером.
resource-pack-sha1
string
blank
Необязательный SHA- 1 дайджест пакета ресурсов в шестнадцатеричном формате в нижнем регистре. Рекомендуется указать это, потому что он используется для проверки целостности пакета ресурсов..
Примечание. Если пакет ресурсов отличается, при запуске сервера в консоли появляется желтое сообщение «Недопустимый sha1 для пакета ресурсов-sha1». Из-за природы хэш-функций вероятность возникновения ошибок мала, поэтому это последствия не имеют никакого эффекта.
Если у игрока большая задержка, рекомендуется выключить/установить значение false.
spawn-monsters
boolean
true
Определяет, могут ли монстры появляться. true — включен. Монстры появляются ночью и в темноте. false — отключено. Никаких монстров.
Этот параметр не действует, если сложность = 0 (мирный). Если сложность не = 0, монстр все еще может появиться из источника.
Если у игрока большая задержка, рекомендуется отключить это значение или установить значение false.
spawn-npcs
логическое
true
Определяет, могут ли жители деревни появляться. true — Включено. Жители появляются. false — отключено. Нет жителей.
Защита от появления
целое число
16
Определяет длину стороны квадратной области защиты от спауна как 2 x +1. Установка этого значения в 0 отключает защиту от появления. Значение 1 защищает квадрат 3 × 3 с центром в точке появления. 2 защищает 5 × 5, 3 защищает 7 × 7 и т. Д. Эта опция не генерируется при первом запуске сервера и появляется, когда присоединяется первый игрок. Если на сервере не заданы операции, защита от спауна также автоматически отключается..
text-filtering-config
[ требуется дополнительная информация ]
[ требуется дополнительная информация ]
[ требуется дополнительная информация ]
use-native-transport
boolean
true
Улучшения производительности сервера Linux: оптимизирована отправка/получение пакетов на Linux true — включен. Включить оптимизацию отправки/получения пакетов Linux false — отключено. Отключить оптимизацию отправки/получения пакетов Linux
view-distance
integer (3-32)
10
Устанавливает количество мировых данных, которые сервер отправляет клиенту, измеряется порциями в каждом направлении игрока. (радиус, а не диаметр). Он определяет расстояние просмотра на стороне сервера.
10 по умолчанию/рекомендуется. Если у плеера большая задержка, рекомендуется уменьшить это значение.
white-list
boolean
false
Включает белый список на сервере.
Если белый список включен, пользователи не в белом списке не могу подключиться. Предназначен для частных серверов, например, для реальных друзей или незнакомцев, тщательно выбранных в процессе подачи заявки.
false — Белый список не используется. true — файл whitelist.json используется для создания белого списка.
Примечание.Операции автоматически заносятся в белый список, и нет необходимости добавлять их в белый список.
enforce-whitelist
boolean
false
Применяет белый список на сервере.
Когда эта опция включена, пользователи, которые не присутствуют в белом списке (если он включен), удаляются с сервера после сервера перезагружает файл белого списка.
false — ни один пользователь не будет выгнан, если он не находится в белом списке. true — пользователи, не включенные в белый список, будут исключены.
Bedrock Edition
Имя параметра
Возможные значения
Значение по умолчанию
Когда оно используется
Использовать
Примечания
имя-сервера
Любая строка
Выделенный сервер
Всегда
Используется как имя сервера
Это имя сервера, отображаемое в списке серверов в игре.
режим игры
выживание, творчество, приключения
выживание
Всегда
Устанавливает игровой режим для новых игроков.
Применяется во время первого присоединения игрока к серверу. Изменение этого параметра не изменит режим игры для существующих игроков..
Значения соотносятся с целочисленными режимами игры следующим образом:
Minecraft Свойства классического сервера
Примечание:Если установлено больше 3, оно меняется обратно на 3.