快速开始

5 分钟内完成 AIOShop 的安装和基础配置

安装步骤

1. 前置条件

项目要求
Minecraft 版本1.20.4 或更高
服务端Paper 或 Spigot
Java17 或更高
Vault (可选)用于经济系统集成

2. 安装插件

  1. 下载 AIOShop-1.3.1.jar 文件
  2. 将文件放入服务器的 plugins/ 目录
  3. 重启服务器（或使用插件管理器加载）

3. 验证安装

查看控制台输出，确认以下信息：

[AIOShop] Loading AIOShop v1.3.1
[AIOShop] Plugin enabled

游戏内执行以下命令：

/as list
成功标志：能够看到示例商店列表，包括 "杂货铺"、"随机商店" 等。

目录结构

安装后，插件会在 plugins/AIOShop/ 生成以下文件：

plugins/AIOShop/
├── config.yml          # 主配置文件
├── items.yml           # 自定义物品存储
├── papi-currencies.yml # PAPI 货币定义
├── rarities.yml        # 稀有度配置
├── shops/              # 商店配置目录
│   ├── general-store.yml
│   ├── random-shop-by-item.yml
│   └── ...
├── templates/          # GUI 模板目录
│   ├── general-store.yml
│   ├── random-shop.yml
│   └── ...
└── lang/               # 语言文件
    └── zh_CN.yml

创建第一个商店

1. 创建商店配置文件

在 plugins/AIOShop/shops/ 目录下创建 my-shop.yml：

# 我的第一个商店
display-name: "&a&l我的商店"
description:
  - "&7这是我的第一个商店"

gui-template: "general-store"

items:
  diamond:
    item-id: "diamond"
    display-name: "&b闪亮钻石"
    description:
      - "&7珍贵的钻石"
    buy-price:
      amount: 100.0
      currency: "VAULT"
    buy-rewards:
      self:
        type: "ITEM"
        item: "diamond"
        amount: 1
    sell-item-matcher:
      material: "diamond"
    sell-rewards:
      main:
        type: "CURRENCY"
        amount: 50.0
        currencyType: "VAULT"
    limit-type: "NONE"
    enabled: true

2. 重载配置

/as reload

3. 打开商店

/as open my-shop
商店 ID 就是配置文件名（不含 .yml 后缀），如 my-shop.yml 的 ID 为 my-shop。

常用命令速查

命令说明权限
/as open <商店ID>打开指定商店aioshop.use
/as list查看所有商店aioshop.use
/as reload重载配置aioshop.admin.reload
/asitem add <ID>保存手中物品aioshop.admin.item

下一步