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.
Links
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.
