eco
eco 是一个功能强大的 Spigot 插件框架,能够简化插件开发并大幅提升你的插件性能。
它是以下插件的核心引擎:EcoEnchants、Reforges、EcoItems、EcoSkills、EcoArmor、Talismans 以及更多其他插件。
eco 内置了你在开发插件时所需的所有工具:
-
现代化命令 API
-
原生颜色解析,全面支持十六进制/RGB/MiniMessage
-
基于 YAML/JSON/TOML 的配置系统,支持配置序列化
-
持久化数据存储 API,支持 YAML、SQLite、MySQL、MariaDB、PostgreSQL、MongoDB 和 Redis,并提供从 YAML 到 SQLite 的迁移功能
-
共享排行榜服务
-
等级曲线与进度 API
-
带分层 Lore API 的数据包物品显示系统
-
共享物品组件系统
-
轻量级 Netty 数据包 API
-
实体 AI API,提供近乎 1:1 的 NMS 映射
-
额外事件(装备护甲、跳跃、自然经验获取、击杀归属等)
-
扩展 API(插件的插件)
-
针对 NamespacedKey、Metadata 值等的流畅依赖注入
-
绕过 ItemMeta 的超快 ItemStack 重新实现
-
完整的 GUI API,支持分页、遮罩、响应式槽位及虚拟 GUI
-
超过 50 种对其他插件的原生集成,均可在配置中单独关闭
-
一流的一流自定义物品、方块和实体支持,包含查找字符串
-
内置数学表达式引擎,支持编译后的表达式
-
粒子查找功能,支持颜色及玩家专属粒子效果
-
音效支持音高范围、表达式及自定义音效
-
完整的 Placeholder API
-
价格系统(支持经济插件、经验值、物品等)
-
自定义配方 API,涵盖合成、熔炼、锻造台、切石机、酿造、铁砧、磨石、制箭器及村民交易,支持堆叠物品及自定义物品
-
铁砧及拖放处理程序 API
-
自定义附魔注册表
-
内置全息图、路标及持久化动作条
-
数据包 API
-
Discord Webhook API
-
缓存 API
-
兼容 Folia 的计划任务 API
-
NMS/版本特定工具集
-
原生插件更新检测
-
原生 bStats 支持
-
完整的 Kotlin 支持,附带原生扩展
-
用于诸如 libreforge 之类的元框架的工具
-
以及更多
面向服务器管理员
- 支持 1.21.8 至 26.3
- 支持 Folia
面向开发者
eco 是一个独立插件。将其安装到任何依赖它的插件所在的服务器上,并在你的 plugin.yml 中声明它:
depend:
- eco
依赖信息
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>
将 Tag 替换为发布标签,例如 2026.42。
Javadocs
Javadocs 可通过 JitPack 获取,格式如下:
https://javadoc.jitpack.io/com/willfp/eco/<version>/javadoc/
将 <version> 替换为你目标版本的发布标签。
本地构建
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 许可证授权。
阅读完整许可证:LICENSE.md
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
评论 0
登录后参与评分
还没有评论,来抢沙发吧