- 版权类型
- 原创
- 插件中文名称
- 世界等级限制
- 插件英文名称
- HangLevelGate
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- Folia
- Purpur
- PufferFish
- SpongeVanilla
- Leaves
- 其他核心
- 语言支持
- 中文(简体)
- 前置组件
- PlaceholderAPI
- 适配版本(Java)
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
- 1.15
- 1.14
- 1.13
- 1.12
- 1.11
- 1.10
- 1.9
- 1.8
[MD]
# HangLevelGate —— 世界等级限制
> **Hang系列插件 - 基于PlaceholderAPI的世界等级限制插件**
  
---
## 📖 插件介绍
HangLevelGate 是一款基于 PlaceholderAPI 变量的世界等级限制插件,可以根据玩家的等级限制其进入特定世界。支持 VIP 等级减免、自定义权限节点、完全兼容 1.8-1.21.x 版本。
### 核心特性
- ✅ 基于 PlaceholderAPI 变量的等级检测
- ✅ 支持世界等级限制
- ✅ VIP 等级减免系统(支持自定义权限节点)
- ✅ 豁免权限支持
- ✅ 拦截所有传送方式(命令、传送门、插件传送等)
- ✅ 自定义世界显示名称
- ✅ 自定义提示消息
- ✅ 完全兼容 1.8-1.21.x 版本
---
## 🎯 使用场景
- **RPG 服务器**:根据玩家等级开放不同的地图区域
- **生存服务器**:限制新手玩家进入危险世界(地狱、末地)
- **经济服务器**:VIP 玩家可以更早进入高级资源世界
- **小游戏服务器**:根据玩家段位限制进入特定竞技场
---
## 📦 依赖插件
- **PlaceholderAPI**(必需)- 用于获取玩家等级变量
---
## ⚙️ 配置文件
```yaml
# PlaceholderAPI 变量配置
# 支持任何返回数字的 PAPI 变量
placeholder: "%hanglevel_level%"
# 世界等级限制
# 格式: 世界名称: 所需等级
# 等级为 0 表示无限制
worlds:
world: 0 # 主世界无限制
world_nether: 10 # 地狱需要 10 级
world_the_end: 20 # 末地需要 20 级
resource_world: 15 # 资源世界需要 15 级
# 世界显示名称(可选)
# 用于提示消息中显示更友好的名称
world-names:
world_nether: "地狱"
world_the_end: "末地"
resource_world: "资源世界"
# VIP 等级减免系统
vip-reduction:
enabled: true
levels:
levelgate.vip1: 5 # VIP1 减免 5 级
levelgate.vip2: 10 # VIP2 减免 10 级
levelgate.vip3: 15 # VIP3 减免 15 级
levelgate.svip: 20 # SVIP 减免 20 级
# 支持任何自定义权限节点!
# 例如:
# essentials.vip: 5
# cmi.vip: 10
# group.vip: 15
# 提示消息
messages:
# {level} - 所需等级
# {world} - 世界名称
# {current} - 当前等级
no-permission: "&c你的等级不足!需要 &e{level} &c级才能进入 &e{world}&c,你当前等级: &e{current}"
no-command-permission: "&c你没有权限使用此命令!"
```
---
## 🔧 权限节点
| 权限节点 | 说明 | 默认 |
|---------|------|------|
| `levelgate.bypass` | 完全绕过世界等级限制 | 无 |
| `levelgate.reload` | 重载配置文件 | OP |
| `levelgate.vip1` | VIP1 等级减免(-5级) | 无 |
| `levelgate.vip2` | VIP2 等级减免(-10级) | 无 |
| `levelgate.vip3` | VIP3 等级减免(-15级) | 无 |
| `levelgate.svip` | SVIP 等级减免(-20级) | 无 |
**注意**:你可以在配置文件中使用任何自定义权限节点!
---
## 📝 命令列表
| 命令 | 说明 | 权限 |
|-----|------|------|
| `/levelgate` | 查看插件信息 | 无 |
| `/levelgate reload` | 重载配置文件 | `levelgate.reload` |
| `/lg` | 命令别名 | 无 |
---
## 💡 使用示例
### 示例 1:基础配置
```yaml
worlds:
world: 0 # 主世界无限制
world_nether: 10 # 地狱需要 10 级
world_the_end: 20 # 末地需要 20 级
```
### 示例 2:VIP 减免
玩家等级 8 级,地狱需要 10 级:
- **普通玩家**:无法进入(8 < 10)
- **VIP1 玩家**(减免5级):可以进入(8 >= 10-5)
### 示例 3:自定义权限节点
```yaml
vip-reduction:
enabled: true
levels:
essentials.vip: 5 # 使用 Essentials 的 VIP 权限
cmi.premium: 10 # 使用 CMI 的高级权限
group.mvp: 15 # 使用权限组
myserver.donator: 20 # 完全自定义的权限
```
[/MD]
Q群361919269 禁广 有报错或者想添加的可以跟我说
Q群361919269 禁广 有报错或者想添加的可以跟我说