Compatibility
Minecraft: Java Edition
26.1
1.21
1.20
1.19
Platforms
Links
Tags
Creators
Details
Licensed MIT
Published 5 days ago

✨ 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.
⚡ Features
- Displays health tags above mobs when players are within range
- 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
- 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)
- Ignore options for passive mobs, bosses, and players
- Lightweight and optimized for performance
📷 Screenshots
🎮 Commands & Permissions
/mobtag reload— Reloads the config | Permission:mobtag.admin(default: OP)/mobtag toggle— Toggle your mob health tags | Permission:mobtag.toggle(default: everyone)
🔌 Soft Dependencies
- PlaceholderAPI (optional)
- MythicMobs (optional)
- PacketEvents (optional — for smooth tags)
📥 Installation
- Drop the jar into your plugins folder
- Restart your server
- Edit
plugins/MobTag/config.ymlto your liking - Run
/mobtag reloadto apply changes
📄 config.yml
# ╔══════════════════════════════════════╗
# ║ MobTag Config ║
# ║ by Abood_8001 ║
# ╚══════════════════════════════════════╝
# -----------------------------------------------
# GENERAL SETTINGS
# -----------------------------------------------
# Worlds where MobTag will NOT display tags
blacklisted-worlds:
- example_world1
- example_world2
# 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
# Height offset of the tag above the mob's head (in blocks).
tag-height-offset: 0.3
# 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?
ignore-players: true
# Should tags be shown on boss mobs (Ender Dragon, Wither)?
show-on-bosses: true
# -----------------------------------------------
# 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} &7| {bar}"
# -----------------------------------------------
# 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: true
# 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]"
# -----------------------------------------------
# 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 reload"
💜 If you enjoy the plugin, please leave a review!
Source code: GitHub


