TPS

Module info
Configuration	tps in config.yml
Manager	TPSManager
Support	1.8+
Free version	✔
Proxy-configurable	❌

This module allows players to check the server's current TPS and offers custom placeholders. It is possible to configure ranges to colorize the TPS based on its value.

Setup

The following snippet of code represents and explains the TPS's configuration.

# ...ping's settings...
tps: 
  enabled: true # whether to enable or disable this module
  20-tps-cap:
    enabled: false # whether to cap TPS to 20.0
    add-wildcard: false # whether to add * before the number if it exceeds 20.0
  update-timeout: 5s # timeout between updates
  qualities:
    excellent: 19.99 # first quality's minimum TPS (19.99+)
    great: 19.5 # second quality's minimum TPS (19.5-19.98)
    good: 19 # ...
    poor: 18
    bad: 17
    unplayable: 16
# ...MSPT's settings...

Refer to the Getting started/Syntax/Timestamps page to find out the timestamp specifiable at update-timeout.

The first and last qualities determine the first and last TPS ranges.

Adding qualities

To add a new quality or range, you just need to specify its ID and its minimum TPS.

# ...TPS's settings...
  qualities: 
    new-quality: 19.7
    # ...default qualities...
# ...MSPT's settings...

Once done, open messages.yml and any custom messages files present and insert the new quality's ID, color and text at tps-qualities:

# ...ping's messages...
tps-qualities: 
  # ...default qualities...
  new-quality: '&9' # new quality's ID and color
# ...MSPT's messages...

Placeholders

This module has a set of placeholders available described at Modules/Placeholders/TPS.

/tps command

It is possible to check the server's current TPS using the /tps command:

Refer to the Getting started/Commands/Misc page for more info.

---

ChatPlugin — A feature-rich and modular chat ecosystem, lightweight and efficient by design.
© 2025  Remigio07

This wiki is currently updated to version 1.10.4.
Please report any mistakes and misspellings as described at Home/Reporting issues.