RFTools · Troubleshooting · Intermediate

RFTools Troubleshooting Guide: Fixing Dimension Deaths, Quarry Stops, and Teleport Failures

RFTools offers some of the most powerful automation and dimension-building tools in modded Minecraft, but minor configuration errors can quickly lead to trapped gear, stalled quarries, or wasted resources. This guide provides practical, step-by-step solutions to rescue items from collapsed dimensions, get your Builder quarry running again, and stop your Endergenic Generator from eating Ender Pearls. Mastering these troubleshooting techniques will save your hard-earned equipment and keep your base running at peak efficiency.

What you need

  • Phased Field Generator (fully charged with RF/FE)
  • Charged Porter or Matter Transmitter and Dialing Device
  • Builder, Shape Card (Quarry), and a valid inventory (such as a Chest or Modular Storage)
  • Endergenic Generator, Pearl Injector, and Ender Monitors
  • Smart Wrench and Redstone conduits or repeaters
  • A chunk-loading solution (like FTBUtilities or a Weirding Gadget)

Step by step

  1. 1Rescue Gear from a Collapsed Dimension

    If your custom dimension runs out of power while you are inside, you will instantly die, leaving your grave in a lethal void. To rescue your items without dying again, craft a Phased Field Generator and charge it completely in an energetic infuser or capacitor. Hold it in your inventory (or Baubles/Curios slot if supported) before dialing back into the unpowered Matter Receiver. The tool will actively drain its own internal RF buffer to protect you from dimension collapse damage, giving you enough time to break your grave and teleport home.

    Tip: Always bring a pre-linked Charged Porter with you so you do not have to rely on an unpowered Matter Transmitter inside the dead dimension to escape.

  2. 2Fix Builder Quarry Inventory Halts

    When a Builder with a Shape Card (Quarry) stops working or refuses to start, the most common culprit is a missing or full output inventory. Place a standard Chest, double chest, or RFTools Modular Storage block directly on top of or underneath the Builder. Open the Builder GUI and verify that the wait/skip toggle is set properly; by default, the Builder pauses safely whenever it cannot output a mined block rather than voiding your resources.

    Tip: Place a Filter Module inside the Builder to automatically void common blocks like dirt and cobblestone, preventing your storage from clogging up instantly.

  3. 3Resolve Builder Redstone and Chunk Errors

    If your inventory has space and the Builder has power but still does nothing, check the redstone control button in the lower left of its GUI. By default, the Builder requires an active Redstone signal to operate, so either place a lever on it or change the GUI setting to 'Ignored'. Additionally, verify that the chunk containing the Builder is chunk-loaded, and hit the 'Restart' button in the GUI if you recently updated the coordinates on the Shape Card.

    Tip: You only need to chunk-load the Builder itself; the Builder automatically chunk-loads the remote single chunk it is currently actively mining.

  4. 4Troubleshoot Matter Teleportation Failures

    If a Matter Transmitter beam turns red or fails to teleport you, open your Dialing Device and click 'Check' on the target Matter Receiver. A status of 'No Power' or 'Unloaded' means the destination chunk has unloaded or drained its energy buffer. Ensure the target Receiver is actively chunk-loaded and connected to a stable power grid, and verify via the Receiver's GUI that its access permissions are not set to private if a friend placed it.

    Tip: If you dial a Matter Receiver located in an unpowered RFTools Dimension, the teleport will still work, so always check the Dimension Builder's power level before stepping into the beam.

  5. 5Stop Endergenic Generator Pearl Loss (Destination)

    Endergenic Generators easily lose Ender Pearls if the network loop is not properly linked. Take your Smart Wrench, switch it to configuration mode, right-click the first Endergenic Generator, and then right-click the next one in your circle to set its destination. Repeat this for every generator in the loop until the final one links back to the first, ensuring pearls have a valid path to travel.

    Tip: Click the 'Show Particles' button in the Endergenic Generator GUI to see colorful visual indicators showing whether pearls are being destroyed or successfully passed.

  6. 6Synchronize Endergenic Timing with Ender Monitors

    If your linked generators still drop pearls immediately after firing, your redstone timing is out of sync. Place an Ender Monitor directly adjacent to each Endergenic Generator, ensuring the monitor's input arrow points straight at the generator block. Set the Ender Monitor mode to 'Pearl Arrived', and route its redstone output through a precise delay into the next generator so that the target enters 'charging' mode just before the pearl physically lands.

    Tip: Because server tick rates and pearl travel distances vary, consult your in-game RFTools manual via JEI and adjust repeater delays by single ticks until power output stabilizes.

  7. 7Automate Safe Pearl Injection

    Firing a second Ender Pearl into an Endergenic loop that already has an active pearl will cause both pearls to collide and vanish. To fix this, set up an Ender Monitor on your very first generator set to 'Pearl Lost' mode to trigger your Pearl Injector only when the loop fails. For the initial startup, use a simple push button on the Pearl Injector rather than a fast redstone clock.

How it works

RFTools Dimensions require a constant tick-by-tick RF/FE upkeep cost based on the complexity of the dimlets used to create them. When a Dimension Builder's internal capacitor hits zero and the dimension's own energy buffer depletes, the mod applies a severe, unavoidable void-like damage effect to any entity inside. The Phased Field Generator works by intercepting this specific damage event and substituting the player's health loss with an RF deduction from the handheld item.

The Builder operates on a state-machine pointer that scans one block at a time within the coordinates defined by the Shape Card. To prevent lag and item entities from flooding the world, the Builder refuses to break a block until it confirms a valid inventory slot exists in an adjacent container for the drops. If an area is protected by spawn protection or chunk-claiming mods, the Builder's fake player is blocked from breaking the block, causing it to pause unless configured in the GUI to skip unbreakable blocks.

The Endergenic Generator generates RF by tossing an Ender Pearl between nodes at a fixed velocity. When a generator receives a redstone pulse, it opens a charging window that lasts for a specific number of game ticks. If a pearl arrives too early, the generator is idle and drops the pearl; if the generator charges for too long before the pearl arrives, it consumes RF instead of creating it and destroys the pearl. Peak power occurs when the pearl arrives around the middle of the charging tick window, requiring tight redstone signal travel between the Ender Monitor and the next generator.

Common mistakes

  • Leaving the Dimension Builder in an unloaded chunk in the Overworld: The moment you teleport into your custom dimension, the Overworld unloads, cutting power to the Dimension Builder and killing you seconds later.
  • Using the wrong wrench on Endergenic Generators: Standard wrenches from other mods might rotate or break the block; you must use the RFTools Smart Wrench to link pearl destinations.
  • Forgetting to click 'Restart' on the Builder: If you remove a Shape Card to adjust its offset or dimensions and put it back in, the Builder often remembers its old progress pointer and thinks it is already finished until you press Restart.
  • Placing Ender Monitors facing the wrong direction: The Ender Monitor is directional and will never output a redstone signal unless its front sensor face is pointing directly into the Endergenic Generator it is watching.

FAQ

Why is my Builder quarry skipping blocks or leaving weird pillars behind?

This usually happens when the Builder encounters blocks with tile entities (like chests or spawners), bedrock, or claimed chunks while 'Skip' mode is active. It can also happen if its internal RF buffer runs dry mid-operation while 'Do not wait' is enabled. Ensure it has constant power and check chunk claim permissions for fake players.

How do I retrieve my Dialing Device link if I accidentally broke my Matter Receiver?

Once a Matter Receiver is broken, its unique destination ID is destroyed and will disappear from the Dialing Device once you click 'Check'. When you place the Receiver back down, you must re-select it in the Dialing Device and click 'Dial' to establish a fresh connection.

Can I charge a Dimension Tab in multiple Dimension Builders at once to save a high-cost dimension?

No, a Realized Dimension Tab can only exist in one Dimension Builder at a time. However, once inside the dimension, you can craft and place an Activity Probe or an internal Dimensional Powercell system (depending on your mod version) to feed power directly from multiple sides.

Why does my Endergenic Generator produce negative or very low power even though pearls are not breaking?

If pearls survive the loop but power is low, your redstone delay is slightly too short, causing the generators to start charging too early and drain RF while waiting for the pearl. Increase your redstone repeater or conduit delay by one or two ticks and check the GUI's last-tick RF stats.

By keeping a charged Phased Field Generator for dimension emergencies, verifying chunk loads and inventory access on your Builder, and precisely timing your Endergenic Monitors, you can easily prevent and solve the most frustrating disasters in RFTools.

More RFTools guides

RFTools · Getting startedRFTools Getting Started Guide: Dimensional Shards, Machine Frames, and InfusingEvery powerful device in the RFTools mod family—from automated quarry Builders to wireless power cells and custom Dimension Builders—relies on a shared foundation of core components. In this guide, you will learn how to craft your essential configuration tool, mass-produce Machine Frames, locate rare Dimensional Shards, and use the Machine Infuser to permanently upgrade your machines so they run faster and consume less energy.Beginner6 steps
RFTools · AutomationHow to Automate Multi-Step Recipes with the RFTools CrafterIn this guide, you will learn how to master the RFTools Crafter to automate complex, multi-step crafting chains within a single block. Unlike basic single-recipe auto-crafters, the RFTools Crafter can store up to eight sequential recipes and handle catalysts seamlessly, saving you massive amounts of factory space and piping.Beginner8 steps
RFTools · PowerRFTools Power Endergenic Generator Setup: High-RF Ender Pearl Power PlantThe Endergenic Generator is one of the most rewarding and complex power sources in the RFTools family, capable of generating tens of thousands of RF per tick from a single Ender Pearl. Because it relies on precise tick-based timing rather than simple fuel burning, building one requires an understanding of redstone logic and pearl travel times. This guide walks you through the exact mechanics and provides a foolproof, self-sustaining 4-generator loop to power your late-game base and custom dimensions.Advanced7 steps
RFTools · ProgressionRFTools Power Progression Guide: Coal Generators, Blazing Power, and Wireless PowercellsMastering energy infrastructure is essential for running hungry RFTools machines like the Builder and Dimension Builder. This guide walks you through scaling your energy production from a basic Coal Generator to an automated Blazing Generator setup, while tying everything together with a cross-dimensional wireless Powercell network. By the end, you will have a reliable, wire-free RF grid capable of powering remote quarries and custom dimensions.Intermediate7 steps
RFTools · Addon guideRFTools Control Beginner's Guide: Processors, Crafting Stations, and Visual ProgrammingRFTools Control transforms standard item and fluid routing into a deterministic, visual programming playground capable of handling your most complex factory automation. In this guide, you will learn how to assemble a Processor, link remote Nodes, and build your first opcode program in the Programmer. Mastering this system allows you to execute exact-count inventory transfers and multi-step crafting sequences with zero lag or overflowing buffers.Advanced7 steps