- 版权类型
- 原创
- 插件中文名称
- 航式等级
- 插件英文名称
- HangLevel
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- Folia
- Purpur
- PufferFish
- SpongeVanilla
- Leaves
- 其他核心
- 语言支持
- 中文(简体)
- 前置组件
- MythicMobs
SX-Attribute
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]
# HangLevel - 航式等级系统
> 一款轻量级、高性能的 Minecraft 等级系统插件,完美兼容 MythicMobs 和 SX-Attribute
---
## 📖 插件简介
**HangLevel** 是 Hang 系列插件之一,为服务器提供完整的玩家等级系统。支持通过击杀 MythicMobs 怪物获取经验,兼容 SX-Attribute 经验加成,提供丰富的 PlaceholderAPI 变量支持。
---
## ✨ 核心特性
### 🎯 基础功能
- **完整的等级系统** - 支持自定义最大等级和升级经验需求
- **灵活的经验配置** - 分段式经验需求,不同等级段可设置不同经验值
- **自动数据保存** - 定时自动保存玩家数据,防止数据丢失
- **多样化提示方式** - 支持 ActionBar 和 Title 两种经验/升级提示
### 🔌 插件兼容
- **MythicMobs 全版本支持** - 兼容 MythicMobs 4.x 和 5.x 全版本
- 使用 `hexp` 掉落类型为玩家提供经验
- 示例:`- hexp 50` 或 `- hexp 100 0.5`(50%概率掉落100经验)
- **SX-Attribute 经验加成** - 读取玩家 `ExpAddition` 属性自动计算经验加成
- **PlaceholderAPI 变量** - 提供丰富的变量用于其他插件调用
### 🎨 自定义功能
- **可自定义进度条** - 长度、颜色、符号完全可配置
- **多语言支持** - 所有消息均可在 `lang.yml` 中自定义
- **灵活的显示方式** - 经验获取和升级提示可分别配置显示方式
---
## 📋 命令列表
| 命令 | 别名 | 说明 | 权限 |
|------|------|------|------|
| `/hanglevel help` | `/hl help` | 查看帮助信息 | `hanglevel.command` |
| `/hanglevel info [玩家]` | `/hl info` | 查看等级信息 | `hanglevel.command` |
| `/hanglevel add <玩家> <数量>` | `/hl add` | 增加玩家经验 | `hanglevel.admin` |
| `/hanglevel remove <玩家> <数量>` | `/hl remove` | 减少玩家经验 | `hanglevel.admin` |
| `/hanglevel set <玩家> <数量>` | `/hl set` | 设置玩家经验 | `hanglevel.admin` |
| `/hanglevel setlevel <玩家> <等级>` | `/hl setlevel` | 设置玩家等级 | `hanglevel.admin` |
| `/hanglevel reload` | `/hl reload` | 重载配置文件 | `hanglevel.admin` |
| `/hanglevel save` | `/hl save` | 手动保存数据 | `hanglevel.admin` |
---
## 🔑 权限节点
- `hanglevel.command` - 基础命令权限(默认所有玩家)
- `hanglevel.admin` - 管理员权限(默认OP)
---
## 📊 PlaceholderAPI 变量
| 变量 | 说明 | 示例输出 |
|------|------|----------|
| `%hanglevel_level%` | 玩家当前等级 | `15` |
| `%hanglevel_exp%` | 玩家当前经验值 | `350` |
| `%hanglevel_required%` | 升级所需经验 | `500` |
| `%hanglevel_progress%` | 升级进度百分比 | `70` |
| `%hanglevel_progressbar%` | 可视化进度条 | `■■■■■■■□□□` |
---
## ⚙️ 配置文件示例
### config.yml
```yaml
# 数据定时保存间隔 (秒)
auto-save-interval: 600
# 最大等级 (满级)
max-level: 100
# 经验获取提示方式: ACTIONBAR 或 TITLE
exp-gain-display: ACTIONBAR
# 升级提示方式: ACTIONBAR 或 TITLE
level-up-display: TITLE
# 兼容 SX-Attribute 插件的经验加成
enable-sx-attribute-bonus: false
# 进度条自定义设置
progressbar:
length: 10
completed-color: '&a'
remaining-color: '&7'
completed-symbol: '■'
remaining-symbol: '■'
# 分段式等级经验需求配置
level-exp-requirements:
- "10:100" # 1-10级每级需要100经验
- "30:200" # 11-30级每级需要200经验
- "50:500" # 31-50级每级需要500经验
- "100:1000" # 51-100级每级需要1000经验
```
---
## 🎮 MythicMobs 配置示例
在你的 MythicMobs 怪物配置中添加 `hexp` 掉落:
```yaml
僵尸王:
Type: ZOMBIE
Display: '&c僵尸王'
Health: 100
Drops:
- hexp 50 # 必定掉落50经验
- hexp 100 0.5 # 50%概率掉落100经验
- diamond 1-3 0.1 # 其他掉落物
```
---
## 📦 安装方法
1. 下载插件 jar 文件
2. 将文件放入服务器 `plugins` 文件夹
3. 重启服务器或使用 PlugMan 等插件热加载
4. 根据需要修改 `config.yml` 和 `lang.yml`
5. 使用 `/hl reload` 重载配置
---
## 🔧 依赖插件
### 可选(软依赖)
- **MythicMobs** 4.x/5.x - 用于怪物经验掉落
- **PlaceholderAPI** - 用于变量支持
- **SX-Attribute** - 用于经验加成
---
## 💡 使用场景
- ✅ RPG 服务器的玩家等级系统
- ✅ 生存服务器的成长体系
- ✅ 配合 MythicMobs 的怪物击杀奖励
- ✅ 配合其他插件的等级门槛判断
---
[/MD]
Q群361919269 禁广 有报错或者想添加的功能可以跟我说
后续如有大更新准备考虑转为付费插件
Q群361919269 禁广 有报错或者想添加的功能可以跟我说
后续如有大更新准备考虑转为付费插件