Lag Spike Diary

Lag Spike Diary

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

655 downloads 4 followers

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.

No gallery available for this project.

Version Minecraft Loader Download

Lag Spike Diary 1.0.0

1.0.0

1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6
fabric
Download