Overview#
RFTools Dimensions is the definitive expansion for the RFTools suite, focusing on the creation of entirely custom-built worlds. By utilizing RF (Redstone Flux) energy and a modular system of Dimlets, players can control every aspect of a new dimension, including its terrain shape, block composition, liquid oceans, biomes, weather, and even the flow of time.
Creating a dimension is an end-game pursuit that requires significant infrastructure, massive power generation, and the collection of rare knowledge found throughout the multiverse. Be warned: dimensions require constant power to remain stable. If a dimension's power buffer empties while a player is inside, the result is often instantaneous death.
Getting Started#
To begin your journey into dimensional engineering, you must follow a specific progression path to unlock and craft the necessary components:
- Collect Lost Knowledge: Hunt Endermen or explore vanilla dungeons to find Lost Knowledge items. These are the blueprints for all Dimlets.
- Research: Place Lost Knowledge into a Researcher to identify it.
- Store Knowledge: Transfer identified knowledge into a Knowledge Holder.
- Craft Dimlets: Use a Dimlet Workbench (placed adjacent to a Knowledge Holder) to craft specific Dimlets using parts like Energy Modules and Memory Modules.
- Enscribe: Place an Empty Dimension Tab into a Dimension Enscriber and add your Dimlets to define the world's properties.
- Build: Insert the Realized Dimension Tab into a Dimension Builder to begin the infusion of RF power.
Blocks & Machinery#
The mod adds several high-tech machines required for the dimensional lifecycle.
Dimension Builder
The heart of the mod. It accepts a Realized Dimension Tab and uses RF to create and maintain the dimension.
- Creation Cost: A one-time high-energy cost to 'realize' the world.
- Maintenance Cost: A constant RF/tick drain. If this isn't met, the dimension becomes lethal.
- Buffer: Can store up to 40,000,000 RF.
Dimension Enscriber
Used to 'write' Dimlets onto an Empty Dimension Tab.
- Layout: Features a grid where Dimlets are placed. The order matters (e.g., a Material Dimlet must come before the Terrain Dimlet it modifies).
- Naming: Allows you to name your dimension before storing it.
Dimlet Workbench
The crafting station for all Dimlets. It requires a Knowledge Holder to function.
- Components: Requires a Base Dimlet Part, a Type Controller, an Energy Module, and a Memory Module.
- Essence: Many Dimlets require 'Essence' (e.g., a Block Absorber filled with 128 blocks of Diamond for a Diamond Block Dimlet).
Absorbers
| Used to collect data for Dimlet crafting. Place them in the world to 'absorb' the target feature. | Absorber Type | Usage |
|---|---|---|
| Material Absorber | Place on a block. Requires 128 blocks to fill. | |
| Liquid Absorber | Place near a liquid source. Requires 128 buckets worth. | |
| Biome Absorber | Place in the desired biome. Takes time to reach 100%. | |
| Terrain Absorber | Used to capture specific terrain shapes from other dimensions. | |
| Time Absorber | Captures the current time of day. |
Items & Tools#
Dimension Tabs
- Empty Dimension Tab: The blank slate used in the Enscriber.
- Realized Dimension Tab: The 'key' to your dimension. It displays the maintenance cost and current power level in its tooltip.
Phased Field Generator (PFG)
A vital survival tool. If you enter a dimension that has run out of power, you will normally die instantly. Carrying a charged PFG in your hotbar creates a temporary 'safety bubble,' allowing you to survive and escape. It consumes RF rapidly while active.
Syringe
Used to collect Mob Essence. Attack a mob with the syringe multiple times until it reaches 100%. This is used in the Dimlet Workbench to create Mob Dimlets.
Dimlet Types#
Dimlets are the building blocks of your dimensions. They are categorized by the aspect of the world they control:
| Type | Description |
|---|---|
| Material | Defines the base block of the terrain (e.g., Stone, Diamond Block). |
| Liquid | Defines the fluids used for oceans and lakes (e.g., Water, Lava, Oil). |
| Biome | Specifies which biomes appear in the dimension. |
| Terrain | Controls the shape of the world (Flat, Normal, Void, Amplified, Islands). |
| Feature | Adds structures like Orbs, Tendrils, Canyons, or Lakes. |
| Structure | Forces vanilla structures like Villages, Strongholds, or Nether Fortresses. |
| Sky | Controls sky color, fog color, and the appearance of the sun/moon. |
| Time | Sets the day/night cycle (Normal, Fast, Slow, or Static Noon/Night). |
| Mob | Controls which mobs spawn (or prevents spawning entirely). |
| Effect | Applies potion effects to all players in the dimension (Regeneration, Haste). |
| Controller | Determines how biomes are distributed (Single, Checkerboard, Random). |
| Digit | Used to make dimensions unique. Adding a 'Digit 1' dimlet creates a different seed than 'Digit 2'. |
Mechanics & Maintenance#
Power Consumption
Every Dimlet added to a tab increases the RF/tick maintenance cost.
- Base Cost: Every dimension has a base cost (default 10 RF/t).
- Modifiers: Material Dimlets like 'Diamond Block' add massive costs (e.g., +50,000 RF/t).
- Efficiency Dimlets: Special rare Dimlets that can be added to reduce the total maintenance cost of a dimension.
Dimensional Stability
If the Dimension Builder cannot provide enough RF/tick, the dimension's internal buffer will drain. As it drains, the following occurs:
- Warnings: The sky darkens and the player receives negative status effects (Hunger, Slowdown).
- Lethality: Once the buffer hits 0, any player inside without a Phased Field Generator dies instantly.
Dimension Dungeons
Dimensions created by RFTools often contain unique Dimensional Huts. These small structures contain chests with rare Dimlets, Dimlet Parts, and Lost Knowledge, making exploration of even 'failed' dimensions rewarding.
Configuration#
For server admins and modpack creators, the dimlets.json file is the primary method of balancing the mod.
The dimlets.json Structure
The file is split into two sections by a specific line:
"Everything below this line will be regenerated from defaults every time. Remove this line if you do not want that"
To override default costs or rarities, you must place your custom rules above this line. Rules are evaluated from top to bottom; the first rule that matches a block or mob will be applied.
Filter Tags:
mod: Match by Mod ID.name: Match by registry name (e.g.,minecraft:diamond_block).type: Match by Dimlet type (material,liquid, etc.).feature: Filter by block properties (oredict,falling,tileentity).
Settings Tags:
rarity: 0 (Common) to 6 (Legendary).create: RF cost to create the dimension.maintain: RF/tick cost to keep the dimension running.ticks: Time added to the creation process.
Commands#
The mod provides several administrative commands via /rftdim:
/rftdim list: Lists all existing RFTools dimensions and their IDs./rftdim tp <id>: Teleports the player to the specified dimension ID./rftdim info: Displays detailed power and Dimlet information for the current dimension./rftdim reclaim: Safely removes a dimension from the registry (use with caution)./rftdim forget <id>: Forces the mod to forget a dimension ID, allowing it to be reused.