AxRankMenu Fixed

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10

平台： bukkit paper purpur spigot

标签： game-mechanics technology

◾ 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

1. Download 'AxRankMenuFixed.jar' (or you can check the source code for yourself)
2. Place the JAR into your server's 'plugins/' directory
3. 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.