UltimateHealthDisplay

** 🎮 UltimateHealthDisplay - Complete Plugin Description 📋 **Overview** **UltimateHealthDisplay** is a premium-quality, highly optimized health display plugin for Minecraft Paper servers (1.21-1.21.11). It elegantly shows the health of any entity (mob or player) you're looking at directly in your action bar, featuring multiple beautiful display styles, extensive plugin compatibility, and performance-first design. Unlike basic health display plugins, UltimateHealthDisplay seamlessly integrates with popular custom mob plugins (MythicMobs, LevelledMobs), respects region protection (WorldGuard), and intelligently avoids conflicts with other action bar plugins. --- ✨ **Key Features** 🎨 **6 Pre-Built Display Styles** Choose from professionally designed health bar styles or create your own: | Style | Description | Example Display | |-------|-------------|-----------------| | **Hearts** | Classic Minecraft hearts | `Zombie: ❤❤❤❤❤❤❤♥♥♥` | | **Bars** | Modern progress bar | `Skeleton: ████████▌` | | **Lines** | Pipe-based indicator | `Creeper - ` | | **Numbers** | Simple numeric HP | `Steve: 19.5 / 20.0` | | **RPG** | Role-playing game style | ` HP: ■■■■■■□□□□ (600/1000)` | | **Minimalist** | Clean modern dots | `Warden • ●●●●●●●●●○ • 485.2` | 🔌 **Extensive Plugin Compatibility** **Fully Integrated With:** - ✅ **Citizens** - Ignore NPC health displays - ✅ **MythicMobs** - Shows custom mob names, health, and levels - ✅ **WorldGuard** - Region-based blacklist system - ✅ **PlaceholderAPI** - Use any PAPI placeholder in displays - ✅ **WildStacker** - Compatible with stacked entities - ✅ **AuraMobs** - Custom mob support - ✅ **MobArena** - Works in arena environments - ✅ **McMMO** - No conflicts with McMMO displays **Plus compatibility with:** - SimpleTabList, TAB, ScoreboardStatsX (no action bar conflicts) ⚡ **Performance Optimized** - **Smart Caching System** - Reduces redundant calculations - **Camera Movement Detection** - Only updates when needed - **Async Ray Tracing** - Non-blocking entity detection - **Configurable Update Rate** - Balance responsiveness vs performance - **Memory Efficient** - Minimal RAM footprint - **No TPS Impact** - Designed for high-player-count servers 🎯 **Advanced Features** - **Conflict Prevention** - Automatically yields to other action bar plugins - **Custom Entity Names** - Reads display names from custom mob plugins - **Dynamic Health Scaling** - Works with any health value (vanilla to 999999+) - **Per-Type Toggle** - Separate enable/disable for mobs and players - **Region Blacklist** - Disable in spawn, lobbies, or safe zones - **Half-Heart Precision** - Visual indicators for partial health - **Unicode Support** - Full color and symbol customization - **Hot Reload** - Update config without server restart - **Permission System** - Control who sees health displays --- 🎮 **Usage & Commands** **Commands** | Command | Description | Permission | Default | |---------|-------------|------------|---------| | `/uhd` | Show plugin information and version | `uhd.use` | All players | | `/uhd reload` | Reload configuration from disk | `uhd.reload` | Operators only | **Permissions** ```yaml uhd.use Basic plugin access (default: everyone) uhd.reload Reload configuration (default: op) uhd.bypass Bypass WorldGuard region restrictions (default: op) uhd.* All permissions (default: op) ``` --- 🛠️ **Configuration** **Basic Setup** ```yaml display: show-mob-health: true Show health for mobs show-player-health: true Show health for players current-style: hearts Active display style ``` **Performance Tuning** ```yaml performance: update-interval-ticks: 10 Update frequency (20 = 1 second) max-raytrace-distance: 50.0 Detection range in blocks camera-movement-threshold: 0.01 Sensitivity (lower = more updates) ``` **Plugin Integrations** ```yaml hooks: ignore-citizens: true Don't show NPC health worldguard-blacklisted-regions: Disable in specific regions - 'spawn' - 'lobby' - 'safezone' ``` **Creating Custom Styles** ```yaml styles: mystyle: message: '&d&l{name} &8➜ {usestyle} &7({health}/{maxhealth})' full-icon: '&d▰' half-icon: '&5▰' empty-icon: '&8▱' ``` **Available Placeholders:** - `{name}` - Entity or player name - `{health}` - Current health (numeric) - `{maxhealth}` - Maximum health (numeric) - `{usestyle}` - Visual bar (generated from icons) --- 📊 **Use Cases** **🏰 RPG Servers** Display custom mob health from MythicMobs with RPG-style formatting. Perfect for dungeon crawlers and boss fights. **⚔️ PvP Servers** Show enemy player health during combat. Configure separate styles for players vs mobs. **🎪 Minigame Servers** Disable health displays in lobbies using WorldGuard regions. Enable only in game arenas. **🌍 Survival Servers** Help players gauge mob danger w