
Server Utilities
Server Utilities (Server Utils) - датапак-библиотека для создателей серверных датапаков в Minecraft. Числовые ID игроков, отслеживание входа и выхода, сохранение данных после смены ника, очистка и восстановление инвентаря.
Server Utilities
Сразу к делу: Server Utilities - это не мод и не контентный датапак для игроков. Это библиотека инструментов для тех, кто сам пишет датапаки под сервер. Если вы просто хотите поиграть, ставить его некуда и незачем - игрок ничего не заметит. А вот если вы делаете мини-игру, лобби или какую-то серверную механику, дальше будет интересно.
Раньше проект назывался Player ID - он вырос из служебных систем сервера Seacraft, где на нём держалась вся логика игроков. Отсюда и специфический фокус: не добавить в игру контент, а выдать разработчику готовые и надёжные кирпичики. Короткое сленговое имя в сообществе - Server Utils.
Что это даёт разработчику
Главная боль, которую решает Server Utilities - идентификация игрока. В ванильном Minecraft у игрока нет постоянного ID. Ник меняется за две минуты прямо в лаунчере, а UUID хоть и стабилен, но возиться с ним в командных блоках неудобно. Server Utilities закрывает эту проблему:
- Каждому игроку присваивается числовой scoreboard-ID - компактный идентификатор для дальнейших проверок и логики.
- На каждого игрока создаётся marker entity для хранения данных. Именно эта сущность тянет за собой все сохранённые значения, даже если игрок сменил ник.
- Отслеживание событий игрока, причём в трёх видах: первый заход на сервер, обычный вход и выход.
- Трекинг точки спавна мира - полезно для телепортов, респавна и логики лобби.
- Система очистки и восстановления инвентаря. Актуально для мини-игр, где инвентарь нужно спрятать при входе в арену и вернуть после матча.
- Функциональные макросы для обновления текстовых компонентов под новые версии. Свежая фишка: в актуальных сборках добавили инструмент для перевода старых JSON-текстов в NBT под формат 1.21.5+, и это здорово экономит время при апдейте проекта.
Отдельно стоит проговорить ключевой момент. Уровень регистрации и ID игрока переносятся на новый ник. Сменил имя - датапак всё равно узнаёт того же человека, потому что связка идёт через маркер, а не через строку с ником. Для серверов с платной сменой ника это буквально спасение.
Опциональные фичи (включаются в конфиге)
Проект не раздувает нагрузку по умолчанию. Дополнительные штуки включаются только если реально нужны:
- Командные циклы на 1 секунду, 10 секунд и минуту - удобно, когда нужны периодические проверки без своих костылей.
- Система регистрации нового игрока при первом входе.
- Триггеры для показа ника и ID игрока.
Важный нюанс
Не путайте это с плагинами под Bukkit и Paper. Server Utilities - чистый датапак, модлоадер ему не нужен. Кидаете в папку датапаков мира, и он работает на стороне сервера. Клиенту игрока ставить ничего не надо.
Версии и совместимость
| Параметр | Значение |
|---|---|
| Платформа | Data Pack (только Minecraft Java Edition) |
| Поддерживаемые версии | Minecraft 1.18 - 1.21.8 |
| Актуальный релиз | v2.2.2 от 1 июля 2025 года |
| Загрузчик | не требуется |
В свежих сборках обновили совместимость с 1.21.6, добавили pack format 81 под 1.21.7 и вынесли внутренние функции в отдельный namespace-каталог, чтобы ничего не конфликтовало с вашим кодом.
Совет из практики: не тащите старую версию датапака на новый мир без проверки. Между 1.21.5 и 1.21.7 менялся формат текстовых компонентов, и макросы как раз для таких случаев и придумали - прогоните свои JSON-тексты через них, иначе часть сообщений в чате просто отвалится.
С чем работает
Датапак проектировали как фундамент для других проектов, а не как одиночную вещь. В экосистеме Seacraft его использовали вместе с Trigger Commands и Reef Crystals, а мини-игры вроде Spleef строили поверх его системы игроков. То есть по факту это тот самый незаметный слой, на котором держится серверная логика - и который редко кто замечает, пока он не сломается.
Итог
Если вы пишете серверные датапаки и устали каждый раз с нуля городить систему ID, отслеживание входов и хранение данных - Server Utilities сэкономит вам дни работы. Скачать Server Utilities имеет смысл даже просто ради спокойствия: базовая логика игроков уже отлажена, а вам останется заниматься геймплеем. Для игрока же это абсолютно невидимый слой, и это как раз то, что нужно. Новичку, который ищет контент для выживания, датапак не зайдёт - тут другая аудитория.
Как запустить датапак Server Utilities на сервере?
Датапак Server Utilities удобнее всего раскрывается на общем сервере: установили один раз - и вся компания играет с новыми механиками. Создать сервер Майнкрафт с датапаком Server Utilities можно за пару минут вместе с BungeeHost.
