转载 闭源 世界管理 gHub 1.2.1

[MD]
## 简介

版本： 1.0
兼容服务端： Paper 1.21.x

# GHub — Minecraft 大厅实用插件

**版本：** 1.0
**兼容服务端：** Paper 1.21.x

```
ProtocolLib
PlaceholderAPI (Optional)
```

GHub 是一款简洁而实用的 Minecraft 服务端大厅管理插件，用于管理出生点、大厅物品及玩家传送。插件支持设置出生点、向玩家发放特殊物品，并可通过 PlaceholderAPI 使用变量占位符。

## 主要功能

### 出生点设置

- 玩家加入服务器时会自动传送至出生点。
- 支持发送带有 Minecraft 颜色代码的出生提示消息（`welcome-spawn`）。

**命令示例：**

```
/ghub spawn
```

### 大厅物品

玩家加入服务器时可获得一个可配置的大厅物品，支持以下设置：

- 物品材质，例如 `COMPASS`
- 物品名称与 Lore 描述
- 使用物品时执行的操作（`console` 或 `bungee`）
- 玩家无法丢弃该物品

**`config.yml` 配置示例：**

```yaml
item:
material: COMPASS
slot: 4
name: "&6Server Selector"
lore:
- "&7Click to choose a server"
function: "[console] deluxemenus open selector %player_name%"
```

### 物品功能

#### 控制台命令

- 以控制台身份执行命令。
- 支持占位符，例如 `%player_name%`。
- 若命令需要玩家变量、但由没有关联玩家的控制台环境触发，插件会显示警告并避免执行，以防止报错。

#### BungeeCord 跨服传送

- 可通过 BungeeCord 将玩家传送至其他子服务器。
- 示例：`[bungee] lobby`

### 虚空传送

- 当玩家跌落至设定高度（`VOID_HEIGHT = -60`）以下时，将自动传送回出生点。
- 连续触发虚空传送时具有 3 秒冷却时间，避免频繁传送。

### PlaceholderAPI 支持

所有标准 PlaceholderAPI 占位符均可用于玩家消息。

**示例：**

```yaml
messages:
welcome-spawn: "Welcome, %player_name%!"
```

为避免控制台环境中缺少玩家上下文导致错误，依赖玩家占位符的控制台命令会被禁用。

### 插件命令

| 命令 | 说明 | 权限 |
| --- | --- | --- |
| `/ghub reload` | 重载插件配置 | `ghub.reload` |
| `/ghub spawn` | 设置出生点 | `ghub.spawn` |

### 配置

全部设置均位于 `config.yml` 和 `spawn.yml` 中，可配置内容包括：

- 大厅物品的材质、栏位及名称
- 玩家消息
- 物品触发功能

**`config.yml` 配置示例：**

```yaml
item:
material: COMPASS
slot: 4
name: "&6Server Selector"
lore:
- "&7Click to choose a server"
function: "[console] deluxemenus open selector %player_name%"

messages:
welcome-spawn: "Welcome, %player_name%!"
cannot-drop: "&cYou cannot drop this item!"
reload-success: "&aConfiguration reloaded successfully!"
no-permission: "&cYou do not have permission to use this command!"
usage: "&eUsage: /ghub [reload|spawn]"
```

### 安全性与便利功能

- 大厅物品无法被丢弃或移动。
- 虚空传送冷却可防止重复触发传送。
- 消息与命令会安全处理控制台环境中不存在玩家的情况。

## 安装方法

1. 下载最新版 `GHub.jar` 插件。
2. 将文件放入 Paper 服务端的 `plugins` 文件夹。
3. 重启服务器，插件将自动生成 `config.yml` 和 `spawn.yml`。
4. 编辑 `config.yml`，并使用 `/ghub spawn` 设置出生点。
5. 完成后，玩家加入服务器时即可获得大厅物品。
[/MD]