MobVitals | Health & Corpses [1.16-26.3]

1. Overview & Purpose

MobVitals transforms combat feedback and entity mortality across your Minecraft server. Instead of entities abruptly vanishing into a vanilla puff of smoke, entities gracefully fall onto their side, persisting as interactive visual corpses with ambient particle wisps before dissolving into a thematic dissipation finale. Above their heads, sleek real-time health indicators and floating damage/heal popups inform players of exact combat vitals with zero server-side physical entity lag.

2. Key Features

• 100% Packet-Based Indicators: Healthbars and floating damage popups are rendered client-side via PacketEvents. No physical ArmorStands or entities are spawned in the server world.
• Cinematic Corpse Physics: Fallen entities rotate into authentic corpse poses on the ground with zero collision or hitbox interference for players.
• Per-Entity Floating Popups: Clean, uncluttered combat popups showing exact damage dealt or health recovered with randomized radial drift.
• Modern Minimalist Healthbars: High-visibility segmented battery bars (❙❙❙❙❙❙❙❙❙❙) with dynamic Adventure MiniMessage color gradients based on remaining health.
• Dense Area Optimization: Built-in crowd reduction algorithm dynamically accelerates corpse dissipation in high-density mob farms to prevent visual clutter.
• Multi-Platform & Folia Ready: Native support for Paper, Spigot, Purpur, and Folia region threading without race conditions or main-thread hitching.

Changelog v1.0.5

• Fluxo de Morte Suave & Âncora em 2 Ticks (~100ms - 250ms): Permitido o envio do status 3 para que a entidade execute sua animação natural de tombar ao solo antes de ser ancorada aos 2 ticks com estabilização aos 5 ticks (250ms) junto às partículas ambientes.
• Remoção do Efeito Vermelho: O corpo tem seu dano e overlay vermelho normalizados, mantendo suas cores e texturas originais intactas até a dissipação final.
• Hologramas de Dano Instantâneos e Confiáveis: Disparo síncrono dos popups de dano em cada hit (inclusive golpes letais e ataques rápidos consecutivos), eliminando qualquer falha ou perda de exibição de dano.

Changelog v1.0.4

• Teleporte de Posição 1.21.2+ / 26.2 (EntityPositionSync): Implementada a sincronização de posição através do pacote moderno ClientboundEntityPositionSyncPacket para compatibilidade de teleporte.

Changelog v1.0.3

• Isolamento de Colisão & Âncora Rápida: Aplicação nativa de regra de colisão no scoreboard para evitar empurrões no jogador e alinhamento de estado de corpo.

Changelog v1.0.2

• 1-Tick Damage Synchronization: Health updates and popups are now processed after 1 tick to reflect Bukkit's exact post-damage health calculation.
• Corpse Skin Normalization: Eliminated permanent red hurt overlay on dead mob bodies by cancelling status 3 packets and adopting packet-based sleep poses.
• Corpse Collision Elimination: Added scoreboard team collision rules (CollisionRule.NEVER) to completely stop corpses from pushing players.
• 10-Tick Teleport Anchor: Anchors the corpse body at 10 ticks with zero delta movement, locking corpse coordinates and ambient particle wisps into vertical alignment.
• Self-Indicator Suppression: Players can no longer view their own healthbars or popups directly on themselves.
• Heal Tag Fix: Sanitized invalid <emerald> color tag in heal format.

3. Supported Platforms & Minecraft Versions

4. Requirements & Dependencies

• Java Runtime: Java 17, 21, or 25.
• PacketEvents: v2.14.0 or higher installed in the plugins/ folder.

5. Installation Guide

1. Ensure your server runs Java 17 or newer.
2. Download and install packetevents-spigot-2.14.0.jar into your plugins/ directory.
3. Place MobVitals-1.0.0.jar into your plugins/ directory.
4. Start or restart your server to generate default configurations.
5. Customize styling and timings in plugins/MobVitals/config.yml as desired.

6. Commands & Usage

7. Permissions

• mobvitals.use — Allows viewing indicators, checking status, and using /mobvitals toggle. (Default: true for all players).
• mobvitals.admin — Allows configuration reloads and death profile testing. (Default: op).

8. Configuration Overview

The configuration file allows extensive customization of display distance, bar symbols, formats, blacklist, and corpse timings:

indicators:
  enabled: true
  view-distance: 24.0
  height-offset: 0.25
  show-only-when-damaged: true
  damaged-display-seconds: 4.0
  bar-length: 10
  symbol-full: "❙"
  symbol-empty: "❙"
  color-high: "<green>"
  color-medium: "<yellow>"
  color-low: "<gold>"
  color-critical: "<red>"
  color-empty: "<dark_gray>"
  format: "<white><bold><name></bold></white> <bar> <color><current><reset><dark_gray>/</dark_gray><gray><max></gray> <red>❤</red>"

corpses:
  duration-seconds: 4.0
  enable-corpse-body: true
  enable-ambient-particles: true
  dense-corpse-reduction: true
  dense-radius: 6.0

9. Performance & Technical Safety

• Zero Entity Footprint: MobVitals does not create or register Minecraft entities in chunk saves or server ticking loops. All markers exist solely in memory as network packets.
• Thread-Safe Concurrency: Backed by concurrent maps and Folia region task schedulers, guaranteeing crash-free execution under extreme combat loads.
• Adaptive Packet Dispatch: Visual packets are dispatched silently only to players within configured line-of-sight view distances.

10. Troubleshooting & FAQ