Logo
AxRankMenu Fixed
PluginLicenseRef-All-Rights-Reserved

AxRankMenu Fixed

AxRankMenuFixed restores correct inventory behaviour for all other GUI plugins, while keeping AxRanksMenu fully functional.

22
Downloads
0
Followers
3 months ago
Updated
📦
1
Versions
game-mechanicstechnologybukkitpaperpurpurspigot
Download Latestv1.0.0View on Modrinth

📖About AxRankMenu Fixed

AxRankMenuFixed

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