All Mods Resource Packs Data Packs Shaders Modpacks Plugins
eco

eco

by Exanthiax • Downloads: 0 • Followers: 0
Description
Gallery
Changelog
Versions

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
26.3 26.2 26.1.2 +1
Paper Purpur Spigot
8h ago 1
26.3 26.2 26.1.2 +1
Paper Purpur Spigot
8h ago 1
26.3 26.2 26.1.2 +1
Paper Purpur Spigot
8h ago 1
26.3 26.2 26.1.2 +1
Paper Purpur Spigot
8h ago 1
26.3 26.2 26.1.2 +1
Paper Purpur Spigot
8h ago 1
26.2 26.1.2 1.21.x
Paper Purpur Spigot
8h ago 1
26.2 26.1.2 1.21.x
Paper Purpur Spigot
8h ago 1
26.2 26.1.2 1.21.x
Paper Purpur Spigot
8h ago 1
26.2 26.1.2 1.21.x
Paper Purpur Spigot
8h ago 1
26.2 26.1.2 1.21.x
Paper Purpur Spigot
8h ago 1
26.2 26.1.2 1.21.x
Paper Purpur Spigot
8h ago 1
26.2 26.1.2 1.21.x
Paper Purpur Spigot
8h ago 1
26.2 26.1.2 1.21.x
Paper Purpur Spigot
8h ago 1
26.2 26.1.2 1.21.x
Paper Purpur Spigot
8h ago 1
26.2 26.1.x 1.21.x
Paper Purpur Spigot
8h ago 1
26.2 26.1.x 1.21.x
Paper Purpur Spigot
8h ago 1
26.2 26.1.x 1.21.x
Paper Purpur Spigot
8h ago 1
26.1.2 1.21.x
Paper Purpur Spigot
8h ago 1
26.1.2 1.21.x
Paper Purpur Spigot
8h ago 1
26.1.2 1.21.x
Paper Purpur Spigot
8h ago 1
26.1.2 1.21.x
Paper Purpur Spigot
8h ago 1
26.1.2 1.21.x
Paper Purpur Spigot
8h ago 1
26.1.2 1.21.x
Paper Purpur Spigot
8h ago 1
26.1.2 1.21.x
Paper Purpur Spigot
8h ago 1
26.1.2 1.21.x
Paper Purpur Spigot
8h ago 1
1.21.x
Paper Purpur Spigot
8h ago 1
1.21.x
Paper Purpur Spigot
8h ago 1
1.21.x
Folia Paper Purpur Spigot
8h ago 1
1.21.x
Paper Purpur Spigot
8h ago 1
1.21.x
Paper Purpur Spigot
8h ago 1
1.21.x
Paper Purpur Spigot
8h ago 1
1.21.x
Paper Purpur Spigot
8h ago 1
26.1.1 1.21.x
Paper Purpur Spigot
8h ago 1
1.21.x
Paper Purpur Spigot
8h ago 1
26.1.1 1.21.x
Paper Purpur Spigot
8h ago 1
1.21.x
Paper Purpur Spigot
8h ago 1
1.21.x
Paper Purpur Spigot
8h ago 1
1.21.x
Paper Purpur Spigot
8h ago 1
1.21.x
Paper Purpur Spigot
8h ago 1
[2026.41] 2026.41 by Exanthiax on Oct 15, 2026
Download
  • 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.
[2026.40] 2026.40 by Exanthiax on Oct 15, 2026
Download
  • 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.
[2026.39.1] 2026.39.1 by Exanthiax on Oct 15, 2026
Download
  • feat: Redis Storage (Thanks CallumJohnson!!!)
  • feat: PostgreSQL Storage (Thanks CallumJohnson!!!)
  • EcoHub: Bump version to 2026.39.1.
[2026.39] 2026.39 by Exanthiax on Oct 15, 2026
Download
  • feat: shared level curve and progression core
  • EcoHub: Bump version to 2026.39.
[2026.38] 2026.38 by Exanthiax on Oct 15, 2026
Download
  • 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.
[2026.37] 2026.37 by Exanthiax on Oct 15, 2026
Download
  • 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.
[2026.36] 2026.36 by Exanthiax on Oct 15, 2026
Download
  • 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.
[2026.35] 2026.35 by Exanthiax on Oct 15, 2026
Download
  • 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.
[2026.34] 2026.34 by Exanthiax on Oct 15, 2026
Download
  • 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.
[2026.33] 2026.33 by Exanthiax on Oct 15, 2026
Download
  • 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.
[2026.32] 2026.32 by Exanthiax on Oct 15, 2026
Download
  • 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.
[2026.31] 2026.31 by Exanthiax on Oct 15, 2026
Download
  • 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.
[2026.30.1] 2026.30.1 by Exanthiax on Oct 15, 2026
Download
  • fix: Version Parsing (Thanks CallumJohnson!!!)
  • EcoHub: Bump version to 2026.30.1.
[2026.29] 2026.29 by Exanthiax on Oct 15, 2026
Download
  • 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.
[2026.28] 2026.28 by Exanthiax on Oct 15, 2026
Download
  • 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.
[2026.27] 2026.27 by Exanthiax on Oct 15, 2026
Download
  • 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
[2026.25] 2026.25 by Exanthiax on Oct 15, 2026
Download
  • Standardised Versioning
  • Added 26.2 support
  • Improved pages & navigation
  • Added %page% and %max_page% placeholders.
[7.6.5] 7.6.5 by Exanthiax on Oct 15, 2026
Download
  • Added Prices.unregisterPriceFactory for reload safe re-registration
[7.6.4] 7.6.4 by Exanthiax on Oct 15, 2026
Download
  • 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
[7.6.2] 7.6.2 by Exanthiax on Oct 15, 2026
Download
  • Added unenchantable item lookup arg parser
  • Fixed ExcellentEconomy integration (Thanks DeathGOD7!)
  • Added onLoad function for extensions (Thanks refractored!)
^- Any current **extensions** will need updating.
[7.6.1] 7.6.1 by Exanthiax on Oct 15, 2026
Download
  • Add variable pitch support (Thanks Auxilor!)
  • Updated CraftEngine support (Thanks jhqwqmc!)
  • Fixed dead players respawning on death location with PVP plugins
[7.6.0] 7.6.0 by Exanthiax on Oct 15, 2026
Download
  • Added bStats backend handlers
  • Reduced unnecessary library shading
  • Updated ModelEngine integration
  • Fixed null/blank permissions in recipes
[7.5.2] 7.5.2 by Exanthiax on Oct 15, 2026
Download
Hotfix: Fixed %level% and other variable placeholders not returning correct values
[7.5.1] 7.5.1 by Exanthiax on Oct 15, 2026
Download
  • 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
[7.5.0] 7.5.0 by Exanthiax on Oct 15, 2026
Download
Added 26.1.2 Support
Dropped 1.21.4 -> 1.21.7 support. 1.21.8 is the oldest supported version.
[7.4.3] 7.4.3 by Exanthiax on Oct 15, 2026
Download
  • Updated FactionsUUID integration (Thanks OfTeN!)
  • Updated getVein to use TestableBlock
  • Added Discord Webhook API support (Thanks OfTeN!)
  • Reverted Folia support
[7.4.1] 7.4.1 by Exanthiax on Oct 15, 2026
Download
  • Added TitleCase to StringUtils (API)
  • Revert MiniMessage changes due to breakages elsewhere.
[7.4.0] 7.4.0 by Exanthiax on Oct 15, 2026
Download
  • Added Folia support (Thanks Nico!)
  • Fixed plugin reload errors
[7.3.3] 7.3.3 by Exanthiax on Oct 15, 2026
Download
  • Fixed lore duplication
[7.3.2] 7.3.2 by Exanthiax on Oct 15, 2026
Download
  • Fixed plugin not loading and various other issues from 7.3.1
  • Fixed banners not applying to EcoItem shields (Thanks 0x484!)
eco Icon
Download eco
Select game version
Select platform