Don’t Void My Items: Prevent HQM Quest Item Loss

Understanding the Problem: Why Hardcore Questing Mode Eats Your Items

Hardcore Questing Mode (HQM) is a legendary mod that transforms Minecraft into a progression-driven survival challenge, complete with quest books, reputation systems, and the iconic Quest Delivery System (QDS). The QDS is a barrel-like block where you deposit items or fluids to complete specific quest tasks. In theory, it is a convenient way to automate quest completion. In practice, however, the QDS can be a hungry void that swallows your hard-earned resources without making any progress. If you accidentally pipe in the wrong item, or if the quest is already finished, on cooldown, or not even bound to a player, the QDS will still accept and destroy your input. This silent item voiding has frustrated countless players, especially in expert modpacks where every diamond and bucket of destabilized redstone matters.

Introducing "Don't Void My Items": The Guardian of Your Quest Deliveries

"Don't Void My Items" is a precision-engineered mod designed to stop this wasteful behavior. It acts as a gatekeeper for the HQM Quest Delivery System, ensuring that the QDS only accepts items or fluids when that input will actually advance a bound, active, and incomplete consume task. If the QDS cannot make valid progress, the mod simply rejects the input, leaving your items safely in the pipe, hopper, or tank. This small but powerful tweak restores sanity to automated questing setups and protects your inventory from accidental loss.

Key Features That Safeguard Your Resources

• Item Protection: Rejects any item that does not match an unmet QDS item requirement, using HQM's own precision matching rules.
• Fluid Protection: Rejects fluids that do not match an unmet QDS fluid requirement, checking by fluid ID.
• No Overfill Voiding: Accepts only the exact amount still needed by the task, preventing excess items from being destroyed once the requirement is met.
• Unbound QDS Safety: Rejects all input when the QDS is not bound to a player task, so a freshly placed barrel will not eat your items.
• Completed Task Safety: Rejects input after the bound task is already complete, eliminating post-completion waste.
• Cooldown Safety: Respects HQM repeatable quest availability, including cooldown periods, and will not accept items while the quest is on cooldown.
• Seamless HQM Integration: Targets Hardcore Questing Mode 4.4.4 Quest Delivery Systems specifically, leaving all other HQM blocks untouched.

How the Mod Works Under the Hood

Because HQM's QDS consumes items inside its own tile entity logic, a simple peripheral mod cannot intercept the process. "Don't Void My Items" uses a coremod approach, applying a targeted patch directly to the QDS tile entity. This is achieved through UniMixins, a flexible mixin library that allows late loading of the patch so that HQM classes are fully visible before the target is prepared. The mod overrides the item insertion validation and handling, as well as the fluid fill validation and handling, effectively adding a permission check before any resource is accepted. The scope is strictly limited to the Quest Delivery System, so other HQM blocks like the quest book or reputation stations keep their normal behavior.

QDS Input Protection Logic in Detail

The mod performs a series of checks before allowing any input. The QDS will only accept items or fluids when all of the following conditions are true:

• The QDS has a stored player name, meaning it is bound to a specific player's quest progress.
• The QDS can resolve a current task from that player's quest data.
• The current task is of type QuestTaskItemsConsumeQDS, the only task that uses the delivery system.
• The parent quest is available for that player, respecting HQM's availability rules including repeatable quest cooldowns.
• The task data is QuestDataTaskItems, confirming it tracks item/fluid requirements.
• The task is not already completed.
• For items, the incoming stack is checked against unmet item requirements using HQM's own ItemPrecision.areItemsSame comparison, ensuring modded items with NBT data are correctly matched.
• For fluids, the incoming fluid is checked against unmet fluid requirements by fluid ID.

When valid progress is possible, the mod lets the original HQM methods handle the rest. Items are processed through QuestTaskItems.increaseItems, and fluids through QuestTaskItemsConsume.increaseFluid. After successful progress, the QDS sync timer is scheduled exactly as HQM would do internally, so the quest book updates without delay. This means the mod does not reimplement HQM's repeat timing or quest logic; it simply adds a smart gate that follows the existing rules.

Compatibility and Practical Limits

"Don't Void My Items" is built and tested for a specific but widely used modded environment: Minecraft 1.7.10, Forge 10.13.4.1614, UniMixins 0.3.0, and Hardcore Questing Mode 4.4.4. This version combination remains popular in many classic expert modpacks. The mod's coremod patch is lightweight and scoped, minimizing conflicts with other mods. However, there is one important limitation to understand. Automation that deletes source items before calling QDS insertion—for example, some custom piping systems that extract items and then attempt to insert them—cannot be fully protected by the QDS itself. In those cases, the item is already removed from the source inventory before the QDS rejects it, leading to loss. The mod works best with standard automation that respects IInventory.isItemValidForSlot or IFluidHandler.fill, where invalid input is simply left behind in the pipe or container.

If you are assembling a modpack and want to include this fix without manual coremod installation headaches, the foxygame.net launcher offers a convenient, flexible, and modern Minecraft launcher where you can download mods right from the menu. It handles the technical details of mixin loading and mod ordering, making it easy to add "Don't Void My Items" alongside your favorite HQM-based challenges.

Conclusion: Never Lose Progress to a Hungry Barrel Again

Hardcore Questing Mode is all about meaningful progression and resource management, and "Don't Void My Items" aligns perfectly with that philosophy. By preventing the QDS from voiding items and fluids that do not advance a bound consume task, the mod eliminates a long-standing source of frustration. Whether you are deep in an expert skyblock, battling through a tech-heavy questline, or simply automating your deliveries for efficiency, this mod ensures that every ingot, every bucket, and every precious item reaches its intended purpose. Install it, configure your pipes, and enjoy a questing experience where the only thing that disappears is the requirement itself—not your hard-earned resources.