Настройка server.properties
(Java Edition)
Актуально для серверов Minecraft Java 1.20–1.21 и большинства форков (Paper/Spigot/Fabric/Forge). Значения по умолчанию приведены для ванильного сервера.
Что это за файл?
server.properties
— основной конфиг Java‑сервера. Изменения вступают в силу после перезапуска сервера (или /reload
). Ключи слева от =
менять нельзя, редактируются только значения справа.
Самые важные параметры
gamemode — режим для новых игроков
survival (0)
/creative (1)
/adventure (2)
/spectator (3)
difficulty — сложность мира
peaceful (0)
/easy (1)
/normal (2)
/hard (3)
max-players — максимум одновременных игроков (по умолчанию
20
)pvp — урон между игроками
true
— игроки могут наносить урон друг другу; стрела, пущенная в себя, тоже нанесёт уронfalse
— урон между игроками отключён
view-distance — серверная дальность прогрузки (радиус в чанках)
- По умолчанию
10
. При лагах уменьшайте.
- По умолчанию
simulation-distance — радиус симуляции сущностей/механик
- По умолчанию
10
. Выше = дороже по ресурсам.
- По умолчанию
Рекомендация
Для большинства серверов удобно начинать с view-distance=10
, simulation-distance=10
и уже потом подбирать значения под нагрузку.
Сеть, статус и безопасность
online-mode — проверка лицензионности Java‑аккаунта через сервера авторизации Mojang/Microsoft
true
(по умолчанию) — требуется валидный Java‑аккаунтfalse
— «офлайн/крякнутый» режим (риски подмены ников)
enforce-secure-profile — пускает только игроков с подписанным профильным ключом (связано с подписью чата)
true
(по умолчанию) — клиенты без ключа не подключатсяfalse
— разрешает старые/модовые клиенты, но снижает защиту чата
enable-status — отвечает на пинг в списке серверов
true
(по умолчанию) — виден как «онлайн»false
— кажется офлайн, но подключаться можно по IP/порт
enable-query — слушатель GameSpy4 (для мониторингов). Включайте, если нужны статусы/онлайн; список плагинов доступен лишь на некоторых ядрах.
query.port — порт Query (обычно совпадает с
server-port
)enable-rcon / rcon.port / rcon.password — удалённая консоль (без шифрования!)
- Совет: включайте только с фаерволом/туннелем; пароль — сложный.
prevent-proxy-connections — кик, если ASN/IP‑провайдер клиента «не совпадает» с данными авторизации (борьба с VPN/прокси)
- По умолчанию
false
. Может давать ложные срабатывания.
- По умолчанию
rate-limit — лимит пакетов от игрока (0 = выкл). Помогает против спама пакетами.
network-compression-threshold — порог сжатия пакетов
-1
выключает,0
сжимает всё, по умолчанию256
. Значения <64 обычно не дают пользы.
use-native-transport — Linux‑оптимизации сетевого стека Netty
- Оставляйте
true
(по умолчанию) ради производительности.
- Оставляйте
Мир и генерация
level-name — имя папки мира (по умолчанию
world
)level-seed — сид (пусто = случайный)
generate-structures — генерация структур (
true
/false
)hardcore — хардкор (
true
принудитhard
и перевод в spectator после смерти)level-type — ID пресета мира (с 1.19+)
minecraft:normal
(по умолчанию)minecraft:flat
(настраивается черезgenerator-settings
)minecraft:large_biomes
minecraft:amplified
minecraft:single_biome_surface
(buffet‑мир одним биомом; настраиваетсяgenerator-settings
)- ⚠️ Старые значения
customized
,default_1_1
,buffet
актуальны только для 1.15 и ниже.
generator-settings — JSON‑настройки генерации (экранируйте двоеточия:
\:
)max-world-size — максимальный полуразмер мира в блоках (по умолчанию
29999984
).spawn-protection — квадратная защита спавна со стороной
2R+1
(0 = выкл, умолчание16
).
Ресурс‑паки и дата‑паки
- resource-pack — URL пакета ресурсов
- resource-pack-sha1 — SHA‑1 хеш пака (очень желательно для проверки целостности)
- require-resource-pack — если
true
, клиент обязан принять пак, иначе будет отключён - resource-pack-prompt — кастомное сообщение в окне установки пака (JSON‑текст)
- initial-enabled-packs / initial-disabled-packs — какие дата‑паки включать/не включать при создании мира (по умолчанию
vanilla
включён)
Спавн и сущности
spawn-animals / spawn-monsters / spawn-npcs — спавн соответствующих мобов
entity-broadcast-range-percentage — масштаб дистанции рассылки сущностей (по умолчанию
100
)- Больше = дальше видимость, но выше нагрузка.
Права и доступ
- op-permission-level — уровень прав операторов по умолчанию (
0–4
, по умолчанию4
) - function-permission-level — уровень прав для функций (
1–4
, по умолчанию2
) - force-gamemode — принудительно переводить игроков в
gamemode
по умолчанию при входе (false
= вход с предыдущим режимом) - white-list — включение вайт‑листа (
true/false
) - enforce-whitelist — при
true
игроки, не в списке, будут кикнуты после/whitelist reload
- player-idle-timeout — автокик AFK в минутах (
0
= выкл)
IP/порт
- server-port — порт сервера (по умолчанию
25565
; на панели Bisquit.Host выставляется автоматически), - server-ip — IP для бинда (обычно оставляют пустым; на панели Bisquit.Host выставляется автоматически)
- motd — подпись сервера в списке (поддерживает цвет‑коды)
- hide-online-players — скрывать список игроков из статуса (
true/false
)
Производительность и отладка
- sync-chunk-writes — синхронная запись чанков (
true
по умолчанию). Выключение ускоряет, но повышает риск потери данных при крэше. - max-tick-time — максимум мс на один тик до остановки watchdog (по умолчанию
60000
;-1
отключает) - max-chained-neighbor-updates — лимит каскадных соседних обновлений (по умолчанию
1000000
; отрицательные = без лимита) - log-ips — логировать IP игроков при входе (
true
по умолчанию)
Устаревшее/удалённое
- max-build-height — удалён в 1.17; высотные лимиты теперь задаёт сама версия мира.
- announce-player-achievements — заменён на
gamerule announceAdvancements
.
Быстрые советы
- Хотите «закрытый» сервер:
online-mode=true
,white-list=true
,enable-status=false
,prevent-proxy-connections=true
. - Принудительный текстур‑пак: задайте
resource-pack
,resource-pack-sha1
,require-resource-pack=true
и приятныйresource-pack-prompt
. - Подлагивает редстоун/фермы: попробуйте уменьшить
simulation-distance
и не завышайтеentity-broadcast-range-percentage
.
Примеры значений
# Консервативные значения для выживания на 10–20 игроков
view-distance=10
simulation-distance=10
entity-broadcast-range-percentage=100
rate-limit=0
sync-chunk-writes=false
online-mode=true
enforce-secure-profile=true
# Принудительный ресурс‑пак
resource-pack=https://example.org/rp.zip
resource-pack-sha1=0123456789abcdef0123456789abcdef01234567
require-resource-pack=true
resource-pack-prompt={"text":"Этот сервер использует официальный ресурспак","color":"yellow"}