RoodyPvP

RoodyPvP handles combat: combat tag, combat-log punishment, anti-escape from safe zones, protections, cooldowns and loot protection. It is made to live with RoodyStaff, WorldGuard and Essentials.

Commands, permissions and default messages are in Spanish. Every text can be changed in messages.yml.

#Installation

License: after the first start, paste your key (from My account) in plugins/RoodyPvP/license.yml and restart. Without a valid key the plugin does not start. Once checked, it keeps working for 14 days offline.

Updates: when a new version is out, the console says so and ops (permission roodypvp.update) get a message with the download link when they join. Turn it off with avisar-actualizaciones: false in config.yml.

1. Put RoodyPvP-<version>.jar in plugins/ and restart.
2. Review the list of commands allowed in combat in config.yml.

Optional: WorldGuard (safe zones and anti-escape), Essentials, PlaceholderAPI, RoodyStaff. Works from 1.20.4 to 1.21.x.

#Combat

• 15 s from the last hit: melee, arrows, tridents, TNT, splash or lingering potions. Hits without damage do not count.
• Action bar with a bar and the enemy's health, boss bar and glow (all configurable). Entering combat closes the inventory.
• In combat: only whitelisted commands (plus staff commands for roodystaff.mod), no command teleports (/spawn, /home, /tpa, /warp…) and no vanilla portals. Ender pearls and wind charges renew the tag.
• Hitting removes flight from both, Essentials god mode and creative from the attacker.

#Combat logging

Quitting, switching server or being kicked while tagged: the player dies, drops their items, the kill goes to their enemy (it counts for RoodyBounties and statistics), it is announced and logged in desconexiones.log. Server restarts, staff freezes and anti-abuse kicks do not count.

#Anti-escape

With WorldGuard: tagged players cannot enter a region with pvp: deny (they are pushed out), not even with a pearl or chorus fruit, and they see a red glass wall (only them) at the edge of nearby safe zones.

#Protections and cooldowns

• Newbies: 10 minutes of play time protected (boss bar; /pvp activar removes it).
• Respawn: 3 s.
• /pvp desactivar with the roodypvp.alternar permission (out of combat, with a cooldown).
• Item cooldowns with the vanilla overlay: in combat (pearl 5 s, wind charge 1 s) and always (golden apple 30 s, enchanted 60 s).

#Deaths

Killer-only loot for 20 s, anti-abuse (same pair 5 times in 20 s → commands, kick by default), commands on every kill and respawn without the death screen. Dying in combat from a fall, lava or /kill gives the kill to the last enemy.

#Staff

Players in vanish, staff mode or spectating someone (RoodyStaff, or the vanished metadata of any plugin) never enter combat and have no restrictions. A frozen player leaves combat and is not punished for logging out.

#Commands

roodypvp.bypass.comandos (nobody by default): any command in combat.

#Placeholders

For other plugins, every tagged player carries the roodypvp.combate metadata (seconds left). RoodyPortals uses it to block its portals.

#Files

• config.yml — combat, display, in-combat rules, logout, protections, anti-escape, deaths and staff, all commented.
• messages.yml — texts.
• datos.yml — newbies and who has PvP turned off.
• desconexiones.log — every combat log.