# RPPlugins
**RPPlugins** 是一款专为 Minecraft 服务器 Spigot/Paper 1.16.x - 1.21.1 角色扮演设计的插件，它添加了沉浸式角色扮演指令，例如 `/me`、`/do`、`/try` 和 `/roll`。消息本地化且仅对附近的玩家可见——非常适合角色扮演服务器、活动或寻求更深层互动的生存社区。
## 🎭 功能
- ✅ 角色扮演聊天指令：
- `/me`: 描述你的角色的动作。
- `/do`: 描述周围发生的事件。
- `/try`: 尝试一个动作，结果随机成功或失败。
- `/roll`: 掷一个 1 到 N 之间的数字。
- 🧠 附近的玩家只能看到角色扮演消息（距离可配置）。
- 🌐 通过 `config.yml` 实现多语言支持。
- 🛠️ 设计简洁干净，并提供可自定义的消息。
- 📜 内置 `/rp help` 指令供用户使用。
## 💬 指令
| 指令 | 描述 |
|----------------|--------------------------------------------|
| `/me <文本>` | 描述你的角色的动作。 |
| `/do <文本>` | 描述世界中的事件。 |
| `/try <文本>` | 尝试一个动作，结果随机成功或失败。|
| `/roll <最大值>` | 掷一个 1 到 `<最大值>` 之间的数字。 |
| `/rp help` | 显示指令帮助。 |
## 🔁 示例用法
- `/me 微笑地对你点头` → *Steve 微笑地对你点头*
- `/do 一阵寒风吹过 (Steve)` → *一阵寒风吹过 (Steve)*
- `/try 打开生锈的门` → Steve 尝试打开生锈的门，成功或失败。
- `/roll 100` → Steve 掷出了 57 (1-100)
## ⚙️ 配置
该插件使用一个简单的 `config.yml` 文件，包含以下选项：
```yaml
language: "en"
settings:
message_distance: 100.0
messages:
en:
player_only: "Only players can use this command."
me_usage: "Usage: /me "
do_usage: "Usage: /do "
roll_usage: "Usage: /roll "
try_usage: "Usage: /try "
positive_number: "You must enter a positive number."
rolled: "rolled"
tries: "tries to"
succeeds: "and succeeds."
fails: "but fails."
rp_help_usage: "Use /rp help to view available commands."
help_header: "Available RP commands:"
me_description: "Describe your character's actions."
do_description: "Describe the world around you."
roll_description: "Roll a number between 1 and your chosen max."
try_description: "Attempt an action with randomized success or failure."
help_description: "Display this help menu."
ru:
player_only: "Только игроки могут использовать эти команды."
me_usage: "Использование: /me <действие>"
do_usage: "Использование: /do <действие>"
positive_number: "Число должно быть больше нуля."
roll_usage: "Использование: /roll <число>"
rolled: " выбросил "
tries: " пытается "
succeeds: " и удается!"
fails: " и не удается!"
try_usage: "Использование: /try <действие>"
help_header: "Справка по RP командам:"
me_description: "Описывает действие от третьего лица."
do_description: "Описывает происходящее действие или событие."
roll_description: "Бросает случайное число от 1 до указанного числа."
try_description: "Пытается выполнить действие с шансом 50/50."
help_description: "Показывает это сообщение."
rp_help_usage: "Использование: /rp help"
```