安装配置

服务器要求

最低要求

• Java: 8 或更高版本
• 服务端: Spigot 1.12.2+
• 内存: 建议 2GB+

推荐配置

• Java: 17 或 21
• 服务端: Paper 1.20.x 或 1.21.x
• 内存: 4GB+

依赖插件

必需依赖

AIOShop 核心功能无需任何依赖即可运行。

可选依赖

插件	用途	下载链接
Vault	经济系统接口	SpigotMC
EssentialsX	Vault 经济提供者	SpigotMC
PlayerPoints	点券货币系统	SpigotMC
PlaceholderAPI	变量占位符支持	SpigotMC
NeigeItems	自定义物品系统	GitHub

安装步骤

1. 准备工作

确保你的服务器满足最低要求，并已安装所需的可选依赖。

2. 下载插件

从以下渠道获取最新版本：

• GitHub Releases

3. 安装插件

# 1. 停止服务器
stop

# 2. 将 AIOShop.jar 复制到 plugins 目录
cp AIOShop.jar /path/to/server/plugins/

# 3. 启动服务器
java -jar server.jar

4. 验证安装

启动服务器后，检查控制台日志：

[AIOShop] 插件已启用！

配置文件说明

首次启动后，插件会在 plugins/AIOShop/ 目录下生成以下文件：

核心配置

文件	说明
config.yml	主配置文件，包含数据库、货币、点击操作等设置
items.yml	物品模板定义
rarities.yml	稀有度配置（随机商店使用）
papi-currencies.yml	PAPI 自定义货币配置

商店配置

shops/ 目录下的每个 .yml 文件定义一个商店：

文件	说明
general-store.yml	普通杂货铺示例
random-shop-by-item.yml	按物品随机的商店示例
random-shop-by-rarity.yml	按稀有度随机的商店示例
advanced-features.yml	高级功能展示

GUI 模板

templates/ 目录下的模板文件定义商店界面布局：

文件	说明
general-store.yml	普通商店模板
random-shop.yml	随机商店模板
compact.yml	紧凑型模板
advanced-flexible.yml	高级灵活模板

数据库配置

AIOShop 支持 SQLite 和 MySQL 两种数据库：

SQLite（默认）

database:
  type: "sqlite"

SQLite 数据库文件将保存在 plugins/AIOShop/data.db。

MySQL

database:
  type: "mysql"
  host: "localhost"
  port: 3306
  username: "root"
  password: "password"
  database: "aioshop"

常见问题

插件未加载

1. 检查 Java 版本是否满足要求
2. 检查服务端版本是否兼容
3. 查看控制台是否有错误日志

货币系统不工作

1. 确认已安装对应的货币插件（如 Vault）
2. 确认经济插件已正确配置
3. 使用 /vault-info 检查 Vault 状态

商店无法打开

1. 检查商店配置文件语法是否正确
2. 检查商店 ID 是否存在
3. 使用 /shop reload 重载配置后重试