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
- Persistent data storage API with YAML/MySQL/MongoDB support
- Packet item display system
- Lightweight event-loop packet API
- Entity AI API with near-1:1 NMS mappings
- More events
- Extension API (plugins for plugins)
- Fluent dependency injection for NamespacedKey, Metadata values, and more
- Ultra-fast ItemStack reimplementation bypassing ItemMeta
- Complete GUI API with pre-made components from ecomponent
- Over 40 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 (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 with native extensions
- Tooling for meta-frameworks like libreforge
- And much more
For Server Owners
- Supports 1.21.4+
- Folia supported
For Developers
Plugin Information
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:
repositories {
maven("https://repo.auxilor.io/repository/maven-public/")
}
Gradle dependency:
dependencies {
compileOnly("com.willfp:eco:Tag")
}
Replace Tag with a release tag, for example 7.4.0.
Maven repository + dependency:
<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 7.4.0.
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
All Versions
+ Add Version| Name | Game version | Platforms | Published | Downloads | Actions |
|---|---|---|---|---|---|
|
R
2026.41
|
8h ago | 1 | |||
|
R
2026.40
|
8h ago | 1 | |||
| 8h ago | 1 | ||||
|
R
2026.39
|
8h ago | 1 | |||
|
R
2026.38
|
8h ago | 1 | |||
|
R
2026.37
|
8h ago | 1 | |||
|
R
2026.36
|
8h ago | 1 | |||
|
R
2026.35
|
8h ago | 1 | |||
|
R
2026.34
|
8h ago | 1 | |||
|
R
2026.33
|
8h ago | 1 | |||
|
R
2026.32
|
8h ago | 1 | |||
|
R
2026.31
|
8h ago | 1 | |||
| 8h ago | 1 | ||||
|
R
2026.29
|
8h ago | 1 | |||
|
R
2026.28
|
8h ago | 1 | |||
|
R
2026.27
|
8h ago | 1 | |||
|
R
2026.25
|
8h ago | 1 | |||
|
R
7.6.5
|
8h ago | 1 | |||
|
R
7.6.4
|
8h ago | 1 | |||
|
R
7.6.2
|
8h ago | 1 | |||
|
R
7.6.1
|
8h ago | 1 | |||
|
R
7.6.0
|
8h ago | 1 | |||
|
R
7.5.2
|
8h ago | 1 | |||
|
R
7.5.1
|
8h ago | 1 | |||
|
R
7.5.0
|
8h ago | 1 | |||
|
R
7.4.3
|
8h ago | 1 | |||
|
R
7.4.1
|
8h ago | 1 | |||
|
R
7.4.0
|
8h ago | 1 | |||
|
R
7.3.3
|
8h ago | 1 | |||
|
R
7.3.2
|
8h ago | 1 | |||
|
R
7.3.1
|
8h ago | 1 | |||
|
R
7.2.2
|
8h ago | 1 | |||
|
A
7.2.1
|
8h ago | 1 | |||
|
R
7.2.1
|
8h ago | 1 | |||
|
R
7.2.0
|
8h ago | 1 | |||
| 8h ago | 1 | ||||
| 8h ago | 1 | ||||
| 8h ago | 1 | ||||
| 8h ago | 1 |
- feat: disabled integrations [EcoHub-200]
- docs: add disabled-integrations docs
- feat: version prerequisites
- fix: Reloading dynamic commands. [EcoHub-202] (Thanks CallumJohnson!!!)
- feat: item use api [EcoHub-192]
- chore: update authors
- feat: enchantment registry api
- fix: anvil item name reset [EcoHub-210]
- feat: persistent action bar api
- fix: Missing folia support (Thanks CallumJohnson!!!)
- feat: add RedisEconomy as Price Integration (Thanks Saros-6585!!!)
- feat: block drops api
- EcoHub: Bump version to 2026.41.
- feat: Shared Item Component system [EcoHub-97] (Thanks CallumJohnson!!!)
- docs: sync supported plugins
- feat: unconsumable item arg [EcoHub-198]
- feat: lore system rework [EcoHub-195]
- feat: no-climb entity modifier [EcoHub-150]
- EcoHub: Bump version to 2026.40.
- feat: Redis Storage (Thanks CallumJohnson!!!)
- feat: PostgreSQL Storage (Thanks CallumJohnson!!!)
- EcoHub: Bump version to 2026.39.1.
- feat: shared level curve and progression core
- EcoHub: Bump version to 2026.39.
- docs: update supported plugins list and enhance descriptions
- fix: merging same items in anvil broken [EcoHub-161]
- feat: PlotSquared support [EcoHub-157]
- feat: 26.3 support [EcoHub-170]
- perf(data): bound the persistent data executor (Thanks ohAleee!!!)
- EcoHub: Bump version to 2026.38.
- feat: shared leaderboard service [EcoHub-114]
- fix: Kill attribution memory leak [EcoHub-136] (Thanks CallumJohnson!!!)
- feat: yaml to sqlite migration
- EcoHub: Bump version to 2026.37.
- fix: price factory registration [EcoHub-88]
- feat: added PlayerProfileResolver to allow plugins to store player data against a different UUID (Thanks joogiebear!!!)
- fix: denizen integration issues
- fix: update merchant trade cost display to prevent lore conflicts [EcoHub-123]
- fix: lore duplicating on items whose display lines were flattened
- fix: mace repairability [EcoHub-121]
- feat: Folia Support (WIP) (Thanks CallumJohnson!!!)
- fix: eco doubles anvil repair costs
- feat: MC Version consolidation (Thanks CallumJohnson!!!)
- docs: rename documentation to ecohub
- feat: Residence AntiGrief upgrade [EcoHub-129] (Thanks CallumJohnson!!!)
- fix: eco blocking other plugin anvil recipes [EcoHub-124] (Thanks CallumJohnson!!!)
- EcoHub: Bump version to 2026.36.
- feat: per_player_particles
- feat: shutdown on major api version mismatch
- feat: rework datapack handlers (Thanks CallumJohnson!!!)
- fix: version qualifier mismatch
- fix: NMS related issues and add checker for future errors [EcoHub-104]
- feat: validate datapack entries against the draft as well as the live registries
- feat: Bukkit's recipe converter [EcoHub-105]
- fix: eco removing lore from other plugins [EcoHub-23]
- EcoHub: Bump version to 2026.35.
- chore: Updated intro documentation (EcoHub SEO) (Thanks CallumJohnson!!!)
- fix: speed up recipe reloading [EcoHub-61] (Thanks CallumJohnson!!!)
- fix: Recursive custom block lookup breaks noteblocks with instrument modifiers
- EcoHub: Bump version to 2026.34.
- fix: MythicMobs item-lookup case-sensitivity [EcoHub-1] (Thanks CallumJohnson!!!)
- feat: Residence Antigrief (Thanks CallumJohnson!!!)
- feat: added virtual GUI methods [EcoHub-16] (Thanks CallumJohnson!!!)
- feat: added particle colors and additional data [EcoHub-12] (Thanks CallumJohnson!!!)
- fix: armor swapping via hotbar [EcoHub-15] (Thanks CallumJohnson!!!)
- fix: update ExcellentShop integration [EcoHub-2] (Thanks CallumJohnson!!!)
- fix: anvil name components changes [EcoHub-14]
- feat: Mathematics Upgrade [EcoHub-24] (Thanks CallumJohnson!!!)
- fix: Cache for non-random expressions [EcoHub-25] (Thanks CallumJohnson!!!)
- docs: update math docs
- EcoHub: Bump version to 2026.33.
- fix: stonecutting recipes not working on 26.x
- chore: JavaDocs for eco-api (Thanks CallumJohnson!!!)
- feat: add {#{expression}} progress bar placeholder syntax
- fix: placeholder parsing in sound expressions
- feat: implement waypoint marker API
- EcoHub: Bump version to 2026.32.
- feat: bStats Origin (Thanks CallumJohnson!!!)
- feat: indirect kill attribution
- feat: add expression support to sounds
- fix: 26.1.2 holograms and persistent holograms
- EcoHub: Bump version to 2026.31.
- fix: Version Parsing (Thanks CallumJohnson!!!)
- EcoHub: Bump version to 2026.30.1.
- feat: added initial custom sound support to PlayableSound (Thanks WillFP!!!)
- fix: GUIHelpers use AbstractSound (Thanks Exanthiax!!!)
- feat: centralise cache in eco (Thanks CallumJohnson!!!)
- chore: update kingdomsx integration (Thanks Exanthiax!!!)
- fix: add Merchant packet listener for 26.2 (Thanks Exanthiax!!!)
- feat: migrate anvil handlers to eco (Thanks Exanthiax!!!)
- feat: implement more crafting workstations (Thanks Exanthiax!!!)
- fix: nexo items not updating ever (Thanks Saros-6585!!!)
- Fix: health reset on join (Thanks DeathGOD7!!!)
- EcoHub: Bump version to 2026.29.
- docs: reorganise sidebar positions
- docs: replace old links with EcoHub links
- docs: replace old links with EcoHub links
- Fix/26.2 errors (Thanks Exanthiax!!!)
- EcoHub: Bump version to 2026.28.
- more updater stuff
- feat: add MythicMobs item provider and registration (Thanks Exanthiax!!!)
- EcoHub: Bump version to 2026.27.
- Change release trigger to use published events
- Allow publish artifact step to continue on error
- Standardised Versioning
- Added 26.2 support
- Improved pages & navigation
- Added %page% and %max_page% placeholders.
- Added Prices.unregisterPriceFactory for reload safe re-registration
- Fixed circular plugin loading caused by Lands in loadbefore. (Thanks NoltoxGit!!!)
- Added tamed filter arg to Entity Lookup. (Thanks Callum!!!)
- Fixed health patch to respect current health attribute value (Thanks 0ft3n!!!)
- Updated Fancy plugins integration (Thanks eljokun!!!)
- Various EcoHub upgrades
- Added
unenchantableitem lookup arg parser - Fixed ExcellentEconomy integration (Thanks DeathGOD7!)
- Added
onLoadfunction for extensions (Thanks refractored!)
- Add variable pitch support (Thanks Auxilor!)
- Updated CraftEngine support (Thanks jhqwqmc!)
- Fixed dead players respawning on death location with PVP plugins
- Added bStats backend handlers
- Reduced unnecessary library shading
- Updated ModelEngine integration
- Fixed null/blank permissions in recipes
- Brought math in-house for major performance gain (Thanks Auxilor & Callum!)
- Fixed bug with CaptiveSlots (Thanks Callum)
- Fixed various Item Flags (Thanks Callum!)
- Added vanilla & custom entity tag framework
Dropped 1.21.4 -> 1.21.7 support. 1.21.8 is the oldest supported version.
- Updated FactionsUUID integration (Thanks OfTeN!)
- Updated getVein to use TestableBlock
- Added Discord Webhook API support (Thanks OfTeN!)
- Reverted Folia support
- Added TitleCase to StringUtils (API)
- Revert MiniMessage changes due to breakages elsewhere.
- Added Folia support (Thanks Nico!)
- Fixed plugin reload errors
- Fixed lore duplication
- Fixed plugin not loading and various other issues from 7.3.1
- Fixed banners not applying to EcoItem shields (Thanks 0x484!)