NexusRanks
Rank core plus punishment suite for Paper: weighted prefix/suffix ranks that sync to LuckPerms, temp/permanent ban & mute commands and GUI-based rank…
⬇ Download on ModrinthNexusRanks
Overview
NexusRanks combines two things most networks bolt together from separate plugins: a rank hierarchy and a moderation toolkit. Ranks are defined in config.yml with a display name, MiniMessage prefix/suffix, a numeric weight for ordering, and a permission list. When LuckPerms is installed, rank changes are synchronised to it automatically, so your existing permission setup keeps working.
The moderation side adds temp/permanent bans and mutes with human-readable durations (1d, 2h30m, etc.), kicks, and an admin GUI for assigning ranks and issuing punishments without memorising commands. It suits SMPs and small-to-mid networks that want one clean dependency instead of three.
Features
- Weighted rank hierarchy — prefix, suffix and permission list per rank, ordered by
weight. - Seven pre-built ranks — Member, VIP, VIP+, MVP, Moderator, Admin, Owner, ready to edit.
- LuckPerms synchronisation — rank changes propagate to LuckPerms when it is present (
settings.luckperms-sync). - Punishment suite —
/ban,/unban,/mute,/unmute,/kick, with optional durations and reasons. - Duration parsing & formatting — accepts inputs like
30m,1d,7dand formats remaining time for messages. - MiniMessage chat formatting — optional formatted chat with rank prefixes (
settings.format-chat). - Admin GUIs — rank assignment GUI and punishment GUI for point-and-click moderation.
- In-game rank creation —
/rank create <id> <weight> <prefix>without editing files. - Live reload —
/rank reloadre-reads the configuration with no restart.
Commands
| Command | Description | Permission |
|---|---|---|
/rank (aliases: /ranks, /group) |
Open the rank admin GUI (admins) / show help | ranks.admin for GUI |
/rank list |
List all configured ranks | — |
/rank help |
Show the command help list | — |
/rank set <player> <rank> |
Set a player's rank | ranks.admin |
/rank create <id> <weight> <prefix> |
Create a new rank in-game | ranks.admin |
/rank reload |
Reload configuration files | ranks.admin |
/kick <player> [reason] |
Kick a player from the server | ranks.mod |
/mute <player> [duration] [reason] |
Mute a player from chat (temp or permanent) | ranks.mod |
/unmute <player> |
Remove a player's mute | ranks.mod |
/ban <player> [duration] [reason] |
Ban a player (temp or permanent) | ranks.mod |
/unban <player> |
Lift a player's ban | ranks.mod |
Permissions
| Node | Default | Description |
|---|---|---|
ranks.mod |
op |
Access to moderation punishment commands (kick, mute, ban, unban) |
ranks.admin |
op |
Full administrative access to ranks, configuration and player assignments |
Configuration
config.yml (excerpt):
settings:
luckperms-sync: true
format-chat: true
ranks:
default:
display-name: "<gray>Member</gray>"
prefix: "<gray>[Member]</gray> "
suffix: ""
weight: 0
permissions:
- "crates.use"
- "enchantments.use"
- "shop.use"
- "wands.use"
vip:
display-name: "<green>VIP</green>"
prefix: "<green>[VIP]</green> "
suffix: ""
weight: 10
permissions:
- "topraksmp.chat.color"
owner:
display-name: "<dark_red><bold>Owner</bold></dark_red>"
prefix: "<dark_red>[Owner]</dark_red> "
suffix: ""
weight: 100
permissions:
- "*"
Pre-configured ranks: default, vip, vip_plus, mvp, moderator, admin, owner.
Compatibility
- Server software: Paper 1.21.11 (api-version
1.21) - Java: 21
- Soft dependencies: LuckPerms (optional — sync is used only if installed)
Support
- GitHub: https://github.com/toprakeker/NexusRanks
- Discord: provided with your purchase for setup help and bug reports
- Issues and feature requests are handled through the GitHub issue tracker.
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.21.11
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as NexusRanks-1.0.0.jar — drop this file into the mods folder
- Download size: 42 KB
- Download link checked 27 Sept 2026 — working
These come from our own check of the pack file, not from the source page.