Custom Advancements - 自定义进度插件

💡重要提示

目前正在重制本插件，1.x 版本将不再更新！

CustomAdvancements 是一款易于配置的 Minecraft 插件，允许你为服务器创建自定义进度。玩家可以通过简单易用的 GUI 查看所有进度、完成进度以及如何触发它们！

🎮核心功能

• 自定义进度：创建完全属于你服务器的独特进度。
• 进度要求：为每个进度设置具体的达成条件。
• 进度奖励：玩家完成进度后可获得奖励。
• 变量支持：支持 PlaceholderAPI 变量。
• 图形界面：提供简单易用的 GUI 供玩家浏览。
• 多样类型：支持多种进度触发类型，并欢迎建议更多类型。
• 自定义消息：所有提示消息均可完全自定义。
• 变量描述：支持在进度描述中使用 PAPI 变量。
• 原生 GUI 集成（自 v1.1.0 起）：可在 Minecraft 原版进度界面中显示自定义进度及其完成情况（仅限 MC 1.17+）。
• 原生提示弹出（自 v1.1.0 起）：玩家完成进度时会显示原版风格的提示（仅限 MC 1.17+）。

🔧命令与权限

所有命令和权限的详细信息均在 Wiki 中列出。如果你想了解更多，请务必前往查看。

❓帮助与支持

Wiki 文档

有关如何配置插件的完整信息，请访问 Wiki

https://github.com/rowan-vr/CustomAdvancements/wiki

报告漏洞

虽然已尽力排除，但漏洞仍可能出现。如果你发现了漏洞，可以通过 Spigot 私信联系我，但更建议在 GitHub 提交问题：

https://github.com/rowan-vr/CustomAdvancements/issues

功能建议

欢迎提出任何想法！无论是新的进度类型，还是与其他插件的集成需求，都请告诉我。你可以在 GitHub 提交问题（链接同上）或通过 Spigot 私信分享你的好点子。

插件教程（西班牙语）

• 插件教程（西班牙语）

💡故障排除

错误提示：`this.d is null`

此错误发生在 Minecraft 无法创建 ResourceLocation（即 minecraft:something 格式的键名）时。修复方法是确保 avancement-trees 文件夹中的所有文件名以及所有进度配置中的键名都只使用小写字母。

玩家因 `PacketTooLarge - PacketPlayOutAdvancements is ???. Max is ???` 被踢出

当一个或多个进度的进度值过大时（例如，要求行走 10000000 格），插件会尝试发送海量的 ImpossibleTriggers 数据，从而超出数据包大小限制。

解决方案：将 minecraft-progress-type 设置为 "PERCENTAGE"，并将具体数值通过变量放入进度描述中。

相关配置说明：https://github.com/rowan-vr/CustomAdvancements/wiki/Configurations:-Advancement-configuration#minecraft-progress-type-since-v124

✨使用本插件的服务器

• mc.swirren.com

如果你希望将你的服务器列在此处，请通过 Spigot 私信发送服务器地址和名称给我。

⭐贡献代码

如果你想为插件开发做出贡献，可以在 GitHub 上提交 Pull Request！我会认真审阅，如果改动合适便会合并。

💡使用与配置指南

如需了解如何使用与配置本插件，请查阅官方 Wiki 页面以获取完整文档。

• Wiki 地址：https://github.com/rowan-vr/CustomAdvancements/wiki