【自定义指令】custom-commands ｜支持PAPI变量｜快捷注册指令｜支持参数｜支持权限｜热重载

[MD]

# CustomCommands - Minecraft 自定义命令插件

一个强大的 Minecraft Paper/Spigot 插件，允许服务器管理员在配置文件中创建自定义命令，将多个指令整合成一条指令执行。支持热重载、参数传递、权限控制等高级功能。

## 功能特性

- **自定义命令** - 在配置文件中轻松创建自定义命令

- **命令整合** - 将多个 Minecraft 命令整合成一条指令

- **热重载** - 支持在线重新加载配置，无需重启服务器

- **参数支持** - 支持命令参数传递和占位符替换

- **PAPI集成** - 完整支持PlaceholderAPI变量系统

- **权限控制** - 细粒度的权限管理系统

- **动态注册** - 自动注册配置文件中的命令

- **颜色支持** - 支持 Minecraft 颜色代码

- **命令管理** - 内置命令列表和状态查看

## 系统要求

- **Minecraft版本**: 1.16.5+

- **服务端**: Paper/Spigot

- **Java版本**: 8+

- **可选依赖**: PlaceholderAPI（用于高级变量支持）

## 安装方法

1. 下载插件 jar 文件

2. 将文件放入服务器的 `plugins` 文件夹

3. **（可选）** 安装 PlaceholderAPI 插件以启用高级变量支持

4. 重启服务器或使用 `/reload` 命令

5. 插件会自动生成默认配置文件

6. 编辑 `plugins/CustomCommands/config.yml` 配置你的自定义命令

### PlaceholderAPI 安装（可选）

如果你想使用 PlaceholderAPI 变量（如 `%player_level%`、`%server_online%` 等），请按以下步骤安装：

1. 下载 [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) 插件

2. 将 PlaceholderAPI.jar 放入 `plugins` 文件夹

3. 重启服务器

4. 使用 `/papi ecloud download <扩展名>` 下载所需的扩展

5. 使用 `/papi reload` 重新加载扩展

> **提示**: 即使没有安装 PlaceholderAPI，插件也能正常工作，只是无法使用 PAPI 变量。

## 配置说明

配置文件位置：`plugins/CustomCommands/config.yml`

### 基础配置格式

```yaml

custom-commands:

  命令名称:

    enabled: true/false  # 是否启用此命令

    commands:            # 要执行的命令列表

      - "命令1"

      - "命令2"

      - "命令3"

```

### 占位符说明

#### 基础占位符

- `{player}` - 执行命令的玩家名称

- `{args}` - 所有参数（用空格连接）

- `{arg0}`, `{arg1}`, `{arg2}...` - 第0、1、2...个参数

#### PlaceholderAPI变量

本插件完全支持PlaceholderAPI变量，使用 `%变量名%` 格式：

**玩家信息变量：**

- `%player_name%` - 玩家名称

- `%player_displayname%` - 玩家显示名

- `%player_level%` - 玩家等级

- `%player_exp%` - 玩家经验值

- `%player_health%` - 玩家当前生命值

- `%player_max_health%` - 玩家最大生命值

- `%player_food_level%` - 玩家饥饿值

- `%player_gamemode%` - 玩家游戏模式

- `%player_world%` - 玩家所在世界

- `%player_x%`, `%player_y%`, `%player_z%` - 玩家坐标

**服务器信息变量：**

- `%server_online%` - 在线玩家数量

- `%server_max_players%` - 最大玩家数量

- `%server_time_24%` - 服务器时间（24小时制）

**世界信息变量：**

- `%world_time%` - 世界游戏时间

- `%world_weather%` - 世界天气状态

- `%world_is_raining%` - 是否正在下雨

**经济变量（需要Vault插件）：**

- `%vault_eco_balance%` - 玩家余额

- `%vault_eco_balance_formatted%` - 格式化的玩家余额

> **提示**: 更多PAPI变量请查看 [PlaceholderAPI官方文档](https://github.com/PlaceholderAP ... I/wiki/Placeholders)

### 配置示例

#### 示例1：新手礼包命令

```yaml

kit:

  enabled: true

  commands:

    - "give {player} minecraft:iron_sword 1"

    - "give {player} minecraft:bread 16"

    - "tell {player} §a欢迎来到服务器！这是你的新手礼包！"

```

#### 示例2：带参数的命令

```yaml

giveitem:

  enabled: true

  commands:

    - "give {player} {arg0} {arg1}"

    - "tell {player} §a已给予你 {arg1} 个 {arg0}！"

```

使用方法：`/giveitem diamond 64`

#### 示例3：传送到出生点

```yaml

spawn:

  enabled: true

  commands:

    - "tp {player} 0 64 0"

    - "tell {player} §b已将你传送到出生点！"

    - "playsound minecraft:entity.enderman.teleport player {player}"

```

#### 示例4：玩家状态查询（使用PAPI变量）

```yaml

status:

  enabled: true

  commands:

    - "tell {player} §6=== 你的状态 ==="

    - "tell {player} §e等级: §f%player_level% (经验: %player_exp%)"

    - "tell {player} §e生命值: §f%player_health%/%player_max_health%"

    - "tell {player} §e坐标: §f%player_x%, %player_y%, %player_z%"

    - "tell {player} §e世界: §f%player_world%"

    - "tell {player} §6=================="

```

#### 示例5：服务器信息（使用PAPI变量）

```yaml

serverinfo:

  enabled: true

  commands:

    - "tell {player} §6=== 服务器信息 ==="

    - "tell {player} §e在线玩家: §f%server_online%/%server_max_players%"

    - "tell {player} §e当前时间: §f%server_time_24%"

    - "tell {player} §e世界天气: §f%world_weather%"

    - "tell {player} §6=================="

```

## 使用方法

### 管理员命令

- `/customcommands` 或 `/cc` - 显示插件信息

- `/customcommands reload` - 重新加载配置文件

- `/customcommands list` - 查看所有自定义命令列表

### 自定义命令

根据配置文件中定义的命令名称使用，例如：

- `/kit` - 获取新手礼包

- `/spawn` - 传送到出生点

- `/heal` - 完全治疗

- `/giveitem diamond 64` - 给予64个钻石

## 权限系统

### 管理权限

- `customcommands.admin` - 插件管理权限（默认：OP）

- `customcommands.reload` - 重新加载配置权限（默认：OP）

- `customcommands.list` - 查看命令列表权限（默认：OP）

### 使用权限

- `customcommands.use.*` - 使用所有自定义命令（默认：所有玩家）

- `customcommands.use.<命令名>` - 使用特定自定义命令

### 权限配置示例

```yaml

# 给予玩家使用特定命令的权限

permissions:

  - customcommands.use.kit

  - customcommands.use.spawn

  - customcommands.use.heal

```

## 高级功能

### 1. 条件执行

可以在命令中使用条件判断（需要配合其他插件）：

```yaml

conditional_heal:

  enabled: true

  commands:

    - "execute if entity {player}[nbt={Health:1.0f..10.0f}] run effect give {player} minecraft:instant_health 1 10"

    - "tell {player} §c你的生命值太低了，已为你治疗！"

```

### 2. 延迟执行

```yaml

delayed_command:

  enabled: true

  commands:

    - "tell {player} §e3秒后将传送你到出生点..."

    - "schedule function mypack:teleport_player 60t"

```

### 3. 多玩家命令

```yaml

broadcast:

  enabled: true

  commands:

    - "say §c[公告] §f{player} 说: {args}"

    - "playsound minecraft:block.note_block.pling master @a"

```

## 开发信息

- **开发者**: 9C2211D

- **版本**: 1.0-SNAPSHOT

- **API 版本**: 1.16+

- **构建工具**: Gradle

- **依赖**: Paper API 1.16.5

## 构建项目

```bash

# 克隆项目

git clone <repository-url>

cd custom-commands

# 构建插件

./gradlew build

# 运行测试服务器

./gradlew runServer

```

## 故障排除

### 常见问题

**Q: 自定义命令不工作？**

A: 检查以下几点：

1. 确保命令在配置文件中 `enabled: true`

2. 检查玩家是否有相应权限

3. 查看控制台是否有错误信息

4. 使用 `/customcommands list` 确认命令已加载

**Q: 配置文件修改后不生效？**

A: 使用 `/customcommands reload` 重新加载配置文件

**Q: 权限设置不正确？**

A: 确保权限插件正确配置了 `customcommands.use.*` 或具体的命令权限

### 调试模式

在配置文件中添加以下内容启用调试：

```yaml

debug: true

```

## 更新日志

### v1.0.0

- 初始版本发布

- 支持自定义命令创建

- 支持热重载配置

- 支持参数传递

- 支持权限控制

- 支持动态命令注册

## 贡献指南

欢迎提交 Issue 和 Pull Request！

1. Fork 本项目

2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)

3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)

4. 推送到分支 (`git push origin feature/AmazingFeature`)

5. 创建 Pull Request

## 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情

## 未来计划

- [ ] 支持命令冷却时间

- [ ] 支持命令使用次数限制

- [ ] 添加 GUI 配置界面

- [ ] 支持数据库存储

- [ ] 添加命令执行统计

- [ ] 支持条件执行

- [ ] 添加命令别名系统

---

**如果这个插件对你有帮助，请给个 Star！**

下载地址：

## 联系方式

- GitHub Issues: [提交问题](https://github.com/9C2211D/custom-commands/issues)

- QQ群: 159998932

[/MD]

插件有点bug，麻烦删帖谢谢。

插件有bug，满法删帖谢谢