- 版权类型
- 原创
- 插件中文名称
- 梦·实体命令
- 插件英文名称
- DreamEntityCommand
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- 其他核心
- 语言支持
- 中文(简体)
- 适配版本(Java)
- 1.12
[MD]
## 📌 插件简介
DreamEntityCommand 是一款轻量级的 Bukkit/Spigot 插件,通过配置文件将实体名称与命令绑定,玩家右键点击对应名称的实体即可触发预设命令。
适用于 NPC 交互、商店入口、传送门、签到面板等场景,无需任何依赖,开箱即用。
## 🎯 适用版本
- **服务端**: Bukkit / Spigot
- **版本**: 1.12.2
- **实际测试版本**: 1.12.2 CatServer
## ✨ 功能特性
- 🖱️ 右键实体触发命令,支持任意实体类型
- 🔧 纯配置文件驱动,无需在游戏内逐个设置
- 👑 支持 OP 临时提权执行命令(安全回收权限)
- 🖥️ 支持控制台执行命令
- 🔄 支持 `%player%` 变量自动替换为玩家名
- 🎨 支持彩色字符(§ 和 & 均可)
- ♻️ 游戏内热重载配置,无需重启服务器
## 📥 安装方法
1. 下载插件 JAR 文件
2. 将 `DreamEntityCommand-1.0.jar` 放入服务器的 `plugins` 目录
3. 重启服务器
4. 修改 `plugins/DreamEntityCommand/config.yml` 配置文件
5. 使用 `/decommand reload` 热重载配置即可生效
## ⌨️ 命令
| 命令 | 别名 | 说明 | 权限 |
|------|------|------|------|
| `/DreamEntityCommand reload` | `/decommand reload` | 重载插件配置文件 | OP |
> 仅服务器管理员(OP)可使用插件命令。
## 📝 配置文件
配置文件路径:`plugins/DreamEntityCommand/config.yml`
```yaml
# 插件消息前缀,支持彩色字符
pluginTitle: "§d服务器 §7§l>>> §a"
# NPC列表:实体名称 -> 命令列表
npcList:
七日登入:
- "dreamweeksign menu"
```
### 配置说明
#### pluginTitle
插件发送消息时的前缀文本,支持 Minecraft 彩色代码(`§` 或 `&` 符号)。
#### npcList
实体名称与命令的映射表。**键名**为实体的名称(即实体在游戏内显示的名字),**值**为该实体被右键时要执行的命令列表。
### 命令前缀
在命令列表中,支持以下三种命令前缀:
| 前缀 | 说明 | 示例 |
|------|------|------|
| 无前缀 | 以玩家身份执行命令 | `"spawn"` |
| `op:` | 临时给予玩家OP权限执行命令,执行完毕后自动回收 | `"op:gamemode creative %player%"` |
| `console:` | 以控制台身份执行命令 | `"console:give %player% diamond 1"` |
### 变量
| 变量 | 说明 |
|------|------|
| `%player%` | 触发交互的玩家名称 |
### 完整配置示例
```yaml
pluginTitle: "§d服务器 §7§l>>> §a"
npcList:
七日登入:
- "dreamweeksign menu"
生存商店:
- "shop open survival"
§f创世界§d传送:
- "console:mvtp creative %player%"
§e领取奖励:
- "op:give %player% diamond 64"
§a游戏大厅:
- "lobby"
- "console:say %player% 进入了游戏大厅"
```
## 🔧 使用方法
1. 在 `config.yml` 的 `npcList` 中添加实体名称和对应命令
2. 在游戏中使用命名牌(Name Tag)或 NPC 插件给实体设置对应名称
3. 玩家右键点击该实体即可触发命令
> **注意**:实体名称必须与配置文件中的键名完全一致(包括彩色字符),才能正确匹配。
## 📮 联系作者
| 项目 | 联系方式 / 说明 |
|:---|:---|
| **作者QQ** | `1011115423` |
| **交流群** | `1104439995` |
| **版本反馈** | 欢迎反馈 1.12.2 版本的 Bug 或建议 |
| **插件定制** | 接受其他插件定制开发需求 |
[/MD]