eco

eco is a powerful Spigot plugin framework that simplifies plugin development and supercharges your plugins.

It is the engine behind EcoEnchants, Reforges, EcoItems, EcoSkills, EcoArmor, Talismans, and many more.

eco comes packed with all the tools you need in your plugins:

• Modern command API
• Native color parsing with full hex/RGB/MiniMessage support
• YAML/JSON/TOML config system with config serialization
• Persistent data storage API with YAML, SQLite, MySQL, MariaDB, PostgreSQL, MongoDB and Redis support, plus YAML to SQLite migration
• Shared leaderboard service
• Level curves and progression API
• Packet item display system with a layered lore API
• Shared item component system
• Lightweight Netty packet API
• Entity AI API with near-1:1 NMS mappings
• Extra events (armor equip, jump, natural XP gain, kill attribution and more)
• Extension API (plugins for plugins)
• Fluent dependency injection for NamespacedKey, Metadata values, and more
• Ultra-fast ItemStack reimplementation bypassing ItemMeta
• Complete GUI API with pages, masks, reactive slots and virtual GUIs
• Over 50 native integrations for other plugins, each one can be turned off in config
• First-class custom item, block and entity support with lookup strings
• Built-in math expression engine with compiled expressions
• Particle lookups with colours and per-player particles
• Sounds with pitch ranges, expressions and custom sound support
• Complete Placeholder API
• Price system (economy plugins, XP, items, etc.)
• Custom recipe API for crafting, smelting, smithing, stonecutting, brewing, anvils, grindstones, crafters and villagers, with support for stacks and custom items
• Anvil and drag-and-drop handler APIs
• Custom enchantment registry
• Built-in holograms, waypoints and persistent action bars
• Datapack API
• Discord webhook API
• Caching API
• Folia-ready scheduler API
• NMS/version-specific tooling
• Native plugin update checking
• Native bStats support
• Full Kotlin support with native extensions
• Tooling for meta-frameworks like libreforge
• And much more

For Server Owners

• Supports 1.21.8 through 26.3
• Folia supported

For Developers

eco is a standalone plugin. Install it on any server running plugins that depend on it, and declare it in your plugin.yml:

depend:
  - eco

Dependency Information

Gradle:

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

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

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>

Replace Tag with a release tag, for example 2026.42.

Javadocs

Javadocs are available via JitPack using this format:

https://javadoc.jitpack.io/com/willfp/eco/<version>/javadoc/

Replace <version> with the release tag you are targeting.

Build Locally

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

Windows:

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

License

eco is licensed under MIT. Read the full license: LICENSE.md