AxRankMenu Fixed

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