AlonsoLevels • Add levels to your network! Rewards! MySQL! PAPI! - AlonsoLevels

厌倦了为你的服务器网络寻找等级系统？买了很多却都用不了？开发者消失不再更新？用电视广告腔调读这段话？

好吧，我曾经也是……正因为如此，我创建了这个插件。不是指广告腔调，而是指其他问题。你遇到了什么？我买了不同的等级系统，但都用不了。数据库有问题，奖励无法正常工作，作者从不回复，每隔四个月才“修复”一次问题，总之，资源很糟糕，尽管它是付费的！那你做了什么？我决定学习编程，自己做一个。然而，多年过去，再没有其他人发布任何添加等级系统的插件。所以我决定重写我的旧等级系统并将其公开。就是它了！

💡重要须知与要求

• 必需前置插件：需要安装 NBTAPI。
• 1.17+ 版本要求：由于 1.17 或 Java 16 需要，必须安装 MomoJS 或 JSEngine。
• 权限插件：必须安装一个权限插件（如 LuckPerms）。
• 不支持：不支持使用 Plugman 或类似插件进行热加载/卸载。
• 数据修改限制：无法添加/删除/修改离线玩家的数据/经验/等级。
• 版本支持：仅支持每个 Minecraft 主版本的最新子版本（例如：仅 1.16.5，而非 1.16.4；仅 1.18.2，而非 1.18.1）。
• 分发与使用：

- 禁止以任何形式（包括在任何软件包中）重新分发此插件。

- 禁止反编译或修改此插件。

- 禁止声称此资源是你自己的创作。

- 禁止在 MCBBS 或类似网站发布/移动/复制此插件。

免费版与专业版

• 免费版和专业版相互兼容。
• 要添加经验，必须使用命令。
• 专业版：要基于倍率添加游戏币，必须使用命令。
• 免费版：要基于倍率添加游戏币，需要你（或你的开发者）制作自定义插件。本插件不会直接挂钩 Vault。

✨核心特性

多版本与数据库支持

• 多版本支持 (BETA)：支持帖子顶部指定的版本。
• 数据库支持 (BETA)：支持使用 SQLite 或 MySQL 保存数据。MySQL 使用 HikariCP 连接池，可配置源属性（如 useSSL）。

等级与经验系统

• 自定义最高等级 (BETA)：可设置服务器允许的最高等级。
• 编辑等级：可通过 levels.yml 文件编辑等级设置。
• 经验条显示 (NEW 1.4-BETA)：在经验条上显示当前等级进度（需要 ProtocolLib）。可选择在哪些世界显示。
• 等级提升消息 (BETA)：可自定义升级时的消息，支持 PlaceholdersAPI。包含可点击文本（仅 Spigot）以打开奖励界面，支持标题+副标题。

奖励与倍率系统

• 无限普通奖励 (BETA)：可为玩家添加任意数量的普通奖励。
• 资深玩家奖励：为最忠实的玩家提供自定义奖励，最多 14 个（专业版可更多）。
• 禁用资深奖励 (BETA)：可禁用资深奖励（同时也会禁用资深倍率），并用自定义物品替代。
• 游戏币倍率：升级可解锁游戏币倍率（非经验倍率）。注意：普通倍率和资深倍率功能尚未实现，未来可能供开发者或其他插件使用。
• 禁用倍率 (BETA)：删除 multipliers.yml 中的内容即可禁用倍率。

命令与权限

• 自定义权限：可配置管理员命令的权限，以及查看他人统计信息的权限。
• 玩家数据修改命令 (BETA)：提供添加、设置、移除玩家经验和等级的一系列命令。
• 统计命令 (BETA)：可查看自己或他人的统计信息。
• 重置数据命令 (BETA)：重置玩家数据（仅控制台）。
• 重载命令 (BETA)：重载消息、权限和一些检查（仍建议重启服务器）。
• 命令别名 (BETA)：可为主命令设置不同的别名（需重启服务器生效）。
• 静默输出：执行修改玩家信息的命令时可隐藏输出，适用于小游戏。

菜单与界面

• 自定义返回物品 (BETA)：可设置材料、显示名称，以及玩家点击时运行的自定义命令（用于打开其他菜单）。
• 自定义额外物品 (BETA)：可设置材料、显示名称和命令。NEW 1.4-BETA：新增选项可禁用奖励 GUI 中的额外物品。
• 物品 Lore 支持 PlaceholdersAPI。
• 自定义模型数据支持 (BETA)：几乎所有 GUI 物品都支持自定义模型数据（仅限 1.14+）。
• 自定义头颅纹理支持 (BETA)：几乎所有 GUI 物品都支持使用自定义纹理的头颅（需要 NBTAPI）。
• 分页奖励 (BETA)：奖励菜单支持分页。
• 自定义奖励描述：可为已锁定和已领取的奖励设置自定义 Lore。

世界与兼容性

• 启用世界 (BETA)：可设置白名单世界，限制玩家在特定世界查看统计/奖励。管理员不受此限制。
• EssentialsChat 支持 (BETA)：允许在 EssentialsChat 中使用占位符（默认禁用，按需启用）。
• 加载失败踢出 (BETA)：插件加载/注册失败时，可踢出玩家并显示支持 PlaceholdersAPI 的自定义原因。

扩展与开发者功能

• 强大的 API (BETA)：为开发者提供 API 以与插件交互，包括打开奖励 GUI 和监听多种事件。
• PlaceholdersAPI 支持 (BETA)：提供丰富的占位符，可用于计分板、物品、菜单等。
• 排行榜 (BETA) (NEW 1.3-BETA)：支持添加排行榜（需要 AlonsoLeaderboards 插件）。
• 配置自动更新：插件更新时，配置文件会自动更新（注释会被移除）。
• 更新检查器：有新更新时会收到通知。

🔧安装与使用指南

• 从 SpigotMC.org 下载插件。
• 将 jar 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 根据需要编辑配置文件。
• 重启服务器以使配置生效。
• 权限可在配置文件中配置。

**命令示例**

/alonsolevels addexp AlonsoAliaga 1000 true

此命令将为玩家 AlonsoAliaga 添加 1000 点经验，但不会向执行命令的玩家/控制台发送任何消息。适用于小游戏奖励。

更多命令：请查看我们的 GitHub。

❓常见问题解答

• 为什么标记为 BETA？这意味着有漏洞吗？

不，插件应该没有漏洞。我用 BETA 只是因为我喜欢这个词。

• 我喜欢你的插件，可以提新点子吗？

当然，加入我的 Discord 服务器并告诉我。我会评估建议并决定是否编码。提出建议不意味着它会被实现。

• 为什么这是免费的？

为什么不呢？

• 你知道这可以是付费资源吗？

是的，我知道。

• 游戏币倍率有什么用？

目前没有实际用途。倍率的存在是为了方便其他开发者使用我们的 API 在他们的迷你游戏等中给予额外游戏币。

• 支持数据库吗？

是的，如特性列表所述，支持 SQLite 和 MySQL。

• API 是什么？

这是供开发者在其插件中与 AlonsoLevels 交互使用的。如果你不是开发者，则无法使用。

• 为什么你不把它做成付费资源？

我想是因为我认为 SpigotMC 上没有真正适用于服务器网络的等级系统插件，所以我决定做一个。

• 你的 Discord 是什么？

你可以在帖子开头找到。

• 我可以捐赠吗？

当然，所有捐赠都欢迎，并激励我制作更多插件。捐赠链接在帖子开头。

• 我可以把它发布到 mcbbs.net 吗？

不可以。

• 求助，它在我的服务器上不工作！

在评价资源前，请确保已安装所有前置插件。如果错误仍然存在，请将启动时的控制台日志粘贴到 https://sourceb.in/ 并在讨论区发布或加入我的服务器。

⭐专业版专属功能

• 自定义物品槽位。
• 超过 14 个资深玩家奖励。
• 更多倍率类型。

🎮开发者信息

• API 包路径：com.alonsoaliaga.alonsolevels.api.AlonsoLevelsAPI
• 开发者文档：请查看我们的 GitHub。
• 提交问题或建议：请加入我的 Discord 或使用我们的 Issue 跟踪器。评价区不是报告错误的地方。
• 社区附加组件：如果你为此插件制作了附加组件，请在此处告知我。

---

感谢 @SoulStriker_ 和 @Ajneb97 的评测（免费版）！

如果你喜欢我的作品，请考虑支持我，以便我能继续开发更多这样的插件！