SI: Essentials
SI: Essentials - базовый API, библиотека и набор инструментов от Soncresity Industries. Пригодится разработчикам модов и сборок: отключение предметов, удобные логи, свои конфиги.
SI: Essentials - это не мод с новыми блоками или мобами. Это API, библиотека и набор инструментов от Soncresity Industries, на котором держатся другие проекты студии.
Игроку в одиночке он почти ничего не даст. А вот если вы собираете сборку модов или пишете собственный мод для Майнкрафт, это тот самый фундамент, который экономит часы рутины. Вместо того чтобы каждый раз изобретать логирование, парсинг предметов и регистрацию блоков, вы просто подключаете готовый набор.
Что внутри
Remover Module
Пожалуй, самый полезный модуль для серверов. Он позволяет отключать предметы прямо в игре через ID, компоненты (Components) и регулярные выражения (regex). Причём предмет можно вырубить полностью или оставить, но запретить только часть функций: атаку, взаимодействие с ним, крафт по его рецептам. По факту это гибкий чёрный список без правки jar-файлов - удобно, когда на сервере нужно убрать конкретный дюп или имбалансный предмет из другой сборки.
Logger
Кастомный логгер на базе slf4j, того самого, что используют почти все моды для Minecraft. Главная фишка - отдельные лог-файлы для каждого мира, куда пишется вывод только вашего мода. Искать баги в своём коде становится в разы быстрее, потому что не нужно копаться в мешанине общего лога.
Есть и режим debug. Он управляется глобальным значение debug_enabled в SI: Essentials Common Config. Нюанс такой: в основной лог Minecraft отладочный вывод попадёт только при включённом значении, а вот в ваш персональный файл он пишется всегда.
Configuration API
Позволяет разработчику создавать в проекте сразу несколько конфигов и свободно читать/записывать ключи и значения. На выбор два типа файлов - cnfg или objt.
Command Utilities
Класс для запуска команд от лица игрока с настройкой прав, позиции и поворота. Удобно, когда нужно эмулировать действие в конкретной точке мира.
Decimal Utilities
Округление дробных значений до нужного числа знаков после запятой.
File Hash Utilities
Получение SHA256-хеша (контрольной суммы) файла в виде строки.
Item Utilities
Парсинг предметов и стаков из строк и обратно.
Message Utilities
Отправка личных и broadcast-сообщений в чат или на Action Bar через Adventure/MiniMessage API.
Registry Utilities
Хелперы, которые упрощают регистрацию предметов и блоков - меньше шаблонного кода.
Singleplayer Utilities
Проверка, является ли ServerPlayer хостом одиночного мира. Звучит мелочью, но это реально спасает: если ваш мод умеет банить игроков, хост-игрока лучше не трогать. Иначе его мир просто не сохранится корректно, а остальных повыкидывает с сервера.
Slot Utilities
Возвращает координаты x и y слота в GUI большого сундука. Полезно для пресетов слотов.
Sound Utilities
Парсинг ID звука в SoundEvent с возможностью проиграть его приватно одному игроку или на всех.
Title Utilities
Показ и broadcast полностью настраиваемых титров через Adventure/MiniMessage API.
Требования
Важный нюанс
Это библиотека, а не контентный мод. Сама по себе она почти ничего не добавляет в игру, зато часто выступает зависимостью для других проектов. Если после установки какого-то мода игра падает с ошибкой про отсутствующий SI: Essentials - значит, вы забыли поставить эту библиотеку. Проверьте, что версия загрузчика (Fabric или NeoForge) совпадает с той, под которую собран зависимый мод.
Хорошая новость в том, что библиотека не трогает генерацию мира и не добавляет блоков. Конфликтов с шейдерами, ресурспаками и оптимизационными модами вроде Sodium ждать не стоит - ей просто не с чем пересекаться.
Что нового
В ветке 2.3.x разработчики вернули поддержку 1.21.1 и 1.21.4, а заодно добавили UI-модуль и Placeholder API. В свежих релизах появилась поддержка Minecraft 26.1.2, так что проект живёт и обновляется вместе с игрой.
Для кого этот проект
- Разработчикам модов, которые хотят меньше возиться с рутиной
- Сборщикам модпаков, которым нужен гибкий контроль предметов
- Админам, которые чистят сервер от лишних предметов
Если вы собираете сборку модов или пишете свой мод, SI: Essentials - по сути must-have база. Скачать SI: Essentials можно под Fabric и NeoForge, а лицензия проекта - Soncresity Standard License (SSL).
Кто за этим стоит
Проект развивает команда Soncresity Industries. В кредитах указаны Soncresity Industries, SkyKing_PX и KalarianAthecila.
Как поиграть с друзьями с модом SI: Essentials?
Мод SI: Essentials куда интереснее в компании: поднимите сервер Майнкрафт с уже установленным модом, позовите друзей и играйте по своим правилам. Хостинг Майнкрафт для мода SI: Essentials будет готов за пару минут - BungeeHost сделает всё за вас.