◾ 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.
