# GHub — Minecraft 服务器中心实用工具插件
**版本:** 1.0
**兼容性:** Paper 1.21.x
```
ProtocolLib
PlaceholderAPI (可选)
```
GHub 是一个简约但功能强大的插件，用于管理 Minecraft 服务器的生成点、中心物品和玩家传送。它允许您轻松设置生成点、给予特殊物品，并支持 PlaceholderAPI 的占位符。
---
## 🌟 主要功能
### 1. 生成点设置
* 玩家加入服务器时会自动传送到生成点。
* 支持生成点欢迎消息 (`welcome-spawn`)，可以使用 Minecraft 颜色。
**示例命令:**
```
/ghub spawn
```
---
### 2. 中心物品
* 给玩家加入时提供的可配置物品。
* 支持：
* 材质 (例如，COMPASS)
* 名称和 Lore
* 使用动作 (`console` 或 `bungee`)
* 玩家无法丢弃该物品。
**示例 `config.yml` 设置:**
```yaml
item:
material: COMPASS
slot: 4
name: "&6服务器选择器"
lore:
- "&7点击选择服务器"
function: "[console] deluxemenus open selector %player_name%"
```
---
### 3. 物品功能
1. **控制台命令**
* 作为控制台命令执行。
* 支持占位符 (例如，`%player_name%`)。
* 如果从控制台无玩家运行时 — 将显示警告。
2. **BungeeCord 传送**
* 通过 BungeeCord 将玩家传送到另一个服务器。
* 示例: `[bungee] lobby`
---
### 4. 虚空传送
* 掉落到设置高度以下 (`VOID_HEIGHT = -60`) 的玩家会自动传送到生成点。
* 重复传送的冷却时间：3 秒。
---
### 5. PlaceholderAPI 支持
* 所有标准的 PlaceholderAPI 占位符都可以在玩家消息中使用。
**示例:**
```yaml
messages:
welcome-spawn: "欢迎, %player_name%!"
```
* 依赖于玩家占位符的控制台命令被禁用以避免错误。
---
### 6. 插件命令
| 命令 | 描述 | 权限 |
| -------------- | --------------------------- | ------------- |
| `/ghub reload` | 重新加载插件配置 | `ghub.reload` |
| `/ghub spawn` | 设置生成点 | `ghub.spawn` |
---
### 7. 配置
* 所有设置都在 `config.yml` 和 `spawn.yml` 中。
* 可配置选项包括：
* 中心物品的材质、槽位和名称
* 玩家消息
* 物品功能
**示例 `config.yml`:**
```yaml
item:
material: COMPASS
slot: 4
name: "&6服务器选择器"
lore:
- "&7点击选择服务器"
function: "[console] deluxemenus open selector %player_name%"
messages:
welcome-spawn: "欢迎, %player_name%!"
cannot-drop: "&c您不能丢弃此物品!"
reload-success: "&a配置已成功重新加载!"
no-permission: "&c您没有权限使用此命令!"
usage: "&e用法: /ghub [reload|spawn]"
```
---
### 8. 安全性 & 方便性
* 中心物品不能被丢弃或移动。
* 冷却时间可防止在坠入虚空时传送垃圾。
* 消息和命令安全地处理控制台中的缺失玩家。
---
### 9. 安装
1. 下载最新的 `GHub.jar` 插件。
2. 将文件放在您的 Paper 服务器的 `plugins` 文件夹中。
3. 重新启动服务器以生成 `config.yml` 和 `spawn.yml`。
4. 配置 `config.yml` 并使用 `/ghub spawn` 设置生成点。
5. 完成！玩家现在将会在加入时收到中心物品。