Titanium Perks

# TitaniumPerks **-------------------------------------------** This is an extended version of FancyPerks by Oliver Schlueter. As the original version of this plugin is not developed anymore by Oliver and the repo is even archived in Github, I hope this version can help out :) **-------------------------------------------** TitaniumPerks is a simple plugin that adds some fancy perks to your server. ## Prerequisites - Using a (https://papermc.io/downloads) based server is highly recommended.<br> - **Only supported for Minecraft version 1.21+**<br> - LuckPerms (otherwise big parts of the perks won't work as intended or not at all)<br> - Vault (otherwise, players cannot purchase perks) ## Commands ### Player commands: /perks - Opens the perks gui<br> /perks activate (perk | *) - _Activates the perk_<br> /perks deactivate (perk | *) - _Deactivates the perk_<br> ### Admin commands: /titaniumperks version - _Shows the current version_<br> /titaniumperks reload - _Reloads the config_<br> /titaniumperks getperksof (player) - get a list of active and inactive perks of the specified player<br> /titaniumperks activateperk (player) (perk) - enable perk for the specified player<br> /titaniumperks deactivateperk (player) (perk) - disable perk for the specified player<br> /titaniumperks grantperk (player) (perk) - grant player a perk for free so he does not have to buy it<br> /titaniumperks revokeperk (player) (perk) - revoke player's perk with no refund<br> /titaniumperks massgrantperk (perk) - grants a perk to all players /titaniumperks massrevokeperk (perk) - revokes a perk from all players It's strongly recommended to perform bulk actions like ``/titaniumperks massgrantperk *`` not in the times when the server is under heavy traffic (e.g. prime time with hundreds of live players). Truly, the mass tasks are desgned to run asynchronous to reduce lags, but it's not guaranteed that everything runs smoothly, especially on big servers with hundreds of players (keep in mind that also offline players are counting into that number!). #### General thoughts about admin commands: In short words: This plugin has no brain, use your own :) That means, the plugin assumes that as an admin you know what you are doing. So **the plugin does not** **check**, for example, **whether a perk is allowed in the player's world or whether the player has** **bought that perk at all** if you're using the admin commands (that's _your_ job as admin!). So if you fire an admin command, the plugin does exactly what you tell it to do (if it's possible). It is also important to keep in mind that if you activate, deactivate, enable or disable a perk for an online player, the player affected will receive a message about this and who did it. Also it is possible to disable a fly/levitation perk of players that are literally flying at that moment, keep in mind that such players should land first or they might hit the ground very hard. Remember to play fair, also as admin. :) #### About offline players Yes, you can change perk statuses for players that aren't online at the moment as long as they were online some time ago. But that has a little catch: if a player has activated an effect perk like strength, and you deactivate that perk, the effect will still remain active if the player comes back. This is due to the technical nature of offline players: you cannot add or clear any effect until that player is online. This might lead to ... unexpected states. ## Permissions To use a perk - ``titaniumperks.perk.(perk name)``<br> ## Available Perks | Perk ID | Name | Description | |---|---|---| | `fast_digging` | Fast Digging | Gives you the haste effect. | | `instabreak` | Instant Break | Enables you to instantly break (nearly) every block. | | `night_vision` | Night Vision | Gives you the night vision effect. | | `water_breathing` | Water Breathing | Gives you the water breathing effect. | | `speed` | Speed | Gives you the speed effect. | | `dolphins_grace` | Dolphins Grace | Lets you swim faster when diving. | | `slowness` | Slowness | Gives you the slowness effect. | | `glowing` | Glowing | Makes you glow. | | `strength` | Strength | Gives you the strength effect. | | `jumpboost` | Jump Boost | Gives you the jump boost effect. | | `health_boost` | Health Boost | Gives you extra hearts. | | `regeneration` | Regeneration | Gives you the regeneration effect. | | `fire_resistance` | Fire Resistance | Makes you fire-proof. | | `resistance` | Resistance | Gives you the resistance effect. | | `invisibility` | Invisibility | Makes you invisible. | | `levitation` | Levitation | Gives you the levitation effect. | | `luck` | Luck | Increases your luck when fishing. | | `slow_falling` | Slow Falling | Decreases damage when falling. | | `bad_omen` | Bad Omen | Gives you the bad omen effect. | | `hero_of_the_village` | Hero of the Village | Gives you the hero of the village effect. | | `keep_exp` | Keep EXP | Don't lose your EXP after