eco

eco - это мощный фреймворк для разработки плагинов на Spigot, который не просто упрощает жизнь разработчикам, а буквально прокачивает их плагины до уровня, о котором раньше можно было только мечтать. Если вы собираете сервер с кастомными механиками, то eco - это та самая база, на которой всё держится.

По сути, eco - это движок, на котором построены такие известные плагины, как EcoEnchants, Reforges, EcoItems, EcoSkills, EcoArmor, Talismans и многие другие. Он предоставляет разработчикам готовые инструменты, чтобы не писать одну и ту же систему заново для каждого нового плагина. А для серверов это значит, что всё работает стабильно, плавно и без конфликтов.

Что даёт eco прямо из коробки:

• Современная система команд - создание команд без лишней головной боли.
• Парсинг цвета - нативная поддержка HEX, RGB и MiniMessage, так что чат и имена выглядят красиво.
• Система конфигов - YAML, JSON и TOML - выбирай, что удобнее.
• Хранение данных - YAML, MySQL, MongoDB - для любых масштабов.
• Система отображения предметов - работает через пакеты, без лагов.
• Лёгкая пакетная API - для работы с сетевыми пакетами, почти как в NMS, но проще.
• API для ИИ существ - почти 1:1 с маппингами NMS, то есть полный контроль.
• Дополнительные события - больше хуков для ваших механик.
• Расширяемость - Extension API позволяет делать плагины для плагинов.
• Dependency Injection - NamespacedKey, метаданные и прочее подключаются сами.
• Быстрая работа с предметами - обход стандартного ItemMeta, всё летает.
• Готовый GUI - с компонентами из ecomponent, красиво и без костылей.
• Более 40 встроенных интеграций - с другими плагинами, всё из коробки.
• Кастомные предметы - с поддержкой lookup строк, удобно для скриптов.
• Математический парсер - через Crunch, для сложных формул.
• Поиск частиц - быстрый и удобный.
• API для плейсхолдеров - своя система, без лишних плагинов.
• Система цен - экономика, XP, предметы - гибко и мощно.
• NMS-инструменты - под каждую версию свои, чтобы не было проблем.
• Кастомные крафты - с поддержкой стеков и кастомных предметов.
• Автообновление - встроенная проверка обновлений.
• bStats - статистика готова из коробки.
• Kotlin - полная поддержка с нативными расширениями.
• Инструменты для мета-фреймворков - например, для libreforge.

И это далеко не всё - дальше только растёт.

Для владельцев серверов

• Поддерживается **Minecraft 1.21.4+
• Folia - да, работает и на многопоточке.

Просто ставите плагин на сервер, объявляете его в depend других плагинов - и всё работает. Без сложных настроек.

Для разработчиков

Подключение плагина

eco - самостоятельный плагин. Поставьте его на сервер, пропишите зависимость в plugin.yml:

depend:
  - eco

Dependency Information

Gradle репозиторий:

repositories {
    maven("https://repo.auxilor.io/repository/maven-public/")
}

Gradle зависимость:

dependencies {
    compileOnly("com.willfp:eco:Tag")
}

Замените Tag на номер релиза, например 7.4.0.

Maven репозиторий и зависимость:

<repository>
    <id>auxilor</id>
    <url>https://repo.auxilor.io/repository/maven-public/</url>
</repository>

<dependency>
    <groupId>com.willfp</groupId>
    <artifactId>eco</artifactId>
    <version>Tag</version>
    <scope>provided</scope>
</dependency>

Замените Tag на номер релиза.

Javadocs

Документация доступна через JitPack по ссылке:

https://javadoc.jitpack.io/com/willfp/eco/<версия>/javadoc/

(Замените <версия> на нужный тег релиза.)

Сборка локально

git clone https://github.com/Auxilor/eco
cd eco
./gradlew build

На Windows:

git clone https://github.com/Auxilor/eco
cd eco
.\gradlew.bat build

Лицензия

eco распространяется под лицензией MIT.

Если вы собираете сервер с кастомными механиками, eco - это must-have. Он не просто ускоряет разработку, а делает возможным то, что раньше требовало месяцев написания кода. Скачайте eco и попробуйте - разница будет сразу заметна.

Скачать eco для Minecraft можно на нашем сайте, установка занимает пару минут.