MobTag | MythicMobs & PlaceholderAPI support icon

MobTag | MythicMobs & PlaceholderAPI support -----

Display mob health tags above mobs | Fully configurable | PAPI & MythicMobs support



[​IMG]

[HR][/HR]

✨ About

MobTag is a lightweight plugin that displays a customizable health tag above mobs when a player gets close to them. No lag, no heavy dependencies — just clean and simple mob health display.

[HR][/HR]

⚡ Features

  • Displays health tags above mobs when players are within range
  • Player health tags — optionally show health above players too, with separate format/height/range
  • In-game settings GUI — players toggle mob tags, player tags & damage indicators for themselves
  • Fully configurable tag format with colors, symbols and health bar
  • Configurable display range and tag height
  • Visibility modes: ALL, DAMAGER, or LOOKING_AT
  • Gradient health bar that changes color based on health percentage
  • Damage indicators — floating damage numbers with motion, fade-out & crit support
  • Damage animations — tags flash and bounce when the mob is hit
  • Configurable tag scale
  • Bedrock support — separate Java/Bedrock heights with Floodgate detection
  • World blacklist support
  • Per-entity-type custom tag formats (e.g. bosses show differently)
  • PlaceholderAPI support
  • MythicMobs support
  • PacketEvents support — smooth lag-free tags (with ArmorStand fallback)
  • Update checker — get notified of new versions in console
  • Ignore options for passive mobs, bosses, and players
  • Lightweight and optimized for performance

[HR][/HR]

Screenshots

[​IMG]
[​IMG]
[​IMG]

[HR][/HR]

Commands & Permissions

  • /mobtag admin reload — Reloads the config | Permission: mobtag.admin (default: OP)
  • /mobtag — Opens a gui settings per player | Permission: mobtag.toggle (default: everyone)

[HR][/HR]

Soft Dependencies

  • PlaceholderAPI (optional)
  • MythicMobs (optional)
  • PacketEvents (optional — for smooth tags)

[HR][/HR]

Installation

  1. Drop the jar into your plugins folder
  2. Restart your server
  3. Edit plugins/MobTag/config.yml to your liking
  4. Run /mobtag admin reload to apply changes

[HR][/HR]

Code (Text):

# ╔══════════════════════════════════════╗
# ║           MobTag Config              ║
# ║        by Abood_8001                 ║
# ╚══════════════════════════════════════╝

# -----------------------------------------------
# GENERAL SETTINGS
# -----------------------------------------------

# Worlds where MobTag will NOT display tags
blacklisted-worlds:
  - example_world1
  - example_world2

# -----------------------------------------------
# BEDROCK DETECTION (for Geyser/Floodgate servers)
# -----------------------------------------------
bedrock:
  # Use Floodgate API to detect Bedrock players (recommended if installed)
  use-floodgate: true
  # Fallback: detect Bedrock players by username prefix
  prefix: "."

# How often (in ticks) the tags are updated.
# 1 second = 20 ticks. Lower = smoother but more CPU. Recommended: 4
update-interval: 4

# The range (in blocks) a player must be within to see a tag.
display-range: 16.0

# The max length for check tag mobe (ONLY LOOKING_AT MODE)
looking-len: 5.0

# Height offset of the tag above the mob's head (in blocks).
# Bedrock players (via Geyser) often need a different offset.
tag-height-offset:
  java: 0.3
  bedrock: 0.0

# Display mode for health tags
# Options:
#   AUTO        - Automatically uses PacketEvents if installed, ArmorStand otherwise
#   ARMORSTAND  - Always use ArmorStands (works everywhere, slight stutter when mob moves)
#   PACKET      - Always use PacketEvents (smooth movement, requires PacketEvents plugin)
display-mode: AUTO

# Who can see the tags?
# Options:
#   ALL     - All players within range see the tag
#   DAMAGER - Only the player who last damaged the mob sees the tag
#   LOOKING_AT - Only the player currently looking at the mob sees the tag
visibility-mode: ALL

# Ignore peaceful mobs (cows, pigs, sheep, etc)?
ignore-passive: false

# Ignore player entities? (set false AND enable player-tags below to show player health)
ignore-players: true

# Should tags be shown on boss mobs (Ender Dragon, Wither)?
show-on-bosses: true

# -----------------------------------------------
# PLAYER TAGS
# -----------------------------------------------
# Show health tags above players too?
# (ignore-players above must be false for this to work)
player-tags:
  enabled: false
  # Separate format for player tags
  format: "&c❤ &f{current}&7/&f{max}"
  # Separate height offset for player tags
  height-offset:
    java: 0.3
    bedrock: 0.0
  # Separate display range for player tags (blocks)
  display-range: 16.0

# -----------------------------------------------
# TAG FORMAT
# -----------------------------------------------
# Available placeholders:
#   {name}       - Mob's custom name (or type if no custom name)
#   {type}       - Mob entity type (e.g. ZOMBIE)
#   {current}    - Current health (rounded to 1 decimal)
#   {max}        - Max health (rounded to 1 decimal)
#   {bar}        - Health bar (see health-bar section below)
#   {percent}    - Health percentage (e.g. 75.0)
#
# Color codes: Use & followed by a color code (e.g. &c = red, &a = green)
# Hex colors: Use &#RRGGBB format (e.g. &#ff0000 = red)
# -----------------------------------------------

tag-format: "&c❤ &f{current}&7/&f{max}"

# -----------------------------------------------
# HEALTH BAR
# -----------------------------------------------

health-bar:
  # Total number of characters in the bar
  length: 10

  # Character used for filled portion
  filled-char: "█"

  # Character used for empty portion
  empty-char: "░"

  # Color of the filled portion
  # Supports gradient based on health percentage:
  #   Use 'gradient' to enable dynamic color
  #   Or set a fixed color like '&a'
  filled-color: gradient

  # Colors for gradient (used when filled-color: gradient)
  # high   = above 60% health
  # medium = between 30% and 60%
  # low    = below 30%
  gradient-high: "&a"
  gradient-medium: "&e"
  gradient-low: "&c"

  # Color of the empty portion
  empty-color: "&8"

# -----------------------------------------------
# MYTHICMOBS INTEGRATION
# -----------------------------------------------

mythicmobs:
  # Enable MythicMobs support?
  enabled: false

  # Show the MythicMob's internal name instead of entity type?
  show-mythic-name: true

  # Custom format for MythicMob tags (leave empty to use global tag-format)
  # Supports same placeholders as tag-format plus:
  #   {mythic_name} - The MythicMob's internal name
  custom-format: "&5⚔ &f{mythic_name} &8| &c❤ &f{current}&7/&f{max} {bar}"

# -----------------------------------------------
# PLACEHOLDERAPI INTEGRATION
# -----------------------------------------------

placeholderapi:
  # Enable PlaceholderAPI support?
  enabled: true

# -----------------------------------------------
# PER ENTITY FORMATS
# -----------------------------------------------
# Override the global tag-format for specific entity types.
# Use the entity type name in CAPS (e.g. ZOMBIE, CREEPER, ENDER_DRAGON)
# Leave empty to use the global tag-format for all mobs.
# Supports all the same placeholders as tag-format.

entity-formats:
  ENDER_DRAGON: "&5❤ &f{current}&7/&f{max} &7| {bar} &5[Dragon]"
  WITHER: "&8❤ &f{current}&7/&f{max} &7| {bar} &8[Wither]"

# -----------------------------------------------
# TAG SCALE
# -----------------------------------------------
# Size multiplier for packet-based tags (PACKET mode only).
# 1.0 = default, 0.5 = half size, 2.0 = double size.
tag-scale: 1.0

# -----------------------------------------------
# DAMAGE ANIMATION
# -----------------------------------------------
# Animate the tag when the mob takes damage (PACKET mode only).
damage-animation:
  enabled: false
  flash: false
  scale-bounce: false
  duration: 8

# -----------------------------------------------
# DAMAGE INDICATOR
# -----------------------------------------------
# Show floating damage numbers when a mob takes damage (PACKET mode only).
damage-indicator:
  enabled: true
  format: "&c-{damage}"
  crit-format: "&d-{damage} ✸"
  show-on-players: true
  duration: 20
  height-offset: -0.5
  # Motion direction: UP, DOWN, FORWARD, RANDOM, NONE
  # FORWARD = moves toward the player who hit the mob
  motion: UP
  # How far it travels over its lifetime (in blocks)
  motion-distance: 1.0
  # Fade out near the end of its lifetime?
  fade-out: true

# -----------------------------------------------
# UPDATE CHECKER
# -----------------------------------------------
update-checker: true

# -----------------------------------------------
# MESSAGES
# -----------------------------------------------

messages:
  prefix: "&8[&bMobTag&8] "
  reload-success: "&aConfiguration reloaded successfully!"
  no-permission: "&cYou don't have permission to do that."
  unknown-command: "&cUnknown sub-command. Usage: /mobtag admin reload"
 

[HR][/HR]

If you enjoy the plugin, please leave a review!
Source code: https://github.com/Abood8001/MobTag
Resource Information
Author:
----------
Total Downloads: 33
First Release: May 30, 2026
Last Update: Jun 8, 2026
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings