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.

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