Плагін Minecraft eco

🔌 Про eco

eco — це бібліотека для розробки Spigot (окремий плагін Minecraft), створена, щоб спростити розробку плагінів і надати повторно використовувані можливості рушія для інших плагінів. Вона надає API для команд і конфігурації, адаптери постійного сховища, системи GUI та кастомних предметів, а також численні інтеграції, щоб автори плагінів могли повторно використовувати типову функціональність замість того, щоб реалізовувати її з нуля.

🎯 Призначення

eco існує, щоб централізувати поширені системи, потрібні сучасним плагінам: розбір команд, формати кольорів і повідомлень, формати конфігурацій, доступ до постійних даних, компоненти GUI, роботу з предметами та інтеграції з іншими серверними системами. Вона призначена для авторів плагінів, які хочуть швидко створювати функції на основі підтримуваного спільного фреймворку.

⚙️ Можливості

• Сучасний API команд і розбір
• Власний розбір кольорів із підтримкою hex / RGB / MiniMessage
• Система конфігурації з підтримкою YAML, JSON і TOML
• API постійного сховища даних із бекендами YAML, MySQL і MongoDB
• API GUI та готові компоненти
• Кастомні предмети та надшвидка обробка ItemStack
• Відображення предметів через пакети та легкий event loop для пакетів
• API AI для сутностей із майже 1:1 мапінгом NMS
• Placeholder API та нативні інтеграції (проєктом перелічено понад 30 інтеграцій)
• Абстракція ціни/економіки (система цін, що підтримує економічні плагіни, XP, предмети)
• Нативна підтримка bStats і перевірка оновлень плагіна
• Система розширень (плагіни для плагінів) і інструменти dependency injection для розробників

🧩 Для кого це

• Розробники плагінів, які створюють сумісні зі Spigot/Paper плагіни та хочуть повторно використовуваний фреймворк
• Власники серверів, які запускають плагіни, що залежать від eco (eco має бути встановлений як залежність)
• Проєкти, яким потрібні кастомні предмети, GUI або уніфіковані інструменти для сховища та команд

🏗️ Приклади використання

• Розробник створює кастомний набір предметів, який використовує API пошуку предметів і GUI від eco.
• Плагін використовує API сховища eco, щоб підтримувати і локальний YAML, і віддалений бекенд MongoDB без дублювання коду.
• Кілька невеликих плагінів спільно використовують eco для узгодженої обробки команд і розбору кольорів.

⚙️ Встановлення

📥 Налаштування

• Встановіть eco як плагін на будь-який сервер, якому він потрібен, помістивши JAR у папку plugins/ сервера та перезапустивши сервер.
• Якщо інший плагін залежить від eco, вкажіть це у plugin.yml цього плагіна в depend: з - eco, щоб сервер завантажив eco першим.

📦 Залежність (для розробників плагінів)

• Проєкт публікує Maven-репозиторій і координати Gradle для використання compile-only. Проєкт пропонує опублікований artifact (наприклад, із group com.willfp і тегами версій), щоб розробники додавали eco як provided dependency під час збірки.

🧠 Технічні примітки

• Підтримуване серверне ПЗ: офіційний проєкт вказує підтримку Spigot, Paper, Purpur і Folia.
• Підтримувані версії Minecraft: у проєкті зазначено підтримку починаючи з 1.21.4, а пізніші збірки орієнтовані на сучасну серію 1.21.x.
• Бекенди сховища: фреймворк надає адаптери YAML, MySQL і MongoDB.
• Ліцензія: eco випущено під ліцензією MIT.

🤝 Коли цей плагін корисний

Якщо ви розробляєте кілька функцій або плагінів із спільними потребами (команди, формати конфігурації, компоненти GUI, сховище, кастомні предмети), eco зменшує дублювання роботи, надаючи підтримуваний фреймворк та інтеграції, від яких можуть залежати інші плагіни.