RelishEconomy

插件

· 作者 iM5LB1

[重大更新] ? 多货币经济系统 • 商店 • 出售界面 • 实体货币 • ATM机 • 自然来源货币 • 个人保险箱 ⭐

0 本站下载 0 关注 更新于 1 个月前

最新 1.2.2-Beta · 26.3 · Bukkit / Paper

一键开服(送7天)

? 多货币经济 • 商店 • 出售界面 • 实体货币 • ATM • 自然来源货币 • 个人金库 ⭐

Relish-Economy-Logo M5LB Store Banner


? 为什么选择 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
  • ⭐ 可制作的带有所有者元数据的 实体货币
  • ⭐ 实体货币的 自定义模型数据 支持
  • ⭐ 针对配置的物品来源的 自然来源货币转换
  • ⭐ 堆肥箱出售 — 将物品扔进堆肥箱即可出售
  • ⭐ 个人金库 — 带悬停全息图的受密码保护的实体货币存储方块

? 安装

  1. 下载 插件 JAR 文件
  2. 放置 到服务端的 plugins 文件夹中
  3. 启动/重启 你的服务器
  4. (可选) 如需高级功能,请从 M5LB Store 购买许可证密钥
  5. 将 许可证密钥 放入 config.yml 中
  6. 重载 插件
# 快速设置命令
/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}。

Physical coin

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

Natural-currency

⭐ 实体货币的 ATM 菜单。玩家可以直接将支持的货币物品存入托盘,在货币之间切换,选择取款金额,并从单个图形用户界面确认操作。

ATM 亮点:

  • 存款托盘 - 排队存放支持存款的实体货币物品
  • 取款流程 - 选择货币,调整金额,并以实体物品形式取款
  • 方块访问 - 通过配置的方块交互打开 ATM
  • 商店风格布局 - 使用与购买 GUI 相同的聚焦数量工作流程

ATM 配置

atm:
  enabled: true
  block:
    material: LOOM
    require-sneak: true

ATM Overview

? 货币兑换

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 的高级商店系统提供了一个全面的物品市场,拥有直观的图形用户界面和灵活的配置选项。

ShopGUI

核心商店能力:

  • 创造模式风格的分类(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)。

Relish-Economy-SellGUI.gif

出售方式:

  • 基于命令的出售 - 快速使用 /sellhand、/sellhotbar 和 /sellall 命令(免费)
  • ⭐ 交互式出售 GUI - 支持拖拽的选择性出售界面
  • 自动抓取功能 - 自动从背包中收集可出售的物品
  • 价格计算 - 实时价值计算与货币转换
  • 确认系统 - 通过确认提示防止意外出售
  • ⭐ 日志查看 - 从出售 GUI 打开出售历史记录

SellGUI

高级出售功能:

  • 多货币支付 - 以配置的目标货币接收付款
  • 批量出售 - 一次性出售整个堆叠或背包内容
  • 500+ 可出售物品 - 全面的物品价格数据库
  • ⭐ 堆肥桶出售 - 将物品扔进堆肥桶即可立即出售
  • 交易记录 - 跟踪所有出售交易以便审计
  • 已售物品悬停摘要 - 悬停在聊天输出上可查看已售物品的明细

Sell Hover Preview

? 出售命令(免费)

/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 提供了优雅且用户友好的购物体验,并具备完整的自定义选项。

ShopGUI

界面亮点:

  • 分类浏览:支持配置图标和颜色
  • 物品购买:提供多种数量选项(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%     # 数据库健康状态

PlacholdersAPI


? 多语言支持

?️ 内置语言

  • ?? 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 文件。

获取高级许可证

要获取高级许可证密钥:


由 M5LB 用 ❤️ 制作

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源