Cattol - Competitive PvP SMP Mod

Overview

Cattol is a PvP-focused mod designed for competitive SMP servers. It replaces the vanilla heart system with a custom life-based mechanic where players are banned when they run out of hearts. The mod also adds unique PvP items that are carefully balanced for skill-based combat - no one-shots, no chain stuns, just readable fights where player skill matters most.

Features

Custom Heart System: Players start with 10 hearts (max 20). At 0 hearts, you're automatically banned with the message "Out of Hearts"
Heart Items: Withdraw your hearts into tradeable Nether Star items using /withdrawheart, or consume them to regain max health
PvP Items: 7 unique items across 4 categories:
- Engage: Swift Katana (speed boost), Inferno Blade (fireball launcher), Frost Blade (applies slow)
- Mobility: Grappling Hook (pull to blocks), Wind Mace (dash in any direction)
- Control: Guard Breaker Hammer (breaks shields, ground slam)
- Utility: Guardian Shield (blocks one attack with cooldown)
Admin Control: Full GUI-based admin panel to manage hearts and items in real-time
Action Bar Feedback: Cooldowns and active effects display on your action bar, updating every 0.5 seconds

How to Use

Player Commands

/hearts - Open your heart display GUI
/balance - See your current heart count
/withdrawheart - Convert 1 max heart into a Heart Item (Nether Star)
Right-click a Heart Item to consume it and regain +1 max heart

Admin Commands

/cattoladmin gui - Open the main admin control panel
/cattoladmin hearts <player> set <amount> - Set a player's hearts
/cattoladmin hearts <player> add <amount> - Give hearts to a player
/cattoladmin hearts <player> remove <amount> - Take hearts from a player
/cattoladmin giveitem <player> <itemid> - Give custom items (grapplinghook, shield, katana, hammer, fireballsword, freezesword, dashmace)
/hearts <player> - View and manage a specific player's hearts via GUI

Using Custom Items

All custom items are used by right-clicking:

Most have cooldowns shown on your action bar
Items cannot be crafted or found in loot - they must be given by admins
Items have infinite durability and respect vanilla armor/enchantments

Tips & Tricks

Katana + Dash Mace: Hold the Katana for passive speed, then dash with the mace for aggressive engages
Shield Timing: The Guardian Shield blocks ONE attack - time it carefully against big hits
Freeze + Fireball: Slow enemies with the Frost Blade, then knock them back with a fireball while they can't escape
Grappling Hook: Works on any block - use it for vertical escapes or rapid repositioning

Known Limitations

Heart data is stored in a server-side JSON file - make backups before major changes
The freeze effect from Frost Blade applies to all LivingEntities, not just players
Grappling Hook pulls directly to the hit point - be careful near void or lava