?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
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.

519
4
519
4

Compatibility

Minecraft: Java Edition

1.20.1โ€“1.20.6

Platforms

Supported environments

Client-side

Tags

Creators

Details

Licensed ARR
Published 6 months ago

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.