CraftHub

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 assignment. Seven ranks included.

51 downloads 0 followers

NexusRanks

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, 7d and 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 reload re-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

No gallery available for this project.

Version Minecraft Loader Download

1.0.0

1.21.11
paper
Download