πŸ› οΈ Troubleshooting

This page covers common issues you may encounter while using LiteNameTags.


Nametags are not showing

Check that:

  • LiteNameTags is loading correctly

  • PacketEvents is installed and enabled

  • your groups are configured correctly

  • the player has the correct group permission

If needed, review both config.yml and groups.yml.


Nametags look wrong

This is usually caused by:

  • invalid placeholders

  • unsupported formatting

  • incorrect group settings

Start with a simple group format first, then add more placeholders and styling gradually.


Bedrock players see issues

If your server uses Geyser and Floodgate, review the Bedrock compatibility settings in config.yml.

Some formatting options may need adjustment for Bedrock clients.


Nametags are misplaced

Check:

  • group display settings

  • Bedrock offset settings

  • HMCCosmetics offset settings

Make small changes and test them in-game.


Performance feels worse than expected

Review:

  • update interval

  • placeholder usage

  • health updates

  • crowd mode

Use /lnt perf to test the plugin under real server conditions.


Still need help?

Before asking for support, collect:

  • server version

  • LiteNameTags version

  • installed dependencies

  • your current configuration

  • any console errors

Last updated