🔌 Integrations
This page covers the compatibility options available in LiteNameTags for external platforms and plugins.
These integrations are configured in the compatibility section of config.yml.
Overview
LiteNameTags includes compatibility settings for specific environments where nametag behavior may need adjustment.
The goal of these options is to improve visual consistency, prevent rendering issues, and make the plugin behave better alongside other systems.
Current compatibility options include:
Bedrock support
Disguise support
HMCCosmetics support
Bedrock
The bedrock section is designed for servers using Geyser and Floodgate.
Bedrock clients may render nametags differently from Java clients, so LiteNameTags includes extra settings to improve compatibility.
Available options
enabledy-offset-addforce-legacy-onlystrip-minimessage-tagsdisable-obfuscated
What these settings do
enabled
Enables Bedrock-specific compatibility handling.
y-offset-add
Adds extra vertical offset for Bedrock players if the nametag appears too low or overlaps the player model.
force-legacy-only
Forces legacy-only formatting for Bedrock clients.
This can be useful if advanced formatting does not render correctly on certain setups.
strip-minimessage-tags
Removes MiniMessage tags for Bedrock players when needed.
This helps avoid formatting issues on clients that do not handle those tags properly.
disable-obfuscated
Disables obfuscated text formatting for Bedrock players.
This is recommended if obfuscated text causes visual glitches or poor readability.
Recommended use
Enable this section only if your server supports Bedrock players through Geyser and Floodgate.
If your server is Java-only, this section can stay disabled.
Disguises
The disguises section is designed for servers using disguise-related plugins.
When a player is disguised, showing the normal nametag may look incorrect or reveal information you do not want visible.
Available options
enabledhide-while-disguisedcache-ttl-ms
What these settings do
enabled
Enables disguise compatibility handling.
hide-while-disguised
Hides the LiteNameTags nametag while the player is disguised.
This is useful for keeping disguise behavior consistent and avoiding visual conflicts.
cache-ttl-ms
Caches disguise state checks for a short time to reduce repeated lookups and improve performance.
Recommended use
Enable this section only if your server uses disguise plugins and you want LiteNameTags to respect disguise state.
HMCCosmetics
The hmccosmetics section is designed for setups where cosmetics can affect how high a nametag should appear.
Items such as helmets or backpacks may visually change the player's model, so LiteNameTags includes offset options to keep nametags aligned correctly.
Available options
enabledcache-ttl-mshelmet-extra-y-offsetbackpack-extra-y-offsetmax-extra-y-offset
What these settings do
enabled
Enables HMCCosmetics compatibility handling.
cache-ttl-ms
Caches cosmetic state checks to reduce repeated processing.
helmet-extra-y-offset
Adds extra vertical offset when a cosmetic helmet affects the player's height.
backpack-extra-y-offset
Adds extra vertical offset when a backpack cosmetic affects the model.
max-extra-y-offset
Limits the maximum extra vertical offset that can be applied.
This helps prevent nametags from being pushed too high.
Recommended use
Enable this section only if your server uses HMCCosmetics and you notice nametag position issues caused by cosmetics.
Last updated