# 🧱 AzHuntMan - Hunter vs Runner 插件
将您的服务器打造成一个肾上腺素飙升的战场，让猎人追捕跑步者，进行终极生存游戏！
---
## ✨ 特性
🎯 **基于角色的游戏玩法** - 选择猎人、跑步者或旁观者
🧭 **指南针追踪** - 猎人获得追踪指南针来找到他们的猎物
✨ **发光效果** - 猎人以独特的颜色发光，以便于识别
👑 **管理员控制面板** - 通过直观的 GUI 进行完整的游戏管理
🚫 **PvP 保护** - 防止猎人与猎人之间的战斗，以确保公平的游戏体验
❄️ **猎人冻结** - 跑步者有 30 秒的领先优势来逃脱
📊 **动态积分板** - 实时游戏状态和玩家信息
🎨 **完全自定义** - 每一个消息、颜色和设置都可以配置
📡 **PlaceholderAPI** - 用于外部插件兼容的集成
⚡ **自动启动游戏** - 当达到最低玩家数量时，自动启动游戏
---
## 📋 命令 & 权限
🔧 命令
| 命令 | 描述 | 权限 |
|---------|-------------|------------|
| `/huntman` 或 `/hm` | 打开主要角色选择 GUI | `huntman.use` |
| `/huntman admin` | 访问管理员控制面板 | `huntman.admin` |
| `/huntman force ` | 强制分配玩家角色 | `huntman.admin.force` |
| `/huntman reload` | 重新加载插件配置 | `huntman.admin.reload` |
| `/huntman start` | 手动开始游戏 | `huntman.admin.game` |
| `/huntman stop` | 停止当前游戏 | `huntman.admin.game` |
| `/huntman finish` | 游戏结束，跑步者获胜 | `huntman.admin.game` |
| `/huntman leave` | 离开游戏并移除物品 | `huntman.use` |
🔐 权限
| 权限 | 描述 | 默认值 |
|------------|-------------|---------|
| `huntman.use` | 基本插件使用 | `true` |
| `huntman.admin` | 管理员 GUI 访问 | `op` |
| `huntman.admin.force` | 强制分配角色 | `op` |
| `huntman.admin.reload` | 重新加载配置 | `op` |
| `huntman.admin.game` | 开始/停止游戏 | `op` |
---
## 🎮 游戏内消息
消息支持 Minecraft 颜色代码和表情符号：
```yaml
# 示例消息，包含颜色和表情符号
game:
started: "&8[&6🎯 &bᴀᴢʜᴜɴᴛᴍᴀɴ&8] &a▶ The hunt has begun! Hunters vs Runners!"
hunter-freeze-started: "&8[&6🎯 &bᴀᴢʜᴜɴᴛᴍᴀɴ&8] &e🧊 Hunters are frozen for {time} seconds!"
hunting-phase-started: "&8[&6🎯 &bᴀᴢʜᴜɴᴛᴍᴀɴ&8] &c🏹 Hunting phase has begun!"
role:
selected:
hunter: "&8[&6🎯 &bᴀᴢʜᴜɴᴛᴍᴀɴ&8] &c🏹 You are now a Hunter!"
runner: "&8[&6🎯 &bᴀᴢʜᴜɴᴛᴍᴀɴ&8] &b🏃 You are now a Runner!"
```
---
## ⚙️ 要求
- **Minecraft 版本：** 1.20 - 1.21.7+
- **服务器软件：** Spigot/Paper/Bukkit
- **Java 版本：** 17+
- **依赖项：** PlaceholderAPI (可选)
---
## 📁 配置
🎛️ config.yml 示例
```yaml
# 🎯 AzHuntMan 配置 🚀
game:
max-hunters: 3 # 猎人数上限 (-1 = 无限制)
max-runners: -1 # 跑步者人数上限 (-1 = 无限制)
auto-start: true # 当达到最小玩家数时自动开始
min-players: 2 # 开始游戏的最小玩家数
hunter-freeze-time: 30 # 猎人冻结持续时间 (秒)
features:
compass-tracking: true # 启用猎人追踪指南针
glow-effect: true # 为猎人添加发光效果
runner-tracking: true # 允许跑步者追踪彼此
no-hunter-pvp: true # 防止猎人与猎人之间的战斗
gui:
use-small-font: true # 使用 Minecraft 小字体样式
refresh-interval: 20 # GUI 刷新率 (滴)
placeholders:
enabled: true # 启用 PlaceholderAPI 集成
debug:
enabled: false # 启用调试控制台消息
```
💬 messages.yml 示例
```yaml
# 使用颜色和表情符号自定义每个消息
prefix: "&8[&6🎯 &bᴀᴢʜᴜɴᴛᴍᴀɴ&8] "
role-prefix:
hunter: "&c[🏹 ʜᴜɴᴛᴇʀ] &f"
runner: "&b[🏃 ʀᴜɴɴᴇʀ] &f"
game:
started: "{prefix}&a▶ The hunt has begun! Hunters vs Runners!"
countdown-starting: "{prefix}&e⏰ Game starting in 10 seconds!"
hunter-freeze-started: "{prefix}&e🧊 Hunters frozen for {time} seconds!"
```
---
## 🚀 安装
1. 从 releases 下载最新版本 `AzHuntMan-1.0.0.jar`
2. 放置在服务器的 `plugins/` 文件夹中
3. 重启服务器
4. 按照你的喜好配置 `config.yml` 和 `messages.yml`
5. 使用 `/huntman reload` 应用更改，无需重启
---
## 🎯 PlaceholderAPI 支持
可用于外部插件的占位符：
- `%azhuntman_role%` - 玩家当前角色
- `%azhuntman_hunters%` - 猎人数
- `%azhuntman_runners%` - 跑步者人数
- `%azhuntman_game_status%` - 当前游戏状态
---
## 🎪 Discord 社区
加入我们的社区以获取支持、更新和讨论：
**Discord:** `https://discord.gg/R4XmFc9qCq`
---
## 📜 授权协议 & 鸣谢
**版本：** 1.0.0
**API 版本：** 1.20+
**授权协议：** 保留所有权利
---
### ᴍᴀᴅᴇ ᴡɪᴛʜ ❤️ ʙʏ ɢᴀᴍɪɴɢʜᴜᴢᴀɪ
*将您的服务器打造成终极狩猎场！*
