Simple Player List

Simple Player List is a server-side mod that allows customizing the appearance of the server's player list through a configuration file.

Main Features

• Customizing player list appearance using JSON configuration
• Displaying real-time server statistics directly in the player list

Configuration Settings

On first mod launch, a default configuration file is automatically created (config/simpleplayerlist.json):

{
  "enable_mod": true,
  "header": "§lDefault Config§r\n\n§7To change this, edit\nconfig/simpleplayerlist.json\n\n§r§b§m                                        §r",
  "footer": "§r§b§m                                        §r\n\n§7TPS: %tps%§7/%mspt% §8-§7 Ping: %ping%\n§7Day: §b%day%",
  "tick_update_interval": 20
}

The file supports formatting using the § symbol and hexadecimal colors (for example, §#FFFFFF).

The following placeholders are automatically replaced with current server information at the interval specified in the tick_update_interval parameter:

• %mspt% — displays server MSPT (milliseconds per tick)
• %tps% — shows server TPS (ticks per second)
• %ping% — displays player ping in milliseconds
• %day% — indicates current in-game day

Values for %mspt%, %tps%, and %ping% are displayed with color coding for easier interpretation.

Commands

To apply changes in the configuration file, use the /playerlist reload command. The mod can also be enabled or disabled using /playerlist toggle.

Players without operator privileges can use the /playerlist command to toggle the mod on their side.

Compatibility

Fabric API is required for the mod to work.