Compatibility
Minecraft: Java Edition
26.1
1.21
1.20
1.19
Platforms
Links
Tags
Creators
Details
Licensed MIT
Published last month

⨠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
- 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
š· Screenshots
š® 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)
š 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 admin 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
# -----------------------------------------------
# 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"
Source code: GitHub


