BasaltRanks - Rank Badge Generator v2.2.1

Pixel-art rank badges for chat, nametags & tab with GUI editor, web panel & LuckPerms integration
Bug Fixes
  • Fixed crash on Paper 1.20.5+ caused by PluginRemapper failing to remap the JAR
  • Root cause: ProGuard's overloadaggressively created duplicate member names that Paper's AutoRenamingTool cannot handle

Improvements
  • Admin notification on join shows version diff and first changelog line

Requirements
  • Paper 1.20.x - 1.21.x (or Purpur/Folia)
  • Java 21+
  • Optional: LuckPerms, PlaceholderAPI
Hey! Big update 🔥
✨ New: Animated Badges

Your badges can now animate in the tab list and above player heads! 4 types available:
  • Rainbow — Cycles through the full color spectrum
  • Pulse — Smooth brightness breathing effect
  • Glow — Neon glow pulsates (best with Neon style)
  • Gradient Shift — Colors smoothly swap and rotate
Use: /badge animate <id> <rainbow|pulse|glow|gradient_shift> [speed] [frames]
✨ New: Prefix + Suffix Badges
Each player can now have TWO badges — one before and one after their name:
[OWNER] PlayerName [OG]
  • /badge assign <player> <badge> prefix — Badge before name
  • /badge assign <player> <badge> suffix — Badge after name
  • /badge remove <player> prefix|suffix — Remove specific slot
✨ New: Pterodactyl Support
Set BASALTRANKS_PORT and BASALTRANKS_IP environment variables for easy setup on shared hosting. The plugin auto-detects them.
✨ New: Web Editor Improvements
  • Animation controls (type, speed, frames) in the editor
  • Prefix/Suffix badge assignment per player
  • Root URL now redirects to /web
🔧 Fixes
  • Fixed animation timing (was running 5x slower than intended)
  • Fixed tab list crash when player had no badge
  • Config now auto-migrates when updating — new settings added automatically
  • Security: password can only be changed in config.yml (removed in-game command)
⚠️ Recommended: Delete your config.yml before updating so the new version loads fresh with all comments and settings. Your badges in badges.yml are NOT affected.
What's New in v2.1.0

This update brings 8 improvements focused on UX polish, visual feedback, and bug fixes.

UX & Visual Feedback

  • Interactive /badge list — Hover over any badge to see full details (colors, style, priority, assigned players). Click to edit (admins) or view info.
  • Sound Feedback — All badge operations now have audio feedback: create (level up), delete (anvil break), assign (success chime), remove (item break), reload (success).
  • Badge Assignment Notification — Players now see a "New Badge!" title screen with sound when they receive a badge. Also notified when badge is removed.
  • Console Startup Banner — Premium ASCII banner on server start showing version, module count, and badge count.
  • Styled /basaltranks Command — Version info now shows a beautiful panel with module status, LuckPerms and Web Editor state.

Bug Fixes

  • Resource Pack Prompt — Fixed MiniMessage tags showing as raw text in the resource pack prompt. Now properly rendered as formatted text.
  • Web Editor Version — Fixed sidebar showing v1.0.0 instead of current version.
  • Templates Header — Fixed template count in templates.yml header.

BasaltRanks v2.1.0 | Paper 1.20.x - 1.21.x | Folia Compatible | Free & Open Source
v2.0.0 — Paper 26.x & Folia Support

BasaltRanks is now compatible with the latest Minecraft versions and Folia servers!

New

  • Paper 26.x Support — Works on Paper 1.20 all the way through 26.x
  • Folia Compatible — Fully works on Folia servers, no configuration needed
  • New "Champion" Template — Metallic gold badge, 26 templates total
  • Web Editor On by Default — The browser-based editor now starts automatically with the server
  • Security Notifications — Admins are reminded to change the default web editor password on join

Improved

  • Better error logging — easier to troubleshoot issues
  • More robust web editor API
  • Improved security for the web editor panel
  • Resource pack now works across all supported Minecraft versions

Fixed

  • Fixed a memory leak when closing the template browser GUI
  • Fixed potential issue with web editor under heavy load

Compatibility: Paper 1.20 — 26.x | Folia | Java 21+


  • New Template — Added "Champion" metallic gold badge (26 total)
  • Better Logging — SLF4J with full stack traces, no more silent exception swallowing
  • Memory Leak Fix — Template GUI properly cleans up player state on close
  • OP Security Alerts — Admins notified on join about insecure web editor passwords

Compatibility: Paper 1.20.x — 26.x | Folia | Java 21+
EULA: Free EULA
627 Views
97 Downloads
May 19, 2026 Published
Jun 1, 2026 Updated
5.00 star(s)
Average rating (2)
275.8 KB File size
Open source
  1. No
DRM-free
  1. Yes
Unobfuscated
  1. No
Type
  1. Chat
  1. GUI
Game mode
  1. Survival
Supported software
  1. Spigot
  1. Paper
  1. Purpur
Supported versions
  1. 1.21.11
  1. 1.21.8
  1. 1.21.5
  1. 1.21.4
  1. 1.21.2
  1. 1.21
  1. 1.20
Supported languages
  1. English
Creator
Owner
Recommended for you
31 modules, Lands, Economy, Teams, Bounties, Auction House, Staff Tools, Custom Tools + more
Not yet rated
0 purchases
#1 BuiltByBit Plugin ~ Protects your server from crash packet exploits ~ Folia Support
5.00 star(s) 140 ratings
4,232 purchases
Create items, blocks, mobs, emojis, and more with automatic resourcepack generation!
5.00 star(s) 54 ratings
3,230 purchases
Protect your server from crash/dupe/packet exploits with the ultimate security fix plugin.
5.00 star(s) 45 ratings
3,133 purchases
High Performance | Customizable | Cross-Version | GeyserMC | Folia Support
4.50 star(s) 72 ratings
2,822 purchases
627 Views
97 Downloads
May 19, 2026 Published
Jun 1, 2026 Updated
5.00 star(s)
Average rating (2)
275.8 KB File size
Open source
  1. No
DRM-free
  1. Yes
Unobfuscated
  1. No
Type
  1. Chat
  1. GUI
Game mode
  1. Survival
Supported software
  1. Spigot
  1. Paper
  1. Purpur
Supported versions
  1. 1.21.11
  1. 1.21.8
  1. 1.21.5
  1. 1.21.4
  1. 1.21.2
  1. 1.21
  1. 1.20
Supported languages
  1. English
Creator
Owner
Recommended for you
31 modules, Lands, Economy, Teams, Bounties, Auction House, Staff Tools, Custom Tools + more
Not yet rated
0 purchases
#1 BuiltByBit Plugin ~ Protects your server from crash packet exploits ~ Folia Support
5.00 star(s) 140 ratings
4,232 purchases
Create items, blocks, mobs, emojis, and more with automatic resourcepack generation!
5.00 star(s) 54 ratings
3,230 purchases
Protect your server from crash/dupe/packet exploits with the ultimate security fix plugin.
5.00 star(s) 45 ratings
3,133 purchases
High Performance | Customizable | Cross-Version | GeyserMC | Folia Support
4.50 star(s) 72 ratings
2,822 purchases
Top