原创 开源 工具 经济 ErrorShop - 轻量商店、玩家市场和自定义菜单 0.18.1

想快速搭建官方商店、玩家自由市场、VIP/SVIP 上架额度和功能菜单，又不想从一开始就部署数据库？ErrorShop 默认使用本地 YAML 即装即用，需要群组服时再切换 MySQL + Redis。

点击展开...

• 当前版本：0.18.1
• 推荐环境：Paper 1.21.11 + Java 21
• 实测经济：Vault 1.7.3-b131 + XConomy Paper 2.26.3
• 开源协议：MIT
• 源码与完整手册：GitHub - ErrorShop
• 云端构建：GitHub Actions
• 下载方式：MineBBS 帖子附件优先；开发构建可从 GitHub Actions 获取

1. 官方商店：通过 shops/*.yml 配置商品、价格、金币/点券组合和访问权限。
2. 玩家市场：玩家自行定价上架，支持购买、搜索、分页、税率、下架和背包满暂存。
3. 自定义菜单：通过 menus/*.yml 制作主菜单、功能导航、传送入口或商店入口。

• 新增 /errorshop claim，玩家清出背包空间后可主动领取暂存物品。
• 新增 errorshop.market.claim 权限，默认所有玩家拥有。
• 增加领取中、领取成功、队列为空和背包仍满等中文提示。
• 手动领取复用异步存储、同步背包操作和玩家级操作互斥，兼容本地 YAML 与 MySQL 市场。

• 重构玩家市场成交顺序：锁定商品后扣款，再提交成交。
• MySQL 模式下，成交状态、买家待发物品和卖家税后收益在同一事务中写入。
• 增加价格上下限、小数位、税率和异常旧价格校验。
• 增加 45 格分页与 /errorshop market <关键词> 搜索。
• 加强重复点击、过期锁、退款、待发货和离线收益提示。
• 在 Paper 1.21.11-132、Vault 1.7.3-b131、XConomy Paper 2.26.3 完成干净启动验证。

• 每个 shops/*.yml 文件对应一个商店。
• 可配置材质、显示名、Lore、数量、金币价格、点券价格和商店权限。
• 支持 Vault 金币、PlayerPoints 点券，以及 and / or 双经济模式。
• 商品点击按配置 ID 绑定，不会仅凭相同材质误匹配其它商品。
• 可配置购买后是否关闭商店界面。

• 玩家手持物品执行 /errorshop sell <价格> 上架。
• 普通玩家、VIP、SVIP 可按权限设置不同上架数量。
• 54 格市场界面，其中每页展示 45 件商品。
• /errorshop market <关键词> 可搜索材质、显示名或卖家名。
• 买家左键购买；卖家对自己的商品在 5 秒内右键两次确认下架。
• 支持最低价格、最高价格、小数位限制和市场税率。
• 下架返还或购买发货时若背包空间不足，物品会安全进入待领取队列。
• 玩家重新上线时自动尝试发放，也可执行 /errorshop claim 手动领取。

点击购买
  → 锁定商品
  → 校验价格与余额
  → 扣除买家金币
  → 原子提交：已售状态 + 买家待发物品 + 卖家税后收益
  → 发放物品并尝试向卖家入账
  → 背包满或经济服务暂不可用时保留到持久化队列

• 同一商品只能由成功取得锁的一台服务器继续处理。
• 超过 market.reservation-timeout-seconds 的异常锁会自动回收。
• 成交尚未提交时会尝试退款；无法立即退款时写入待结算队列。
• 每名玩家同时只处理一个市场操作，降低重复点击造成的竞态。
• 本地 YAML 与 MySQL 后端都将存储 I/O 移出 Paper 主线程。

• 多个子服可共用同一个 MySQL 玩家市场。
• 商品、状态、离线收益和待发物品统一存储。
• Redis 作为可选市场事件总线，可广播上架、购买、下架等事件。
• cluster.group 用于区分服务器组，cluster.server-id 必须在同组内唯一。
• MySQL 是商品数据源；Redis 断开不会变成另一份商品数据库。

• 可创建多个 menus/*.yml，用于主菜单、功能导航、传送入口或活动入口。
• 支持按字符布局 GUI，并分别配置左键、右键或通用动作。
• 支持玩家命令、控制台命令、消息、商店、市场和子菜单动作。
• menu.allow-console-actions: false 可统一禁用控制台权限动作。
• 支持 MiniMessage，并兼容传统 & 颜色代码。

[player] <command>
[console] <command>
[tell] <message>
[shop] <id>
[market]
[menu] <id>

插件以 Paper 1.21.11 为当前开发和验证基线。其它 1.21.x 兼容分支建议先在测试服验证；升级前请备份 plugins/ErrorShop/。

点击展开...

1. 准备 Java 21 和 Paper 1.21.11。
2. 下载 ErrorShop-0.18.1.jar，放入服务器 plugins/。
3. 启动服务器一次，生成默认配置。
4. 编辑 config.yml、shops/*.yml、menus/*.yml 和 lang.yml。
5. 重启服务器，或执行 /errorshop reload。

currency:
  provider: none

market:
  backend: local

cluster:
  enabled: false

1. 安装 Vault 与 XConomy。
2. 确认两个插件均正常启用。
3. 修改以下配置并重启或重载。

currency:
  provider: vault

Vault economy provider connected: me.yic.xconomy.depend.economy.Vault

market:
  backend: local
  min-price: 0.01
  max-price: 1000000000
  price-decimals: 2
  tax-rate: 0.05
  reservation-timeout-seconds: 60
  groups:
    default:
      slots: 9
    vip:
      permission: "errorshop.market.vip"
      slots: 18
    svip:
      permission: "errorshop.market.svip"
      slots: 27

market:
  backend: mysql
  fail-policy: "disable-market"
  reservation-timeout-seconds: 60

cluster:
  enabled: true
  group: "survival"
  server-id: "survival-1" # 每个子服必须不同
  redis:
    enabled: true
    host: "127.0.0.1"
    port: 6379
    password: ""
    database: 0
    channel: "errorshop:market"

database:
  mysql:
    host: "127.0.0.1"
    port: 3306
    database: "errorshop"
    username: "errorshop"
    password: "change-this"
    table-prefix: "errorshop_"
    use-ssl: false

/errorshop sell 100
/errorshop market
/errorshop market 钻石

• 玩家不能购买自己的商品。
• 卖家右键自己的商品一次会看到确认提示，5 秒内再次右键才会下架。
• 下架物品会优先返还背包，空间不足则进入待领取队列。

/errorshop claim

• 先清出足够背包空间再执行。
• 能放入的物品会立即发放；剩余物品继续安全保存。
• 玩家重新登录时也会自动尝试领取。

• 备份 plugins/ErrorShop/。
• 用普通玩家账号测试商店权限、市场上架额度和领取权限。
• 完成一次购买、卖家离线入账、下架返还和背包满领取。
• 群组服同时从两台子服购买同一商品，确认只能成交一次。
• 模拟 MySQL/Redis 或经济插件暂时不可用，观察是否给出明确提示且没有复制物品。
• 非必要时将 menu.allow-console-actions 设为 false。

• MineBBS 下载：请使用本帖附件中的最新版 JAR。
• GitHub：error0403/ErrorShop
• GitHub Actions：云端构建与开发产物
• 问题反馈：GitHub Issues
• 作者 QQ：1955008190
• ErrorShop 交流群：点击加入 QQ 群

• Paper 1.21.11 / Java 21 development baseline.
• Verified with Vault 1.7.3-b131 and XConomy Paper 2.26.3.
• YAML local market by default; no database required for a single server.
• MySQL listing reservations and recoverable sale transactions for server groups.
• Persistent offline seller earnings and full-inventory delivery queues.
• /errorshop claim for manual queued-item delivery.
• Permission-based listing limits, 45-item pages, search, cancellation, tax, and price validation.
• MiniMessage and legacy & color support.