
◾ AxRankMenuFixed
! 在 1.21.11 版本中,AxRankMenu 已经修复了此问题,安装此插件可能会引发问题!
⚠☢☣ 此插件仍需依赖 AxRankMenu 才能运行!如果你未安装它,这个插件将变成毫无用处的垃圾文件,无法为你的服务器提供任何帮助。
AxRankMenuFixed 是一款轻量级外部补丁插件,旨在解决 Paper/Purpur 服务器(1.21+)上由 AxRanksMenu 引起的 InventoryClickEvent 冲突。
该插件不修改 AxRanksMenu,无需任何配置,可直接放入并运行。
◾ ✨ 解决了什么问题?
某些版本的 AxRanksMenu 处理 'InventoryClickEvent' 的方式会全局影响所有库存。当与其他基于 GUI 的插件一起使用时,可能会导致以下问题:
- GUI 中的物品无法点击
- 玩家可以从插件 GUI 中取出物品
- Shift-点击编辑模式不起作用(例如 Shopkeepers 管理商店)
- 管理员商店恢复为原版行为
AxRankMenuFixed 恢复了其他所有 GUI 插件的正确库存行为,同时保持 AxRanksMenu 完全正常运行。
◾ ? 工作原理(技术摘要,供插件开发者参考)
- 监听 'InventoryClickEvent'
- 以 'EventPriority.HIGHEST' 优先级运行,且 'ignoreCancelled = false'
- 仅针对顶层库存(GUI 菜单)
- 允许 AxRanksMenu 菜单正常运行
- 强制取消对其他 GUI 的点击事件,以便它们自身的逻辑能正确工作
这有效地中和了由 AxRanksMenu 引起的全局副作用。
◾ ? 功能特性
-
无需配置
-
无依赖项
-
不修改 AxRanksMenu
-
兼容其他 GUI 插件,例如:
- Shopkeepers
- RTPGui
- EconomyShopGUI
- 以及大多数基于 Bukkit/Paper 的 GUI 插件
-
极其小巧轻量
◾ ? 要求
- Paper / Purpur 服务器
- Minecraft 1.21.x
- Java 21(通常运行 Paper 1.21+ 需要它)
- 已安装 AxRanksMenu(因为此插件并非 AxRanksMenu 本身!)
◾ ? 安装方法
- 下载 'AxRankMenuFixed.jar'(你也可以自行检查源代码)
- 将 JAR 文件放入服务器的 'plugins/' 目录
- 重启服务器(请勿使用 /reload 命令)
就是这样,无需设置。
◾ ✅ 验证过的行为
启用 AxRankMenuFixed 后:
- AxRanksMenu 菜单继续正常工作
- 其他 GUI 插件重新获得对其库存的完全控制权
- 无法再从受保护的 GUI 中取出物品
- Shift-点击和管理员编辑模式再次生效
◾ ⚠ 注意事项
- 该插件目前通过库存标题来识别 AxRanksMenu 菜单。
- 如果你大幅自定义了 AxRanksMenu 的菜单标题,可能需要调整源代码中的标题检查逻辑。
- 支持 Shaded(阴影化/打包)和非 Shaded 构建版本。
◾ ? 许可证
你可以自由地使用、修改和重新分发此插件。
◾ ? 作者
由一位在实际工作中遇到 AxRanksMenu GUI 冲突的服务器/插件开发者创建,作为实用的修复方案。
如果遇到其他边缘情况或希望扩展修复功能(如基于持有者的检测、配置文件支持等),欢迎 Fork 并进行适配。

◾ AxRankMenuFixed
! In 1.21.11, axrankmenu already fixed this problem, install this plugin may cause problems !
⚠☢☣ This plugin Still required AxRankMenu to work! if you didnt have it, this thing can become a trash file that does nothing to help your server.
AxRankMenuFixed is a lightweight external patch plugin designed to resolve InventoryClickEvent conflicts caused by AxRanksMenu on Paper/Purpur servers (1.21+).
This plugin does not modify AxRanksMenu, does not require any configuration, and is safe to drop in and run.
◾ ✨ What problem does this solve?
Some versions of AxRanksMenu handle 'InventoryClickEvent' in a way that affects all inventories globally. When used together with other GUI-based plugins, this can cause issues such as:
- GUI items not being clickable
- Players being able to take items out of plugin GUIs
- Shift-click edit modes not working (e.g. Shopkeepers admin shop)
- Admin shops reverting to vanilla behaviour
AxRankMenuFixed restores correct inventory behaviour for all other GUI plugins, while keeping AxRanksMenu fully functional.
◾ ? How it works (technical summary, for plugin creator)
- Listens to 'InventoryClickEvent'
- Runs at 'EventPriority.HIGHEST' with 'ignoreCancelled = false'
- Only targets top inventories (GUI menus)
- Allows AxRanksMenu menus to function normally
- Force-cancels clicks for other GUIs so their own logic works correctly
This effectively neutralizes the global side-effects caused by AxRanksMenu.
◾ ? Features
-
No configuration required
-
No dependencies
-
No modification of AxRanksMenu
-
Compatible with other GUI plugins such as:
- Shopkeepers
- RTPGui
- EconomyShopGUI
- And most Bukkit/Paper-based GUIs
-
Extremely small and lightweight
◾ ? Requirements
- Paper / Purpur server
- Minecraft 1.21.x
- Java 21 (normally you need it to run paper 1.21+)
- AxRanksMenu installed (because this plugin isnt AxRanksMenu!)
◾ ? Installation
- Download 'AxRankMenuFixed.jar' (or you can check the source code for yourself)
- Place the JAR into your server's 'plugins/' directory
- Restart the server (do not use /reload)
That's it. No setup required.
◾ ✅ Verified behaviour
With AxRankMenuFixed enabled:
- AxRanksMenu menus continue to work normally
- Other GUI plugins regain full control over their inventories
- Items can no longer be taken from protected GUIs
- Shift-click and admin edit modes work again
◾ ⚠ Notes
- The plugin currently identifies AxRanksMenu menus by their inventory title.
- If you heavily customize the AxRanksMenu menu title, you may need to adjust the title check in source code.
- Shade / non-shade builds are both supported.
◾ ? License
You are free to use, modify, and redistribute this plugin.
◾ ? Author
Created as a practical fix by a server/plugin developer encountering real-world AxRanksMenu GUI conflicts.
If you encounter additional edge cases or want to extend the fix (holder-based detection, config support, etc.), feel free to fork and adapt.
评论 0
登录后参与评分
还没有评论,来抢沙发吧