ForgeTPS

The ForgeTPS modification is a convenient tool for displaying server performance statistics directly in the player list menu (Tab). Important information about server operation becomes available right in the game without the need for additional commands or interfaces.

Display customization

The mod allows customizing the appearance of the header and footer in the Tab menu using special placeholders:

• Header (tabHeader) — supports only the %playername% placeholder for displaying the current player's name
• Footer (tabFooter) — offers extended functionality with the following metrics: %tps% (ticks per second), %mspt% (tick processing time in milliseconds), %ping% (connection latency)

Configuration

The mod settings are stored in the forgetps.json file located in the config folder. Upon first launch, a file with preset values is automatically created.

Example of standard configuration:

{
  "tabHeader": "Welcome, %playername%!",
  "tabFooter": "TPS: %tps% | Ping: %ping% | MSPT: %mspt%",
  "enableNicknameColorChange": true,
  "customDimensions": {
    "minecraft:overworld": "GREEN",
    "minecraft:the_nether": "RED",
    "minecraft:the_end": "LIGHT_PURPLE", 
    "undergarden:undergarden": "DARK_GREEN",
    "ae2:spatial_storage": "WHITE"
  }
}

Configuration parameters

• tabHeader — text in the upper part of the Tab menu; only the %playername% placeholder is allowed
• tabFooter — text in the lower part of the Tab menu; supports performance metrics %tps%, %mspt%, %ping%
• enableNicknameColorChange — when set to true, changes player nickname color based on dimensions
• customDimensions — dictionary for setting nickname colors by dimensions; key — dimension identifier, value — color

Available color options

For the customDimensions parameter, a wide range of colors is available:

• BLACK, DARK_BLUE, DARK_GREEN, DARK_AQUA, DARK_RED, DARK_PURPLE, GOLD, GRAY, DARK_GRAY, BLUE, GREEN, AQUA, RED, LIGHT_PURPLE, YELLOW, WHITE

Installation

1. Ensure Forge is installed
2. Place the TabTPS mod in the mods folder
3. Configure parameters in the tabtps.json file (automatically created on first launch)
4. Restart the server to apply changes