Back to mods
PingOverlay project artwork

Modrinth · Minecraft mod

PingOverlay

A mod which shows the amount of ping a player has next to their head.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which PingOverlay release should I use?

Updated 22 days ago
Latest stable file 1.0.0+26.3
Game version 26.3
Loader Fabric

PingOverlay 1.0.0+26.3 targets 26.3 with Fabric. It must be installed on the client. Do not install it on the dedicated server. No extra mods listed for this file.

Where it goes

Is PingOverlay required on the client, server, or both?

It must be installed on the client. Do not install it on the dedicated server.

Client Required
Dedicated server Not supported
Loader for this release Fabric
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

This file is marked client-only.

What else does PingOverlay 1.0.0+26.3 need?

1.0.0+26.3. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add PingOverlay without breaking your instance.

Built for PingOverlay 1.0.0+26.3. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 1.0.0+26.3. It targets 26.3 with Fabric; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    It must be installed on the client. Do not install it on the dedicated server.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 1.0.0+26.3. It opens that exact file at the source.

About this project

What does PingOverlay add?

Ping Overlay

See every player's latency right on their nametag.

Please note this does not work on all servers due to missing certain permissions.

Ping Overlay is a lightweight client-side Fabric mod for Minecraft 1.21.11 that appends each player's ping in milliseconds to their nametag, with clear color coding so you can read connection quality at a glance.

Features

  • Client-side only (no server install required)
  • Shows ping as [Xms] next to player nametags
  • Color-coded quality display:
    • Green: low ping
    • Yellow: medium ping
    • Red: high ping
  • In-game settings screen from the pause menu
  • User-editable config file support
  • Cached ping updates (3-second refresh interval) for low overhead
  • Keeps vanilla nametag behavior and visibility rules

In-Game Configuration

You can change ping thresholds without editing source code:

  • Open the pause menu (Esc) and click Ping Overlay Settings
  • Set:
    • Green max ms
    • Yellow max ms
  • Save and continue playing

If you prefer manual config, edit:

config/ping-overlay.json

How Colors Work

  • Green if ping is less than or equal to greenMaxMs
  • Yellow if ping is above greenMaxMs and less than or equal to yellowMaxMs
  • Red if ping is above yellowMaxMs

Example: if you want red to start at 120+, set yellowMaxMs to 119.

Performance

Ping values are cached and refreshed every 3 seconds per player, reducing repeated lookup work while keeping values current.

Compatibility

  • Minecraft: 1.21.11
  • Mod Loader: Fabric
  • Environment: Client

Why Use This Mod?

  • Quickly spot laggy players in PvP or co-op
  • Easy to tune thresholds for your server or region
  • Minimal impact and clean vanilla-style integration

Notes

  • Ping display is only available when ping data is provided by the client network player list (typical multiplayer behavior)
  • Singleplayer/integrated worlds do not represent real network latency the same way as remote servers

Project description from Modrinth.

Pick your setup

PingOverlay by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

6 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

PingOverlay versions and loaders

5 of 5 releases match

Looking for an older file? The official Modrinth project page is in Resources.