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