Understanding the Golem Delivery Dilemma
Thaumcraft’s golems are among the most beloved automation tools in modded Minecraft. These tiny, customizable helpers can sort items, fill chests, and keep your magical factory running smoothly. Yet anyone who has relied on golems for precise inventory management knows a frustrating quirk: when a golem tries to place a carried stack into a target inventory, it’s an all-or-nothing deal. If the destination can only accept part of the stack, the golem simply gives up, keeping the entire stack and often wandering back to its starting point without making any progress. This behavior becomes a real headache in modpacks that use Hardcore Questing Mode (HQM) quest delivery systems or any inventory that enforces strict stack limits.
Introducing Thaumcraft: Golem Batch Guard
Golem Batch Guard is a lightweight Forge addon for Minecraft 1.7.10 that rewires this exact behavior. Instead of forcing the golem to insert the whole carried stack or nothing, the mod teaches golems to try smaller batches. If a full stack is rejected, the golem will intelligently search for the largest acceptable amount, insert that portion, and keep the remainder for the next trip. This means your golems finally work the way you always wished they would—delivering exactly what the target can take, without wasting items or getting stuck in loops.
How the Batch Insertion Works
The mod’s logic is both clever and respectful of Thaumcraft’s original design. When a golem approaches an inventory to place items, the standard Thaumcraft insertion is always attempted first. If the target happily accepts the full carried stack, nothing changes. The magic happens only when the full stack is rejected unchanged. At that point, the guard kicks in and performs a binary search: it creates a copied stack and offers it to the target inventory, gradually narrowing down the largest batch size that gets fully accepted. A configurable minimum batch size prevents the golem from wasting time on tiny one-item offers unless absolutely necessary. If even a single item cannot be placed, the golem keeps the entire stack as before.
For example, imagine a golem carrying 8 cobblestone and a guarded HQM quest delivery system that can safely accept only 2 more. Without the mod, the golem would fail and return with all 8. With Golem Batch Guard, the golem inserts 2, keeps 6, and can deliver the rest later. This also applies during pickup simulations: if a source chest has 10 stone and the destination can only take 4, the golem will still pick up the full 10 because the simulation sees that 4 can be placed. The placement step then inserts 4 and preserves the remaining 6 for normal Thaumcraft handling.
Key Features at a Glance
- Golem Stack Preservation: The uninserted part of a carried stack stays with the golem, avoiding item loss or unnecessary back-and-forth trips.
- Smaller Batch Retry: When a full stack is rejected, the mod retries with copied stacks to find a safe smaller insertion amount using a binary search.
- Thaumcraft AI Patch: The coremod redirects only the golem item-placement AI calls, leaving all other golem behaviors—movement, marker colors, sorting checks, home checks—untouched.
- All Inventory Targets: Works through Thaumcraft’s normal IInventory insertion path, so any modded inventory that follows standard contracts benefits, not just HQM systems.
- QDS Compatibility: Explicitly supports the all-or-nothing validation of HQM quest delivery systems, making it a perfect partner for the hqm-dontvoidmyitems addon.
- Configurable Guard: A generated Forge config lets you enable or disable the guard, set the minimum batch size, and toggle debug logging for troubleshooting.
Under the Hood: A Scoped Coremod Approach
Because Thaumcraft’s golem insertion logic is baked directly into its AI classes, Golem Batch Guard uses a small coremod patch. It registers late UniMixins mixins, ensuring Thaumcraft classes are fully available before the targets are prepared. The redirects focus on four key AI tasks: AIHomePlace, AIEmptyPlace, AISortingPlace, and AIHomeReplace. Each of these calls Thaumcraft’s InventoryUtils.placeItemStackIntoInventory(...), and the mod intercepts those calls to apply the batch guard. Additionally, source filter simulations in GolemHelper.getContainersWithRoom(...) are redirected so golems can pick up a larger source stack even when only a smaller batch is currently insertable at the destination. The guarded hook always reuses Thaumcraft’s original inventory helper internally with copied stacks, preserving compatibility.
This scoped approach means the mod never touches item pickup, extraction, fluids, essentia, or HQM internals. It simply makes golem item placement smarter. For players who enjoy tinkering with mods, the installation process is refreshingly straightforward. Many users find that adding this mod to their setup is as simple as dropping it into the mods folder, but if you prefer a more streamlined experience, you can easily install it via the foxygame.net launcher—a convenient, flexible, and modern Minecraft launcher where you can download mods right from the menu. This launcher handles dependencies like UniMixins automatically, so you can focus on building your golem-powered empire without wrestling with file management.
Compatibility and Requirements
Golem Batch Guard is built for a specific but widely used modded environment: Minecraft 1.7.10, Forge 10.13.4.1614, UniMixins 0.3.0, and Thaumcraft 4.2.3.5. It does not alter any other mod’s code, so it slots neatly into existing modpacks. The mod’s behavior depends on the correct return contract of Thaumcraft’s original inventory helper; inventories that falsely report successful insertion but internally discard items cannot be fixed by this addon. For HQM quest delivery systems, overfill protection still relies on the hqm-dontvoidmyitems addon rejecting unsafe oversized stacks. Manual testing is recommended for automation-heavy modpacks, as different inventories may implement insertion rules in unexpected ways.
Configuration and Fine-Tuning
After the first launch, the mod generates a config file with three simple options. enableBatchGuard (default true) turns the entire feature on or off. minBatchSize (default 1) sets the smallest batch the golem will attempt before falling back to a single-item offer. Setting this higher can prevent golems from making many tiny deliveries, but might also cause them to skip valid small insertions. debugLogging (default false) outputs detailed information about batch search attempts, helping you diagnose why a particular inventory isn’t cooperating. The config is straightforward and rarely needs adjustment once you confirm the mod works with your target inventories.
Limitations to Keep in Mind
While Golem Batch Guard solves a very specific pain point, it’s not a universal inventory fixer. The guard only runs at the redirected Thaumcraft golem AI call sites, so if another mod bypasses those calls entirely, the batch logic won’t engage. Inventories that accept items but then void them due to internal bugs remain problematic. The mod also doesn’t change golem carry limits, movement speed, or any other Thaumcraft settings—it’s purely an insertion behavior tweak. For most players, these limits are irrelevant because the mod does exactly what it promises: it makes golems smarter about partial stack placement without breaking anything else.
Why This Mod Matters for Your Modpack
In complex modpacks where quest delivery, precise storage, and automation intersect, the all-or-nothing golem behavior can grind entire systems to a halt. Golem Batch Guard removes that friction, letting your golems work harmoniously with HQM, Applied Energistics interfaces, or any inventory that respects standard insertion rules. It preserves the charm of Thaumcraft’s golem mechanics while fixing a long-standing annoyance. The result is a smoother, more reliable automation experience that feels like a natural extension of the mod rather than a hack.
Whether you’re running a magic-only pack or a sprawling tech-magic hybrid, this addon deserves a spot in your mods folder. It’s small, configurable, and laser-focused on one problem—making it the kind of quality-of-life improvement that you’ll quickly forget is even a separate mod, because golems simply start behaving the way you always expected them to.