Aurelium

插件

· 作者 APPLEPIE6969

一套完整的 Paper 经济解决方案,包含可定制的基于 Web 的市场、玩家拍卖行以及独特的刷怪笼交易功能。内置自定义货币,并自动安装 Vault 插件,提供即插即用的便捷体验。

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

最新 1.5.4.1-1.21.x · 1.21.11 · Paper / Purpur

一键开服(送7天)

Aurelium

实验性 Web 功能 Web 仪表板正在积极开发中。如果启用 web.enabled,可能会出现潜在的错误或不稳定。核心的游戏内经济、GUI 市场和拍卖行是稳定的。

适用于 Minecraft Paper 的独立经济插件。

兼容性: Paper, Purpur, Pufferfish, Leaves


功能

经济系统

  • 多货币支持 - 定义多种货币(例如 Aurels、Dollars、Euros),拥有独特的符号和初始余额
  • 按物品分配货币 - 为市场中的单个物品分配特定的货币
  • Vault 支持 - 完全兼容依赖 Vault 的插件(ShopGUI+、Essentials 等)
  • 数据库 - 支持 SQLite 或 MySQL 存储,并支持自动迁移
  • 离线收益 - 即使离线也能获得拍卖销售的收入

服务器市场

一个由服务器拥有的商店,具有动态定价和三种界面模式:

  • 经典模式 - 传统的基于箱子的库存 GUI
  • 现代模式 - 带有 MiniMessage 渐变标题、玻璃面板边框和格式化描述文本的样式化箱子 GUI
  • Web 模式 - 浏览器仪表板(参见下方的 Web 仪表板部分)

定价机制:

  • 购买时价格自动上涨(需求),出售时价格自动下跌(供给)
  • 防作弊:售价永远不能超过买价
  • 价格下限:不能低于基础价格的 20%(可配置)
  • 价格上限:不能高于基础价格的 500%(可配置)
  • 自然恢复:价格每 10 分钟被动地向基础价值漂移

便捷功能:

  • 实时 UI 更新:菜单打开时每 1 秒刷新一次
  • 页码指示器:显示当前页面(例如“第 1 页,共 5 页”)
  • 指南针搜索按钮:查找任何物品
  • 市场崩盘警报:用于标记低价高价值物品
  • 智能库存:购买时优先填满半堆叠的物品

性能优化:

  • 仅查看者刷新:除非玩家打开了菜单,否则逻辑处于休眠状态
  • 批量磁盘 I/O:交易数据在后台以批次形式保存
  • O(1) 数据访问:本地缓存,对 CPU 的影响几乎为零
  • 海量目录:包含所有建筑方块 + 60 多种生物刷怪笼

拍卖行

一个完全自包含的玩家驱动交易所:

  • 100% GUI 驱动:通过菜单内的按钮出售物品、出价、进行私人报价
  • 安全确认:扣除资金前有专门的确认屏幕
  • 管理报价:使用 /ah offers 接受或拒绝收到的交易
  • 实时更新:购买、出价、取消时,所有玩家的 GUI 立即刷新;计时器每秒更新
  • 自动退款:被竞价超过?资金立即退还

买入订单

用于离线购买的全球请求系统:

  • 以任何价格请求任何物品(包括 120 多种附魔书和锭)
  • 其他玩家可以浏览并从他们的库存中完成订单
  • 托管系统:资金安全持有,取消时退款
  • 离线收集:已完成的物品进入 /ah collect 垃圾箱;登录时通知
  • 买家通知:填充时实时通知,或在下次登录时通知

自定义物品检测

自动从流行的第三方插件中发现自定义物品:

  • 启动时自动扫描 - 运行一次,检测所有自定义物品
  • 支持的插件(无硬性依赖,全部通过反射实现):
    • ItemsAdder, Oraxen, MMOItems, MythicMobs, ExecutableItems, Nexo, SX-Item
  • 发现的物品写入 config.yml 下的 discovered-items:
  • 持久存储在 custom_items 数据库表中(schema v2,自动迁移)
  • 未安装支持的插件?扫描仪将静默跳过,零开销

Web 仪表板

Aurelium

  • 服务器市场 - 从网页购买物品,即时在游戏内交付

Web Market

  • 拍卖行 - 从浏览器出价和直接购买物品(BIN)

Web Auction House

  • 买入订单 - 从你的在线库存中完成玩家的买入订单

Web Buy Orders

  • 价格追踪器 - 交互式图表,带有 7 天历史、贝塞尔曲线、渐变填充和悬停提示框

Web Chart

Web Chart Detail

Web 功能:

  • 实时同步:游戏内的更改会立即反映在网页上,反之亦然
  • 价格每 10 分钟记录一次,存储 7 天
  • 云模式:可选的云端托管仪表板,适用于所有主机,无需端口转发
  • 多货币 UI:自定义货币符号从 config.yml 同步
  • 图标回退:在较旧的 MC 版本上使用旧版物品纹理作为回退
  • 安全会话:在游戏中使用 /web 生成限时链接(滚动 1 小时超时)
  • 标签页睡眠模式:标签页不活动时不进行网络/CPU 操作;返回时瞬间唤醒
  • RAM 优化:通过原始 JSON 字符串缓存,每个服务器的内存占用低于 1MB
  • 激活队列:当云服务器达到其 500MB 限制时,公平的等待列表

命令

玩家命令

指令 描述 权限
/bal [player] [currency] 查看自己或其他玩家的余额 aureleconomy.bal
/pay <player> <amount> [currency] 向其他玩家付款 aureleconomy.pay
/market 打开游戏内服务器市场 aureleconomy.market
/sell 出售背包中的物品 aureleconomy.sell
/stocks 查看市场趋势 aureleconomy.stocks
/web 生成浏览器仪表板的安全链接 aureleconomy.web
/ah 打开拍卖行 aureleconomy.ah
/ah sell <price> [duration] [currency] 将手持物品设为一口价(BIN)。持续时间示例:1h、7d aureleconomy.ah
/ah bid <price> [duration] 将手持物品上架拍卖。持续时间示例:1h、7d aureleconomy.ah
/ah offer <id> <qty> 对拍卖物品发送私人报价 aureleconomy.ah
/ah offers 管理收到的私人报价 aureleconomy.ah
/ah collect 收取已过期或已售出的物品 aureleconomy.ah
/ah search <query> 打开筛选后的拍卖行视图 aureleconomy.ah
/orders 打开购买订单 GUI aureleconomy.orders
/orders create <item> <amount> <price> [currency] 发布购买订单 aureleconomy.orders
/orders fill <id> [amount] 从你的库存中完成订单 aureleconomy.orders
/orders cancel <id> 取消你的订单并退款 aureleconomy.orders
/orders my 列出你活跃的购买订单 aureleconomy.orders
/orders search <query> 按物品名称搜索活跃订单 aureleconomy.orders

管理员指令

指令 描述 权限
/eco <give|take|set> <player> <amount> [currency] 修改玩家余额 aureleconomy.admin
/customitems 打开自定义物品浏览器 aureleconomy.admin
/customitems scan 强制重新扫描所有支持的自定义物品插件 aureleconomy.admin
/customitems list 查看所有发现的自定义物品 aureleconomy.admin
/customitems info <id> 显示特定自定义物品的详细信息 aureleconomy.admin
/customitems reload 从磁盘重载配置覆盖项 aureleconomy.admin
/customitems toggle <id> 在市场启用或禁用已发现的物品 aureleconomy.admin
/customitems price <id> <buy> [sell] 设置已发现物品的买入/卖出价格 aureleconomy.admin

权限

权限 描述 默认值
aureleconomy.bal 查看余额 所有人
aureleconomy.pay 向玩家付款 所有人
aureleconomy.market 使用市场 所有人
aureleconomy.sell 使用 /sell 所有人
aureleconomy.ah 使用拍卖行 所有人
aureleconomy.orders 使用购买订单 所有人
aureleconomy.stocks 查看市场趋势 所有人
aureleconomy.web 使用 /web 所有人
aureleconomy.admin 管理员指令 (eco, customitems) 仅限 OP

安装

  1. 从 Modrinth 下载与你的服务器 Minecraft 版本匹配的 jar 文件
    • 以 1.21.x 结尾的文件适用于 Minecraft 1.21 至 1.21.11,需要 Java 21
    • 以 26.1.x 结尾的文件适用于 Minecraft 26.1、26.1.1 和 26.1.2,需要 Java 25
    • 以 26.2.x 结尾的文件适用于 Minecraft 26.2,需要 Java 25
  2. 将其放入服务器的 plugins/ 文件夹中
  3. 重启服务器
    • 如果未检测到 Vault,Aurelium 会在首次运行时自动提取并安装它

配置

数据库

database:
  type: sqlite          # sqlite 或 mysql
  file: "database.db"   # 仅 SQLite,相对于插件文件夹的路径
  mysql:                # 仅 MySQL
    host: "localhost"
    port: 3306
    database: "aurelium"
    username: "root"
    password: "password"
    ssl-mode: "PREFERRED"  # DISABLED | PREFERRED | REQUIRED | VERIFY_CA | VERIFY_IDENTITY

ssl-mode 默认为 PREFERRED:只要服务器提供 TLS,连接就会加密,无需信任库。如果通过不受信任的网络访问数据库,请使用 VERIFY_CA 或 VERIFY_IDENTITY,因为它们还会验证服务器证书。

经济系统

economy:
  default-currency: "Aurels"
  currencies:
    Aurels:
      symbol: "₳"
      starting-balance: 100.0
  max-balance: -1       # -1 = 无限制
  min-pay-amount: 0.01

市场物品

直接控制每个价格:

market-items:
  DIAMOND:
    buy: 5000.0    # 从服务器购买的成本
    sell: 0.0      # 0.0 = 禁止出售
  DIRT:
    buy: 1.0
    sell: 0.5      # 玩家可以以 0.5 的价格出售
  BEDROCK:
    buy: -1.0      # -1.0 = 禁止购买

市场设置

market:
  enabled: true
  gui-mode: modern              # "classic" 或 "modern"
  dynamic-pricing: true
  price-increase-per-buy: 0.001 # 每次购买 +0.1%
  price-decrease-per-sell: 0.001 # 每次出售 -0.1%
  default-sell-ratio: 0.5
  price-floor: 0.2              # 最低不能低于基础价格的 20%
  price-ceiling: 5.0            # 最高不能超过基础价格的 500%
  price-recovery:
    enabled: true
    rate: 0.01                  # 每个周期恢复差距的 1%
    interval-minutes: 10

拍卖行

auction-house:
  enabled: true
  default-duration: 86400       # 24 小时(秒)
  max-duration: 604800          # 最长 7 天
  listing-fee-percent: 2.0
  sales-tax-percent: 5.0
  max-listings-per-player: -1   # -1 = 无限制
  min-listing-price: 1.0

购买订单

buy-orders:
  enabled: true
  max-active-orders-per-player: 10
  min-price-per-piece: 0.1
  max-order-value: -1           # -1 = 无限制
  creation-fee-percent: 2.0
  sales-tax-percent: 5.0

Web 仪表板

web:
  enabled: true
  mode: cloud            # "local" = 插件内置的 Web 服务器(需要开放端口)
                         # "cloud" = 同步到外部服务器(适用于所有主机)
  local:                 # 仅在 mode 为 "local" 时使用
    host: "localhost"    # 将仪表板保留在此机器上。"0.0.0.0" 会在所有网络接口上暴露它,
                         # 并在其 URL 中暴露会话链接
    port: 8585
    server-id: "local"   # 在仪表板 URL 中此服务器的标识方式
    session-timeout-minutes: 60
    snapshot-interval-seconds: 30
    price-history-interval-minutes: 10
  cloud:                 # 仅在 mode 为 "cloud" 时使用
    url: "https://aurelium.alwaysdata.net"
    sync-interval: 30

首次运行时,web.cloud 下的 server-id 和 api-key 会自动生成并保存到配置文件中。请勿泄露它们:该密钥用于向仪表板授权您的服务器。

在 local 模式下,仪表板在插件内部运行,因此无需其他托管服务。 在 cloud 模式下,所有内容都会同步到托管的仪表板,因此即使在不允许开放端口的主机上也能正常工作。玩家通过 /web 命令打开仪表板,这将生成一个有时效性的链接;会话也可以随时撤销。

Web 购买请求会在扣款前排队,队列是否在重启后保留是可配置的:

web-queue:
  type: memory           # memory(重启时丢失)或 sqlite(保存在磁盘上)
  file: "web-queue.db"

网络同步(需要 MySQL)

Aurelium 支持 BungeeCord 和 Velocity 网络的跨服务器数据同步。

同步功能需要 MySQL。SQLite 不支持跨服务器数据共享。请将所有后端服务器指向同一个 MySQL 数据库:

  • 全局余额 - 玩家在网络中登录时刷新的余额
  • 全球拍卖行 - 所有链接服务器共享的有效拍卖和收藏箱
  • 各服务器市场 - 动态价格存储在每个服务器的本地 config.yml 中,允许每个服务器拥有不同的经济系统,同时玩家保持相同的钱包

语言

启动时会生成一个 messages.yml 文件。

  • 翻译:将任何消息更改为您的语言
  • 颜色代码:使用 MiniMessage 格式(例如 <green>)或传统的 & 代码

常见问题解答

“未知命令” - 如果 /market 或 /eco 提示“未知命令”,说明插件加载失败。

  • 检查服务器控制台/日志中的错误信息
  • 确保 plugins/ 目录下有 Aurelium.jar
  • 确保您正在运行 Paper(或其兼容分支:Purpur、Pufferfish、Leaves)

“无权限” - 您需要 OP 权限(执行 /op <player>)或 aureleconomy.admin 权限节点。默认情况下,所有玩家都启用标准玩家命令。

仍然无法工作? - 请在 GitHub 上提交问题,附上您的服务器版本、错误日志以及复现步骤。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源