Lag Spike Diary

📋 Description

Lag Spike Diary is a "black box" for diagnosing lags in Minecraft. The mod automatically tracks FPS freezes and TPS spikes, saves detailed reports, and provides a convenient way to quickly attach diagnostics to an issue.

🎯 Main features

• Automatic freeze detection — monitors FPS and frametime in real time
• Context collection — Saves coordinates, measurement, velocity and other information around the spike
• Detailed Reports — generates JSON files with full information about the system, mods and events
• User—friendly interface - Pause menu buttons and a hotkey for quick access
• Integration with Spark — shows hints if Spark mod is installed

🚀 Quick Start

1. Install the mod in the mods/ folder
2. Start the game — the mod works automatically
3. When freezing, open the pause menu (ESC) and press "Report last spike"
4. Send the created report to the developer

⚙️ Settings

All settings are in the file config/lag_spike_diary.json:

• `frameSpikeMsThreshold' (150) — frametime threshold in milliseconds
• contextBufferSeconds (10) — how many seconds of context to store
• `maxReports' (20) — maximum reports on disk
• `autoNotifyOnSpike' (true) — show notifications in the chat

🎮 Management

• The buttons in the pause menu are in the lower right corner
• Hotkey — configurable in Controls → "Lag Spike Diary" → "Report Last Spike"
• Command /testspike — to test the mod (creates an artificial frieze)

, Reports

The reports are saved in the lag_spike_reports/ folder next to the configs. Each report contains:

• summary.json — spike summary (FPS, frametime, time)
• timeline.json — timeline of events around the spike
• environment.json — system information (Java, OS, Minecraft version)
• mods.json is a list of all installed mods.

🌍 Languages

The mod supports:

• English (default)
• Russian

🔧 Technical Details

• Minimal performance impact — Data collection is very easy
• Automatic cleaning — old reports are deleted automatically
• Compatibility — works with large modpacks, does not conflict with other mods

Note: This mod does not replace Spark as a full-fledged profiler. It focuses on user-friendliness and quick creation of reports for developers.