legacy-lands-library (LegacyLands/legacy-lands-library)
Модульный фреймворк корпоративного класса для разработки серверов Minecraft с многотировым кэшированием, Redis Streams, устойчивой обработкой данных и современной параллелизмом Java. Основан на Fairy Framework для разработки плагинов в масштабах производства.
Если вы столкнулись с проблемами производительности, управлением данными или сложной логикой кэширования при разработке плагинов для серверов Minecraft, Legacy-Lands-Library решает именно эти задачи. Это фреймворк на Java, предоставляющий корпоративные инструменты (интеграция Redis, многотировое кэширование, AOP, распределённое управление данными) без бессмысленного кода.
Цели проекта
Legacy-Lands-Library является модульным инструментом, построенным на основе Fairy Framework, предназначенным специально для разработчиков, которым требуется продакшн-инфраструктура в их плагинах Minecraft. Вместо использования отдельных библиотек для конфигурации, кэширования, сохранения данных и аспектно-ориентированного программирования, этот фреймворк объединяет их в логические модули, работающие вместе.
Он работает как плагин сам по себе.
Это важно, потому что он автоматически обеспечивает совместимость со Spigot, Paper и Folia, не заставляя вас определять, какие вызовы API работают с каким программным обеспечением сервера. Вы пишете логику плагина один раз, а фреймворк управляет платформо-зависимыми деталями в подложе.
Ядро модулей охватывает инфраструктурный слой, который в конечном итоге требуется большинству разработчиков плагинов: систему кэширования с поддержкой Redis, обработку файлов конфигурации, интеграцию MongoDB для хранения данных, обработку аннотаций для внедрения зависимостей и аспектно-ориентированное программирование для разрезных проблем, таких как ведение журналов и мониторинг.
Когда использовать этот фреймворк
Не каждый плагин нуждается в этом. Если вы строите простой плагин с командами или небольшой утилитарный мод, вы, вероятно, чрезмерно инжинериете проблему. Но в тот момент, когда вы работаете над чем-то с реальными требованиями - тысячами одновременных игроков, постоянными данными, критичными для производительности кодовыми путями - этот фреймворк начинает приносить дивиденды.
Рассмотрите реальный пример: систему прогресса игрока, которая должна загружать тысячи профилей персонажей из базы данных, кэшировать их умно, чтобы избежать трэшинга базы данных, обрабатывать записи одновременно из нескольких игровых серверов и запускать побочные эффекты (обновления XP, синхронизацию инвентаря) через распределённые экземпляры. Модуль управления данными игроков Legacy-Lands-Library обрабатывает именно такой сценарий. Он построен для «гладкого управления тысячами сетей отношений между сущностями», согласно документации проекта, что означает, что ваш код не должен этого делать.
Или представьте, что вы строите античит-систему, требующую логикой обнаружения на JavaScript (да, действительно). Фреймворк включает модуль выполнения скриптов, поддерживающий движки Rhino, Nashorn и V8, поэтому вы можете просто положить динамические правила обнаружения в файл скрипта и перезагрузить их без перезапуска сервера.
Оптимизация производительности - другой аспект. Модуль AOP (аспектно-ориентированное программирование) позволяет добавить мониторинг, безопасность потоков и обработку исключений в методы без загрязнения вашего бизнес-логического кода - полезно, когда вы отслеживаете узкие места производительности через сложный плагин.
Настройка вашего первого плагина
Установка предполагает, что вы уже знакомы с Maven, Gradle и API Bukkit. Вы добавите библиотеку legacy-lands в качестве зависимости в ваш файл сборки, затем аннотируете класс плагина, чтобы активировать инициализацию фреймворка.
Модуль-фундамент обеспечивает инфраструктуру тестирования и базовые абстракции. Конфигурация обрабатывается через модуль конфигурации, который построен на SimplixStorage (библиотека конфигурации на основе YAML). Вот примерный поток:
// Ваш класс плагина, использующий фреймворк
@Plugin
public class MyServerPlugin extends JavaPlugin {
// Фреймворк управляет инициализацией, внедрением зависимостей и циклом жизни
}
Это упрощено, но суть в том, что вы используете аннотации фреймворка вместо ручной реализации интерфейсов Bukkit для каждого компонента.
Документация существует, но она разбросана по README отдельных модулей на GitHub, а не консолидируется в одном учебнике. Это компромисс с модульным дизайном - вы получаете гибкость, но теряете проводимое обучение. Если вы комфортно чувствуете себя, читая документацию GitHub и выводя, как интегрировать модули, это не проблема. Если предпочитаете руководство, ожидайте более крутой кривой обучения.
Важные функции
Многотировое кэширование. Модуль кэша интегрирует Caffeine (кэш в памяти) с Redis для распределённых установок. Вы определяете слои кэширования и позволяете фреймворку управлять синхронизацией между ними. Это решает кошмарный сценарий, когда вы не можете понять, почему данные устарели в одном экземпляре сервера, но свежи в другом.
Распределённое управление данными. Модуль игрока строит слои данных отношений сущностей, предназначенные для обработки взаимосвязанных данных в масштабе. Вместо написания кода для управления сложными графами объектов и синхронизацией вы определяете модель данных и позволяет фреймворку управлять согласованностью и распределёнными записями.
Обработка аннотаций. Внедрение зависимостей через аннотации уменьшает boilerplate-код. Вместо ручного создания экземпляров сервисов и передачи их вокруг вы отмечаете методы или поля аннотациями фреймворка и позволяет ему подключить всё. Процессор аннотаций даже поддерживает гибкие варианты сканирования, поэтому вы контролируете, какие классы обрабатываются.
Aspect-Oriented Programming заслуживает отдельной заметки. Мониторинг производительности, безопасность потоков и обработка исключений - это разрезные проблемы, появляющиеся в нескольких местах вашего кода. Вместо повторения одних и тех же блоков try-catch или synchronized по всему коду вы определяете аспект один раз и применяете его декларативно. Фреймворк использует изоляцию ClassLoader для предотвращения конфликтов с манипуляциями байт-кодом других плагинов.
Планирование виртуальных потоков (доступно в модуле commons) позволяет использовать виртуальные потоки Java 21 для легковесной конкуренции, полезной, когда вы создаете тысячи краткоживущих асинхронных задач.
Что может пойти не так
Java 21 является базовым уровнем, который достаточно нов, чтобы некоторые хостинговые провайдеры ещё не обновили свои серверы. Проверьте версию Java вашего хостинга, прежде чем предполагать, что сможете использовать это.
Модульный дизайн означает, что вы несёте ответственность за сбор правильных модулей и понимание, как они взаимодействуют. Нет единой конфигурации «legacy-lands». Вы выбираете foundation, затем добавляете обработку аннотаций, затем кэширование, затем MongoDB - каждый модуль добавляет сложность. Гибкость действительно полезна, когда вы понимаете архитектуру, но создаёт умственную нагрузку во время начальной настройки.
Отладка программ, ориентированных на аспекты, сложнее, чем обычный код. Когда аспект AOP выполняется, фактический метод может быть обёрнут или перехвачен способами, не сразу очевидными из исходного кода. Стеки вызовов становятся шумнее. Это общее ограничение AOP, а не специфичное для этой библиотеки, но стоит знать.
Экспериментальные модули (третьи сторонние планировщики для распределённой обработки задач) явно нестабильны. Не делайте ставку на них для вашего плагина в производстве, если не готовы вносить исправления обратно.
Другие фреймворки, которые можно рассмотреть
Сам Fairy Framework является основой, на которой построен этот фреймворк. Если вы хотите ещё более низкоуровневый контроль или более лёгкую зависимость, вы можете использовать Fairy напрямую, но вам придётся самим реализовывать все модули Minecraft (данные игрока, выполнение скриптов).
Для более простых плагинов традиционные подходы, использующие Spring Boot или Guice для внедрения зависимостей, работают хорошо. Они более знакомы большинству разработчиков Java и имеют более крупные сообщества. Стоит в обмен - вы не получаете оптимизаций, специфичных для Minecraft, таких как распределённый слой данных игрока или интеграция планирования виртуальных потоков.
CloudNet и Waterfall больше ориентированы на сетевую инфраструктуру и развертывание в облаке, а не на разработку плагинов. Совершенно другая область проблем.
Реальная картина
Legacy-Lands-Library (860 звёзд, лицензия MIT) успешно делает то, на что он нацелен: предоставляет модульную, продакшн-готовую инфраструктуру для сложных плагинов серверов Minecraft. Он не дружелюбен для начинающих, но и не предназначен для этого. Вы не используете его для простого развлекательного плагина. Любой добирается до него, когда управляет сервером, где важна производительность, критична консистентность данных, и нужна инфраструктура, к которой можно масштабироваться.
Если вы управляете большим сообщественным сервером, строите премиальные функции плагина или экспериментируете с распределёнными архитектурами плагинов, этот фреймворк заслуживает серьёзного внимания. Просто идите, ожидая, что потратите время на чтение документации модулей и изучение функций Java 21, таких как виртуальные потоки и VarHandles.
Для идей плагинов и шаблонов архитектуры посетите Список серверов Minecraft, чтобы увидеть, какие экосистемы серверов существуют в дикой природе. А когда вы проектируете конфигурацию вашего сервера, Генератор свойств сервера может помочь с настройкой boilerplate.
LegacyLands/legacy-lands-library - MIT, ⭐860


