跳到主要内容

Quickstart

目标：5 分钟内跑通 AIOShop（打开示例商店、完成一次买入/卖出、测试随机商店刷新）。

前置条件​

  • Minecraft：建议 Paper 1.20.4
  • Java：17
  • 可选依赖（按你要用的货币/功能安装）：
    • Vault + 经济插件：使用 VAULT 货币
    • PlayerPoints：使用 PLAYER_POINTS 货币
    • PlaceholderAPI：使用 PAPI_COMMAND 货币；模板也可使用 PAPI 占位符
    • NeigeItems：商店里需要 neige-item-id 时安装

1) 安装并启动​

  1. 把 AIOShop-*.jar 放入服务端 plugins/
  2. 需要的话一起放入可选依赖
  3. 启动服务器

2) 验证商店已加载​

/as list
列出已加载商店（商店ID=shops/*.yml 文件名）
/as open general-store
打开示例杂货铺
成功标志

能打开 GUI，并能在控制台看到 AIOShop、模板、商店加载完成的日志。

3) 测试买入/卖出（默认点击行为）​

默认 config.yml 的点击行为：

  • 左键：买 1 个
  • Shift+左键：买一组（堆叠最大）
  • 右键：卖 1 个
  • Shift+右键：卖一组（堆叠最大）
  • 中键：打开“购买数量选择”
  • Shift+中键：打开“出售数量选择”

在杂货铺对同一商品完成一次买入/卖出即可。

4) 测试随机商店刷新​

/as open random-shop-by-item
打开随机商店示例
/as refreshpoints <玩家名> random-shop-by-item 10
给该玩家发放刷新点数（用于点击“刷新”按钮）

然后重新打开随机商店，点击模板中的“刷新”按钮。

刷新失败常见原因

商店不是随机商店、禁用了手动刷新、或刷新点数不足（通常默认是 0）。

5) 配置变更后重载​

/as reload
重载主配置/货币/物品/稀有度/商店/模板/语言等