Modrinth · Fabric · Client mod

Light Core

Light Core is a client-side mod. Install it on your computer; the server does not need it.

LightCore is a client-side performance monitor that samples FPS and system memory/CPU usage, logs results, and ranks your Minecraft performance with tiers and insights.

Downloads
2.4K
Author
Stormglyph
Loader
Fabric
Minecraft
1.21.10 – 1.21.9
Updated
–

Setup

Install Light Core on your client

Client-side mods only run on your computer. More server RAM does not change their performance.

  1. 01

    Install the loader locally

    Install Fabric for your Minecraft version in your launcher.

  2. 02

    Download the file

    Download the Light Core file for your loader and your exact Minecraft version, for example 1.21.9.

  3. 03

    Add it to the mods folder

    Put the .jar file in your local .minecraft/mods folder and remove older duplicates.

  4. 04

    Launch

    Launch Minecraft with the loader profile. Nothing needs to change on the server.

On the server
Not needed
On the client
Required
Loader
Fabric
Minecraft
1.21.9, 1.21.8, 1.21.7 +5 more
License
LicenseRef-All-Rights-Reserved

Releases

Published releases

Pick the file that matches your server’s loader and Minecraft version. The server and players need the same release.

Light Core · Modrinth
Original description by the project author

LightCore

LightCore is a lightweight, client-side performance logger for Minecraft that samples FPS and key system metrics, then converts them into a clear score, tier, and ranking—so you can understand what’s driving low performance.

What it measures

LightCore collects periodic performance snapshots containing:

  • Client FPS (averaged over a short rolling window)
  • JVM memory usage (heap used / heap max)
  • Physical memory usage (used / total)
  • CPU load (percent) and CPU core count
  • OS/architecture/Java version metadata (for context)

Scoring, tiers, and ranking

Each snapshot is analyzed into:

  • Score (0–100): a weighted evaluation based on FPS plus penalties from memory pressure, CPU load, and CPU core context
  • Tier: Excellent, Good, Average, or Low
  • Hint: a short, actionable message (e.g., low FPS, high CPU load, or high memory pressure)
  • Rank: where the current snapshot stands compared to recent history
    Sampling timing adapts to current conditions (when FPS is low, it samples more frequently; when FPS is stable, it backs off).

Output (CSV + logs)

Results are written to your local game directory as a CSV file:

  • logs/lightcore-performance.csv
    It also prints a compact summary line to logs for quick checks while testing.

How to use

  1. Install the mod on the client.
  2. Play normally for a few minutes (especially when you suspect lag/stutter).
  3. Review lightcore-performance.csv and the log output to spot trends and the best/worst snapshots.

Compatibility

Designed for Fabric with Fabric API and runs on the client side.

FAQ

Light Core questions

Question not listed? Ask our team.

Does Light Core need to be installed on the Minecraft server?

No. Modrinth marks Light Core as unsupported on the server side. Install it only in your local mods folder. Your server can stay unchanged unless the project page lists an additional dependency.

Which version and loader does Light Core require?

Use a file for Fabric and your exact Minecraft version. Supported versions include 1.21.9, 1.21.8, 1.21.7. Files for different loaders are not interchangeable.

Light Core is not working – what should I check?

First check the Minecraft version, loader version and required dependencies. Because the mod is client-side, more server RAM will not fix it.

Looking for mods for your own server?

The catalog lists mods that run on Minecraft servers.

Browse all mods