? ECore — Paper 与 Folia 的完整经济系统
ECore 是专为 Minecraft 1.21+ 设计的一站式经济插件。 它涵盖了货币、拍卖行、银行、职业、税收、基于供需关系的服务器商店以及 Discord 日志记录,所有功能共享同一个快速且防崩溃的核心。开启你需要的部分,关闭其余部分即可。
支持 Paper, Purpur 和 Folia · 支持 SQLite, MySQL 和 MariaDB · 兼容 Vault 和 PlaceholderAPI · 提供 英文和波兰语 消息
✨ 为什么选择 ECore?
- 一个插件代替六个。 经济系统、拍卖行、银行、职业、税收和商店共享相同的账户、货币和数据库。
- 玩家的资金安全无忧。 每次余额变动都是原子操作,资金以精确的整数形式存储,绝不使用浮点数。数据库层会在写入失败时重试,确保数据库波动不会导致资金丢失。
- 零卡顿。 余额保存在内存中,并在后台按顺序批量写入数据库。在我们的测试中,8,000 次转账(约 24,000 次数据库写入)在不到 2 秒内完成写入 MySQL。
- 原生支持 Folia。 从第一天起就基于 Paper 的区域感知调度器构建,而非后期修补。
- 轻松切换。 只需一条命令即可从 EssentialsX 或其他任何 Vault 经济插件导入余额。
? 核心经济系统
- 无限货币 (
currencies.yml):支持符号、格式、0–2 位小数、初始余额、最大余额、世界限定使用权限以及使用该货币所需的权限
- 数字格式化:
1,234.50、紧凑格式 1.2k / 3.4M / 1B,以及输入如 /pay Steve 2.5k
- 完整的 Vault 支持,包括按世界划分的货币和 Vault 银行
- 排行榜:支持点击翻页的
/baltop
- 交易日志:通过
/ecore history 查看,并自动清理
- 可疑活动警报:大额转账和集中转账会向管理员报告
? 拍卖行
- GUI 界面,支持分类、排序(最新、最旧、价格、即将结束)和搜索
- 托管与防重复购买:购买前会锁定商品列表,防止资金转移前出现重复售卖,菜单中的每次点击都受到保护
- 收藏箱:过期、取消和无法交付的物品在此等待,永远不会丢失
- 上架费和出售税作为资金回收机制,支持设置最低/最高价格和允许的货币
- 上架限制:通过权限控制 (
ecore.auction.limit.<n>)
- 黑名单:禁止特定材质和名称模式,包括隐藏在潜影盒和包裹中的物品
- 通知:卖家会立即收到销售通知,或在登录时收到汇总信息
- 出售历史:通过
/ah history 查看
? 银行
- 个人银行:将资金与钱包分离,提供用于快速存款和提款的 GUI
- 按权限分级 (
ecore.bank.tier.<name>):每个等级拥有独立的容量和利率
- 利息:按设定间隔发放,单次 payouts 有上限。如果银行账户长期闲置则不产生利息,从而防止多账号刷取利息的行为。
- 共享/公会银行 (
/gbank):支持所有者、经理和成员角色,邀请、踢出、晋升,以及成员上限和创建费用
- 存款和取款手续费(资金回收机制),并为每个银行提供完整的历史记录
- Vault 银行 API,使 Towny 等插件能够使用 ECore 银行
? 职业
- 五种预设职业:矿工、伐木工、农民、猎人和渔夫。可在
jobs.yml 中添加自定义职业;支持通配符如 *_LOG。
- 等级与经验值:每提升一级都会增加收入
- 倍率加成:可按等级、按权限 (
ecore.jobs.multiplier.<x>) 设置,也可通过 /jobs boost 2 60 进行全服加成
- 每日收入上限,重启后依然保留
- 反作弊机制:
- 放置的方块即使被活塞移动也不支付报酬;
- 圆石、石头和黑曜石生成器不支付报酬;
- 作物仅在完全成熟时支付报酬;
- 来自刷怪笼、蛋和傀儡农场的生物不支付报酬;
- 怪物研磨机在每个区块有限制;
- 创造模式下不支付报酬。
- 收益批量支付(每隔几秒进行一次交易,而不是每个方块一次),并在动作栏即时反馈
? 动态市场
- 基于供需关系的服务器商店:玩家出售某物品会降低其价格,购买则会提高价格
- 价格保护:每种价格始终在其基础价格的最低值和最高值之间波动
- 自动平衡:价格随时间推移逐渐回归基础价格
- 资金回收:出售价格为买入价格的一部分,因此倒卖物品永远无利可图
- 拆分交易没有优势,因为每个单位单独定价
- GUI 界面包含分类、实时价格和趋势,以及
/sell hand、/sell all 和 /market price <item> 命令
- 预置了五个类别中约 60 种物品
? 税收与通胀控制
- 累进税率,像真实所得税一样边际应用
- 转账税:应用于
/pay 命令,与转账操作在同一原子操作中完成
- 按世界倍率,例如在地狱加倍征税或出生点免税
- 财富税:针对大额余额(可选,仅限活跃玩家)
- 反通胀自动化:ECore 每天测量货币供应量。如果增长速度快于目标,税率会自动上升;如果慢于目标,则下降。市场出售价格随之调整。
- 统计信息:通过
/tax stats 查看,并通过 /tax calc <amount> 预览任何转账的税额
? Discord
- Webhooks,无需机器人
- 事件类型:大额转账、可疑活动、管理员余额变更、拍卖销售与上架、财富税和职业加成
- 每日经济报告:玩家数量、新玩家、流通货币、最富有的玩家、税收、市场、拍卖和职业收入
- 始终禁用提及功能,因此名为
@everyone 的玩家无法 ping 你的服务器
? 给服务器管理员
- 模块化:在
config.yml 中开启或关闭各个模块
- 完全可配置:每条消息均使用 MiniMessage(包含英语和波兰语);GUI 布局、材质和声音均可自定义
- 自动数据库迁移:更新时无需手动执行 SQL
- 更新通知:当 Modrinth 上发布新版 ECore 时,管理员会收到一条可点击的聊天通知
- 导入支持:使用
/ecore import essentials 或 /ecore import <VaultPlugin>,在任何更改发生前提供预览
? 占位符 (PlaceholderAPI)
| 占位符 |
示例 |
%ecore_balance%, %ecore_balance_<currency>% |
$1,234.50 |
%ecore_balance_compact% |
$1.2k |
%ecore_top_<currency>_<rank>_name% / _balance |
Steve / $5,300.00 |
%ecore_job_level_<job>%, %ecore_job_progress_<job>% |
12, 57 |
%ecore_jobs_earned% |
$1,250.00 |
%ecore_tax_multiplier% |
1.05 |
⌨️ 主要命令
| 命令 |
功能 |
/balance, /pay, /baltop |
金钱相关 |
/ah |
拍卖行 |
/bank, /gbank |
个人银行与共享银行 |
/jobs |
职业系统 |
/market, /sell |
动态市场 |
/tax |
税率与计算器 |
/eco give|take|set|reset |
管理员余额管理 |
/ecore reload|info|update|import|discord |
后台管理 |
所有上限、等级和倍率均由权限控制,因此 ECore 可与 LuckPerms 或其他任何权限插件配合使用。
? 开发者 API
ECoreAPI eco = ECoreProvider.get();
Currency coins = eco.getDefaultCurrency();
TransactionResult result = eco.withdraw(player.getUniqueId(), coins, Money.toMinor(new BigDecimal("25.50")), "myplugin:shop");
API 包含余额查询、转账和货币功能,以及可取消的事件(PreTransactionEvent、AuctionListEvent、AuctionPurchaseEvent)和 PostTransactionEvent / AuctionSaleEvent。
? 运行要求
- Paper、Purpur 或 Folia 1.21.1 或更高版本,包括 26.x(不支持原版 Spigot)
- Java 21 或更高版本(Minecraft 26.x 服务器需要 Java 25)
- 可选:Vault(其他插件使用 ECore 货币所需)、PlaceholderAPI
已在 Paper 1.21.11、Paper 26.3 和 Folia 1.21.11 下测试,数据库支持 SQLite、MySQL 8.4 和 MariaDB 11.4。
? 统计数据
ECore 使用 bStats 收集匿名使用统计数据:服务器数量、玩家数量、版本信息以及启用的模块。不收集任何玩家数据。可在 config.yml 中设置 metrics: false 关闭此功能,或在 plugins/bStats/config.yml 中为所有插件统一关闭。
更新检查器会联系 Modrinth API 以查找新版本;可通过设置 update-checker.enabled: false 将其关闭。
? ECore — the complete economy for Paper & Folia
ECore is an all-in-one economy plugin for Minecraft 1.21+. It covers money, an auction house,
banks, jobs, taxes, a supply-and-demand server shop and Discord logging, all sharing one fast,
crash-safe core. Turn on the parts you want and switch the rest off.
Runs on Paper, Purpur and Folia · SQLite, MySQL and MariaDB · works with Vault and PlaceholderAPI · messages in English and Polish
✨ Why ECore?
- One plugin instead of six. Economy, auction house, banks, jobs, taxes and a shop share the same
accounts, currencies and database.
- Your players' money is safe. Every balance change is atomic, and money is stored as exact whole
numbers, never floating point. The database layer retries until a write succeeds, so a database
hiccup doesn't lose money.
- No lag. Balances live in memory and are written to the database in ordered batches in the
background. In our tests 8,000 transfers (about 24,000 database writes) reached MySQL in under
2 seconds.
- Folia native. Built on Paper's region-aware schedulers from day one, not patched in later.
- Easy switching. Import balances from EssentialsX or any other Vault economy plugin with one
command.
? Core economy
- Unlimited currencies (
currencies.yml): symbol, format, 0–2 decimals, starting balance,
max balance, per-world use and a permission to use it
- Number formatting:
1,234.50, compact 1.2k / 3.4M / 1B, and input like /pay Steve 2.5k
- Full Vault support, including per-world currencies and Vault banks
- Leaderboard:
/baltop with clickable pages
- Transaction log with
/ecore history and automatic clean-up
- Suspicious activity alerts: large transfers and transfer bursts are reported to admins
? Auction house
- GUI with categories, sorting (newest, oldest, price, ending soon) and search
- Escrow and anti-dupe: a purchase reserves the listing before any money moves, so an item can
only be sold once, and every click in the menus is protected
- Collection bin: expired, cancelled and undeliverable items wait here and never get lost
- Listing fee and sale tax as money sinks, min/max price, allowed currencies
- Listing limits by permission (
ecore.auction.limit.<n>)
- Blacklist: materials and name patterns, including items hidden in shulker boxes and bundles
- Notifications: sellers are told about sales instantly, or get a summary when they log in
- Sale history with
/ah history
? Banks
- Personal bank: money kept apart from the wallet, with a GUI for quick deposits and withdrawals
- Tiers by permission (
ecore.bank.tier.<name>): each tier has its own capacity and interest rate
- Interest at a set interval, with a cap per payout. Banks idle for too long earn nothing, which
stops interest farming on alt accounts.
- Shared / guild banks (
/gbank): owner, manager and member roles, invites, kick, promote,
a member limit and a creation cost
- Deposit and withdrawal fees (money sinks) and a full history for every bank
- Vault bank API, so plugins like Towny can use ECore banks
? Jobs
- Five ready jobs: miner, woodcutter, farmer, hunter and fisherman. Add your own in
jobs.yml;
wildcards like *_LOG work.
- Levels and XP: every level raises income
- Multipliers: per level, per permission (
ecore.jobs.multiplier.<x>), and server-wide boosts
with /jobs boost 2 60
- Daily income limit, which survives restarts
- Anti-exploit:
- placed blocks pay nothing, even after a piston moves them;
- cobblestone, stone and obsidian generators pay nothing;
- crops pay only when fully grown;
- mobs from spawners, eggs and golem farms pay nothing;
- mob grinders are limited per chunk;
- creative mode pays nothing.
- Earnings are paid in batches (one transaction every few seconds instead of one per block),
with instant action-bar feedback
? Dynamic market
- A server shop with supply and demand: players selling an item lowers its price, players buying
it raises it
- Price protection: every price stays between a minimum and maximum of its base price
- Automatic balancing: prices drift back to their base over time
- Money sink: the sell price is a fraction of the buy price, so flipping items never pays
- Splitting trades gives no advantage, because every unit is priced separately
- GUI with categories, live prices and trends, plus
/sell hand, /sell all and
/market price <item>
- About 60 ready items in five categories
? Taxes and inflation control
- Progressive brackets, applied marginally like real income tax
- Transfer tax on
/pay, done in the same atomic operation as the transfer
- Per-world multipliers, e.g. double tax in the Nether or a tax-free spawn
- Wealth tax on large balances (optional, active players only)
- Anti-inflation automation: ECore measures the money supply every day. If it grows faster
than your target, tax rates rise automatically; if slower, they fall. Market sell prices follow.
- Statistics with
/tax stats, and a preview of any transfer's tax with /tax calc <amount>
? Discord
- Webhooks, no bot needed
- Events: large transfers, suspicious activity, admin balance changes, auction sales and listings,
wealth tax and job boosts
- Daily economy report: players, new players, money in circulation, the richest player, taxes,
market, auctions and job income
- Mentions are always disabled, so a player named
@everyone can't ping your server
? For server owners
- Modular: switch each module on or off in
config.yml
- Everything configurable: every message uses MiniMessage (English and Polish included); GUI
layouts, materials and sounds can be changed
- Automatic database migrations: updating never needs manual SQL
- Update notifications: admins get a clickable chat notice when a new ECore version is out on
Modrinth
- Import:
/ecore import essentials or /ecore import <VaultPlugin>, with a preview before
anything changes
? Placeholders (PlaceholderAPI)
| Placeholder |
Example |
%ecore_balance%, %ecore_balance_<currency>% |
$1,234.50 |
%ecore_balance_compact% |
$1.2k |
%ecore_top_<currency>_<rank>_name% / _balance |
Steve / $5,300.00 |
%ecore_job_level_<job>%, %ecore_job_progress_<job>% |
12, 57 |
%ecore_jobs_earned% |
$1,250.00 |
%ecore_tax_multiplier% |
1.05 |
⌨️ Main commands
| Command |
What it does |
/balance, /pay, /baltop |
Money |
/ah |
Auction house |
/bank, /gbank |
Personal and shared banks |
/jobs |
Jobs |
/market, /sell |
Dynamic market |
/tax |
Tax rates and calculator |
/eco give|take|set|reset |
Admin balance management |
/ecore reload|info|update|import|discord |
Administration |
All limits, tiers and multipliers are permissions, so ECore works with LuckPerms or any other
permission plugin.
? Developer API
ECoreAPI eco = ECoreProvider.get();
Currency coins = eco.getDefaultCurrency();
TransactionResult result = eco.withdraw(player.getUniqueId(), coins, Money.toMinor(new BigDecimal("25.50")), "myplugin:shop");
The API includes balances, transfers and currencies, plus cancellable events
(PreTransactionEvent, AuctionListEvent, AuctionPurchaseEvent) and PostTransactionEvent /
AuctionSaleEvent.
? Requirements
- Paper, Purpur or Folia 1.21.1 or newer, including 26.x (plain Spigot is not supported)
- Java 21 or newer (Minecraft 26.x servers need Java 25)
- Optional: Vault (needed by other plugins to use ECore money), PlaceholderAPI
Tested on Paper 1.21.11, Paper 26.3 and Folia 1.21.11 with SQLite, MySQL 8.4 and MariaDB 11.4.
? Statistics
ECore uses bStats to collect anonymous usage
statistics: server count, player count, versions and which modules are enabled. No player data is
collected. Turn it off with metrics: false in config.yml, or for all plugins in
plugins/bStats/config.yml.
The update notifier contacts the Modrinth API to look for new versions; turn it off with
update-checker.enabled: false.
评论 0
登录后参与评分
还没有评论,来抢沙发吧