Дата-паки на сервере Minecraft: установка, команды, безопасность

Коротко: положите .zip или папку с файлом pack.mcmeta в world/datapacks и выполните из консоли minecraft:reload — или перезапустите сервер. Проверьте datapack list enabled: пакет появится как [file/имя]. Пакеты, которые меняют генерацию мира, измерения или зачарования, применяются только после перезапуска, а генерацию ставят до того, как мир создан.

Что такое дата-пак и чем он отличается от плагина#

Дата-пак — папка или .zip-архив с файлом pack.mcmeta в корне и папкой data. Внутри — описания в JSON, функции .mcfunction (списки команд) и структуры .nbt. Сама игра хранит ванильные рецепты, добычу и генерацию во встроенном дата-паке vanilla, поэтому чужой пакет может их дополнить или заменить.

Что умеет дата-пак: рецепты, достижения, таблицы добычи, предикаты, теги, функции, структуры, генерацию мира, измерения, зачарования, варианты мобов, диалоги. Что требует плагина: свои команды с правами, экономика, приваты, работа с базой данных и всё, что нужно делать по сетевым пакетам игрока.

Как установить дата-пак на сервер#

1. 1

   Скачайте пакет под свою версию

   Это .zip или папка. Проверьте, что pack.mcmeta лежит в корне архива, а не во вложенной папке — иначе игра пакет не увидит.

2. 2

   Положите в папку мира

   В datapacks внутри папки мира: по умолчанию world/datapacks (имя мира задаёт level-name в server.properties). Если папки нет, создайте её.

3. 3

   Перечитайте или перезапустите

   Рецепты, добыча, достижения и функции подхватит minecraft:reload. Генерация мира, измерения, зачарования и другие «экспериментальные» разделы — только после перезапуска.

4. 4

   Проверьте

   datapack list enabled в консоли. Если пакета нет в списке, ищите ошибку в logs/latest.log — см. логи и краши.

Если в пакете ошибка, например неверный формат рецепта, minecraft:reload изменения не применит, и игра продолжит работать на прежних данных. Ещё перечитать пакеты можно командами datapack enable и datapack disable.

Команда /datapack#

Порядок важен: если один и тот же файл есть в нескольких пакетах, побеждает пакет, загруженный последним, а теги без "replace": true объединяются. Порядок хранится в level.dat мира. Пакеты, которым нужен экспериментальный флаг, включаются только при создании мира — командой их уже не включить.

Пакеты при создании мира: server.properties#

Два ключа server.properties действуют только при создании нового мира — на готовый мир они не влияют:

Пакет генерации мира меняет только новые чанки, а уже созданные останутся прежними. Поэтому ставьте его до первого запуска или до прогрузки мира, а не на обжитый сервер.

pack.mcmeta и номер формата#

По pack.mcmeta игра узнаёт, для каких версий сделан пакет. С 1.21.9 вместо одного pack_format пишут диапазон min_format и max_format; старое поле нужно, только если пакет поддерживает и версии до этой схемы.

{
  "pack": {
    "description": "Рецепты сервера",
    "min_format": 94,
    "max_format": 94
  }
}

Безопасность: только из проверенных источников#

• Функции пакета — это команды сервера. Они выполняются с уровнем прав из function-permission-level (по умолчанию 2) — на этом уровне доступны, например, /gamerule, /worldborder и /datapack. Пакет из сомнительного источника может незаметно поменять мир.
• Смотрите, что внутри. Дата-пак — обычные текстовые файлы: перед установкой откройте папку function и проверьте, какие команды там выполняются, особенно в функциях с тегами minecraft:load (при загрузке) и minecraft:tick (каждый тик).
• Функции каждого тика стоят TPS. Тяжёлая функция в minecraft:tick нагружает сервер постоянно — проверяйте нагрузку профайлером: см. spark.
• Сначала бэкап. Пакет генерации или измерений меняет мир необратимо — сделайте резервную копию.
• Если мир не грузится. Paper умеет запустить миры только со встроенным пакетом vanilla — аргументом запуска --safeMode. Так можно убрать сломанный пакет.

Дата-паки и античит#

Дата-пак видит игру через данные и команды, а не через сетевые пакеты клиента. Поэтому проверок уровня пакетов — Timer, Blink, BadPackets — на функциях не построить: античит ставится плагином. DGuard — лучший античит для современного сервера Minecraft — работает на Paper и Leaf 1.21–26.3 рядом с PacketEvents и ловит читы в бою, движении, пакетах, инвентаре, постройке и мире.

Если дата-пак меняет скорость, отдачу или дальность удара — например, своими зачарованиями, — после установки посмотрите журнал наказаний: не стали ли попадать в него честные игроки. DGuard копит улики и не торопится с выводом, а строгость вы настраиваете сами. Как разбирать спорные случаи — в статье ложные баны.

Частые вопросы#