神话猫助手CatHelpBot

# 神话猫小助手 (CatHelpBot)

一个为Minecraft服务器打造的个性化小助手插件，可以让玩家拥有自己的专属跟随者。小助手会悬浮在玩家身边，可以是物品或生物，支持丰富的自定义功能。所有GUI界面采用9×6规格设计，优美简洁。

## 功能介绍

- **个性化小助手**：生成一个小助手跟随玩家左右，可以是物品或生物，支持自定义
- **悬浮效果**：小助手会悬浮在玩家肩膀高度，可在配置文件中自定义高度
- **互动系统**：右键小助手打开GUI界面，左键小助手切换位置，其他玩家左键小助手会收到打招呼消息
- **命名系统**：可自定义小助手名称，支持颜色代码和PlaceholderAPI变量，限制中文10字以内
- **智能跟随**：
- 小助手会跟随玩家跳跃和移动
- 当玩家传送到其他世界时，小助手会在3秒后自动传送到玩家身边
- 当玩家不移动时，小助手保持静止，不会随视角转动
- **轨道模式**：当玩家静止10秒后，小助手会进入轨道模式，围绕玩家旋转
- **欢迎轨道**：当玩家首次进入服务器或传送到新世界时，小助手会先绕玩家旋转一周再恢复正常跟随
- **粒子效果**：小助手可以拥有粒子拖尾效果，支持各种原版粒子类型
- **商店系统**：通过游戏内金币购买不同的小助手类型和粒子效果
- **权限系统**：玩家默认拥有蜜蜂小助手，其他类型需要通过商店购买获取
- **新玩家引导**：新玩家首次进入服务器时，会收到是否开启小助手模式的提示
- **自定义外观**：通过GUI界面选择小助手的外观，支持物品类型
- **配置灵活**：所有小助手类型和交互行为均可在配置文件中自定义
- **插件兼容**：支持MythicMobs生物和MMOItems物品作为小助手
- **优化设计**：针对FPS优化，减少不必要的位置更新，自动处理插件重载和玩家退出

## 指令列表

| 指令 | 描述 |
|------|------|
| `/chb help` | 显示插件帮助信息 |
| `/chb create item` | 创建新的物品组 |
| `/chb create mobs` | 创建新的生物组 |
| `/chb gui` | 打开管理GUI，可添加/删除生物和物品 |
| `/chb set hand item` | 将手中物品添加到物品组 |
| `/chb set hand mobs` | 将手中物品添加到生物组 |
| `/chb rename <名称>` | 更改小助手名称，支持颜色代码，限制中文10字以内（修复了重命名提示错误问题） |
| `/chb toggle` | 切换小助手的启用/禁用状态 |
| `/chb side` | 切换小助手的左右位置 |
| `/chb shop [items/mobs]` | 打开小助手商店 |

| `/chb particle [效果名称/off/gui]` | 设置小助手粒子效果 |

## 权限节点

| 权限 | 描述 |
|------|------|
| `cathelpbot.use` | 允许使用基本功能 |
| `cathelpbot.admin` | 允许使用管理员功能 |
| `cathelpbot.command.help` | 允许使用帮助命令 |
| `cathelpbot.command.toggle` | 允许切换小助手状态 |
| `cathelpbot.command.side` | 允许切换小助手位置 |
| `cathelpbot.command.shop` | 允许使用商店命令 |

| `cathelpbot.command.particle` | 允许设置粒子效果 |

## 配置文件

插件包含以下配置文件：
- `config.yml` - 主配置文件，包含小助手行为设置
- 悬浮高度、动画效果
- 默认名称格式（支持%player%占位符）
- 名称长度限制（中文10字以内）
- 交互类型设置
- 轨道模式设置
- 粒子效果设置
- 小助手价格设置
- `items.yml` - 物品类型配置
- `mobs.yml` - 生物类型配置
- `messages.yml` - 消息配置
- `permissions.yml` - 玩家权限配置，存储玩家已解锁的小助手和粒子效果
- `particles.yml` - 粒子效果配置，包含各种粒子效果及其价格

## 依赖

- Minecraft 1.20.1
- Paper服务端
- 可选依赖：
- MythicMobs（支持神话生物作为小助手）
- MMOItems（支持MMO物品作为小助手）
- Vault（支持经济系统，用于商店功能）
- PlaceholderAPI（支持变量替换，用于小助手名称）


感谢使用CatHelpBot，如有问题或建议，请联系客服。