RankSwitch

Lets players switch their displayed rank between every LuckPerms rank they've unlocked, without losing any permissions.

File Details

RankSwitcher-1.10.24.jar (Bugfix Rank Config)

  • R
  • Jul 17, 2026
  • 764.87 KB
  • 6
  • 0.5

File Name

RankSwitcher-1.10.24.jar

Supported Versions

  • 0.5

RankSwitcher 1.10.24

Fixed: editing a rank in /rank config could create a duplicate

Editing an existing rank (for example just changing its color) could silently create a second entry with the same display name — with nothing shown in the log. This happened whenever a rank's internal group key didn't match a slugified version of its display name, which is common in real setups: an English group shown under a localized name (group: builder displayed as "Builder" in another language), or names with accents, spaces, + or -. Editing ranks.yml by hand was never affected. The editor now keeps an existing rank's group key intact and only derives a new key for genuinely new ranks.

New: auto group for newcomers & a minimum rank for everyone

Nobody has to walk around as default anymore. Two new, independent toggle buttons in /rank admin (both OFF by default):

  • Auto group for new players — anyone joining your server for the very first time is automatically placed into a LuckPerms group of your choice (e.g. member) and, optionally, removed from default.
  • Minimum rank for everyone — the bigger sibling: on every join, anyone who still has no group besides default gets the group too. Switching it on even processes all currently online players immediately — nobody has to rejoin.

Both share one target group (firstJoinGroup in config.yml) and come with a hard safety guarantee: any player who already holds a real LuckPerms group is never touched. Your hand-assigned ranks, staff roles, and donor tiers stay exactly as you set them. If the target group doesn't exist yet, nothing is changed and the console tells you the exact /lp creategroup command to run.

This is the one — clearly separated, strictly opt-in — exception to RankSwitcher's "never writes to LuckPerms" principle, added by popular request. Everything else in the plugin remains read-only, as always.

New: broken ranks.yml no longer fails silently

If ranks.yml can't be parsed (e.g. after a manual editing mistake), you now get a clear warning in-game and in the console — including the hint that the syntax error in the file itself needs fixing. Previously the plugin silently fell back to a backup in memory while the broken file stayed broken on disk. /rank test now also lists every currently loaded rank in the console so you can verify what's actually active.

Improved: EssentialsPlus link got smarter

  • Deleted ranks are now cleaned up in EssentialsPlus' chat.groups too — but only entries RankSwitcher itself wrote earlier. Hand-made entries are never touched.
  • Protection against case-collision duplicates: if an entry like "Builder" already exists, saving "builder" now updates the existing entry instead of creating a conflicting second one (a known EssentialsPlus pitfall).

Fixed: editing a rank no longer moves it into the "custom" category

Editing an existing rank via /rank config keeps its original category (e.g. "playtime") instead of silently relocating it to "custom".