Sueta

AzoPerks

1.0.0

PerkSystem almost like Bausucht and Griefergames

·Plugin
DescriptionUpdates1Version history1AddonsDiscussionReviews


AzoPerks is a Perk System plugin, which allows your players to have specific perks by permissions.

  • Every player can enable or disable the perks he owns.
  • 13 Perks in this version (more coming)
  • Perks can be activated by using a GUI or by using a command (/perk <perk>)
  • The GUI is fully customizable . You can change every item in the config file.
  • Every message shown to the player is customizable in the config file.


/perks
Opens the GUI, where the player can manage the owned perks.
/perk <perk>
Enables or disables the perk, if it is owned by the player.
/perksinfo <player>
Gives (an admin) information about the unowned, owned and active perks of a given player.
/azoperks
Shows information about AzoPerks.


Command Permissions:

  • /perks: azoperks.command.perks
  • /perk <perk>: azoperks.command.perk
  • /perksinfo <player>: azoperks.command.perksinfo
  • /azoperks: azoperks.command.azoperks

Perk Permissions:
In order to "own" a perk, the player needs the permission azoperks.perk.<perkname> (perkname = perk to lower case without '_') . But you can actually change the permission string for every perk in the config file. So you are able to allow more perks with the same permission if you need to.

In the default config.yml file, not everything is saved by default . For example all GUI items are not saved by default into the config.yml file. You can manually add them there, if you want to change the items, but if you don`t want to do this, the config file will be clear.

Default config.yml
perk  :  
  changestatus  :  
    success   :  '&7The perk &a  %perkname%&7 is now &a%status%&7.'   
    failure   :  '&7The status of the perk &c  %perkname%&7 could not be changed. It is  
      still &c  %status%&7.'   
command  :  
  perks  :  
    openPerksGUI   :  '&7You &asuccessfully &7opened the perks GUI.'  
  message  :  
    wrongUsage   :  '&7You used the command &c/  %command% &7the wrong way. Just try &c/%usage%&7.'   
    noPermission   :  '&7You have &cno permission&7 to perform the command &c/  %command%&7.'   
    noPlayer   :  '&cYou need to be a player to perform this action.'  
  perk  :  
    noPerk   :  '&7Plese enter a valid perk instead of &c  %noperk%&7.'   
prefix   :  '&7  [  &6AzoPerks&7  ]  &r '

To change a perk , you can add the following. You do not need to set everything . If you just want to rename the perk, just just the perk.<perkname>.name path to rename the perk.

Perknames for the config.yml
  • NO_FALL_DAMAGE
  • NO_FIRE_DAMAGE
  • NO_DROWNING_DAMAGE
  • NO_HUNGER
  • KEEP_INVENTORY
  • KEEP_XP
  • DOUBLE_XP
  • FAST_RUN
  • SUPER_JUMP
  • DOUBLE_DAMAGE
  • NIGHT_VISION
  • FLY
  • FAST_MINING

Changing an item:
For the perkItem, you need to set everything, if you want to change it. It will work, if you just set the material, but the item probably would not look great. Here is a list of valid values for the material and here is a list of valid values for the enchantments . You can add as many enchantments as you want. Just use a key of the given list and a number for the enchantment level. 

perk  :  
  FLY  :  
    name   :  Fly Perk  
    permission   :  azoperks.perk.fly  
    guiItemSlot   :  52  
    toggleGuiItemSlot   :  51  
    item  :  
      material   :  FEATHER  
      displayname   :  '&cFly'  
      enchantments  :  
        silk_touch   :  2  
      lore   : 
        - '&2You can fly' 
        - '&2like in creative mode.'
Example Config (changed fly perk and double_xp perk)
perk  :  
  changestatus  :  
    success   :  '&7The perk &a  %perkname%&7 is now &a%status%&7.'   
    failure   :  '&7The status of the perk &c  %perkname%&7 could not be changed. It is  
      still &c  %status%&7.'   
  FLY  :  
    name   :  Fly Perk  
    permission   :  azoperks.perk.fly  
    guiItemSlot   :  52  
    toggleGuiItemSlot   :  51  
    item  :  
      material   :  FEATHER  
      displayname   :  '&cFly'  
      enchantments  :  
        silk_touch   :  2  
      lore   : 
      - '&2You can fly' 
      - '&2like in creative mode.'  
  DOUBLE_XP  :  
    name   :  Double XP  
    permission   :  azoperks.perk.doublexp  
    item  :  
      material   :  GOLDEN_SWORD  
      displayname   :  '&eDouble XP'  
      lore   : 
      - '&2You gain double xp.'  
command  :  
  perks  :  
    openPerksGUI   :  '&7You &asuccessfully &7opened the perks GUI.'  
  message  :  
    wrongUsage   :  '&7You used the command &c/  %command% &7the wrong way. Just try &c/%usage%&7.'   
    noPermission   :  '&7You have &cno permission&7 to perform the command &c/  %command%&7.'   
    noPlayer   :  '&cYou need to be a player to perform this action.'  
  perk  :  
    noPerk   :  '&7Plese enter a valid perk instead of &c  %noperk%&7.'   
prefix   :  '&7  [  &6AzoPerks&7  ]  &r '

GUI-Toggle Items:
You can change this 3 items at the path perk.toggleItem.<item>. For <item> you can use:

  • owned: Shown, when the perk is owned, but not active
  • unowned: Shown, when the perk is not owned and not active
  • active: shown, when the perk is active 
perk  :  
  toggleItem  :  
    owned  :  
      material   :  ROSE_RED  
      displayname   :  '&eOwned'  
      enchantments  :  
        efficiency   :  2  
      lore   : 
      - '&2You own this item.' 
      - '&2But you &cdid not&2 activate it.'  
    active  :  
      material   :  LIME_DYE  
      displayname   :  '&aActive'  
      enchantments  :  
        efficiency   :  10  
      lore   : 
      - '&2This perk is active.' 
      - '&2You can benefit from it.'
Example Config (with all changes above)
perk  :  
  changestatus  :  
    success   :  '&7The perk &a  %perkname%&7 is now &a%status%&7.'   
    failure   :  '&7The status of the perk &c  %perkname%&7 could not be changed. It is  
      still &c  %status%&7.'   
  toggleItem  :  
    owned  :  
      material   :  ROSE_RED  
      displayname   :  '&eOwned'  
      enchantments  :  
        efficiency   :  2  
      lore   : 
      - '&2You own this item.' 
      - '&2But you &cdid not&2 activate it.'  
    active  :  
      material   :  LIME_DYE  
      displayname   :  '&aActive'  
      enchantments  :  
        efficiency   :  10  
      lore   : 
      - '&2This perk is active.' 
      - '&2You can benefit from it.'  
  FLY  :  
    name   :  Fly Perk  
    permission   :  azoperks.perk.fly  
    guiItemSlot   :  52  
    toggleGuiItemSlot   :  51  
    item  :  
      material   :  FEATHER  
      displayname   :  '&cFly'  
      enchantments  :  
        silk_touch   :  2  
      lore   : 
      - '&2You can fly' 
      - '&2like in creative mode.'  
  DOUBLE_XP  :  
    name   :  Double XP  
    permission   :  azoperks.perk.doublexp  
    item  :  
      material   :  GOLDEN_SWORD  
      displayname   :  '&eDouble XP'  
      lore   : 
      - '&2You gain double xp.'  
command  :  
  perks  :  
    openPerksGUI   :  '&7You &asuccessfully &7opened the perks GUI.'  
  message  :  
    wrongUsage   :  '&7You used the command &c/  %command% &7the wrong way. Just try &c/%usage%&7.'   
    noPermission   :  '&7You have &cno permission&7 to perform the command &c/  %command%&7.'   
    noPlayer   :  '&cYou need to be a player to perform this action.'  
  perk  :  
    noPerk   :  '&7Plese enter a valid perk instead of &c  %noperk%&7.'   
prefix   :  '&7  [  &6AzoPerks&7  ]  &r '


(Command /perksinfo <player> [Ingame])

(Command /perksinfo <player> [Console])

(Perks GUI)


  • Better data caching for better performance
  • OfflinePlayer data saving (SQLite and MYSQL database)
  • More Perks (ideas in the disscussion section if you have any)
  • Your suggestions

Similar projects

Plugin →

Let Me Despawn

Improves performance by tweaking mob despawn rules. Say bye to pesky unintentional persistent mobs.

25MSueta

JourneyMap

Real-time map used for mapping in-game or your browser as you explore.

14.7MSueta

Emotecraft

Create your own emotes in Minecraft.

7.5MSueta

Simple Tpa

A simple tpa plugin which sends requests

5.4MSueta

Common Network

Forge and Fabric Unified Networking Solution

3.9MSueta

Set Home

A lightweight plugin for players to set their homes.

3.8MSueta