PlayerRanks -----
Create totally customizable, redeemable rank items for your players!
PlayerRanks is a fully customizable way to let players redeem a rank with an item!
Currently, LuckPerms is the only compatible permission plugin. Support for more permission plugins will be added in the future!
Description:
PlayerRanks allows you to create items which, when right clicked, add the player to the rank group. Simply go into the config file and set up your ranks!
The setup process is very simple: just set the name for each rank (should be the same as the group name you use for permissions), set the tier of the rank (1 is the lowest tier) and input what you want as the name of each rank item. If you want, you can even change the item type! Any item type in the game can be used (Paper, Stone, Nether star, etc.).
Once everything is configured, you can obtain your rank items with the /prankitem command. This command allows you to give the item to yourself or other players.
Features:
Customizable rank names
Infinite number of ranks
LuckPerms support
User-friendly config file
Infinite number of ranks
LuckPerms support
User-friendly config file
Commands:
/prankgive: gives the specified player the specified rank
Permissions:
Usage: /prankgive [playerName] [rankName]
Only works if player's inventory is not full
Only works if player's inventory is not full
playerranks.giveitem: Allows player to use the /prankgive command
Dependencies:
LuckPerms: https://www.spigotmc.org/resources/luckperms.28140/
NBTAPI: https://www.spigotmc.org/resources/nbt-api.7939/
By default, the config sets four ranks: vip, vip+, mvp,. and mvp+. All setup should be done immediately after installing the plugin! If the rank names in config are changed after a player has already redeemed a rank, this plugin does not apply those changes to the permission plugin.
Config
Code (YAML):
## PlayerRank Configuration ##
## READ ALL INSTRUCTIONS BELOW BEFORE CHANGING THE CONFIG ##
# SET THIS ONCE THEN LEAVE IT ALONE #
# Changing periodically will likely result in data loss #
# You may create as many ranks as you want
ranks :
# This is the name of the rank
# This string MUST match the permission group name used in your permission plugin
# NONE OF THE SPECIFIED ATTRIBUTES OF THE RANK MAY BE LEFT BLANK
vip :
# This is the tier of the rank
# This defines the hierarchy in which the ranks will go
# Players cannot redeem a rank of the same tier OR tiers below the tier they already have
# DO NOT USE THE SAME TIER TWICE
# TIERS CANNOT BE LESS THAN 1
tier : 1
# This is the display string of the rank item
# This will be the name of the item that is used to redeem the rank
# I suggest you make this the same as the group prefix you use in your permissions plugin
# In order to add colors to display strings, you MUST use '&' then the Bukkit color code (Ex. "&b" is aqua)
# This is a resource for all Bukkit color codes https://htmlcolorcodes.com/bukkit-color-codes/
displayString : "&aVIP"
vip+:
tier : 2
displayString : "&a&lVIP+"
mvp:
tier : 3
displayString : "&bMVP"
mvp+:
tier : 4
displayString : "&b&lMVP+"
# This is the material that will be used for the rank item
# Make sure the item is compatible with the version of your server
# You CAN change this periodically without issues
# If this is left empty, the plugin will default to PAPER
# AIR is a material that represents an empty item
# DO NOT SET TO AIR
itemMaterial : PAPER
## READ ALL INSTRUCTIONS BELOW BEFORE CHANGING THE CONFIG ##
# SET THIS ONCE THEN LEAVE IT ALONE #
# Changing periodically will likely result in data loss #
# You may create as many ranks as you want
ranks :
# This is the name of the rank
# This string MUST match the permission group name used in your permission plugin
# NONE OF THE SPECIFIED ATTRIBUTES OF THE RANK MAY BE LEFT BLANK
vip :
# This is the tier of the rank
# This defines the hierarchy in which the ranks will go
# Players cannot redeem a rank of the same tier OR tiers below the tier they already have
# DO NOT USE THE SAME TIER TWICE
# TIERS CANNOT BE LESS THAN 1
tier : 1
# This is the display string of the rank item
# This will be the name of the item that is used to redeem the rank
# I suggest you make this the same as the group prefix you use in your permissions plugin
# In order to add colors to display strings, you MUST use '&' then the Bukkit color code (Ex. "&b" is aqua)
# This is a resource for all Bukkit color codes https://htmlcolorcodes.com/bukkit-color-codes/
displayString : "&aVIP"
vip+:
tier : 2
displayString : "&a&lVIP+"
mvp:
tier : 3
displayString : "&bMVP"
mvp+:
tier : 4
displayString : "&b&lMVP+"
# This is the material that will be used for the rank item
# Make sure the item is compatible with the version of your server
# You CAN change this periodically without issues
# If this is left empty, the plugin will default to PAPER
# AIR is a material that represents an empty item
# DO NOT SET TO AIR
itemMaterial : PAPER
Resource Information
Author:
----------
Total Downloads:
309
First Release:
Feb 3, 2022
Last Update:
Feb 3, 2022
Category:
---------------
All-Time Rating:
0 ratings
Version
-----
Released:
--------------------
Downloads:
------
Version Rating:
----------------------
-- ratings