转载 机械 GuiTrader 2026-04-20

[MD]
# GuiTrader

## AdvancedGUI：物品交易菜单

通过简单的拖放式管理员编辑器，在游戏内创建完全自定义的交易与商店 GUI，无需编辑配置文件。

## 概述

AdvancedGUI 允许你直接在游戏内创建任意数量的交易菜单。打开管理员编辑器后，将物品拖入对应槽位，再通过中键设置交易成本与奖励，商店即可立即投入使用。

玩家会看到简洁的 GUI，物品 Lore 中会自动显示所需物品、交易奖励及点击操作提示，无需额外插件支持。

## 功能特性

- **无限菜单**：可创建任意数量的交易菜单，每个菜单均保存为独立的 `.yml` 文件。
- **游戏内拖放编辑器**：自由放置物品，无需输入复杂命令或手动编辑 YAML。
- **按槽位编辑交易**：在管理员模式下中键点击任意物品，即可设置该槽位的成本与奖励。
- **批量购买**：玩家可按住 Shift 并右键点击，一次购买背包容量与材料允许范围内的最大数量。
- **免费物品支持**：不设置成本即可将物品作为免费奖励发放。
- **自动 Lore 提示**：每个商店物品都会自动显示成本、奖励和点击操作说明。
- **空白 GUI 标题**：库存界面不显示标题，界面更简洁专业。
- **控制台与 NPC 支持**：可通过命令为任意玩家打开任意菜单，适合与 Citizens、MythicMobs 等 NPC 插件配合使用。
- **持久化存储**：所有菜单都会在重启后保留，保存路径为 `plugins/AdvancedGUI/menus/`。

## 命令

| 命令 | 说明 |
|---|---|
| `/gui <menu>` | 为自己打开指定菜单。 |
| `/gui <menu> <player>` | 为指定玩家打开菜单。 |
| `/admgui <menu>` | 打开指定菜单的管理员编辑器。 |
| `/admgui <menu> create` | 创建新菜单。 |
| `/admgui <menu> delete` | 删除菜单。 |

## 权限

| 权限节点 | 说明 | 默认权限 |
|---|---|---|
| `guitrade.open` | 使用 `/gui` 命令。 | OP |
| `guitrade.admin` | 使用 `/admgui` 命令。 | OP |

## 使用方法

### 创建菜单

1. 执行命令：`/admgui myshop create`
2. 管理员编辑器将会打开，将需要展示的物品拖入目标槽位。
3. 中键点击某个物品，打开该槽位的交易编辑器。
4. 将成本物品放在**左侧**，将奖励物品放在**右侧**。
5. 点击绿色的 **SAVE** 羊毛方块确认保存。
6. 关闭库存界面，菜单会自动保存。

### 为玩家打开菜单

- 执行 `/gui myshop`，为自己打开菜单。
- 在控制台或通过 NPC 插件执行 `/gui myshop PlayerName`，为指定玩家打开菜单。

### 购买交易

- **右键点击**物品：购买一次。
- **Shift + 右键点击**物品：一次性购买当前背包和材料所允许的最大数量。

## 运行要求

- **Spigot / Paper**：`1.16.x` 至 `1.20.x`
- Java 8 或更高版本

## 注意事项

- 每个菜单均存储在 `plugins/AdvancedGUI/menus/<name>.yml`。
- 展示物品与实际奖励物品相互独立。你可以向玩家展示带有自定义名称或附魔的物品，同时实际发放普通物品。
- 每个交易槽位最多支持设置 **9 种成本物品**。
[/MD]