Back to mods
PerformanceHUD project artwork

CurseForge · Minecraft mod

PerformanceHUD

Lightweight client-side HUD showing FPS, RAM, entities, chunks, ping, and CPU in one customizable corner overlay.

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

Quick answer

Which PerformanceHUD release should I use?

Updated last month
Latest stable file performancehud-neoforge-26.3-1.2.0.jar
Game version 26.3
Loader NeoForge

performancehud-neoforge-26.3-1.2.0.jar targets 26.3 with NeoForge. The project page does not say whether this file belongs on the client, dedicated server, or both. All 1 required mods have matching files.

Where it goes

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

The project page does not say whether this file belongs on the client, dedicated server, or both.

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

The source does not explicitly classify this release as client-only or server-only.

What else does performancehud-neoforge-26.3-1.2.0.jar need?

performancehud-neoforge-26.3-1.2.0.jar. Change the file and its required mods may change too.

All 1 required mods have matching files

Install Architectury API first. We found matching files for this game-version and loader setup.

Architectury API Needed by performancehud-neoforge-26.3-1.2.0.jar
required
Matching file found Matched file: [NeoForge 26.3] v22.0.5

We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add PerformanceHUD without breaking your instance.

Built for performancehud-neoforge-26.3-1.2.0.jar. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use performancehud-neoforge-26.3-1.2.0.jar. It targets 26.3 with NeoForge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    Install Architectury API first. We found matching files for this game-version and loader setup.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside performancehud-neoforge-26.3-1.2.0.jar. It opens that exact file at the source.

About this project

What does PerformanceHUD add?

JOIN_OUR_DISCORD MODRINTH

A lightweight client-side performance HUD that shows FPS, RAM, entities, loaded chunks, ping, and CPU usage in a single clean corner overlay. No more screenshots cluttered with three different mods — one toggleable panel, one hotkey, done.

Client-side only — do not install on the server. A dedicated server does not need this mod and will not write config/performancehud.json if the jar is present anyway. Works in singleplayer — just drop it in your mods folder.

Fabric needs Fabric API and Architectury API. NeoForge needs Architectury API. Forge needs no additional dependencies.

Free to use in any modpack — public or private, no permission needed.

What it does

  • One overlay — a compact HUD in the top-right corner with up to 6 live metrics.
  • Toggle with F8 — hide or show the whole panel with one keybind (changeable in Controls). The HUD also hides when F1 hides the rest of the interface.
  • Per-metric switches — turn individual lines on or off so you only see what you care about.
  • Safe with other HUDs — client overlay only; does not change world or server logic, and is safe to remove at any time.

Metrics shown

  • FPS — current frame rate with frame time in ms (e.g. 120 (8.3ms)).
  • RAM — used / max heap in MB.
  • Entities — entity count in the loaded world.
  • Chunks — currently loaded client chunks.
  • Ping — your latency in ms when available; otherwise -.
  • CPU — system CPU load percentage when available.
  • If a value cannot be read, that line shows - and the reason is logged once.

Configuration

  • In-game screen: /phud open or /performancehud open. On Forge/NeoForge it is also available from the Mods menu.
  • Customization: background opacity, screen margins (X/Y), and line spacing.
  • File: config/performancehud.json. A typo’d file is kept as config/performancehud.json.bak before defaults are written, so settings are not silently lost.
  • Keybind: default F8 toggle in the vanilla Controls menu.

Commands

Use /performancehud or the short alias /phud.

  • /phud open — open the config screen
  • /phud status — print current settings to chat
  • /phud reload / /phud reset — manage the config file
  • /phud <setting> <value> — toggle metrics or adjust visuals from chat (e.g. /phud showFps false, /phud xMargin 10, /phud textColor 16777215)

Details

  • Available in English, Russian, German, Spanish, French, Italian, Japanese, Korean, Brazilian Portuguese, and Simplified Chinese.

Feedback

Please report any bugs, errors, or feature suggestions on Discord: https://discord.gg/HTkn94BXmA

More mods by Nikrecs: DynamicRenderDistance · CropGrowthHUD

My other mods that I recommend.

Project description from CurseForge.

Pick your setup

PerformanceHUD by Minecraft version and loader

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

18 available setups

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

Recent files

PerformanceHUD versions and loaders

44 of 44 releases match

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