Titanium Perks

Get support at Discord

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

-------------------------------------------

!!! OVER 50 PERKS AVAILABLE !!!

TitaniumPerks is a simple plugin that adds some fancy perks to your server.

Prerequisites

• Using a paper based server is highly recommended.
  
  
• Only supported for Minecraft version 1.21+
  
  
• LuckPerms (otherwise big parts of the perks won't work as intended or not at all)
  
  
• Vault (otherwise, players cannot purchase perks)

Commands
Player commands:
/perks - Opens the perks gui
/perks activate (perk | *) - Activates the perk
/perks deactivate (perk | *) - Deactivates the perk

Admin commands:
/titaniumperks version - Shows the current version
/titaniumperks reload - Reloads the config
/titaniumperks getperksof (player) - get a list of active and inactive perks of the specified player
/titaniumperks activateperk (player) (perk) - enable perk for the specified player
/titaniumperks deactivateperk (player) (perk) - disable perk for the specified player
/titaniumperks grantperk (player) (perk) - grant player a perk for free so he does not have to buy it
/titaniumperks revokeperk (player) (perk) - revoke player's perk with no refund
/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)

TitaniumPerks currently provides **51 perks**. The following list contains all currently implemented perks, sorted alphabetically by their English name:

| ID | Name | Function |
|---|---|---|
| `auto_harvest` | Auto Harvest | Harvests fully grown crops by right-clicking and automatically replants them. |
| `auto_planting` | Auto Planting | Automatically replants supported crops after harvesting. |
| `auto_repair` | Auto Repair | Prevents durability loss for tools and armor or automatically repairs them. |
| `bad_omen` | Bad Omen | Provides the Bad Omen effect. |
| `dolphins_grace` | Dolphins Grace | Increases swimming speed while swimming or diving. |
| `double_exp` | Double EXP | Grants double experience from supported experience rewards. |
| `double_mob_drops` | Double Mob Drops | Grants double drops from mobs. |
| `drop_more_blocks` | Drop More Blocks | Allows certain blocks to produce additional or normally unavailable drops. |
| `emergency_heal` | Emergency Heal | Automatically heals the player when their health becomes critically low, using a configurable threshold, heal amount and cooldown. |
| `fast_digging` | Fast Digging | Grants the Haste effect and speeds up block breaking. |
| `fast_swim` | Fast Swim | Provides an additional swimming-speed effect for significantly faster movement in water. |
| `fire_resistance` | Fire Resistance | Protects the player from fire and fire-related damage. |
| `fly` | Fly | Allows the player to fly. |
| `glowing` | Glowing | Makes the player glow. |
| `god` | God | Prevents the player from taking damage. |
| `half_damage` | Half Damage | Reduces incoming damage by half. |
| `health_boost` | Health Boost | Increases maximum health and provides additional hearts. |
| `hero_of_the_village` | Hero of the Village | Provides the Hero of the Village effect. |
| `instant_smelt` | Instant Smelt | Automatically smelts suitable ores. |
| `instabreak` | Instant Break | Allows blocks to be broken almost instantly. |
| `invisibility` | Invisibility | Makes the player invisible. |
| `jumpboost` | Jump Boost | Increases the player's jump height. |
| `keep_exp` | Keep EXP | Prevents experience loss when the player dies. |
| `keep_inventory` | Keep Inventory | Prevents items from being lost when the player dies. |
| `lava_runner` | Lava Runner | Allows the player to walk across lava by temporarily bridging the lava below the player. Experimental. |
| `levitation` | Levitation | Provides the Levitation effect. |
| `lifesteal` | Lifesteal | Restores a configurable percentage of damage dealt as health. |
| `luck` | Luck | Increases luck, for example while fishing. |
| `mobs_ignore` | Mobs Ignore | Causes mobs to ignore the player instead of normally targeting them. |
| `night_vision` | Night Vision | Provides night vision. |
| `no_block_damage` | No Block Damage | Prevents most damage caused by blocks. |
| `no_explosion_damage` | No Explosion Damage | Prevents damage caused by explosions. |
| `no_fall_damage` | No Fall Damage | Prevents fall damage. |
| `no_fire_damage` | No Fire Damage | Prevents fire damage. |
| `no_frost_damage` | No Frost Damage | Prevents damage caused by freezing or frost. |
| `no_hunger` | No Hunger | Prevents the player's hunger level from decreasing. |
| `no_poison_damage` | No Poison Damage | Prevents poison damage. |
| `no_projectile_damage` | No Projectile Damage | Prevents damage from projectiles such as arrows. |
| `regeneration` | Regeneration | Provides the Regeneration effect and restores health over time. |
| `resistance` | Resistance | Provides the Resistance effect and reduces incoming damage. |
| `slowness` | Slowness | Applies the Slowness effect and reduces movement speed. |
| `slow_falling` | Slow Falling | Applies Slow Falling and reduces fall damage. |
| `speed` | Speed | Increases the player's movement speed. |
| `step` | Step | Allows the player to walk up one-block edges without jumping. |
| `strength` | Strength | Provides the Strength effect and increases melee damage. |
| `telekinesis` | Telekinesis | Automatically collects dropped items when mining or picking them up. |
| `triple_exp` | Triple EXP | Grants triple experience from supported experience rewards. |
| `vanish` | Vanish | Hides the player from other players. |
| `water_breathing` | Water Breathing | Allows the player to breathe underwater. |
| `water_walk` | Water Walk | Allows the player to walk across water without sinking. |

### Experimental features

The `lava_runner` perk should be tested carefully before being enabled on a production server because it changes lava behavior and can affect gameplay and existing builds.