Skip to content

TheJoshCode/MineCrash

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 

Repository files navigation

MineCrash Logo

MineCrash Screenshot

MineCrash

MineCrash is a lightweight system tray app that automatically detects Minecraft crash reports, uses AI to summarize the problems, and shows simple fixes — all without opening a terminal.

Features

  • Monitors your Minecraft crash reports folder in real time

  • Summarizes crashes with AI (requires Ollama running locally)

  • Displays easy-to-understand pop-up windows

  • Runs quietly in the system tray with a right-click Quit option

(Optional) Create a config.json file in the same folder as MineCrash.exe to change the crash report directory:

{
  "crash_report_dir": "C:/Path/To/Your/CrashReports"
}

*** Default directory is %APPDATA%/.minecraft/crash-reports.

Usage

  • Run MineCrash.exe.

The app lives in your system tray.

When a new crash report is detected, a window with a summary and fix will appear.

Right-click the tray icon to quit MineCrash.

Requirements

  • Windows OS

  • No need to install Python or dependencies manually (all included in the EXE)

Troubleshooting

  • Ensure Minecraft crash reports are being saved to the configured directory.
  • Ensure GPU Drivers are up-to-date and CUDA is available (VRAM)

About

Turn MineCraft Crash Reports Into Plain English, With The Power Of AI!

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors