FokusAPI — серверная библиотека функций для проектов CoffeeG [1.13 — 26.3]

FokusAPI — служебная библиотека функций для проектов CoffeeG. Она помогает работать с NBT и scoreboard, создавать предметы и мобов через команды. В выбранном выпуске 4.9 скачивается серверный плагин: при первом включении он помещает отдельный датапак FokusAPI в основной мир и пытается активировать его.

Для чего нужна библиотека

Этот файл имеет смысл устанавливать по требованию другого датапака или проекта автора. Самостоятельного набора новых блоков, оружия или приключений здесь нет. Внутри датапака находятся функции для изменения и хранения чисел в scoreboard, обработки NBT сущностей, имитации выбрасывания предмета и создания мобов. Есть и вспомогательные расчёты, например генерация случайного числа и изменение движения сущности.

Наличие функции не превращает её в готовую команду для обычного игрока. Использующий библиотеку проект должен вызывать нужные функции и передавать им ожидаемые данные. Установка FokusAPI сама по себе не выдаёт меню управления этими возможностями.

Какой файл выбран

FokusAPI-4.9.jar — плагин с основным классом JavaPlugin, а не клиентский мод для папки mods. Для этого файла совместимость разобрана статически по файлам и коду Spigot для Minecraft 1.21.1 с Java 21; сервер при проверке не запускался. Общий список версий и платформ проекта значительно шире; он не означает, что каждый вариант проверен для этого сценария.

Установка на сервер

1. Остановите сервер и сохраните резервную копию основного мира.
2. Поместите выбранный JAR в папку plugins сервера Spigot 1.21.1.
3. Разрешите серверу доступ к интернету: плагин загружает фиксированный датапак FokusAPI 4.9.
4. Запустите сервер и проверьте журнал загрузки плагина. В папке datapacks основного мира должен появиться FokusAPI-v4.9_DATAPACK.zip.
5. Проверьте доступные и включённые наборы командой /datapack list. Плагин сначала обновляет этот список, затем отправляет команду включения загруженного файла.

Плагин использует первый мир из списка сервера. Он не устанавливает отдельную копию во все дополнительные миры. Клиентам этот JAR для подключения не требуется.

Что проверить после установки

Внутри датапака указан старый формат данных 41, тогда как Minecraft 1.21.1 использует 48. Игра может показать предупреждение о старой версии набора; оно не равнозначно повреждённому ZIP. Здесь используется явная активация датапака, поэтому проверяйте фактическое состояние через /datapack list.

Есть важная особенность версии 4.9: если ZIP уже существует, плагин пропускает загрузку и повторное включение. Ранее отключённый файл поэтому не обязательно включится после перезапуска. Проверить его состояние и при необходимости включить набор должен администратор. Если загрузка не удалась из-за отсутствия сети, установка одного маленького JAR ещё не означает, что библиотека готова к работе.

FokusAPI подходит как зависимость конкретного проекта CoffeeG. Для обычного выживания без такого проекта устанавливать эту техническую библиотеку незачем.