![UltraRanks](https://raw.githubusercontent.com/creativedm0031/UltraPlugins/main/UltraRanks/release/images/banner.png) # ✦ UltraRanks [1.20.4+] ✦ *Übersichtlich. Mächtig. Ohne Config.* ──────── ✦ ──────── --- ## English Version A complete rank and permission system you manage entirely in-game. Create ranks in a GUI, give them a prefix, suffix and weight, type permissions into an anvil and let UltraRanks style the tab list, the name above the head and the chat. Players see their own rank, every other rank and exactly what each one can do. ### ⭐ Features at a glance: - 🛠️ **Rank Editor GUI:** Create, edit and delete ranks in /rankadmin – display name, prefix, suffix, weight, name colour, icon and description. - 🔑 **Permissions via Anvil:** Click the plus button, type the permission into an anvil – enable, deny or delete it with one click. - 📋 **Tab List, Name Tag & Chat:** Tab list sorted by weight, prefix and colour above the head, rank prefix in chat – all formats configurable. - 👀 **Player Rank Overview:** /ranks shows your rank, every other rank and exactly which permissions each one has. - ⏳ **Timed Ranks:** Give ranks for 30 days or any time – players fall back to their previous rank automatically. - 🧬 **Inheritance & Wildcards:** Ranks inherit from each other; grant whole groups with essentials.* or everything with *. - 🛒 **Rank Shop & Vouchers:** Players buy ranks in the GUI (Vault) or redeem voucher items – perfect for shops and crates. - 🔌 **Vault, PlaceholderAPI & LuckPerms:** Works with every Vault plugin, offers %ultraranks_prefix% and more, imports LuckPerms with one command. - 🧾 **Change Log:** Every change – who, what and when – in a log you can browse in the GUI. - ✨ **Clean Layout:** Feedback in the action bar, only errors in the chat – the same look in every Ultra plugin. - 🚀 **Lightweight:** No required dependencies; runs on Spigot, Paper and Purpur. **🌍 Languages:** English, Deutsch, Français, Nederlands, Italiano – every player automatically gets the language of their Minecraft client. Change the default with /ultraranks language

.

**📦 Requirements:** Spigot, Paper, Purpur · Minecraft 1.20.4 – 26.3 · Java 17+ · no required dependencies · Vault, PlaceholderAPI, LuckPerms, UltraEconomy (all optional)

Commands & Permissions (EN)

- `/ranks` – Your rank and all ranks · `ultraranks.use` (default: everyone)
- `/rankadmin` (aliases: `/ranksadmin`) – Open the rank editor · `ultraranks.manage` (default: OP)
- `/rank  ...` – Set ranks, permissions, inheritance and vouchers by command · `ultraranks.manage` (default: OP)
- `/ultraranks ` – Help, reload, version, language and LuckPerms import · `ultraranks.admin` (default: OP)

**More permissions:**

- `ultraranks.chat.color` – Use &-colour codes in chat (when UltraChat is not installed) (default: OP)
- `ultraranks.*` – All permissions of the plugin (default: OP)



View Full Configuration (EN)

```yaml
# Default language: en, de, fr, nl, it
# Change it here or in-game with /ultraranks language .
language: en

# true: every player gets the plugin in the language of their Minecraft client,
# as long as it is one of the five above. Everyone else gets "language".
use-client-language: true

# Colours used in every message and GUI.
theme:
  primary: "#8B5CF6"
  accent: "#22D3EE"
  muted: "#94A3B8"
  separator: "#64748B"
  error: "#F87171"
  error-text: "#FCA5A5"

sounds:
  enabled: true
  success: {key: "entity.experience_orb.pickup", pitch: 1.4}
  error: {key: "block.note_block.bass", pitch: 0.6}
  tick: {key: "block.note_block.hat", pitch: 1.0}
  teleport: {key: "entity.enderman.teleport", pitch: 1.0}
  click: {key: "ui.button.click", pitch: 1.2}

# Rank every new player gets. Can also be set in the GUI (nether star).
default-rank: default

# Ranks themselves are stored in ranks.yml and edited with /rankadmin.
# Permissions there: "node" grants, "-node" denies.

# Allow wildcards like essentials.* or * (covers every permission the plugins declare).
wildcards: true

# Tab list. Placeholders:    
tablist:
  enabled: true
  format: ""
  # Optional header/footer (empty = off). Placeholders:   , \n = new line
  header: ""
  footer: ""

# Name above the head (scoreboard teams). The name colour is set per rank in the GUI.
nametag:
  enabled: true
  prefix: ""
  suffix: ""

# Chat format. Only used when UltraChat is NOT installed – UltraChat then shows / itself.
# Placeholders:     
chat:
  enabled: true
  format: " » "

# Players can buy ranks with a price in /ranks (needs Vault and an economy plugin such as UltraEconomy).
purchase:
  enabled: true

# Item used for rank vouchers (/rank voucher).
voucher:
  material: PAPER

# How often temporary ranks are checked for expiry.
expiry-check-seconds: 30
```



---

## Deutsche Version

Ein komplettes Rang- und Rechte-System, das du vollständig im Spiel verwaltest. Ränge im GUI erstellen, Prefix, Suffix und Rangstärke vergeben, Rechte in einen Amboss tippen – UltraRanks gestaltet Tabliste, Name über dem Kopf und Chat. Spieler sehen ihren Rang, alle anderen Ränge und genau, was jeder Rang kann.

### ⚙️ Deine Vorteile:

- 🛠️ **Rang-Editor-GUI:** Ränge in /rankadmin erstellen, bearbeiten und löschen – Anzeigename, Prefix, Suffix, Rangstärke, Namensfarbe, Icon und Beschreibung.
- 🔑 **Rechte per Amboss:** Plus-Button anklicken, Recht in den Amboss tippen – mit einem Klick aktivieren, verbieten oder löschen.
- 📋 **Tabliste, Nametag & Chat:** Tabliste nach Rangstärke sortiert, Prefix und Farbe über dem Kopf, Rang-Prefix im Chat – alle Formate anpassbar.
- 👀 **Rang-Übersicht für Spieler:** /ranks zeigt deinen Rang, alle anderen Ränge und genau, welche Rechte jeder hat.
- ⏳ **Zeitränge:** Ränge für 30 Tage oder beliebig lange vergeben – danach automatisch zurück zum vorherigen Rang.
- 🧬 **Vererbung & Wildcards:** Ränge erben voneinander; ganze Gruppen mit essentials.* oder alles mit * vergeben.
- 🛒 **Rang-Shop & Gutscheine:** Spieler kaufen Ränge im GUI (Vault) oder lösen Gutschein-Items ein – ideal für Shops und Crates.
- 🔌 **Vault, PlaceholderAPI & LuckPerms:** Funktioniert mit jedem Vault-Plugin, bietet %ultraranks_prefix% und mehr, importiert LuckPerms mit einem Befehl.
- 🧾 **Änderungs-Log:** Jede Änderung – wer, was, wann – in einem Log, das im GUI einsehbar ist.
- ✨ **Sauberes Layout:** Rückmeldungen in der Actionbar, nur Fehler im Chat – gleicher Look in jedem Ultra-Plugin.
- 🚀 **Leichtgewichtig:** Keine Pflicht-Abhängigkeiten; läuft auf Spigot, Paper und Purpur.

**🌍 Sprachen:** English, Deutsch, Français, Nederlands, Italiano – jeder Spieler bekommt automatisch die Sprache seines Minecraft-Clients. Standardsprache ändern mit /ultraranks language .

**📦 Voraussetzungen:** Spigot, Paper, Purpur · Minecraft 1.20.4 – 26.3 · Java 17+ · keine Pflicht-Abhängigkeiten · Vault, PlaceholderAPI, LuckPerms, UltraEconomy (alle optional)

Befehle & Rechte (DE)

- `/ranks` – Dein Rang und alle Ränge · `ultraranks.use` (Standard: alle)
- `/rankadmin` (Aliase: `/ranksadmin`) – Rang-Editor öffnen · `ultraranks.manage` (Standard: OP)
- `/rank  ...` – Ränge, Rechte, Vererbung und Gutscheine per Befehl · `ultraranks.manage` (Standard: OP)
- `/ultraranks ` – Hilfe, Reload, Version, Sprache und LuckPerms-Import · `ultraranks.admin` (Standard: OP)

**Weitere Rechte:**

- `ultraranks.chat.color` – &-Farbcodes im Chat (wenn UltraChat nicht installiert ist) (Standard: OP)
- `ultraranks.*` – Alle Rechte des Plugins (Standard: OP)



Vollständige Konfiguration anzeigen (DE)

```yaml
# Default language: en, de, fr, nl, it
# Change it here or in-game with /ultraranks language .
language: en

# true: every player gets the plugin in the language of their Minecraft client,
# as long as it is one of the five above. Everyone else gets "language".
use-client-language: true

# Colours used in every message and GUI.
theme:
  primary: "#8B5CF6"
  accent: "#22D3EE"
  muted: "#94A3B8"
  separator: "#64748B"
  error: "#F87171"
  error-text: "#FCA5A5"

sounds:
  enabled: true
  success: {key: "entity.experience_orb.pickup", pitch: 1.4}
  error: {key: "block.note_block.bass", pitch: 0.6}
  tick: {key: "block.note_block.hat", pitch: 1.0}
  teleport: {key: "entity.enderman.teleport", pitch: 1.0}
  click: {key: "ui.button.click", pitch: 1.2}

# Rank every new player gets. Can also be set in the GUI (nether star).
default-rank: default

# Ranks themselves are stored in ranks.yml and edited with /rankadmin.
# Permissions there: "node" grants, "-node" denies.

# Allow wildcards like essentials.* or * (covers every permission the plugins declare).
wildcards: true

# Tab list. Placeholders:    
tablist:
  enabled: true
  format: ""
  # Optional header/footer (empty = off). Placeholders:   , \n = new line
  header: ""
  footer: ""

# Name above the head (scoreboard teams). The name colour is set per rank in the GUI.
nametag:
  enabled: true
  prefix: ""
  suffix: ""

# Chat format. Only used when UltraChat is NOT installed – UltraChat then shows / itself.
# Placeholders:     
chat:
  enabled: true
  format: " » "

# Players can buy ranks with a price in /ranks (needs Vault and an economy plugin such as UltraEconomy).
purchase:
  enabled: true

# Item used for rank vouchers (/rank voucher).
voucher:
  material: PAPER

# How often temporary ranks are checked for expiry.
expiry-check-seconds: 30
```



---

**Please leave a ⭐⭐⭐⭐⭐ rating if you like the plugin!**

UltraRanks

1.0.0