? 多货币经济 • 商店 • 出售界面 • 实体货币 • ATM • 自然来源货币 • 个人金库 ⭐
? 为什么选择 RelishEconomy?
RelishEconomy 提供了一个坚实的经济基础,支持多货币、灵活的数据库以及无缝的插件集成。专为现代 Minecraft 服务器构建,注重性能与可靠性。
✨ 主要亮点
? 多货币系统 - 支持多种自定义货币
? 高性能 - 使用 Caffeine 高级缓存以实现快速操作
? 完全集成 - 支持 Vault 和 PlaceholderAPI
?️ 数据库灵活性 - 支持 SQLite 和 MySQL
? 多语言 - 内置英语、阿拉伯语和葡萄牙语翻译
? 要求
| 组件 |
要求 |
| Minecraft |
1.21+ |
| 服务端 |
Paper, Purpur 或基于 Paper 的分叉版本 |
| Java |
21+ |
| 软依赖 |
Vault(推荐), PlaceholderAPI(可选) |
? 功能概览
? 免费版
- ✅ 基础经济命令 (
/balance, /pay, /baltop, /eco)
- ✅ 具有自定义属性的 多货币系统
- ✅ 每货币格式化、权限控制和小数点控制
- ✅ 具有每货币汇率的 货币兑换
- ✅ 基于命令的出售 (
/sellhand, /sellhotbar, /sellall)
- ✅ 出售命令的物品悬停详情分解
- ✅ Baltop 排行榜占位符和余额占位符
- ✅ 从其他插件迁移数据
- ✅ 在 UUID 余额旁存储玩家用户名
- ✅ Towny 和 Vault 经济兼容性
- ✅ Vault 和 PlaceholderAPI 支持
- ✅ SQLite 和 MySQL 支持
- ✅ 捆绑文件的配置验证、备份和自动恢复
⭐ 高级版
- ⭐ 支持分类浏览的 商店 GUI
- ⭐ 用于出售物品的 出售 GUI
- ⭐ 用于导航出售历史的 交易记录 GUI
- ⭐ 方块交互(商店/出售方块)
- ⭐ GUI 自定义 和交互
- ⭐ 实体货币提取和左键存款
- ⭐ 用于实体货币存取款的 ATM GUI
- ⭐ 可制作的带有所有者元数据的 实体货币
- ⭐ 实体货币的 自定义模型数据 支持
- ⭐ 针对配置的物品来源的 自然来源货币转换
- ⭐ 堆肥箱出售 — 将物品扔进堆肥箱即可出售
- ⭐ 个人金库 — 带悬停全息图的受密码保护的实体货币存储方块
? 安装
- 下载 插件 JAR 文件
- 放置 到服务端的
plugins 文件夹中
- 启动/重启 你的服务器
- (可选) 如需高级功能,请从 M5LB Store 购买许可证密钥
- 将 许可证密钥 放入
config.yml 中
- 重载 插件
# 快速设置命令
/re help # 查看所有命令
/re version # 检查插件状态
/re reload # 重载配置
? 命令与用法
? 玩家命令
| 命令 |
描述 |
示例 |
/balance [player] [currency] |
查看余额 |
/bal coins |
/pay <player> <amount> |
转账 |
/pay Steve 100 |
/baltop [currency] [page] |
查看排行榜 |
/baltop dollars 2 |
/currency <list|info> |
查看货币 |
/currency list |
/exchange <from> <to> <amount> |
兑换货币 |
/exchange dollars coins 500 |
/shop ⭐ |
打开商店 GUI |
/shop |
/shop help ⭐ |
显示商店帮助 |
/shop help |
/sell [subcommands] ⭐ |
打开出售 GUI |
/sell price |
/re atm ⭐ |
打开 ATM GUI |
/re atm |
/sellhand |
出售手持物品 |
/sellhand |
/sellhotbar |
出售快捷栏物品 |
/sellhotbar |
/sellall |
出售所有物品 |
/sellall confirm |
/withdraw <currency> <amount> ⭐ |
获取实体货币 |
/withdraw coins 10 |
? 管理员命令
| 命令 |
描述 |
示例 |
/eco <give|take|set> <player|all|online> <amount> |
管理余额 |
/eco give Steve 1000 |
/eco clear <player|all|online> [currency] |
清零余额 |
/eco clear Steve coins |
/eco info <player> [currency] |
查看任意玩家的余额 |
/eco info Steve |
/re give <player> <vault|atm> [amount] |
给予金库或 ATM 方块物品 |
/re give Steve vault |
/re reload |
重载配置 |
/re reload |
/re migrate <plugin> <currency> |
从其他插件导入 |
/re migrate essentials dollars |
? 数量简写
k = 千 (例如,5k = 5,000)
m = 百万 (例如,2m = 2,000,000)
b = 十亿 (例如,1b = 1,000,000,000)
? 玩家消歧义(转义通配符)
如果玩家名称与通配符 (all, online) 或货币名称冲突,请在其前加上 p: 或 player: 以明确指定目标 (例如,/eco give p:all 100 或 /pay p:dollars 50)。
? 配置
货币设置
currencies:
dollars:
name: "dollars"
symbol: "$"
display-name: "Dollars"
color: "<green>"
default: true
starting-balance: 100.0
payments-enabled: true
permission: ""
decimals-enabled: true
exchange-rates:
coins: 0.01
physical-item:
material: PAPER
deposit-enabled: true
withdraw-enabled: true
name: "<green>$ Dollar Bill"
lore:
- "<gray>$ Dollars: {formatted_amount}"
- "<gray>Owner: <white>{owner}"
- ""
- "<yellow>Shift + Right-Click to deposit"
crafting:
enabled: false
value: 100.0
amount: 1
coins:
name: "coins"
symbol: "◎"
display-name: "Coins"
color: "<gold>"
default: false
starting-balance: 50.0
payments-enabled: true
permission: ""
decimals-enabled: false
exchange-rates:
dollars: 100.0
physical-item:
material: GOLD_NUGGET
deposit-enabled: true
withdraw-enabled: true
name: "<gold>◎ Gold Coin"
lore:
- "<gray>◎ Coins: {formatted_amount}"
- "<gray>Owner: <white>{owner}"
- ""
- "<yellow>Shift + Right-Click to deposit"
custom-model-data: 2001
natural-source:
enabled: true
value-per-item: 1.0
match-any-meta: false
crafting:
enabled: false
value: 1.0
amount: 1
?️ 数据库选项
database:
type: sqlite # or mysql for networks
mysql:
host: localhost
port: 3306
database: relisheconomy
username: root
password: password
⭐ 实体货币纸币和硬币会在物品元数据中保留所有者名称。/withdraw 命令会将所有者设置为玩家,通过合成生成的实体货币会被重写为合成者的名字,并且可以为每种货币物品应用自定义模型数据。默认的物品显示格式为 {symbol} {name}(例如 $ Dollars)。默认的背景文字(lore)数值行格式为 {symbol} {name}: {amount}。

⭐ 自然来源货币转换也可以将配置的游戏内物品来源转换为实体货币物品本身。这是针对每种货币单独配置的。

⭐ 实体货币的 ATM 菜单。玩家可以直接将支持的货币物品存入托盘,在货币之间切换,选择取款金额,并从单个图形用户界面确认操作。
ATM 亮点:
- 存款托盘 - 排队存放支持存款的实体货币物品
- 取款流程 - 选择货币,调整金额,并以实体物品形式取款
- 方块访问 - 通过配置的方块交互打开 ATM
- 商店风格布局 - 使用与购买 GUI 相同的聚焦数量工作流程
ATM 配置
atm:
enabled: true
block:
material: LOOM
require-sneak: true

? 货币兑换
exchange-fee-percentage: 2.5
currencies:
dollars:
exchange-rates:
coins: 0.01 # 1 dollar = 0.01 coins
coins:
exchange-rates:
dollars: 100.0 # 1 coin = 100 dollars
? 数据迁移
RelishEconomy 可以从其他经济插件导入数据:
支持的插件:
- EssentialsX - 从 userdata 文件导入
- CMI - 从 SQLite 数据库导入
- TokenManager - 导入代币余额
- PlayerPoints - 导入点数余额
- CoinsAPI - 导入硬币余额
- GemsEconomy - 导入宝石余额
迁移功能:
- ✅ 自动检测 源插件数据
- ✅ UUID 转换 以适配现代 Minecraft
- ✅ 离线玩家支持 - 迁移所有账户
- ✅ 进度跟踪 并提供详细报告
- ✅ 异步处理 - 无服务器延迟
⭐ 商店系统
? 商店功能
RelishEconomy 的高级商店系统提供了一个全面的物品市场,拥有直观的图形用户界面和灵活的配置选项。
核心商店能力:
- 创造模式风格的分类(11个) - 默认布局遵循创造模式物品栏标签页的顺序(操作员工具默认禁用)
- 收藏系统 - 收藏物品,浏览专用的收藏视图,并可选择性地用发光高亮渲染收藏项(
favorites.yml)
- 购买 GUI 流程 - 点击物品以打开包含数量 +/- 控制、确认/取消以及返回分类分页功能的购买菜单
- 动态定价 - 买入价格可以使用可配置的乘数从卖出价格计算得出
- 分类管理 - 启用/禁用分类,设置图标,并通过
page:slot 控制槽位
- 搜索 + 分页 - 跨分类搜索并导航页面
- 可选的禁用显示 - 将没有买入价格的物品显示为禁用状态而不是隐藏它们(
show-unpriced-items)
商店 GUI 界面:
- 分类浏览器 - 导航创造模式风格的分类标签页
- 物品预览 - 查看物品详情和买入价格
- 余额显示 - GUI 中的实时余额显示
- 音效反馈 - 购买和导航时的音频反馈(在
gui.yml 中配置)
- 分页导航 - 浏览多个页面的物品
- 搜索功能 - 在所有类别中查找物品
? 商店配置
# shop.yml
shop:
enabled: true
buy-currency: "dollars"
buy-multiplier: 2.0
items-per-page: 28
show-unpriced-items: false
categories:
building_blocks:
display-name: "Building Blocks"
icon: STONE
enabled: true
slot: "1:0"
items:
- STONE
- COBBLESTONE
- BRICKS
# ... more items
可用分类(默认布局):
- 建筑方块
- 染色方块
- 自然方块
- 功能性方块
- 红石方块
- 工具与实用物品
- 战斗
- 食物与饮品
- 原料
- 刷怪蛋
- 管理员实用工具(默认禁用)
? 商店命令
/shop # 打开主商店界面
/shop help # 显示商店帮助
? 出售系统
? 出售功能
出售系统为玩家提供了多种将物品兑换为货币的方式,从基于命令的快速出售到交互式图形用户界面(GUI)。
出售方式:
- 基于命令的出售 - 快速使用
/sellhand、/sellhotbar 和 /sellall 命令(免费)
- ⭐ 交互式出售 GUI - 支持拖拽的选择性出售界面
- 自动抓取功能 - 自动从背包中收集可出售的物品
- 价格计算 - 实时价值计算与货币转换
- 确认系统 - 通过确认提示防止意外出售
- ⭐ 日志查看 - 从出售 GUI 打开出售历史记录

高级出售功能:
- 多货币支付 - 以配置的目标货币接收付款
- 批量出售 - 一次性出售整个堆叠或背包内容
- 500+ 可出售物品 - 全面的物品价格数据库
- ⭐ 堆肥桶出售 - 将物品扔进堆肥桶即可立即出售
- 交易记录 - 跟踪所有出售交易以便审计
- 已售物品悬停摘要 - 悬停在聊天输出上可查看已售物品的明细
? 出售命令(免费)
/sellhand # 出售手中物品
/sellhotbar # 出售快捷栏中所有可出售物品
/sellall # 出售背包中所有可出售物品
/sellall confirm # 带安全检查确认批量出售
这些命令无需高级许可证即可使用。只有出售 GUI、堆肥桶出售和出售方块交互需要高级权限。
⭐ 出售 GUI 界面
高级版出售 GUI 提供了一个直观的拖拽式物品出售界面:
GUI 功能:
- 拖拽区域 - 只需将物品拖入即可出售
- 快速抓取按钮 - 自动从背包中收集所有可出售物品
- 实时定价 - 添加物品时查看总售价实时更新
- 总价计算器 - 在确认前查看总售价
- 确认系统 - 通过总价摘要确认出售
- 音效反馈 - 所有交互均有音频反馈
⚙️ 出售配置
# prices.yml
sell:
enabled: true
target-currency: "dollars"
prices:
# 基本格式
STONE: 0.5
COBBLESTONE: 0.3
OAK_LOG: 1.5
# 多货币格式(如需)
DIAMOND: { price: 100, currency: "gems" }
EMERALD: { price: 150, currency: "tokens" }
包含 500+ 可出售物品:
- 石头变体 - 石头、圆石、砖块、深板岩
- 木材材料 - 所有原木、木板、去皮变体
- 自然方块 - 泥土、沙子、砾石、粘土
- 珍贵材料 - 钻石、绿宝石、金、铁
- 下界材料 - 下界岩、灵魂沙、下界砖
- 末地材料 - 末地石、紫珀块
- 怪物掉落物 - 骨头、线、火药、皮革
- 食物物品 - 小麦、胡萝卜、土豆、肉类
⭐ 出售方块交互
高级用户可以使用物理方块来方便地出售物品:
出售方块功能:
- 右键点击堆肥桶 - 打开出售 GUI 界面
- 堆肥桶物品出售 - 将物品扔进堆肥桶即可立即出售
- 可配置冷却时间 - 防止刷屏(默认 500ms)
- 视觉/音频反馈 - 确认消息和声音
# config.yml
composter-selling:
enabled: true
cooldown: 500
sell-gui-block: COMPOSTER
shop-gui-block: EMERALD_BLOCK
⭐ 实体货币
玩家可以将支持的货币提取为实体物品,进行交易,然后通过 Shift + 右键点击 将其存回。
每种货币都可以单独控制此功能:
currencies.<name>.physical-item.withdraw-enabled
currencies.<name>.physical-item.deposit-enabled
currencies.<name>.crafting.enabled
currencies.<name>.physical-item.custom-model-data
currencies.<name>.physical-item.natural-source.enabled
制作出的实体货币还会存储制作玩家作为所有者,与提取的纸币和硬币相匹配。
⭐ 个人保险箱
一个受密码保护的箱子方块,用于存储实体货币物品。放置 Vault 方块(Minecraft 1.21 中的 VAULT 材质)并右键点击即可打开。
保险箱亮点:
- PIN 键盘 — 首次打开时使用基于点击的头颅按钮设置 PIN 码(4–16 位数字),无需聊天
- 悬停全息图 - 注视保险箱方块以看到悬浮的
TextDisplay 显示的余额
- 物品描述更新 - 每次操作后,背包中的保险箱物品会更新以显示当前余额
- 可合成 - 默认配方:8× 下界合金锭围绕 1× 箱子(可配置)
- 管理员给予 -
/re give <player> vault [amount] 可绕过合成步骤
保险箱配置
vault:
enabled: true
show-hologram: true # 注视方块时显示余额全息图
crafting:
enabled: true
⭐ GUI 功能
⭐ 商店界面
高级版商店 GUI 提供了优雅且用户友好的购物体验,并具备完整的自定义选项。
界面亮点:
- 分类浏览:支持配置图标和颜色
- 物品购买:提供多种数量选项(1、32、64)
- 余额显示:实时更新
- 音效反馈:所有交互均配有音效
- 可配置 GUI 大小:支持自定义布局选项
- 基于权限的分类访问控制
⭐ 出售界面
高级出售 GUI 提供了直观的拖放式物品出售体验。
界面功能:
- 拖放出售:带有视觉反馈的物品拖放操作
- 快速抓取:一键自动收集可出售物品
- 实时价值计算与显示
- 确认系统:包含总出售金额汇总
- 音效与粒子动画
- 多货币支付选项
⭐ GUI 自定义
高级用户完全掌控 GUI 的外观和行为:
自定义选项:
- GUI 尺寸:可选 9、18、27、36、45 或 54 格的布局
- 自定义标题:使用颜色代码设置个性化 GUI 标题
- 物品图标:可使用任意材质作为分类或按钮图标
- 音效配置:为不同动作配置自定义音效
- 布局模板:预设计布局或创建自定义布局
? 集成支持
?️ Vault API
完整的经济提供商实现:
getBalance(), depositPlayer(), withdrawPlayer()
- 兼容任何使用 Vault 的插件
- 通过 Vault 支持多货币
- 支持 Towny 银行存款(包括
/t deposit <amount> 流程)
? PlaceholderAPI 集成
余额占位符:
%relisheconomy_balance_[currency]% # 原始余额(例如 1000.50)
%relisheconomy_balance_[currency]_[type]_[style]% # 格式化选项(例如通过 full_plain 格式化为 1,250.00)
%relisheconomy_formatted_[currency]% # 格式化余额(例如 $1,000.50)
排行榜占位符:
%relisheconomy_baltop_[position]_[currency]_name% # 指定位置的玩家名称
%relisheconomy_baltop_[position]_[currency]_balance% # 指定位置的格式化余额
%relisheconomy_baltop_[position]_[currency]_raw% # 指定位置的原始余额
%relisheconomy_rank_[currency]% # 玩家的排名
货币信息:
%relisheconomy_currency_[currency]_symbol% # 货币符号
%relisheconomy_currency_[currency]_display% # 显示名称
%relisheconomy_currency_[currency]_starting% # 初始余额
%relisheconomy_currency_[currency]_default% # 是否为默认货币
实用工具占位符:
%relisheconomy_hasenough_[amount]_[currency]% # 玩家是否有足够余额(true/false)
%relisheconomy_exchangerate_[from]_[to]% # 货币间的汇率
服务器统计:
%relisheconomy_stats_currencies% # 货币数量
%relisheconomy_stats_accounts% # 缓存账户数量
%relisheconomy_stats_dbtype% # 数据库类型(sqlite/mysql)
%relisheconomy_stats_dbhealthy% # 数据库健康状态

? 多语言支持
?️ 内置语言
- ?? English (en) - 完整
- ?? Arabic (ar) - 完整
- ?? Portuguese (pt) - 完整
? 自定义语言
创建 lang/[code].yml 文件以支持任意语言:
# 示例:lang/es.yml 用于西班牙语
balance:
current: "<green>Tu saldo: {balance}"
other: "<green>Saldo de {player}: {balance}"
? 性能与可扩展性
⚡ 优化特性
- Caffeine 缓存:实现即时数据访问
- 连接池:使用 HikariCP(MySQL)
- 异步操作:用于数据库查询
- Baltop 缓存:支持可配置的持续时间
- 自动清理:清除过期的缓存数据
? 可扩展选项
- SQLite:适用于中小型服务器(0-500 名玩家)
- MySQL:适用于大型网络(500+ 名玩家)
- 实时读取模式:用于外部集成
- 数据库健康监控
? 许可证
RelishEconomy 是专有软件。保留所有权利。
许可证类型
? 免费版
- 无需许可证密钥即可使用
- 包含多货币、兑换、排行榜、迁移和基于命令的出售功能
- 可在不限数量的服务器上部署
- 非开源 - 禁止修改和重新分发
⭐ 高级版
- 需要来自 M5LB 的有效许可证密钥
- 包含仅限高级的功能,如商店 GUI、出售 GUI、ATM GUI、交易日志 GUI、实体货币和高级方块交互
- 许可证密钥绑定至购买者及服务器数量
- 非开源 - 禁止修改和重新分发
完整许可条款请参阅 LICENSE 文件。
获取高级许可证
要获取高级许可证密钥:
? Multi-Currency Economy • Shop • Sell GUI • Physical Currency • ATM • Natural Source Currency • Personal Vault ⭐
? Why Choose RelishEconomy?
RelishEconomy provides a solid economy foundation with multi-currency support, database flexibility, and seamless plugin integrations. Built for modern Minecraft servers with performance and reliability in mind.
✨ Key Highlights
? Multi-Currency System - Support for multiple custom currencies
? High Performance - Advanced caching with Caffeine for fast operations
? Full Integration - Vault and PlaceholderAPI support
?️ Database Flexibility - SQLite and MySQL support
? Multi-Language - Built-in English, Arabic, and Portuguese translations
? Requirements
| Component |
Requirement |
| Minecraft |
1.21+ |
| Server |
Paper, Purpur, or Paper-based forks |
| Java |
21+ |
| Soft Dependencies |
Vault (recommended), PlaceholderAPI (optional) |
? Features Overview
? Free Version
- ✅ Basic economy commands (
/balance, /pay, /baltop, /eco)
- ✅ Multi-currency system with custom properties
- ✅ Per-currency formatting, permissions, and decimal control
- ✅ Currency exchange with per-currency exchange rates
- ✅ Command-based selling (
/sellhand, /sellhotbar, /sellall)
- ✅ Sold-item hover breakdowns for sell commands
- ✅ Baltop leaderboard placeholders and balance placeholders
- ✅ Data migration from other plugins
- ✅ Player username storage alongside UUID balances
- ✅ Towny and Vault economy compatibility
- ✅ Vault and PlaceholderAPI support
- ✅ SQLite and MySQL support
- ✅ Config validation, backup, and auto-recovery for bundled files
⭐ Premium Version
- ⭐ Shop GUI with category browsing
- ⭐ Sell GUI for item selling
- ⭐ Transaction Logs GUI for sell history navigation
- ⭐ Block interactions (shop/sell blocks)
- ⭐ GUI customization and interactions
- ⭐ Physical currency withdraw and shift-deposit
- ⭐ ATM GUI for physical currency deposit and withdraw
- ⭐ Craftable physical currency with owner metadata
- ⭐ Custom model data support for physical currencies
- ⭐ Natural-source currency conversion for configured item sources
- ⭐ Composter selling — throw items on composter to sell them
- ⭐ Personal Vault — password-protected physical currency storage block with hover hologram
? Installation
- Download the plugin JAR file
- Place it in your server's
plugins folder
- Start/Restart your server
- (Optional) For premium features, buy a license key from M5LB Store
- Place license key in
config.yml
- Reload the plugin
# Quick setup commands
/re help # View all commands
/re version # Check plugin status
/re reload # Reload configuration
? Commands & Usage
? Player Commands
| Command |
Description |
Example |
/balance [player] [currency] |
Check balance |
/bal coins |
/pay <player> <amount> |
Send money |
/pay Steve 100 |
/baltop [currency] [page] |
View leaderboard |
/baltop dollars 2 |
/currency <list|info> |
View currencies |
/currency list |
/exchange <from> <to> <amount> |
Convert currencies |
/exchange dollars coins 500 |
/shop ⭐ |
Open shop GUI |
/shop |
/shop help ⭐ |
Show shop help |
/shop help |
/sell [subcommands] ⭐ |
Open sell GUI |
/sell price |
/re atm ⭐ |
Open ATM GUI |
/re atm |
/sellhand |
Sell item in hand |
/sellhand |
/sellhotbar |
Sell hotbar items |
/sellhotbar |
/sellall |
Sell all items |
/sellall confirm |
/withdraw <currency> <amount> ⭐ |
Get physical currency |
/withdraw coins 10 |
? Admin Commands
| Command |
Description |
Example |
/eco <give|take|set> <player|all|online> <amount> |
Manage balances |
/eco give Steve 1000 |
/eco clear <player|all|online> [currency] |
Zero out a balance |
/eco clear Steve coins |
/eco info <player> [currency] |
View any player's balance |
/eco info Steve |
/re give <player> <vault|atm> [amount] |
Give vault or ATM block item |
/re give Steve vault |
/re reload |
Reload configuration |
/re reload |
/re migrate <plugin> <currency> |
Import from other plugins |
/re migrate essentials dollars |
? Amount Shortcuts
k = thousand (e.g., 5k = 5,000)
m = million (e.g., 2m = 2,000,000)
b = billion (e.g., 1b = 1,000,000,000)
? Player Disambiguation (Escape Wildcards)
If a player's name conflicts with wildcards (all, online) or currency names, prefix it with p: or player: to explicitly target them (e.g., /eco give p:all 100 or /pay p:dollars 50).
? Configuration
Currency Setup
currencies:
dollars:
name: "dollars"
symbol: "$"
display-name: "Dollars"
color: "<green>"
default: true
starting-balance: 100.0
payments-enabled: true
permission: ""
decimals-enabled: true
exchange-rates:
coins: 0.01
physical-item:
material: PAPER
deposit-enabled: true
withdraw-enabled: true
name: "<green>$ Dollar Bill"
lore:
- "<gray>$ Dollars: {formatted_amount}"
- "<gray>Owner: <white>{owner}"
- ""
- "<yellow>Shift + Right-Click to deposit"
crafting:
enabled: false
value: 100.0
amount: 1
coins:
name: "coins"
symbol: "◎"
display-name: "Coins"
color: "<gold>"
default: false
starting-balance: 50.0
payments-enabled: true
permission: ""
decimals-enabled: false
exchange-rates:
dollars: 100.0
physical-item:
material: GOLD_NUGGET
deposit-enabled: true
withdraw-enabled: true
name: "<gold>◎ Gold Coin"
lore:
- "<gray>◎ Coins: {formatted_amount}"
- "<gray>Owner: <white>{owner}"
- ""
- "<yellow>Shift + Right-Click to deposit"
custom-model-data: 2001
natural-source:
enabled: true
value-per-item: 1.0
match-any-meta: false
crafting:
enabled: false
value: 1.0
amount: 1
?️ Database Options
database:
type: sqlite # or mysql for networks
mysql:
host: localhost
port: 3306
database: relisheconomy
username: root
password: password
⭐ Physical currency notes and coins keep the owner name in their item metadata. /withdraw sets the owner to the player, crafted physical currency is rewritten to the crafting player, and custom model data can be applied per currency item. Default item display format is {symbol} {name} (e.g. $ Dollars). Default lore value line is {symbol} {name}: {amount}.

⭐ Natural-source currency conversion can also turn configured gameplay item sources into the physical currency item itself. This is configured per currency.

⭐ ATM menu for physical currencies. Players can deposit supported currency items directly into the tray, switch between currencies, choose withdraw amounts, and confirm the action from a single GUI.
ATM Highlights:
- Deposit tray - Queue supported physical currency items for deposit
- Withdraw flow - Select currency, adjust amount, and withdraw as physical items
- Block access - Open the ATM from a configured block interaction
- Shop-style layout - Uses the same focused quantity workflow as the purchase GUI
ATM Config
atm:
enabled: true
block:
material: LOOM
require-sneak: true

? Currency Exchange
exchange-fee-percentage: 2.5
currencies:
dollars:
exchange-rates:
coins: 0.01 # 1 dollar = 0.01 coins
coins:
exchange-rates:
dollars: 100.0 # 1 coin = 100 dollars
? Data Migration
RelishEconomy can import data from other economy plugins:
Supported Plugins:
- EssentialsX - Import from userdata files
- CMI - Import from SQLite database
- TokenManager - Import token balances
- PlayerPoints - Import point balances
- CoinsAPI - Import coin balances
- GemsEconomy - Import gem balances
Migration Features:
- ✅ Automatic detection of source plugin data
- ✅ UUID conversion for modern Minecraft
- ✅ Offline player support - migrates all accounts
- ✅ Progress tracking with detailed reports
- ✅ Async processing - no server lag
⭐ Shop System
? Shop Features
RelishEconomy's premium shop system provides a comprehensive item marketplace with intuitive GUI interfaces and flexible configuration options.
Core Shop Capabilities:
- Creative-style categories (11) - Default layout follows the creative inventory tab order (operator utilities disabled by default)
- Favorites system - Favorite items, browse a dedicated favorites view, and optionally render favorites with a glow highlight (
favorites.yml)
- Purchase GUI flow - Click an item to open a buy menu with quantity +/- controls, confirm/cancel, and back-to-category paging
- Dynamic pricing - Buy prices can be calculated from sell prices using a configurable multiplier
- Category management - Enable/disable categories, set icons, and control slots with
page:slot
- Search + paging - Search across categories and navigate pages
- Optional disabled display - Show items with no buy price as disabled instead of hiding them (
show-unpriced-items)
Shop GUI Interface:
- Category browser - Navigate creative-style category tabs
- Item preview - See item details and buy prices
- Balance display - Live balance display in the GUI
- Sound effects - Audio feedback for purchases and navigation (configured in
gui.yml)
- Pagination - Navigate through multiple pages of items
- Search functionality - Find items across all categories
? Shop Configuration
# shop.yml
shop:
enabled: true
buy-currency: "dollars"
buy-multiplier: 2.0
items-per-page: 28
show-unpriced-items: false
categories:
building_blocks:
display-name: "Building Blocks"
icon: STONE
enabled: true
slot: "1:0"
items:
- STONE
- COBBLESTONE
- BRICKS
# ... more items
Available Categories (Default Layout):
- Building Blocks
- Colored Blocks
- Natural Blocks
- Functional Blocks
- Redstone Blocks
- Tools & Utilities
- Combat
- Food & Drinks
- Ingredients
- Spawn Eggs
- Operator Utilities (disabled by default)
? Shop Commands
/shop # Open main shop interface
/shop help # Show shop help
? Sell System
? Sell Features
The sell system provides multiple ways for players to convert their items into currency, from quick command-based selling to an interactive GUI interface.
Sell Methods:
- Command-based selling - Quick
/sellhand, /sellhotbar, and /sellall commands (Free)
- ⭐ Interactive Sell GUI - Drag-and-drop interface for selective selling
- Auto-grab functionality - Automatically collect sellable items from inventory
- Price calculation - Real-time value calculation with currency conversion
- Confirmation system - Prevent accidental sales with confirmation prompts
- ⭐ Logs view - Open sell history from the sell GUI

Advanced Sell Features:
- Multi-currency payouts - Receive payment in configured target currency
- Bulk selling - Sell entire stacks or inventory contents at once
- 500+ sellable items - Comprehensive item price database
- ⭐ Composter selling - Throw items on composter for instant selling
- Transaction logging - Track all sell transactions for auditing
- Sold-items hover summary - Hover chat output to view sold item breakdown
? Sell Commands (Free)
/sellhand # Sell the item in your hand
/sellhotbar # Sell all sellable items in your hotbar
/sellall # Sell all sellable items in inventory
/sellall confirm # Confirm bulk selling with safety check
These commands work without a premium license. Only the sell GUI, composter selling, and sell block interactions are premium.
⭐ Sell GUI Interface
The premium Sell GUI provides an intuitive drag-and-drop interface for item selling:
GUI Features:
- Drag-and-drop zones - Simply drag items to sell them
- Quick grab button - Auto-collect all sellable items from inventory
- Live pricing - See total sale value update as you add items
- Total calculator - View total sale value before confirming
- Confirmation system - Confirm sale with total summary
- Sound effects - Audio feedback for all interactions
⚙️ Sell Configuration
# prices.yml
sell:
enabled: true
target-currency: "dollars"
prices:
# Basic format
STONE: 0.5
COBBLESTONE: 0.3
OAK_LOG: 1.5
# Multi-currency format (if needed)
DIAMOND: { price: 100, currency: "gems" }
EMERALD: { price: 150, currency: "tokens" }
500+ Sellable Items Including:
- Stone variants - Stone, cobblestone, bricks, deepslate
- Wood materials - All logs, planks, stripped variants
- Natural blocks - Dirt, sand, gravel, clay
- Precious materials - Diamonds, emeralds, gold, iron
- Nether materials - Netherrack, soul sand, nether bricks
- End materials - End stone, purpur blocks
- Mob drops - Bones, string, gunpowder, leather
- Food items - Wheat, carrots, potatoes, meat
⭐ Sell Block Interactions
Premium users can use physical blocks for convenient item selling:
Sell Block Features:
- Right-click COMPOSTER - Opens sell GUI interface
- Composter item selling - Throw items on composter to sell instantly
- Configurable cooldown - Prevents spam (500ms default)
- Visual/audio feedback - Confirmation messages and sounds
# config.yml
composter-selling:
enabled: true
cooldown: 500
sell-gui-block: COMPOSTER
shop-gui-block: EMERALD_BLOCK
⭐ Physical Currency
Players can withdraw supported currencies into physical items, trade them, then deposit them back with Shift + Right-Click.
Each currency can control this separately:
currencies.<name>.physical-item.withdraw-enabled
currencies.<name>.physical-item.deposit-enabled
currencies.<name>.crafting.enabled
currencies.<name>.physical-item.custom-model-data
currencies.<name>.physical-item.natural-source.enabled
Crafted physical currency also stores the crafting player as the owner, matching withdrawn notes and coins.
⭐ Personal Vault
A password-protected chest block that stores physical currency items. Place a Vault block (Minecraft 1.21 VAULT material) and right-click to open.
Vault Highlights:
- PIN keypad — first open sets a PIN (4–16 digits) using click-based skull buttons — no chat required
- Hover hologram — look at the vault block to see stored balance(s) as a floating
TextDisplay
- Inventory lore — vault item in your inventory updates to show current balance after each operation
- Craftable — default recipe: 8× netherite ingot surrounding 1× chest (configurable)
- Admin give —
/re give <player> vault [amount] bypasses crafting
Vault Config
vault:
enabled: true
show-hologram: true # Show balance hologram when looking at the block
crafting:
enabled: true
⭐ GUI Features
⭐ Shop Interface
The premium shop GUI provides an elegant and user-friendly shopping experience with full customization options.
Interface Highlights:
- Category browsing with configurable icons and colors
- Item purchasing with multiple quantity options (1, 32, 64)
- Balance display with live updates
- Sound effects for all interactions
- Configurable GUI size and layout options
- Permission-based category access
⭐ Sell Interface
The premium sell GUI offers an intuitive drag-and-drop experience for item selling.
Interface Features:
- Drag-and-drop item selling with visual feedback
- Quick grab button to auto-collect sellable items
- Live value calculation and display
- Confirmation system with total sale summary
- Sound effects and particle animations
- Multi-currency payout options
⭐ GUI Customization
Premium users have full control over GUI appearance and behavior:
Customization Options:
- GUI sizes - Choose from 9, 18, 27, 36, 45, or 54 slot layouts
- Custom titles - Set personalized GUI titles with color codes
- Item icons - Use any material as category or button icons
- Sound effects - Configure custom sounds for different actions
- Layout templates - Pre-designed layouts or create your own
? Integrations
?️ Vault API
Full economy provider implementation:
getBalance(), depositPlayer(), withdrawPlayer()
- Compatible with any plugin using Vault
- Multi-currency support through Vault
- Towny bank deposits are supported (including
/t deposit <amount> flow)
? PlaceholderAPI Integration
Balance Placeholders:
%relisheconomy_balance_[currency]% # Raw balance (e.g. 1000.50)
%relisheconomy_balance_[currency]_[type]_[style]% # Formatting options (e.g. 1,250.00 via full_plain)
%relisheconomy_formatted_[currency]% # Formatted balance (e.g. $1,000.50)
Leaderboard Placeholders:
%relisheconomy_baltop_[position]_[currency]_name% # Player name at position
%relisheconomy_baltop_[position]_[currency]_balance% # Formatted balance at position
%relisheconomy_baltop_[position]_[currency]_raw% # Raw balance at position
%relisheconomy_rank_[currency]% # Player's rank
Currency Information:
%relisheconomy_currency_[currency]_symbol% # Currency symbol
%relisheconomy_currency_[currency]_display% # Display name
%relisheconomy_currency_[currency]_starting% # Starting balance
%relisheconomy_currency_[currency]_default% # Is default currency
Utility Placeholders:
%relisheconomy_hasenough_[amount]_[currency]% # true/false if player has enough
%relisheconomy_exchangerate_[from]_[to]% # Exchange rate between currencies
Server Statistics:
%relisheconomy_stats_currencies% # Number of currencies
%relisheconomy_stats_accounts% # Number of cached accounts
%relisheconomy_stats_dbtype% # Database type (sqlite/mysql)
%relisheconomy_stats_dbhealthy% # Database health status

? Multi-Language Support
?️ Built-in Languages
- ?? English (en) - Complete
- ?? Arabic (ar) - Complete
- ?? Portuguese (pt) - Complete
? Custom Languages
Create lang/[code].yml files for any language:
# Example: lang/es.yml for Spanish
balance:
current: "<green>Tu saldo: {balance}"
other: "<green>Saldo de {player}: {balance}"
? Performance & Scalability
⚡ Optimization Features
- Caffeine caching for instant data access
- Connection pooling with HikariCP (MySQL)
- Async operations for database queries
- Baltop caching with configurable duration
- Auto-cleanup of stale cache data
? Scalability Options
- SQLite for small-medium servers (0-500 players)
- MySQL for large networks (500+ players)
- Real-time read mode for external integrations
- Database health monitoring
? License
RelishEconomy is proprietary software. All rights reserved.
License Types
? Free Version
- Available without license key
- Includes multi-currency, exchange, baltop, migration, and command-based selling
- May be used on unlimited servers
- NOT open source - modification and redistribution prohibited
⭐ Premium Version
- Requires valid license key from M5LB
- Includes premium-only features such as Shop GUI, Sell GUI, ATM GUI, transaction logs GUI, physical currency, and premium block interactions
- License key tied to purchaser and server count
- NOT open source - modification and redistribution prohibited
For full license terms, see LICENSE file.
Obtain Premium License
To get a premium license key:
评论 0
登录后参与评分
还没有评论,来抢沙发吧