Styled Player List Mod FAQ
10 questions players actually ask, answered.
How do I open the config for the Styled Player List Mod?
The mod is configured through a config file rather than an in-game GUI, so you edit it directly and reload or restart the server for changes to apply. On most setups you'll find it in the server's config folder, and many admins use a command to reload the config without a full restart.
Do I need to install this mod on the client too, or just the server?
It's a server-side mod, so players connecting with a vanilla client will still see the customized player list. You only need it on the server unless you want to preview or edit styling locally.
How do I add color and formatting to the player list text?
You use the standard Minecraft formatting codes (the section sign followed by a letter or number) inside your config strings to set colors and styles like bold or italic. The same codes work in headers, footers, and per-player name formats.
Why isn't my header or footer showing up?
The most common cause is a syntax error in the config, such as a missing quote or an unescaped special character, which makes the mod ignore that section. Double-check your formatting codes and make sure the header/footer fields are actually enabled.
Can I use placeholders like player name or health in the list?
Yes, the mod supports placeholders that get replaced per player, such as their name, display name, and other server-provided values. Check the mod's placeholder list so you use the exact syntax it expects.
How do I sort players by team, rank, or permission group?
Sorting is handled through the ordering options in the config, which let you group and order players based on values like team or a placeholder. You define the order rules rather than dragging players around manually.
Does this mod work with other TAB or player list mods?
Running two mods that both control the player list will usually cause conflicts, with one overriding the other. Remove or disable any other player list or TAB mods to avoid unpredictable results.
Will this mod cause lag or hurt server performance?
The mod is lightweight and only rebuilds the list when something changes, so it generally has a negligible performance impact. Very frequent updates or heavy placeholder use across many players can add minor overhead.
My changes aren't showing up after editing the config — what did I do wrong?
You likely didn't reload or restart after saving, or the file has a formatting error that prevented it from loading. Run the reload command (or restart) and check the server log for config errors.
Can I show different player list styles for different players or groups?
Yes, you can apply conditional formatting so certain players or groups get different name styles, colors, or prefixes in the list. This is done through the per-player formatting rules in the config.