ezranks
PluginMIT

ezranks

A lightweight, fully in-game-configurable rank prefix plugin

13
Downloads
0
Followers
2 weeks ago
Updated
📦
1
Versions

📖About ezranks

EzRanks

A simple, fully configurable rank plugin for Paper 1.21.11 (Java 21+).
Ranks show up in chat, the tab list, and above/next to the player's name.

Features

  • Create ranks in-game: /ezranks create <name>
  • Edit a rank's colour, username colour, bold, and tab weight via one tidy /ezranks edit command
  • Bracket toggle + bracket colour via /ezranks bracket
  • Auto default rank — anyone without their own rank automatically gets it
  • Colours by name (red, gold, dark_aqua, plus an extended palette) or any hex code (#ff00aa)
  • Shows the rank prefix in chat, tab list, and on the nameplate (via scoreboard teams)
  • Assign ranks to players, everything saved to config.yml
  • Categorised, paginated help; tab-completion everywhere; live previews

Commands

Only server operators (OPs) can create, edit, or assign ranks. Non-OP players
can still view (list, info, help) but get a "only operators" message
on anything that changes ranks. Alias: /ezrank. Run /ezranks help for paginated,
categorised help.

Ranks

Command What it does
/ezranks create <&color name> Create a rank with inline codes, e.g. &cOwner
/ezranks rename <rank> <&new name> Change a rank's name/colour; moves player assignments over
/ezranks delete <name> Delete a rank
/ezranks list List all ranks (marks the default)
/ezranks info <name> Show a rank's settings + preview

The colour/format lives right in the name you create: /ezranks create &c&lOwner
makes a bold red rank whose id is Owner. You can use & colour codes, &l bold,
&o italic, hex &#ff00aa, and the MOTD form &x&f&f&0&0&a&a.

rename is how you change a rank later — both its visible name and its colours.
Whoever already had the old rank keeps it under the new name automatically. To only
recolour (keep the same name), rename it to the same word with new codes, e.g.
/ezranks rename Owner &6&lOwner.

Edit a rank

Command What it does
/ezranks edit <rank> namecolor <color> Colour of the player's own username
/ezranks edit <rank> weight <number> Tab sort order (higher = top)

Brackets

Command What it does
/ezranks bracket <rank> toggle Turn the [ ] brackets on/off
/ezranks bracket <rank> color <color> Bracket colour

Players

Command What it does
/ezranks set <player> <rank> Give a player a rank
/ezranks unset <player> Remove a player's rank (falls back to default)
/ezranks default <rank|none> Set the auto-applied default rank
/ezranks reload Reload config from disk

Colours can be a name (red, gold, dark_aqua, orange, purple, teal...)
or a hex code (#ff00aa).

Example

/ezranks create &c&lOwner          # bold red, id = "Owner"
/ezranks edit Owner namecolor white
/ezranks edit Owner weight 100
/ezranks bracket Owner color gray
/ezranks set Tyler Owner

# A default rank everyone starts with:
/ezranks create &7Member           # gray, id = "Member"
/ezranks bracket Member toggle      # no brackets on this one
/ezranks default Member