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 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)

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 dying.
keep_inventory	Keep Inventory	Don't lose your items after dying.
fly	Fly	Gives you the ability to fly.
vanish	Vanish	Hide from all players.
god	God	Don't take any damage.
no_hunger	No Hunger	You will never get hungry again.
no_fire_damage	No Fire Damage	Don't get hurt by fire.
no_fall_damage	No Fall Damage	Don't get hurt by fall damage.
no_explosion_damage	No Explosion Damage	Don't get hurt by explosions.
no_poison_damage	No Poison Damage	Don't take damage from poisoning.
no_projectile_damage	No Projectile Damage	Don't take damage from projectiles like arrows.
no_frost_damage	No Frost Damage	Don't take damage when frozen.
no_block_damage	No Block Damage	Don't take (most) block-related damage.
half_damage	Half Damage	Reduce the damage you receive by half.
mobs_ignore	Mobs Ignore	Mobs don't notice you anymore.
double_exp	Double EXP	Receive double EXP for killing monsters.
triple_exp	Triple EXP	Receive triple EXP for killing monsters.
double_mob_drops	Double Mob Drops	Receive double drops for killing mobs.
telekinesis	Telekinesis	Automatically picks up mined blocks and items.
instant_smelt	Instant Smelt	Automatically smelts ores when mined.
auto_repair	Auto Repair	Your tools and armor won't lose durability.
auto_planting	Auto Planting	Automatically replants crops when harvested.
lava_runner	Lava Runner	Allows you to walk on lava (lava turns to obsidian). ⚠️ Disabled by default (experimental).
drop_more_blocks	Drop More Blocks	Some blocks will drop that usually wouldn't.
drop_spawners	Drop Mob Spawners	Mob spawners drop when mined (without keeping the mob).