❤️ HeartBound - Feature Checklist
🎮 Core Gameplay Features
- Dynamic Lifesteal System - Gain hearts on kills, lose hearts on death
- Configurable Heart Limits - Set minimum, maximum, and starting hearts
- Environmental Death Support - Lava, fall, void, and other deaths deduct hearts
- Bypass Permissions - VIP/Admin players can bypass lifesteal mechanics
- Auto-Save System - Player data saves every 5 minutes automatically
⚔️ Combat & Elimination
- Kill Detection - Tracks player vs player kills accurately
- Death Tracking - Records all death types and causes
- Kill Streaks - Tracks current and maximum kill streaks
- Elimination Threshold - Players eliminated at 0 hearts
- 3 Elimination Modes:
- 👻 Spectator Mode - Eliminated players become spectators with Night Vision
- 🛡️ Adventure Mode - Eliminated players become invulnerable adventurers
- 🚫 Ban Mode - Eliminated players are banned from the server
- Elimination Broadcasts - Custom messages when players fall
- Death Sound Effects - Wither spawn sound on elimination
🔮 Secret Revival System
- Hidden Crafting Recipes - Not shown in vanilla recipe book
- Heart Crystal - Crafted from diamond (center slot)
- Soul Fragment - Crafted from echo shard (center slot)
- Revival Totem - Crafted from Heart Crystal + Soul Fragment + Totem of Undying
- Revival Cooldowns - Prevents spam revival (configurable)
- Revival Particles - Totem of Undying cloud effect on successful revival
- Revival Sounds - Toast challenge, level up, and villager cure sounds
- Revival Broadcasts - Custom messages when players are revived
- Admin Revive Command - Force revive eliminated players
📊 Statistics & Leaderboards
- Comprehensive Stats Tracking:
- Total Kills
- Total Deaths
- Current Kill Streak
- Maximum Kill Streak
- Players Revived
- Players Eliminated
- Total Playtime (formatted as hours/minutes/seconds)
- Multiple Leaderboards:
- 💖 Top Hearts
- ⚔️ Top Kills
- 🔥 Top Kill Streaks
- ✨ Top Revives
- 🛡️ Top Survivors
- GUI Leaderboard Menu - Beautiful interactive menu
- Chat Leaderboard - Text-based rankings
- Player Head Icons - Custom trophy heads with lore
🎨 Premium GUI System
- Custom GUI Builder - Professional menu framework
- Interactive Borders - Black stained glass pane borders
- Click Sounds - UI button click feedback
- Main Admin Menu - Central hub for admin commands
- Leaderboard GUI - View top players in categories
- Stats GUI - Personal statistics display
- Custom Titles - Gradient menu titles
- Navigation Buttons - Back/Close functionality
🗄️ Database & Performance
- SQLite Support - Built-in local database (no setup required)
- MySQL Support - Remote database for multi-server networks
- HikariCP Connection Pooling - High-performance database connections
- Asynchronous Queries - Zero-lag database operations
- In-Memory Caching - Instant command and GUI responses
- Auto-Reconnect - Handles database connection drops
- Connection Pool Configuration - Customizable pool size
- Database Migration System - Automatic schema updates
🎁 Custom Items System
- Heart Crystal:
- Material: Nether Star base
- CustomModelData: 10001
- Gradient display name (red to gold)
- Custom lore
- PersistentDataContainer security
- Soul Fragment:
- Material: Echo Shard base
- CustomModelData: 10002
- Gradient display name (purple to gray)
- Custom lore
- PersistentDataContainer security
- Revival Totem:
- Material: Totem of Undying base
- CustomModelData: 10003
- Gradient display name (green to gold)
- Detailed usage instructions in lore
- PersistentDataContainer security
⌨️ Commands
- Player Commands:
-
/hearts- Check current hearts and elimination status -
/stats- View personal detailed statistics -
/top- Open leaderboard GUI -
/top <type>- View specific leaderboard in chat
-
- Admin Commands:
-
/heartboundor/hb- Open admin GUI menu -
/hb reload- Reload configuration files -
/hb revive <player>- Force revive eliminated player -
/hb eliminate <player>- Instantly eliminate player -
/hb hearts <player> <amount>- Set player hearts -
/hb recipe- Show secret recipe information
-
- Tab Completion - Full tab completion for all commands
🔐 Permissions
-
heartbound.admin- Access to all admin commands (Default: OP) -
heartbound.use- Access to player commands (Default: True) -
heartbound.bypass- Bypass lifesteal mechanics (Default: OP)
🔌 Third-Party Integrations
- PlaceholderAPI:
-
%heartbound_hearts%- Current hearts -
%heartbound_is_eliminated%- Elimination status -
%heartbound_kills%- Total kills -
%heartbound_deaths%- Total deaths -
%heartbound_streak%- Current kill streak -
%heartbound_max_streak%- Maximum kill streak -
%heartbound_revives%- Total revives -
%heartbound_playtime%- Formatted playtime
-
- LuckPerms:
- Auto-assign temporary chat prefixes based on heart milestones
- Configurable prefix priorities
- Automatic prefix removal on heart loss
- Vault:
- Economy rewards for kills
- Economy rewards for revivals
- Configurable reward amounts
- Support for any economy plugin
⚙️ Configuration
- config.yml:
- Heart settings (min, max, start, kill gain, death loss)
- Elimination settings (mode, broadcast message)
- Economy settings (enable/disable, reward amounts)
- LuckPerms integration toggle
- messages.yml:
- Customizable prefix with gradient
- No permission message
- Player not found message
- Reload success message
- Hearts view message
- Stats view message (multi-line)
- Elimination broadcast
- Revival broadcast
- Cooldown messages
- database.yml:
- Database type selection (SQLITE/MYSQL)
- MySQL connection details (host, port, database, username, password)
- Connection pool size configuration
- gui.yml:
- GUI titles
- Border material and CustomModelData
- recipes.yml:
- Enable/disable individual recipes
- Custom crafting shapes
- Ingredient configuration
- items.yml:
- CustomModelData for each item
- Display names with MiniMessage formatting
- Custom lore lines
🎨 Resource Pack Support
- 100% Vanilla Compatible - No OptiFine or CIT required
- CustomModelData System - Standard Minecraft item override
- Force Pack Support - Works with server.properties resource pack forcing
- Custom Textures:
- Heart Crystal texture (16x16 or higher)
- Soul Fragment texture (16x16 or higher)
- Revival Totem texture (16x16 or higher)
- No Custom Sounds Required - Uses vanilla sounds only
- No Custom Fonts Required - Uses standard Minecraft font
🏗️ Technical Features
- Java 21 - Built with modern Java features
- Paper API 1.21+ - Optimized for latest Paper servers
- Adventure API - Modern text formatting with MiniMessage
- Maven Build System - Professional dependency management
- Maven Shade Plugin - Bundles all dependencies in one JAR
- Async Task Handling - Non-blocking database operations
- Event-Driven Architecture - Efficient listener system
- Component Logger - Modern Paper logging with MiniMessage
- Error Handling - Graceful failure recovery
- Data Validation - Input sanitization and type checking
📦 Distribution
- Single JAR File - ~17MB with all dependencies included
- No External Dependencies - Everything bundled
- MIT License - Open source and permissive
- GitHub Repository - Public source code
- GitHub Releases - Pre-compiled downloads
- Professional README - Documentation and examples
- .gitignore - Clean repository (no compiled files)
🎯 Performance Optimizations
- Connection Pooling - Reusable database connections
- In-Memory Cache - Reduces database queries
- Batch Operations - Efficient bulk data handling
- Lazy Loading - Load data only when needed
- Async Database - No main thread blocking
- Efficient Event Listeners - Minimal overhead
- Optimized GUI Rendering - Fast menu generation
Total Features Implemented: 150+ ✅
Ready for Production: Yes! 🚀