配置概览

AIOShop 的配置文件位于 plugins/AIOShop/ 目录下。

配置文件结构

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

配置文件说明

文件	说明	热重载
config.yml	数据库、货币、点击操作等全局设置	✅
shops/*.yml	商店定义，每个文件一个商店	✅
templates/*.yml	GUI 模板定义	✅
rarities.yml	稀有度权重配置	✅
items.yml	物品模板定义	✅
papi-currencies.yml	自定义 PAPI 货币	✅

重载配置

所有配置文件都支持热重载：

/shop reload

重载会刷新：

• 主配置
• 商店配置
• GUI 模板
• 稀有度配置
• 物品配置
• PAPI 货币配置
• 语言文件
• 限购缓存
• 随机商店缓存

YAML 语法注意事项

字符串引号

包含特殊字符的字符串需要用引号包裹：

# 正确
display-name: "&2&l我的商店"

# 错误（& 是特殊字符）
display-name: &2&l我的商店

列表格式

# 标准列表格式
description:
  - "第一行"
  - "第二行"

# 紧凑列表格式
slots: [10, 11, 12, 13]

缩进

YAML 使用空格缩进，不要使用 Tab：

items:
  bread:
    display-name: "&f面包"
    buy-price:
      amount: 5.0
      currency: "VAULT"

配置验证

启动服务器时，插件会验证配置文件。如果发现错误，会在控制台输出详细信息：

[AIOShop] 加载商店配置失败: general-store.yml
[AIOShop] 错误: Invalid YAML syntax at line 15

最佳实践

1. 备份配置：修改配置前先备份
2. 逐步修改：每次只修改少量配置，然后测试
3. 使用注释：在配置中添加注释说明
4. 参考示例：参考插件提供的示例配置