FlawlessRank — Simple & Powerful Rank Placeholder System
FlawlessRank is a lightweight, high-performance plugin that allows you to set, reset, and manage custom rank values for players — fully compatible with
PlaceholderAPI.
Whether you want to display ranks in the chat, tablist, scoreboards, or holograms, this plugin makes it simple and flexible.
✨
Features:
Custom default value for all players.
Change ranks dynamically via commands.
Blacklist system to block unwanted words (color codes ignored).
SQLite and MySQL/MariaDB support.
PlaceholderAPI integration
⚡ Optimized for Spigot/Paper 1.21+ with zero performance impact.
Fully customizable messages in config.yml.
Code (Text):
/rank help » Show help menu
/rank set {value} » Change your rank
/rank reset » Reset your rank to default
/rank admin set {value} {player} » Change a player's rank
/rank admin reset {player} » Reset a player's rank
/rank admin reset » Reset all ranks
/rank admin reload » Reload configuration
Code (Text):
flawlessrank.use » Allows using /rank set & /rank reset
flawlessrank.admin » Access to all admin commands
Code (Text):
Placeholder
%FlawlessRanks_rank% » Shows the player's current rank (or default if none set)
Code (YAML):
# Default value that will be returned by the %FlawlessRanks% placeholder
# Can contain other placeholders (e.g.: %vault_prefix%) and they will be processed if PlaceholderAPI is present.
default-value
: '
%vault_prefix%'
# Blacklist (simple substring check, case-insensitive)
blacklist-value
:
- poop
- gay
# SQLite file name (will be saved in plugins/FlawlessRanks/)
database-type
: sqlite
# or mysql
# Only needed if using mysql/mariadb:
mysql-host
: localhost
mysql-port
: 3306
mysql-database
: ranksdb
mysql-username
: root
mysql-password
: pass123
# Customizable messages!
messages:
help
:
-
"&aUse /rank help for help."
-
"&e/rank set {value} - Change your rank"
-
"&e/rank reset - Reset your rank"
-
"&e/rank admin set {value} {player} - Change a player's rank"
-
"&e/rank admin reset {player} - Reset a player's rank"
-
"&e/rank admin reset - Reset all ranks"
-
"&e/rank admin reload - Reload configuration"
only-players
:
"&cOnly players can use this command."
no-permission
:
"&cYou do not have permission."
no-value
:
"&cYou must enter a value."
blacklist-message
:
"&cThe value contains forbidden words. Choose another."
rank-set
:
"&aYour rank is now: {value}"
rank-reset
:
"&aYour rank has been reset to the default value."
admin-no-permission
:
"&cYou do not have administrator permission."
admin-usage
:
"&cUsage: /rank admin <set|reset|reload> [...]"
admin-set-usage
:
"&cUsage: /rank admin set {value} {player}"
player-not-found
:
"&cPlayer not found."
admin-rank-set
:
"&aRank of {player} changed to: {value}"
admin-reset-all
:
"&aAll ranks have been reset to the default value."
admin-rank-reset
:
"&aRank of {player} reset to the default value."
admin-reset-usage
:
"&cUsage: /rank admin reset [player]"
config-reloaded
:
"&aConfiguration reloaded."
admin-invalid-sub
:
"&cInvalid admin subcommand."
unknown-command
:
"&cUnknown command. Use /rank help"