LSE GwLevel - 等级系统[支持LevelExp数据迁入以及接口兼容] 1.3.4 - 修复无法自动升级问题

定制魔改插件、前端找QQ2063665699​

​

GwLevel - 等级系统​

GwLevel 是一个为 Minecraft 基岩版服务器(BDS)开发的玩家等级系统框架。该框架基于 LeviLamina 的 LSE (LegacyScriptEngine) 脚本引擎实现，提供了完整的玩家等级、经验管理功能，并支持通过模块扩展来增强功能

特别注意：插件处于早期，更新较为频繁，请保证您的版本为最新



模块开发文档地址：点击前往
▼ 模块分享站：点击前往

[MD] ## 功能特点 - 完整的玩家等级系统（经验获取、等级提升、等级重置等） - 灵活的配置系统（可自定义升级经验、最高等级、升级消息等） - 丰富的 API 接口（操作玩家等级和经验的各种方法） - 模块化设计（支持通过模块系统扩展功能） - 事件系统（提供各种事件监听功能） - 数据持久化（自动保存玩家数据） ## 安装方法 1. 确保你的服务器已安装 LeviLamina 和 LegacyScriptEngine 2. 下载 GwLevel.js 文件 3. 将文件放置在服务器的 plugins 目录下 4. 重启服务器或使用 ll load GwLevel.js 加载插件 安装成功后，插件会自动创建以下目录结构： [/MD]
plugins/
└── GwLevel/
├── config/ # 配置文件目录
├── data/ # 数据存储目录
└── mod/ # 模块扩展目录
[MD] ## 玩家指令 | 命令 | 别名 | 描述 | |------|------|------| | `/level` | `/lv` | 打开等级系统主界面 | | `/level my` | `/lv my` | 查看自己的等级信息 | | `/level levelup` | `/lv levelup` | 手动升级(如果启用) | | `/level info <玩家名>` | `/lv info <玩家名>` | 查询指定玩家的等级信息 | ## 管理员指令 | 命令 | 描述 | |------|------| | `/level remove <玩家名>` | 删除指定玩家的等级数据 | | `/level reload` | 重新加载配置文件 | | `/level addexp <玩家名> <数量>` | 为指定玩家添加经验值 | | `/level delexp <玩家名> <数量>` | 减少指定玩家的经验值 | | `/level setexp <玩家名> <数量>` | 设置指定玩家的经验值 | | `/level addlevel <玩家名> <数量>` | 为指定玩家增加等级 | | `/level dellevel <玩家名> <数量>` | 减少指定玩家的等级 | | `/level setlevel <玩家名> <数量>` | 设置指定玩家的等级 | ### 主界面 使用 `/level` 或 `/lv` 可以打开主界面，主界面显示以下内容： - 当前等级信息 - 当前经验值与升级所需经验 - 升级进度百分比 - 总经验值 主界面按钮： - **查看我的等级信息**：显示详细的等级信息 - **查看玩家排行榜**：显示服务器等级排行榜 - **等级提升**：(如果启用手动升级)可以手动升级 - **等级管理**：(仅管理员可见)进入等级管理界面 ### 我的等级信息 显示个人详细的等级信息，包括： - 当前等级与经验值 - 升级进度 - 总经验值 - 服务器排名 ### 排行榜 显示服务器等级排行榜前10名玩家，并显示您的当前排名。 ### 管理员界面 管理员界面功能包括： 1. **玩家经验管理** - 添加经验值 - 减少经验值 - 设置经验值 2. **玩家等级管理** - 增加等级 - 减少等级 - 设置等级 3. **查询玩家信息** - 支持查询在线和离线玩家 4. **重置玩家数据** - 重置单个玩家数据 - 重置所有玩家数据(会自动备份) 5. **系统管理** - 重载配置 - 修改系统配置 ## 配置选项 配置文件位于 `plugins/GwLevel/config/settings.json`，包含以下选项： | 配置项 | 描述 | 默认值 | |--------|------|--------| | baseExpToLevelUp | 基础升级所需经验 | 100 | | expIncreaseRate | 每级升级经验增加倍率 | 1.5 | | maxLevel | 最高等级 | 100 | | saveIntervalMinutes | 自动保存间隔(分钟) | 5 | | levelUpMessage | 升级消息 | §a恭喜！您升级到了 {level} 级！ | | enableModSystem | 是否启用模块系统 | true | | manualLevelUp | 是否开启手动升级 | false | | PAPI | 是否启用PAPI变量 | true | ## PAPI变量 如果服务器安装了PAPI插件，GwLevelPlus提供以下变量： | 变量 | 描述 | |------|------| | %level_current% | 当前等级 | | %level_exp% | 当前经验值 | | %level_total% | 总经验值 | | %level_required% | 升级所需经验 | | %level_progress% | 升级进度(百分比) | | %level_rank% | 服务器排名 | ## 数据存储 - 玩家数据保存在 `plugins/GwLevel/data/players.json` - 配置文件保存在 `plugins/GwLevel/config/settings.json` - 模块存放在 `plugins/GwLevel/mod/` 目录 ## 常见问题 **Q: 如何启用手动升级功能？** A: 在配置文件中将 `manualLevelUp` 设置为 `true`，然后重新加载配置。 **Q: 如何修改升级所需经验？** A: 调整配置文件中的 `baseExpToLevelUp` 和 `expIncreaseRate` 参数。 **Q: 数据会自动保存吗？** A: 是的，数据会按照配置的间隔时间自动保存，默认为5分钟。 **Q: 如何备份玩家数据？** A: 玩家数据存储在 `plugins/GwLevel/data/players.json`，您可以定期复制该文件进行备份。系统在重置所有玩家数据前也会自动备份。 **Q: 如何调整等级提升的难度？** A: 您可以通过修改 `baseExpToLevelUp`(基础经验值)和 `expIncreaseRate`(增长倍率)来调整升级难度。倍率越高，高等级所需经验增长越快。 ## 升级计算公式 每级所需经验值计算公式： ``` 所需经验 = 基础经验值 × (增长倍率 ^ (等级 - 1)) ``` 例如： - 默认配置下，从1级升到2级需要100经验 - 从2级升到3级需要100 × 1.5 = 150经验 - 从3级升到4级需要100 × 1.5² = 225经验 [/MD]