SupportBundle

SupportBundle is a lightweight support-report generator for NeoForge modpacks.

When a player says "something is broken", SupportBundle gives them a simple way to create a local diagnostic .zip file that can be attached to a Discord message, GitHub issue, or support ticket.

It is designed for modpack authors, server staff, and players who want cleaner bug reports without manually digging through logs, mod lists, resource packs, settings, and crash reports.

SupportBundle does not upload anything automatically. All reports are created locally on the player's machine.

Features

SupportBundle can create a structured support archive containing useful information about the current client setup, including:

Minecraft, NeoForge, Java, JVM and system information
Installed mod list with mod IDs, names and versions
Active resource packs
Important client options
Keybind conflicts
Sanitized latest.log tail
Latest crash report, if available and enabled
Optional extra text files configured by the modpack
A human-readable report.txt
A structured report.json
A ready-to-copy Discord/GitHub support message

Reports are saved by default to:

.minecraft/supportbundle/reports/

How to Use

You can open SupportBundle in several ways:

Click the Support Bundle button in the pause menu
Run /supportbundle
Run /supportbundle create to create a report directly
Use the configurable keybind from Minecraft's Controls menu

After creating a report, attach the generated .zip file to your bug report or support request.

For Players

SupportBundle helps you send better bug reports with less effort.

Instead of manually collecting your mod list, logs, resource packs and client settings, you can create one support archive and share it with the person helping you.

Before sharing a report, you should still review the contents of the generated archive.

For Modpack Authors and Server Staff

SupportBundle is built to make support easier.

You can include it in a modpack and ask players to send a SupportBundle report when reporting issues. This gives you more consistent information across support requests and reduces the usual back-and-forth questions like:

What modpack version are you using?
What Java version are you running?
What mods are loaded?
Are there any keybind conflicts?
What resource packs are enabled?
What does your latest log say?
Was there a recent crash report?

SupportBundle also includes a configurable copied message template, so players can quickly paste a formatted support message into Discord, GitHub Issues, or another support platform.

What Is Included in a Report?

A generated SupportBundle archive may include:

report.json
report.txt
mods.json
keybind-conflicts.txt
resource-packs.txt
options-summary.txt
latest.log.txt
crash-reports.txt
readme.txt
additional-files/

Some files are only included when enabled in the config and when the source file exists.

Privacy-Focused by Default

SupportBundle only creates local files. It does not upload reports anywhere.

The mod includes a sanitizer for collected text files and logs. It can redact common sensitive values such as:

Access tokens
Session IDs
Email-like strings
User folder paths
Username, unless enabled in config
Server address or IP, unless enabled in config
Extra custom regex patterns configured by the modpack

Username and server address collection are disabled by default.

Even with sanitization, players should review the generated archive before sharing it publicly.

Modpack Customization

SupportBundle includes a flexible TOML config for modpack creators.

You can customize:

GUI title
GUI instruction text
Report folder
Zip filename prefix
Copied Discord/GitHub message template
Pause menu button visibility
Keybind behavior
Latest log collection
Maximum latest log tail size
Crash report collection
Resource pack collection
Keybind conflict collection
Username and server address privacy settings
OS/JVM information collection
Additional allowlisted files
Extra sanitizer regex patterns
Support URL
Issue tracker URL
Discord URL
Whether support links are shown in the GUI

This makes it easy to adapt SupportBundle to your own modpack, server, support workflow or community.

Client-Side Utility

SupportBundle is mainly a client-side support tool.

It is useful in both singleplayer and multiplayer, and it does not require the server to have the mod installed for players to create local reports.

Good Use Cases

SupportBundle is useful when:

A player needs to report a modpack issue
A server owner needs more detailed client information
A modpack author wants cleaner support requests
A crash happened and the latest crash report needs to be shared
A keybind conflict may be causing gameplay issues
A player has the wrong resource packs or settings enabled
Support staff need the mod list, environment info and logs in one place

What SupportBundle Is Not

SupportBundle is not a crash fixer.

It does not automatically repair worlds, fix broken mods, upload reports, or diagnose every possible issue. Its goal is to create a clean and consistent support bundle that makes troubleshooting easier.

Summary

SupportBundle gives players a simple button for creating useful support reports, and gives modpack authors a cleaner way to receive bug reports.

It is lightweight, local-first, privacy-conscious, configurable, and designed specifically for Minecraft modpack support workflows.