- ◆ 支持核心
- CatServer,Spigot,PaperSpigot,Magma,Arclight
- ◆ 插件前置
- PlaceholderAPI(必需) MythicMobs(可选)
- ◆ 游戏版本
- 1.12-1.21.x
核心特性
多等级类型系统
- 支持无限制自定义等级类型(如:修为、境界、武学等)
- 每个等级类型独立配置,互不干扰
- 灵活的经验公式系统,支持分段式经验计算
- 自定义等级名称(如:练气一层、筑基二层、结丹大圆满)
境界突破系统
- 独特的修仙境界突破机制
- 可配置突破成功率、失败惩罚
- 支持突破材料需求(兼容MythicMobs物品)
- 雷劫突破机制,可自定义设置雷劫数量、伤害等精细配置
- 突破成功/失败可执行自定义命令
经验倍率系统
- 权限倍率:不同VIP等级享受不同经验倍率
- 全服倍率:管理员可设置限时全服经验加成
- 个人倍率:为特定玩家设置专属经验倍率(多重倍率叠加计算)
每日经验限制
- 防止玩家过度刷经验,保持游戏平衡
- 支持权限组差异化限制
- 自动每日重置机制
多种存储方式
- YML文件存储:轻量级,适合小型服务器
- SQLite存储:本地数据库,性能更佳
- MySQL存储:支持多服务器数据共享
主要功能
经验获取方式
- 原版经验同步:可选择是否与Minecraft原版经验联动
- MythicMobs兼容:击杀指定MM怪物获得经验
- 命令给予:管理员可直接给予玩家经验
升级奖励系统
- 通用升级奖励:每次升级都会执行的命令
- 特定等级奖励:指定等级升级时的特殊奖励
- 支持控制台命令、玩家命令等多种形式
原版经验条同步
- 智能同步到Minecraft原版经验条
- 自适应同步频率,优化服务器性能
- 可选择性启用/禁用同步功能
命令系统
玩家命令
- /kzlevel exp - 查看详细经验信息
- /kzlevel level - 查看等级信息
- /kzlevel breakthrough <等级ID> - 尝试进行境界突破
管理员命令
- /kzlevel reload [等级类型] - 重载插件/重载指定等级类型配置
- /kzlevel sync <玩家> <等级ID> - 切换同步状态
- /kzlevel toggle <玩家> <等级ID> <true/false> - 启用/停用等级
- /kzlevel addexp <玩家> <等级ID> <经验> - 增加经验
- /kzlevel subexp <玩家> <等级ID> <经验> - 减少经验
- /kzlevel level add <玩家> <等级ID> <等级> - 添加等级
- /kzlevel level set <玩家> <等级ID> <等级> - 设置等级
- /kzlevel setmultis <倍率> <时长(秒)> - 设置全服倍率
- /kzlevel setmultip <玩家> <倍率> <时长(秒)> - 设置玩家倍率
- /kzlevel resetmulti <global|player> [玩家名] - 重置倍率
PlaceholderAPI 变量
插件提供丰富的PAPI变量,格式:%kzlevel_等级名_变量类型%基础变量
- %kzlevel_default_level% - 当前等级
- %kzlevel_default_exp% - 当前经验值
- %kzlevel_default_maxexp% - 升级所需经验
- %kzlevel_default_progress% - 经验进度百分比
- %kzlevel_default_progressbar% - 经验进度条
- %kzlevel_等级名_levelname% - 显示等级名称(如:练气五层)
- %kzlevel_等级名_fulllevelname% - 显示完整名称(如:境界 练气五层)
倍率变量
- %kzlevel_default_multiplier% - 总经验倍率
- %kzlevel_default_globalmultiplier% - 全服倍率
- %kzlevel_default_permmultiplier% - 权限倍率
每日限制变量
- %kzlevel_default_dailyexp% - 今日已获得经验
- %kzlevel_default_dailymaxexp% - 每日经验上限
- %kzlevel_default_dailyprogress% - 每日经验进度
适用场景
- 修仙服务器:完美的境界突破系统
- RPG服务器:多维度等级成长体系
- 生存服务器:增加游戏深度和目标
权限节点
- kzlevel.admin - 管理员权限
- kzlevel.use - 基础使用权限
- kzlevel.vip1/vip2/vip3 - VIP经验倍率权限
为什么选择 KzLevel?
- 功能完整:从基础等级到高级突破,一应俱全
- 性能优化:异步处理,智能同步,不卡服务器
- 高度自定义:几乎所有功能都可以自由配置
- 兼容性强:支持主流插件,适配多个MC版本
- 持续维护:作者长期维护,及时修复问题
YAML:
# KzLevel 插件配置文件
# 数据存储配置
storage:
# 存储类型: yml(YAML文件), sqlite(SQLite数据库), mysql(MySQL数据库)
type: yml
# MySQL数据库配置
mysql:
host: localhost
port: 3306
database: minecraft
username: root
password: ""
table-prefix: "kzlevel_"
# 插件设置
settings:
# 是否启用调试模式
debug: false
# 性能监控配置
performance:
monitoring:
# 是否启用性能监控
enabled: false
# 性能报告间隔(秒)
report-interval: 300
# 内存警告阈值(MB)
memory-threshold-mb: 1024
# 是否显示详细报告(false时只显示关键警告)
detailed-reports: false
YAML:
# 示例修仙等级类型配置文件
# 文件名必须与等级类型名称完全一致
# 等级类型名称(需要与文件名完全一致)
修仙:
# 是否默认同步到原版经验
sync: true
# 默认启用状态
enable: true
# 是否覆盖原版经验(是否取消原版经验掉落)
cancel-minecraft: true
# 掉落经验的设定
drop:
# 是否在获取原版经验时同步增长经验
minecraft: false
# mm兼容,在击杀指定id的mm生物后获得经验
mythic:
- "修仙怪物:50"
- "妖兽:100~150"
# 最大等级
max-level: 50
# 经验公式
exp:
# 1~20级经验公式
1: "{level} * 200"
# 21~40级经验公式
21: "{level} * 400"
# 41~50级经验公式
41: "{level} * 800"
# 权限经验倍率
perm:
- "kzlevel.xiuxian.vip1:1.5"
- "kzlevel.xiuxian.vip2:2.0"
- "kzlevel.xiuxian.vip3:3.0"
# 升级指令
upgrade:
- "op:say {player} 修为提升了!当前境界:{level_display}"
- "op:give {player} diamond 1"
# 指定等级升级指令
upgrade-level:
10:
- "op:say {player} 突破到筑基期!"
- "op:give {player} emerald 3"
20:
- "op:say {player} 突破到金丹期!"
- "op:give {player} emerald 5"
30:
- "op:say {player} 突破到元婴期!"
- "op:give {player} emerald 10"
# 每日经验上限配置
daily-limits:
- "default:1000"
- "kzlevel.xiuxian.vip1:2000"
- "kzlevel.xiuxian.vip2:3000"
# 等级名称映射
level-names:
1: "练气一层"
2: "练气二层"
3: "练气三层"
4: "练气四层"
5: "练气五层"
6: "练气六层"
7: "练气七层"
8: "练气八层"
9: "练气九层"
10: "练气圆满"
11: "筑基一层"
12: "筑基二层"
13: "筑基三层"
14: "筑基四层"
15: "筑基五层"
16: "筑基六层"
17: "筑基七层"
18: "筑基八层"
19: "筑基九层"
20: "筑基圆满"
21: "金丹一层"
22: "金丹二层"
23: "金丹三层"
24: "金丹四层"
25: "金丹五层"
26: "金丹六层"
27: "金丹七层"
28: "金丹八层"
29: "金丹九层"
30: "金丹圆满"
31: "元婴一层"
32: "元婴二层"
33: "元婴三层"
34: "元婴四层"
35: "元婴五层"
36: "元婴六层"
37: "元婴七层"
38: "元婴八层"
39: "元婴九层"
40: "元婴圆满"
41: "化神一层"
42: "化神二层"
43: "化神三层"
44: "化神四层"
45: "化神五层"
46: "化神六层"
47: "化神七层"
48: "化神八层"
49: "化神九层"
50: "化神圆满"
# 突破配置(修仙境界突破系统)
breakthrough:
# 9级突破到10级的配置(练气圆满)
9:
# 基础成功概率 (0.0-1.0)
success-rate: 0.8
# 失败时降级等级数
failure-penalty: 1
# 辅助材料(MM物品,材料物品:数量)
required-items:
- "筑基丹:1"
# 辅助材料提供的额外成功概率
item-bonus-rate: 0.1
# 雷劫配置(可选)
# 注意:启用雷劫后,将跳过基础成功率和辅助材料概率判定,直接进入雷劫考验
# 玩家必须在雷劫中存活才能突破成功,死亡则突破失败
lightning-tribulation:
# 是否启用雷劫
enabled: true
# 雷劫道数
lightning-count: 3
# 每道雷劫间隔时间(秒)
interval: 2
# 每道雷劫伤害
damage: 3.0
# 雷劫范围(格子)
range: 2
# 雷劫精准度(0.6 = 60%精准度)
accuracy: 0.6
# 雷劫特效
effects:
# 是否显示粒子特效
particles: true
# 是否播放音效
sound: true
# 是否显示警告消息
warning: true
# 成功时执行的命令
success-commands:
- "op:say {player} 成功突破到筑基期!"
- "op:give {player} diamond 3"
# 失败时执行的命令
failure-commands:
- "op:say {player} 突破失败,修为受损!"
# 19级突破到20级的配置(筑基圆满)
19:
# 基础成功概率 (0.0-1.0)
success-rate: 0.6
# 失败时降级等级数
failure-penalty: 2
# 辅助材料(MM物品,材料物品:数量)
required-items:
- "金丹:1"
- "高阶金丹:1"
# 辅助材料提供的额外成功概率
item-bonus-rate: 0.2
# 雷劫配置(可选)- 六重雷劫
lightning-tribulation:
# 是否启用雷劫
enabled: true
# 雷劫道数
lightning-count: 6
# 每道雷劫间隔时间(秒)
interval: 3
# 每道雷劫伤害
damage: 5.0
# 雷劫范围(格子)
range: 3
# 雷劫精准度(0.7 = 70%精准度)
accuracy: 0.7
# 雷劫特效
effects:
# 是否显示粒子特效
particles: true
# 是否播放音效
sound: true
# 是否显示警告消息
warning: true
# 成功时执行的命令
success-commands:
- "op:say {player} 成功突破到金丹期!渡过六重雷劫!"
- "op:give {player} diamond 5"
- "op:give {player} emerald 3"
# 失败时执行的命令
failure-commands:
- "op:say {player} 在六重雷劫中失败,境界大损!"
- "player:me 感到修为大损,需要重新修炼..."
# 29级突破到30级的配置(金丹圆满)
29:
# 基础成功概率 (0.0-1.0)
success-rate: 0.4
# 失败时降级等级数
failure-penalty: 3
# 辅助材料(MM物品,材料物品:数量)
required-items:
- "元婴丹:1"
- "天材地宝:2"
# 辅助材料提供的额外成功概率
item-bonus-rate: 0.3
# 雷劫配置(可选)- 九重雷劫
lightning-tribulation:
# 是否启用雷劫
enabled: true
# 雷劫道数
lightning-count: 9
# 每道雷劫间隔时间(秒)
interval: 4
# 每道雷劫伤害
damage: 8.0
# 雷劫范围(格子)
range: 4
# 雷劫精准度(0.8 = 80%精准度)
accuracy: 0.8
# 雷劫特效
effects:
# 是否显示粒子特效
particles: true
# 是否播放音效
sound: true
# 是否显示警告消息
warning: true
# 成功时执行的命令
success-commands:
- "op:say {player} 成功突破到元婴期!渡过九重雷劫!"
- "op:give {player} diamond 10"
- "op:give {player} emerald 5"
- "op:give {player} nether_star 1"
# 失败时执行的命令
failure-commands:
- "op:say {player} 在九重雷劫中失败,道基受损!"
- "player:me 感到道基不稳,需要重新巩固..."
YAML:
# KzLevel 语言配置文件
experience:
gained: "§e获得 {level_name} 经验: +{exp_amount}"
daily_limit_reached: "§c今日 {level_name} 经验已达上限!"
level_up: "§a恭喜!你的 {level_name} 等级提升到了 {level_display}!"
breakthrough:
cap_reached: "§e你的 {level_name} 经验已满,但需要突破才能升级!"
success: "§a突破成功!到达 {level_display}!{bonus_used}"
fail: "§c突破失败!等级降至 {level_display}。{bonus_used}"
insufficient_exp: "§c经验不足,无法尝试突破"
config_not_found: "§c等级配置不存在或未启用"
no_breakthrough_needed: "§c当前等级不需要突破"
tribulation_start: "§6§l天劫降临!§e准备迎接 {count} 道雷劫的考验!"
tribulation_warning: "§c§l警告!§e第 {current}/{total} 道雷劫即将降临!"
tribulation_strike: "§e第 {current}/{total} 道雷劫降临!"
tribulation_survived: "§a你成功抵挡了第 {current}/{total} 道雷劫!"
tribulation_failed: "§c你在雷劫中死亡,突破失败!"
tribulation_completed: "§a§l恭喜!你成功渡过了所有雷劫!"
command:
no_permission: "§c你没有权限执行此命令!"
player_not_found: "§c玩家 {player} 不存在或不在线!"
invalid_number: "§c无效的数字: {number}"
reload_success: "§a配置文件重载成功!"
exp_added: "§a已为玩家 {player} 添加 {level_name} 经验: {exp_amount}"
exp_removed: "§a已为玩家 {player} 减少 {level_name} 经验: {exp_amount}"
multiplier_set: "§a已设置 {level_name} 倍率为: {multiplier}"
multiplier_reset: "§a倍率已重置"
level:
info: "§e{level_name} 等级: §f{level} §e经验: §f{current_exp}/{required_exp}"
max_level: "§a已达到最大等级!"
type_not_found: "§c等级类型 {level_name} 不存在!"
type_disabled: "§c等级类型 {level_name} 已被禁用!"
sync:
success: "§a已同步 {count} 个玩家的数据"
failed: "§c数据同步失败"