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.