mcMMO Multiplier

ABOUT
This gives you the ability to give players mcMMO experience multipliers for a specific skill, or every skill. Every multiplier will self expire after its time is up.

DEPENDENCIES ** = required

• ** mcMMO (built against mcMMO v1.6.0-SNAPSHOT https://ci.ecocitycraft.com/job/McMMO/7/ )
  • You will need to install the mcMMO version compatible with your server version.
• PlaceholderAPI (built against PlaceholderAPI 2.8.4)

** System Dependency: Java 8 **

PlaceholderAPI placeholders:
%mcmmomultiplier_global_current_multiplier% - Current global multiplier
%mcmmomultiplier_global_current_multiplier_skill% - Current global multiplier's skill
%mcmmomultiplier_individual_current_multiplier% - Personal multiplier
%mcmmomultiplier_individual_current_multiplier_skill% - Personal multiplier's skill

COMMANDS (and aliases)
/mcmmomultiplier give <player> <type> <skill> <duration> <amount> <multiplier>
/mcmmomultiplier giveall <type> <skill> <duration> <amount> <multiplier>
/mcmmomultiplier remove <player> <id>
/mcmmomultiplier removeall <player>
/mcmmomultiplier check <player>
/mcmmomultiplier view
/mcmmomultiplier applied
/mcmmomultiplier tip <player>
/mcmmomultiplier quiet
/mcmmomultiplier end <player> <id>
/mcmmomultiplier reload

aliases: [mcmmom, mmultiplier]

AVAILABLE TYPES
There are two types of multipliers. Global and Individual . As their name suggests, global will affect all players. Individual will affect the possessor of the multiplier only.

AVAILABLE SKILLS
You can view all the available mcMMO skills on the wiki:
https://github.com/mcMMO-Dev/mcMMO/wiki/Skills

* If you would like to specify a multiplier for all skills, simply specify 'all'

OTHER COMMAND META

• Duration is counted for in seconds. Duration seconds must be greater than 0. This 0 rule applies for other number arguments, too. If you aren't the braniac to figure out how many seconds are in an interval you want, you can use this: https://www.calculateme.com/Time/Seconds/ToMinutes.htm

• Players may only receive by command and in sum total, the max number of multipliers in the config. The current default, 300 is a reasonable number, no need to change it to anything super high.
• Multipliers can be of any decimal greater than or equal to 1 .
• To get a certain ID of a multiplier, view a player's multipliers with the check command.

PERMISSIONS
Access base command & View Usage: mcmmomultiplier.command
Give multipliers: mcmmomultiplier.give
Give everyone a multiplier: mcmmomultiplier.giveall
Remove multipliers: mcmmomultiplier.remove
Remove All multipliers: mcmmomultiplier.removeall
Check multipliers: mcmmomultiplier.check
View own multipliers: mcmmomultiplier.view
View all active multipliers: mcmmomultiplier.applied
Tip a multiplier owner: mcmmomultiplier.tip
Toggle earned experience messages: mcmmomultiplier.quiet
End multiplier: mcmmomultiplier.end
Reload configuration: mcmmomultiplier.reload
Update notification : mcmmomultiplier.updatecheck

USAGE
You can view functionality through commands and how to remove & start your multiplier with the view command. Majority, if not all messages are configurable.

CONFIGURATION wwwwwww

[  /SIZE  ]  
 ##################################################################################################################################  
 #   ███╗   ███╗ ██████╗███╗   ███╗███╗   ███╗ ██████╗ ███╗   ███╗██╗   ██╗██╗  ████████╗██╗██████╗ ██╗     ██╗███████╗██████╗    #  
 #   ████╗ ████║██╔════╝████╗ ████║████╗ ████║██╔═══██╗████╗ ████║██║   ██║██║  ╚══██╔══╝██║██╔══██╗██║     ██║██╔════╝██╔══██╗   #  
 #   ██╔████╔██║██║     ██╔████╔██║██╔████╔██║██║   ██║██╔████╔██║██║   ██║██║     ██║   ██║██████╔╝██║     ██║█████╗  ██████╔╝   #  
 #   ██║╚██╔╝██║██║     ██║╚██╔╝██║██║╚██╔╝██║██║   ██║██║╚██╔╝██║██║   ██║██║     ██║   ██║██╔═══╝ ██║     ██║██╔══╝  ██╔══██╗   #  
 #   ██║ ╚═╝ ██║╚██████╗██║ ╚═╝ ██║██║ ╚═╝ ██║╚██████╔╝██║ ╚═╝ ██║╚██████╔╝███████╗██║   ██║██║     ███████╗██║███████╗██║  ██║   #  
 #   ╚═╝     ╚═╝ ╚═════╝╚═╝     ╚═╝╚═╝     ╚═╝ ╚═════╝ ╚═╝     ╚═╝ ╚═════╝ ╚══════╝╚═╝   ╚═╝╚═╝     ╚══════╝╚═╝╚══════╝╚═╝  ╚═╝   #  
 ##################################################################################################################################   
global-multiplier-announcement   :  '&b  %player%&a has started a global &e%multiplier%x&a mcmmo exp multiplier for skill &d%skill%&a for &b%duration%!'   
global-multiplier-announcement-self   :  '&bYou&a have begun a global mcmmo exp multiplier of &e  %multiplier%x&a for skill &d%skill%&a for &b%duration%!'   
individual-multiplier-announcement   :  '&bYou&a have started a &e  %multiplier%x&a mcmmo exp multiplier for skill &d%skill%&a for &b%duration%!'  
 
global-multiplier-end-announcement   :  '&b  %player%''s&c global &e%multiplier%x&c mcmmo exp multiplier for &d%skill%&c has ended!'   
global-multiplier-end-announcement-self   :  '&cYour global mcmmo exp multiplier of &e  %multiplier%x&c for &d%skill%&c has ended!'   
individual-multiplier-end-announcement   :  '&cYour &e  %multiplier%x&c mcmmo exp multiplier for &d%skill%&c has ended!'  
 
multiplier-has-none   :  '&cYou do not have  any  multipliers!'  
multiplier-must-be-player   :  '&cOnly players can execute this!' 
 
multiplier-given   :  '&aYou have given &b  %player% &2%amount% &5%type% &e%multiplier%x&a multiplier of &b&n%duration%&a for skill &d%skill%&a!'   
multiplier-received   :  '&aYou received &2  %amount% &5%type% &e%multiplier%x &amultiplier of &b&n%duration%&a for skill &d%skill%&a! Activate it with &e/mcmmomultiplier view&a!'  
 
global-multiplier-sound-announcement   :  LEVEL_UP  
global-multiplier-end-sound   :  WITHER_DEATH 
 
individual-multiplier-sound-announcement   :  LEVEL_UP  
individual-multiplier-end-sound   :  WITHER_DEATH 
 
tipping-enabled   :  true  
tipping-amount   :  500 
 
tipping-cannot-tip-self   :  '&cYou cannot tip yourself.'  
tipper-already-tipped   :  '&cYou have already tipped  %owner%.'   
tipping-not-enabled   :  '&cTipping is not enabled.'  
tipping-has-no-multiplier   :  '&c  %player% does not have any multipliers.'  
 
tipper-not-enough-money   :  '&cYou need &6$  %amount%&c to tip &b%owner%&c.'  
 
tip-received   :  '&b  %tipper%&a tipped you &6$%amount%&a!'  
 
tipped-successful   :  '&aYou tipped &b  %owner% &6$%amount%&a. For being generous, you were given &d5 diamonds&a!'   
tipped-successful-commands   : 
     - 'give  %tipper% diamond 5'  
 
max-multipliers   :  300  
max-multipliers-exceeded   :  '&cPlayers can only hold up to  %max% multipliers.'  
 
multiplier-inventory-name   :  '  %player%''s Exp Multipliers (%total%)'   
multiplier-inventory-icon   :  MAGMA_CREAM;0  
multiplier-inventory-previous-page-button-icon   :  ARROW;0  
multiplier-inventory-next-page-button-icon   :  ARROW;0  
multiplier-inventory-icon-name   :  '&aExp Multiplier  (  &d  %skill%&a) %multiplier%x'   
multiplier-inventory-icon-lore   : 
     - '&7Exp multiplier' 
     - ' '  
     - '&aRemaining   :   &b%remaining%'   
     - '&aAmount   :   &b%multiplier%x'   
     - '&aType   :   &b%type%'   
     - '&aActive   :   &b%active%'   
     - '&aSkill   :   &b%skill%'  
     - ' ' 
     - '&dLeft-Click to use this multiplier!' 
     - '&5Shift + Left-Click to delete this multiplier!'  
multiplier-inventory-icon-glow-if-active   :  true  
multiplier-inventory-next-page-button-icon-name   :  '&aNext Page'  
multiplier-inventory-previous-page-button-icon-name   :  '&cPrevious Page'  
multiplier-all-inventory-name   :  '  All  Multipliers  (   %total%)'   
multiplier-all-inventory-icon   :  DIAMOND;0  
multiplier-all-inventory-previous-page-button-icon   :  ARROW;0  
multiplier-all-inventory-next-page-button-icon   :  ARROW;0  
multiplier-all-inventory-icon-name   :  '&aExp Multiplier  (  &d  %skill%&a) %multiplier%x'   
multiplier-all-inventory-icon-lore   : 
     - '&7Exp multiplier' 
     - ' '  
     - '&6&lSTARTED BY   :   &e&n%owner%'  
     - ' '  
     - '&aRemaining   :   &b%remaining%'   
     - '&aAmount   :   &b%multiplier%x'   
     - '&aType   :   &b%type%'   
     - '&aSkill   :   &b%skill%'  
     - ' ' 
     - '&e&nCLICK TO TIP!'  
multiplier-all-inventory-next-page-button-icon-name   :  '&aNext Page'  
multiplier-all-inventory-previous-page-button-icon-name   :  '&cPrevious Page'  
multiplier-all-inventory-icon-glow-if-active   :  false  
multiplier-none-active   :  '&cThere are  no  active multipliers.'  
multiplier-already-ended   :  '&cThis multiplier has already ended.'  
player-has-no-multipliers   :  '&c  %player% has no modifiers.'   
player-has-no-multiplier-of-id   :  '&cThe player  %player% does not have a multiplier with ID: %id%'   
multiplier-modified-xp   :  '&a&n+  %extra%&a extra xp &afrom&b %player%''s&a mcmmo exp multiplier for &d%skill% &a(&6&l%multiplier%x&a) &e[%remaining%]! %tip-message%'   
multiplier-modified-xp-click-tip-message   :  '&a&nClick to tip them&a!'  
multiplier-modified-xp-click-tip-message-hover   :  '&e&nClick here to tip &b  %owner%&6 $%amount%.'   
multiplier-modified-xp-individual   :  '&a&n+  %extra%&a extra xp &afrom&b your&a mcmmo exp multiplier for &d%skill% &a(&6&l%multiplier%x&a) &e[%remaining%]!'   
multiplier-notification-click-to-tip   :  true  
multiplier-cannot-start-when-started   :  '&cThis multiplier is already started.'  
multiplier-cannot-remove-when-started   :  '&cYou cannot remove a multiplier while it''s already been started.'  
multiplier-removed-self   :  '&cYou have removed your multiplier.'  
multiplier-removed-other   :  '&cYou have removed  %player%''s multiplier.'   
multiplier-removed-all   :  '&cYou have removed  all  of  %player%''s multipliers.'   
multiplier-ended   :  '&cYou have ended  %player%''s multiplier.'   
multiplier-not-running   :  '&cThis multiplier is not running.'  
max-multipliers-activated-at-once   :  2  
max-multipliers-already-activated   :  '&cYou can only have  %max% multipliers enabled at once.'   
multiplier-quiet-enable-success   :  '&aYou will  no  longer receive multiplier messages.'  
multiplier-quiet-disable-success   :  '&aYou will now receive multiplier messages.'  
multiplier-global-max-stack   :  3  
multiplier-individual-max-stack   :  3  
max-multipliers-stack-reached   :  '&cThere can only be  %limit% multipliers of %skill% active at once.'   
received-message-enabled   :  true 
 
multiplier-check   : 
     - '&d&m  ---------------------------------------------  -' 
     - '&7Multipliers for &b  %player%'  
     - ' ' 
     - '&a  %multipliers%'  
     - '&d&m  ---------------------------------------------  -' 
 
player-not-online   :  '&cThe player  %player% is not online.'   
player-never-played   :  '&cThis player has never played before.' 
 
command-usage   : 
     - '&d&m  ---------------------------------------------  -' 
     - '&7Command Help' 
     - ' ' 
     - '&e/mcmmomultiplier give <player> <type> <skill> <duration> <amount> <multiplier>' 
     - '&e/mcmmomultiplier giveall <type> <skill> <duration> <amount> <multiplier>' 
     - '&e/mcmmomultiplier remove <player> <id>' 
     - '&e/mcmmomultiplier removeall <player>' 
     - '&e/mcmmomultiplier check <player>' 
     - '&e/mcmmomultiplier view' 
     - '&e/mcmmomultiplier applied' 
     - '&e/mcmmomultiplier tip <player>' 
     - '&e/mcmmomultiplier quiet' 
     - '&e/mcmmomultiplier end <player> <id>' 
     - '&e/mcmmomultiplier reload' 
     - '&d&m  ---------------------------------------------  -' 

 
command-no-permission   :  '&cYou can''t do this, silly.'  
command-no-one-online   :  '&cThere is  no  one online.'  
command-reload-successful   :  '&aConfiguration has been reloaded successfully.' 
 
opted-out-users-received-message   :   [   ]  
 [  SIZE=6  ]

Available server sounds & materials:
https://gist.github.com/NiklasEi/7bd0ffd136f8459df0940e4501d47a8a
https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html

* Not all may be available for versions older than 1.13.2, as they represent 1.13 values.
* For servers not using 1.13.x builds, you will need to specify any durability values for varied marterials (i.e Colored Glass). This is not needed for 1.13.x servers.

OTHER

• Planned refactoring of some of the techniques used, to support better implementation. One of these includes a better offline player fetching system.
• Single, not lists, configuration messages can have multiple lines. This can be achieved using \n to start a new line.
• Experience, due to how mcMMO works, will not be gained if the player is in creative mode.
• Broadcast messages, as of now, can be opted out by simply leaving the message blank in the configuration.

BUGS
If you discover a bug I may have missed, you can feel free to discuss the problem in the discussion page.

* Support will not be provided for older versions of the plugin or server software builds.