π οΈ Troubleshooting
This page covers common issues you may encounter while using LiteNameTags.
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.
This is usually caused by:
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.
Check:
HMCCosmetics offset settings
Make small changes and test them in-game.
Review:
Use /lnt perf to test the plugin under real server conditions.
Still need help?
Before asking for support, collect:
your current configuration
Last updated