All Mods Resource Packs Data Packs Shaders Modpacks Plugins
PerformanceHUD

PerformanceHUD

by Nikrecs • Downloads: 0 • Followers: 0
Description
Gallery
Changelog
Versions

CURSEFORGE

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.

PerformanceHUD

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.

How to Install PerformanceHUD (Mod)

PerformanceHUD by Nikrecs is verified for Fabric, Forge, Neoforge across Minecraft versions 1.19.2, 1.20.1, 1.21.1, 1.21.11, 26.1, 26.1.2, 26.2, 26.3 (latest release: 1.2.0, file size: 273 KB). Follow the steps below to install it safely from ModCraft.tv:

  1. Click the Download button above and select your Minecraft version (1.19.2, 1.20.1, 1.21.1, 1.21.11, 26.1, 26.1.2, 26.2, 26.3) and platform (Fabric, Forge, Neoforge).
  2. Make sure you have the compatible loader or environment installed for Fabric, Forge, Neoforge.
  3. Move the downloaded PerformanceHUD file into your Minecraft .minecraft/mods folder and launch the game.

All Versions

+ Add Version
Name Game version Platforms Published Downloads Actions
26.3
Neoforge
22d ago 1
26.2
Neoforge
22d ago 1
26.1.2
Neoforge
22d ago 1
1.21.11
Neoforge
22d ago 1
1.21.1
Neoforge
22d ago 1
1.21.11
Forge
22d ago 1
1.21.1
Forge
22d ago 1
1.20.1
Forge
22d ago 1
1.19.2
Forge
22d ago 1
26.3
Fabric
22d ago 1
26.2
Fabric
22d ago 1
26.1.2
Fabric
22d ago 1
1.21.11
Fabric
22d ago 1
1.21.1
Fabric
22d ago 1
1.20.1
Fabric
22d ago 1
1.19.2
Fabric
22d ago 1
26.3
Neoforge
1mo ago 1
26.3
Fabric
1mo ago 1
26.2
Neoforge
4mo ago 1
26.1.2
Neoforge
4mo ago 1
26.1
Neoforge
4mo ago 1
1.21.11
Neoforge
4mo ago 1
1.21.1
Neoforge
4mo ago 1
1.20.1
Forge
4mo ago 1
1.19.2
Forge
4mo ago 1
26.2
Fabric
4mo ago 1
26.1.2
Fabric
4mo ago 1
26.1
Fabric
4mo ago 1
1.21.11
Fabric
4mo ago 1
1.21.1
Fabric
4mo ago 1
1.20.1
Fabric
4mo ago 1
26.2
Neoforge
4mo ago 1
26.2
Fabric
4mo ago 1
26.1
Neoforge
5mo ago 1
26.1.2
Neoforge
5mo ago 1
1.21.11
Neoforge
5mo ago 1
1.21.1
Neoforge
5mo ago 1
1.20.1
Forge
5mo ago 1
1.19.2
Forge
5mo ago 1
26.1
Fabric
5mo ago 1
26.1.2
Fabric
5mo ago 1
1.21.11
Fabric
5mo ago 1
1.21.1
Fabric
5mo ago 1
1.20.1
Fabric
5mo ago 1
### 1.2.0

  • Ports**
  • New: Fabric 1.19.2, Forge 1.21.1, Forge 1.21.11
  • Same HUD, F8, /performancehud and /phud, settings screen, and config/performancehud.json as the other builds

  • Fixes**
  • NeoForge 26.2 and 26.3: HUD hides when F1 hides the rest of the interface
  • A typo’d config/performancehud.json is kept as config/performancehud.json.bak before defaults are written (settings are no longer silently lost)
  • If a HUD value can’t be read (entities, chunks, ping, CPU), the reason is logged once; the line still shows a dash
  • Dedicated servers with the mod installed no longer create config/performancehud.json

  • Compatibility**
  • Client-side only; a server does not need the mod
  • Fabric: Fabric API + Architectury API (Architectury new)
  • NeoForge: Architectury API (new)
  • Forge: Forge only
  • Each jar targets exactly one Minecraft version

  • Unchanged**
  • HUD lines and formats, draw position, F8, commands and value ranges, settings screen, config keys/defaults, translations
### 1.2.0

  • Ports**
  • New: Fabric 1.19.2, Forge 1.21.1, Forge 1.21.11
  • Same HUD, F8, /performancehud and /phud, settings screen, and config/performancehud.json as the other builds

  • Fixes**
  • NeoForge 26.2 and 26.3: HUD hides when F1 hides the rest of the interface
  • A typo’d config/performancehud.json is kept as config/performancehud.json.bak before defaults are written (settings are no longer silently lost)
  • If a HUD value can’t be read (entities, chunks, ping, CPU), the reason is logged once; the line still shows a dash
  • Dedicated servers with the mod installed no longer create config/performancehud.json

  • Compatibility**
  • Client-side only; a server does not need the mod
  • Fabric: Fabric API + Architectury API (Architectury new)
  • NeoForge: Architectury API (new)
  • Forge: Forge only
  • Each jar targets exactly one Minecraft version

  • Unchanged**
  • HUD lines and formats, draw position, F8, commands and value ranges, settings screen, config keys/defaults, translations
### 1.2.0

  • Ports**
  • New: Fabric 1.19.2, Forge 1.21.1, Forge 1.21.11
  • Same HUD, F8, /performancehud and /phud, settings screen, and config/performancehud.json as the other builds

  • Fixes**
  • NeoForge 26.2 and 26.3: HUD hides when F1 hides the rest of the interface
  • A typo’d config/performancehud.json is kept as config/performancehud.json.bak before defaults are written (settings are no longer silently lost)
  • If a HUD value can’t be read (entities, chunks, ping, CPU), the reason is logged once; the line still shows a dash
  • Dedicated servers with the mod installed no longer create config/performancehud.json

  • Compatibility**
  • Client-side only; a server does not need the mod
  • Fabric: Fabric API + Architectury API (Architectury new)
  • NeoForge: Architectury API (new)
  • Forge: Forge only
  • Each jar targets exactly one Minecraft version

  • Unchanged**
  • HUD lines and formats, draw position, F8, commands and value ranges, settings screen, config keys/defaults, translations
### 1.2.0

  • Ports**
  • New: Fabric 1.19.2, Forge 1.21.1, Forge 1.21.11
  • Same HUD, F8, /performancehud and /phud, settings screen, and config/performancehud.json as the other builds

  • Fixes**
  • NeoForge 26.2 and 26.3: HUD hides when F1 hides the rest of the interface
  • A typo’d config/performancehud.json is kept as config/performancehud.json.bak before defaults are written (settings are no longer silently lost)
  • If a HUD value can’t be read (entities, chunks, ping, CPU), the reason is logged once; the line still shows a dash
  • Dedicated servers with the mod installed no longer create config/performancehud.json

  • Compatibility**
  • Client-side only; a server does not need the mod
  • Fabric: Fabric API + Architectury API (Architectury new)
  • NeoForge: Architectury API (new)
  • Forge: Forge only
  • Each jar targets exactly one Minecraft version

  • Unchanged**
  • HUD lines and formats, draw position, F8, commands and value ranges, settings screen, config keys/defaults, translations
### 1.2.0

  • Ports**
  • New: Fabric 1.19.2, Forge 1.21.1, Forge 1.21.11
  • Same HUD, F8, /performancehud and /phud, settings screen, and config/performancehud.json as the other builds

  • Fixes**
  • NeoForge 26.2 and 26.3: HUD hides when F1 hides the rest of the interface
  • A typo’d config/performancehud.json is kept as config/performancehud.json.bak before defaults are written (settings are no longer silently lost)
  • If a HUD value can’t be read (entities, chunks, ping, CPU), the reason is logged once; the line still shows a dash
  • Dedicated servers with the mod installed no longer create config/performancehud.json

  • Compatibility**
  • Client-side only; a server does not need the mod
  • Fabric: Fabric API + Architectury API (Architectury new)
  • NeoForge: Architectury API (new)
  • Forge: Forge only
  • Each jar targets exactly one Minecraft version

  • Unchanged**
  • HUD lines and formats, draw position, F8, commands and value ranges, settings screen, config keys/defaults, translations
### 1.2.0

  • Ports**
  • New: Fabric 1.19.2, Forge 1.21.1, Forge 1.21.11
  • Same HUD, F8, /performancehud and /phud, settings screen, and config/performancehud.json as the other builds

  • Fixes**
  • NeoForge 26.2 and 26.3: HUD hides when F1 hides the rest of the interface
  • A typo’d config/performancehud.json is kept as config/performancehud.json.bak before defaults are written (settings are no longer silently lost)
  • If a HUD value can’t be read (entities, chunks, ping, CPU), the reason is logged once; the line still shows a dash
  • Dedicated servers with the mod installed no longer create config/performancehud.json

  • Compatibility**
  • Client-side only; a server does not need the mod
  • Fabric: Fabric API + Architectury API (Architectury new)
  • NeoForge: Architectury API (new)
  • Forge: Forge only
  • Each jar targets exactly one Minecraft version

  • Unchanged**
  • HUD lines and formats, draw position, F8, commands and value ranges, settings screen, config keys/defaults, translations
### 1.2.0

  • Ports**
  • New: Fabric 1.19.2, Forge 1.21.1, Forge 1.21.11
  • Same HUD, F8, /performancehud and /phud, settings screen, and config/performancehud.json as the other builds

  • Fixes**
  • NeoForge 26.2 and 26.3: HUD hides when F1 hides the rest of the interface
  • A typo’d config/performancehud.json is kept as config/performancehud.json.bak before defaults are written (settings are no longer silently lost)
  • If a HUD value can’t be read (entities, chunks, ping, CPU), the reason is logged once; the line still shows a dash
  • Dedicated servers with the mod installed no longer create config/performancehud.json

  • Compatibility**
  • Client-side only; a server does not need the mod
  • Fabric: Fabric API + Architectury API (Architectury new)
  • NeoForge: Architectury API (new)
  • Forge: Forge only
  • Each jar targets exactly one Minecraft version

  • Unchanged**
  • HUD lines and formats, draw position, F8, commands and value ranges, settings screen, config keys/defaults, translations
### 1.2.0

  • Ports**
  • New: Fabric 1.19.2, Forge 1.21.1, Forge 1.21.11
  • Same HUD, F8, /performancehud and /phud, settings screen, and config/performancehud.json as the other builds

  • Fixes**
  • NeoForge 26.2 and 26.3: HUD hides when F1 hides the rest of the interface
  • A typo’d config/performancehud.json is kept as config/performancehud.json.bak before defaults are written (settings are no longer silently lost)
  • If a HUD value can’t be read (entities, chunks, ping, CPU), the reason is logged once; the line still shows a dash
  • Dedicated servers with the mod installed no longer create config/performancehud.json

  • Compatibility**
  • Client-side only; a server does not need the mod
  • Fabric: Fabric API + Architectury API (Architectury new)
  • NeoForge: Architectury API (new)
  • Forge: Forge only
  • Each jar targets exactly one Minecraft version

  • Unchanged**
  • HUD lines and formats, draw position, F8, commands and value ranges, settings screen, config keys/defaults, translations
### 1.2.0

  • Ports**
  • New: Fabric 1.19.2, Forge 1.21.1, Forge 1.21.11
  • Same HUD, F8, /performancehud and /phud, settings screen, and config/performancehud.json as the other builds

  • Fixes**
  • NeoForge 26.2 and 26.3: HUD hides when F1 hides the rest of the interface
  • A typo’d config/performancehud.json is kept as config/performancehud.json.bak before defaults are written (settings are no longer silently lost)
  • If a HUD value can’t be read (entities, chunks, ping, CPU), the reason is logged once; the line still shows a dash
  • Dedicated servers with the mod installed no longer create config/performancehud.json

  • Compatibility**
  • Client-side only; a server does not need the mod
  • Fabric: Fabric API + Architectury API (Architectury new)
  • NeoForge: Architectury API (new)
  • Forge: Forge only
  • Each jar targets exactly one Minecraft version

  • Unchanged**
  • HUD lines and formats, draw position, F8, commands and value ranges, settings screen, config keys/defaults, translations
### 1.2.0

  • Ports**
  • New: Fabric 1.19.2, Forge 1.21.1, Forge 1.21.11
  • Same HUD, F8, /performancehud and /phud, settings screen, and config/performancehud.json as the other builds

  • Fixes**
  • NeoForge 26.2 and 26.3: HUD hides when F1 hides the rest of the interface
  • A typo’d config/performancehud.json is kept as config/performancehud.json.bak before defaults are written (settings are no longer silently lost)
  • If a HUD value can’t be read (entities, chunks, ping, CPU), the reason is logged once; the line still shows a dash
  • Dedicated servers with the mod installed no longer create config/performancehud.json

  • Compatibility**
  • Client-side only; a server does not need the mod
  • Fabric: Fabric API + Architectury API (Architectury new)
  • NeoForge: Architectury API (new)
  • Forge: Forge only
  • Each jar targets exactly one Minecraft version

  • Unchanged**
  • HUD lines and formats, draw position, F8, commands and value ranges, settings screen, config keys/defaults, translations
### 1.2.0

  • Ports**
  • New: Fabric 1.19.2, Forge 1.21.1, Forge 1.21.11
  • Same HUD, F8, /performancehud and /phud, settings screen, and config/performancehud.json as the other builds

  • Fixes**
  • NeoForge 26.2 and 26.3: HUD hides when F1 hides the rest of the interface
  • A typo’d config/performancehud.json is kept as config/performancehud.json.bak before defaults are written (settings are no longer silently lost)
  • If a HUD value can’t be read (entities, chunks, ping, CPU), the reason is logged once; the line still shows a dash
  • Dedicated servers with the mod installed no longer create config/performancehud.json

  • Compatibility**
  • Client-side only; a server does not need the mod
  • Fabric: Fabric API + Architectury API (Architectury new)
  • NeoForge: Architectury API (new)
  • Forge: Forge only
  • Each jar targets exactly one Minecraft version

  • Unchanged**
  • HUD lines and formats, draw position, F8, commands and value ranges, settings screen, config keys/defaults, translations
### 1.2.0

  • Ports**
  • New: Fabric 1.19.2, Forge 1.21.1, Forge 1.21.11
  • Same HUD, F8, /performancehud and /phud, settings screen, and config/performancehud.json as the other builds

  • Fixes**
  • NeoForge 26.2 and 26.3: HUD hides when F1 hides the rest of the interface
  • A typo’d config/performancehud.json is kept as config/performancehud.json.bak before defaults are written (settings are no longer silently lost)
  • If a HUD value can’t be read (entities, chunks, ping, CPU), the reason is logged once; the line still shows a dash
  • Dedicated servers with the mod installed no longer create config/performancehud.json

  • Compatibility**
  • Client-side only; a server does not need the mod
  • Fabric: Fabric API + Architectury API (Architectury new)
  • NeoForge: Architectury API (new)
  • Forge: Forge only
  • Each jar targets exactly one Minecraft version

  • Unchanged**
  • HUD lines and formats, draw position, F8, commands and value ranges, settings screen, config keys/defaults, translations
### 1.2.0

  • Ports**
  • New: Fabric 1.19.2, Forge 1.21.1, Forge 1.21.11
  • Same HUD, F8, /performancehud and /phud, settings screen, and config/performancehud.json as the other builds

  • Fixes**
  • NeoForge 26.2 and 26.3: HUD hides when F1 hides the rest of the interface
  • A typo’d config/performancehud.json is kept as config/performancehud.json.bak before defaults are written (settings are no longer silently lost)
  • If a HUD value can’t be read (entities, chunks, ping, CPU), the reason is logged once; the line still shows a dash
  • Dedicated servers with the mod installed no longer create config/performancehud.json

  • Compatibility**
  • Client-side only; a server does not need the mod
  • Fabric: Fabric API + Architectury API (Architectury new)
  • NeoForge: Architectury API (new)
  • Forge: Forge only
  • Each jar targets exactly one Minecraft version

  • Unchanged**
  • HUD lines and formats, draw position, F8, commands and value ranges, settings screen, config keys/defaults, translations
### 1.2.0

  • Ports**
  • New: Fabric 1.19.2, Forge 1.21.1, Forge 1.21.11
  • Same HUD, F8, /performancehud and /phud, settings screen, and config/performancehud.json as the other builds

  • Fixes**
  • NeoForge 26.2 and 26.3: HUD hides when F1 hides the rest of the interface
  • A typo’d config/performancehud.json is kept as config/performancehud.json.bak before defaults are written (settings are no longer silently lost)
  • If a HUD value can’t be read (entities, chunks, ping, CPU), the reason is logged once; the line still shows a dash
  • Dedicated servers with the mod installed no longer create config/performancehud.json

  • Compatibility**
  • Client-side only; a server does not need the mod
  • Fabric: Fabric API + Architectury API (Architectury new)
  • NeoForge: Architectury API (new)
  • Forge: Forge only
  • Each jar targets exactly one Minecraft version

  • Unchanged**
  • HUD lines and formats, draw position, F8, commands and value ranges, settings screen, config keys/defaults, translations
### 1.2.0

  • Ports**
  • New: Fabric 1.19.2, Forge 1.21.1, Forge 1.21.11
  • Same HUD, F8, /performancehud and /phud, settings screen, and config/performancehud.json as the other builds

  • Fixes**
  • NeoForge 26.2 and 26.3: HUD hides when F1 hides the rest of the interface
  • A typo’d config/performancehud.json is kept as config/performancehud.json.bak before defaults are written (settings are no longer silently lost)
  • If a HUD value can’t be read (entities, chunks, ping, CPU), the reason is logged once; the line still shows a dash
  • Dedicated servers with the mod installed no longer create config/performancehud.json

  • Compatibility**
  • Client-side only; a server does not need the mod
  • Fabric: Fabric API + Architectury API (Architectury new)
  • NeoForge: Architectury API (new)
  • Forge: Forge only
  • Each jar targets exactly one Minecraft version

  • Unchanged**
  • HUD lines and formats, draw position, F8, commands and value ranges, settings screen, config keys/defaults, translations
PerformanceHUD Icon
Download PerformanceHUD
Select game version
Select platform