PremiumItems » Perfect for paper ranks/perks! [1.19-1.21] icon

PremiumItems » Perfect for paper ranks/perks! [1.19-1.21] -----

Allow console access via fully customizable items!



About PremiumItems
PremiumItems is a fully customizable item creator for your Spigot/Bukkit server. It's main purpose is to allow a player to execute commands from the console by clicking an item.

Commands
  • /premiumitems reload » Reloads the plugin's configuration.
  • /premiumitems list » Previews all the available items (in chat).
  • /premiumitems give [player] [item] [amount] » Gives the item(s) to the specified player.
Permissions
  • premiumitems.config » Allows the player to use the /premiumitems [reload/list] commands.
  • premiumitems.admin » Allows the player to use the /premiumitems [give] command.
Configuration
Code (YAML):
# The message displayed when the command provided is invalid.
unknown-command
: "&c&l[!] &cUnknown Command."

# The message displayed when the sender of the command does not have the permission to execute the command.
no-permission
: "&c&l[!] &cYou do not have enough permission to do this."

# The message displayed as the title of every item in the listing command. You may use %item_id% for the id of the item (e.g : rank)
list-name
: "&f&l- %item% &f:"

# The messages displayed for all the descriptions of item in the listing command.
list-description
: "  &5&l* %description%"

# The message displayed when the give command arguments are incorrect (e.g : No item is provided).
incorrect-give-arguments
: "&c&l[!] &cIncorrect argument(s) : /premiumitems give [player] [item] [number]"

# The message displayed when the give command is used with an invalid player username.
# This message will also trigger if the player is offline!
incorrect-give-player
: "&c&l[!] &cIncorrect player : %player% is not online."

# The message displayed when the give command is used with an unexisting item name.
incorrect-give-item
: "&c&l[!] &cIncorrect item : %item% is unknown."

# The message displayed when the give command is used with an incorrect number format.
incorrect-give-number
: "&c&l[!] &cIncorrect number : %number% is not an integer."

# The message displayed when the give command is used with a number that is not between 1 and 64.
unallowed-give-number
: "&c&l[!] &cIncorrect number : Amount must be between 1 and 64."

# The message displayed to the receiver of the item. You may use %item_id% for the id of the item (e.g : rank)
item-received-message
: "&5&lPrem&d&lium&8&lIte&7&lms &7&l>> &dYou received %amount%x &5%item%&d from &5%sender%&d."

# The message displayed to the sender of the item. You may use %item_id% for the id of the item (e.g : rank)
item-sent-message
: "&5&lPrem&d&lium&8&lIte&7&lms &7&l>> &5%receiver%&d successfully received %amount%x &5%item%&d."

# The message displayed when the configuration of the plugin is reloaded.
plugin-reload
: "&5&lPrem&d&lium&8&lIte&7&lms &7&l>> &dPlugin Reloaded."
This is the config.yml file : You may choose to edit it but the default version of this configuration fits most servers.

Items
Code (YAML):
# The items :
items
:
  # The name of the item, basically a key word to know which item is which (it is basically every items' id).
  # Make sure every item has a different name (no duplicates!)
  rank
:
    # The in-game name of the item.
    name
: "&5&lPrem&d&lium &8&lRa&7&lnk"
    # The description of the item shown in /premiumitems list
    description
:
     - "&fProvides the player who clicked"
      - "&fwith the &d&mPremium Rank"
    # The in-game lore of the item.
    lore
:
     - "&7&o(Click on this item to redeem the rank!)"
      - "&7 * This item can only be used once!"
    # The material (type) of the item.
    # Please refer to the bukkit list of materials: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
    item
: NETHER_STAR
    # Should the item be enchanted?
    enchanted
: true
    # Should the item be consumed when used (right-clicked)?
    one-time-use
: true
    # Command(s) that the console will execute when the item is used (without the /).
    console-commands
:
     - "give %player% dirt 1"
    # Command(s) that the player will execute when the item is used (without the /).
    player-commands
:
     - "help"
    # Message(s) sent to the player (when they use the item).
    messages
:
     - "&5&lPrem&d&lium&8&lIte&7&lms &7&l>> &dYou just redeemed the &5&lPrem&d&lium &8&lRa&7&lnk&d."
    # Broadcast(s) sent to all the online players (when someone used the item).
    broadcasts
:
     - "&5&lPrem&d&lium&8&lIte&7&lms &7&l>> &5&l%player% j&dust redeemed the &5&lPrem&d&lium &8&lRa&7&lnk&d."
    # Should the player using the item receive the broadcast? (True = no, False = yes)
    broadcast-exempt
: true
    # The sound played to the player who clicked the item.
    # Please refer to the bukkit list of sound: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html
    sound
: ENTITY_EXPERIENCE_ORB_PICKUP

  spell
:
    name
: "&3&lMag&b&lic &8&lSpe&7&lll"
    description
:
     - "&fAllows the player to use a"
      - "&fspecial &b&mPremium Rank"
    lore
:
     - "&7&o(Click on this item to cast a spell!)"
    item
: BLAZE_ROD
    enchanted
: true
    one-time-use
: false
    player-commands
:
     - "summon fireball"
    messages
:
     - "&3&l[&bMagic Spell&3&l] &8&lFire&6&lBall"
    sound
: ENTITY_EXPERIENCE_ORB_PICKUP
This is the items.yml file : You need to edit this file to add your personalized items!

Support
Looking for help with PremiumItems? Join the AnimalPlugins discord for support with the plugin!

Metrics collection
PremiumItems collects anonymous statistics via bStats.
[​IMG]
Resource Information
Author:
----------
Total Downloads: 278
First Release: May 11, 2023
Last Update: May 11, 2023
Category: ---------------
All-Time Rating:
1 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings