Light Core

# 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.