eco is a powerful Spigot plugin framework that simplifies the process of plugin creation and supercharges your plugins. It's the engine behind EcoEnchantsReforgesEcoItemsEcoSkillsEcoArmorTalismans, and many more.

eco?color=informational 7666?color=informational 7666?color=informational 452518336627081236?label=discord&color=informational java-ci.yml?branch=develop&color=informational

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
  • Persistent data storage API with Yaml/MySQL/MongoDB support
  • Packet item display system
  • Lightweight event loop based packet API
  • Entity AI API with near-1:1 NMS mappings
  • More events
  • Extension API, essentially plugins for plugins
  • Fluent dependency injection for NamespacedKey, Metadata values, etc.
  • Ultra-fast ItemStack reimplementation bypassing ItemMeta
  • Complete GUI API with pre-made components available from ecomponent
  • Over 30 native integrations for other plugins
  • First-class custom item support with lookup strings
  • Math expression parsing via Crunch
  • Particle lookups
  • Complete Placeholder API
  • Price system, supporting economy plugins, XP, Items, etc.
  • NMS/Version-specific tooling
  • Custom crafting recipe API with support for stacks and custom items
  • Native plugin update checking
  • Native bStats support
  • Full Kotlin support and native extensions
  • Tooling to make meta-frameworks, like libreforge
  • And much more

For server owners

  • Supports 1.17+


For developers


The 6.49.0 Javadoc can be found here

Plugin Information

eco is a standalone plugin, so you will need to install it on any servers that have plugins which depend on it, and specify it as a dependency in your plugin.yml:

  - eco

Get from JitPack:


repositories {
        maven { url '' }
dependencies {
        compileOnly 'com.willfp:eco:Tag'

Replace Tag with a release tag for eco, eg 6.49.0.



Replace Tag with a release tag for eco, eg 6.49.0.

Build locally:

Run the following commands in your terminal of choice.

If you're on windows, you will need to have git bash installed.

git clone
cd eco
./gradlew build


eco is licensed under GNU GPL3. Click here to read the entire license.

Check out our partners!