NextLib

NextLib 1.0.8 — это модульная библиотека для Paper/Spigot-плагинов, которая закрывает инфраструктурный слой проекта: БД, GUI, команды, конфиги, перезагрузку, локализацию, наблюдаемость и событийную коммуникацию.

Для кого эта библиотека

NextLib особенно полезен, если вы:

• развиваете плагин дольше «одного релиза»;
• хотите единый инженерный стиль вместо ad-hoc кода;
• хотите быстрее внедрять фичи без постоянного переписывания инфраструктуры;
• хотите, чтобы код оставался читаемым через месяцы развития.

Ключевая идея NextLib

Не тратить время на повторяемый каркас.

Вместо этого:

• инфраструктура типизирована и централизована;
• бизнес-логика остаётся в вашем домене;
• техдолг снижается за счёт единых контрактов.

Что входит в библиотеку

Базовые модули

• Dynamic Database
• GUI API
• Command API
• Item API
• Color API
• Config Manager

Операционные и платформенные модули

• NextLib Context
• Validation API
• Reload API
• Observability API
• I18n API
• Messaging API
• Quests API
• Utilities API

Что нового в линии 1.0.8

• NextLibContext как единая runtime-точка сервисов.
• Усиленный Dynamic Database: relations, include-graphs, upsert, auto migrations, аннотации validation/index/unique/convert.
• Полноценные эксплуатационные инструменты: health checks, metrics, structured logs.
• Расширение доменных модулей: quests + validation + reload orchestration.

Архитектурная карта (в одном абзаце)

NextLibContext поднимает сервисы платформы. DatabaseManager + DynamicDatabase работают с данными. GuiManager обслуживает меню. Command API управляет входной точкой игрока/админа. Validation фильтрует вход. I18n и Color формируют пользовательский текст. Reload позволяет безопасно обновлять состояние. Observability показывает, что происходит в проде.

Как читать эту документацию

Если начинаете с нуля

1. Установка
2. Быстрый старт
3. Dynamic Database
4. GUI API

Если у вас уже есть плагин

• устойчивость и эксплуатация:
  • Reload API
  • Observability API
  • Troubleshooting
• контент и UX:
  • Quests API
  • I18n API
  • Item API
• инфраструктурная чистота:
  • Validation API
  • Config Manager

Рекомендуемый путь внедрения в существующий проект

1. Подключить NextLib и драйвер БД.
2. Вынести bootstrap в NextLibContext.
3. Перевести хотя бы один доменный блок на DynamicTable.
4. Перенести GUI из хардкода в YAML.
5. Включить Reload + базовые метрики/health.
6. После стабилизации расширить на i18n и messaging.

Философия качества

• Явные контракты вместо «магии».
• Малые модули с понятной ответственностью.
• Наблюдаемость и reload как часть дизайна, а не post-fix.
• Документация и код развиваются вместе.

Полезные разделы

• API Reference — подробный справочник методов и контрактов.
• Cookbook — практические сценарии «как сделать фичу».
• Glossary — словарь терминов для команды.
• Roadmap — куда движется проект.