What Is Re-Fraction and Why Your Scavenge Gameplay Needs It
Minecraft modding constantly reshapes how we experience blocky worlds, and scavenge mechanics have become a favorite among players who love resource gathering with a twist. Re-Fraction steps in as a dedicated Scavenge Addon that completely reimagines how you interact with blocks. Instead of the traditional scavenge triggers, this mod lets you fire custom loot scripts whenever a player breaks or places a block. It feels like having a personal loot designer right inside your server’s config files.
Understanding the Core Shift from Standard Scavenge
The original Scavenge system already offered powerful automation, but Re-Fraction moves the trigger points to the exact moment a block is broken or placed. Because the underlying logic differs so drastically, the developer wisely packaged it as a standalone addon. This separation keeps your existing scavenge setups intact while opening a fresh avenue for event-driven loot. You are no longer limited to just inventory-based scavenging; now the world itself responds to your actions with tailored rewards.
How Break and Place Scripts Work
Every interaction is defined through a JSON script that you drop into the mod’s configuration. The script listens for a targeted block ID and then executes a series of conditions and drops. Here is a simplified look at what a typical break script contains:
- id – A unique identifier for your script, such as
"test:break_netherrack". - swing – Whether the player’s arm swing animation plays.
- drop_rule – Defines how the loot physically appears in the world, often set to
"block". - type – Determines the event trigger, with
"break"or"place"as the new options, plus flags like"consume"and"show". - targets – An array of blocks that the script watches, for instance
"minecraft:nether_brick". - properties – Optional conditions such as requiring the player to sneak or adding custom data to cancel the vanilla action.
- drops – The loot pool that gets rolled when the script fires, referencing any loot table like
"minecraft:blocks/iron_block".
When a player mines a targeted block, the break type activates. If you set "consume": true, the script will prevent any further scripts from running for that action, giving you precise control over event chaining. The place type works identically but triggers the moment a player sets down a block. This opens up creative possibilities, such as rewarding builders with special items when they place rare blocks, or punishing griefers by canceling their placement entirely.
Canceling Vanilla Actions with Custom Data
One of the most powerful features tucked into Re-Fraction is the ability to cancel the actual game action. Normally, consuming a script only stops other scripts, but the break or place still happens. By injecting a property with "scavenge_utils:add_data" and including "break_data": {"cancel": true} or "place_data": {"cancel": true}, you can completely negate the block interaction. This means you can design scenarios where a player attempts to break a diamond ore, but instead of dropping the ore, the break is canceled and a custom loot chest spawns nearby. It gives map makers and server admins an unprecedented level of authority over the game’s physics.
Practical Applications for Server Owners and Modpack Creators
Imagine a skyblock pack where breaking a log doesn’t give you wood directly but instead triggers a loot crate with saplings and dirt. Or a prison server where placing a specific block within a region grants rank points. Re-Fraction makes these ideas trivial to implement. Because the scripts are plain JSON, you can share them across servers without any Java knowledge. The mod also respects Minecraft’s loot table system, so you can plug in existing tables or craft custom ones with condition predicates for extra randomness.
Managing such a flexible tool becomes even smoother when you use a modern launcher. Many players find that the foxygame.net launcher lets them install Re-Fraction and its dependencies directly from an in-app menu, saving the hassle of manual file juggling. This kind of streamlined setup keeps your modded environment stable and ready for instant experimentation with block-based loot scripts.
Version Compatibility and Migration Notes
The information above applies to Minecraft 1.16 and newer. If you are still running 1.12 or older, the mod’s structure and property names differ, so you will need to consult the legacy documentation. The core concept remains the same, but the JSON syntax has been refined for better readability and performance in the later versions. Always double-check that your server and clients are running the same version of the addon to avoid script mismatches.
Getting Started with Your First Re-Fraction Script
Start by placing a JSON file inside the designated scripts folder. A minimal break script that rewards an iron block when a player breaks nether brick might look like the example from the official description. Test it in a single-player world first to see the drop rule in action. Then experiment with the place type by targeting a decorative block like chiseled stone bricks and dropping a random dye. The property system lets you gate actions behind player states—sneaking, holding a specific item, or even having a certain scoreboard tag—so you can build intricate progression systems without touching a single line of code.
Remember that the consume flag and cancel data work together to create layered interactions. If you want a block to be unbreakable unless the player holds a special tool, you would set the break script to cancel the action by default, then add a property that checks for the tool and, if present, removes the cancel data. The result is a fully custom mining mechanic that feels native to Minecraft.
Final Thoughts on Expanding Your Scavenge Horizons
Re-Fraction breathes new life into the scavenge ecosystem by shifting the focus from inventory scanning to real-time world events. Whether you are building a challenging adventure map, a competitive minigame, or simply want to surprise your survival friends with unexpected loot, this addon delivers a clean and scriptable solution. Its JSON-driven design lowers the entry barrier while the cancel mechanics provide depth for advanced creators. Pair it with a robust loot table library, and you have a toolkit that can transform any block into a story waiting to be uncovered.