Описание
# 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.