# MeowTools
一个强大的 Minecraft Spigot 插件，为您的服务器提供有用的工具。
## 📋 主要特性
- **治疗命令 (Heal Command)** - 快速恢复玩家的生命值和饥饿度
- **喂食命令 (Feed Command)** - 恢复玩家的饥饿度
- **欢迎系统 (Welcome System)** - 为新玩家和回归玩家提供个性化欢迎消息
- **快捷键系统 (Hotkey System)** - 通过 F 键组合快速访问常用功能
- **多语言支持 (Multi-language Support)** - 支持中文和英文界面
- **权限系统 (Permission System)** - 完整的权限控制
## 🔧 系统要求
- **Minecraft 版本**: 1.21 及以上
- **服务器软件**: Spigot/Paper 1.21+
- **Java 版本**: Java 21
## 🚀 安装
1. 下载插件 JAR 文件
2. 将 JAR 文件放入服务器的 `plugins` 文件夹
3. 重启服务器
4. 插件将自动生成配置文件
## 📖 命令用法
### 主命令 `/meow`
- `/meow help` - 显示帮助信息
- `/meow heal [玩家]` - 治疗你自己或指定的玩家
- `/meow feed [玩家]` - 喂食你自己或指定的玩家
- `/meow workbench` - 打开工作台 GUI
- `/meow enderchest` - 打开末影箱
- `/meow reload` - 重新加载插件配置 (管理员)
### 独立命令
- `/heal [玩家]` - 治疗命令
- `/feed [玩家]` - 喂食命令
- `/workbench` - 工作台命令
- `/enderchest` - 末影箱命令
## 🎮 快捷键功能
通过 **按下 F 键** 配合不同的状态快速访问功能：
| 快捷键 | 功能 | 权限 |
|--------|----------|------------|
| **普通 F** | 打开工作台 | `meowtools.hotkey.workbench` |
| **向上看 F** | 打开末影箱 | `meowtools.hotkey.enderchest` |
| **向下看 F** | 切换创造模式 | `meowtools.hotkey.lookdown` |
| **Shift+F** | 执行特殊命令 | `meowtools.hotkey.shift` |
| **Ctrl+F** | 执行冲刺命令 | `meowtools.hotkey.ctrl` |
### 使用说明
1. **普通 F 键**: 在正常范围内 ( -87° 到 87°) 按下 F 键
2. **向上看 F 键**: 在向上看 (≥ 87°) 的状态下按下 F 键
3. **向下看 F 键**: 在向下看 (≤ -87°) 的状态下按下 F 键
4. **Shift+F 键**: 按下 F 键的同时按住潜行键 (Shift)
5. **Ctrl+F 键**: 按下 F 键的同时按住冲刺键 (Ctrl)
## 🔐 权限系统
| 权限节点 | 描述 | 默认值 |
|-----------------|-------------|---------|
| `meowtools.*` | 所有权限 | OP |
| `meowtools.admin` | 管理员权限 | OP |
| `meowtools.heal` | 使用治疗命令 | 所有玩家 |
| `meowtools.feed` | 使用喂食命令 | 所有玩家 |
| `meowtools.workbench` | 使用工作台命令 | 所有玩家 |
| `meowtools.enderchest` | 使用末影箱命令 | 所有玩家 |
| `meowtools.hotkey.*` | 所有快捷键权限 | 所有玩家 |
## ⚙️ 配置文件
配置文件位于 `plugins/MeowTools/config.yml`
### 基本配置
```yaml
# 欢迎消息设置
welcome:
enabled: true
sound_enabled: true
# 命令设置
commands:
heal:
enabled: true
cooldown: 30
feed:
enabled: true
cooldown: 30
# 快捷键设置
hotkeys:
enabled: true
cancel_original_function: true
# 普通 F 键
normal:
enabled: true
command: "workbench"
# Shift+F 键
shift:
enabled: true
command: "fly"
```
## 🌍 多语言支持
插件支持中文和英文，语言文件位于 `plugins/MeowTools/languages/`:
- `zh_CN.yml` - 中文语言包
- `en_US.yml` - 英文语言包
你可以通过修改配置文件中的 `language` 设置来切换语言。
## 🐛 问题反馈
如果您遇到任何问题，请：
1. 检查服务器日志
2. 确认权限配置是否正确
3. 验证配置文件格式
## 📄 许可证
本项目采用 MIT 许可证。
---
**感谢您使用 MeowTools!** 🐱