FluidOredict

Fluid Oredict

     Tired of incompatible liquids across your favorite mods? Ever experienced HBM's oil being rejected by Industrial Upgrade, TerraFirmaCraft (TFC) breaking machine recipes by overriding vanilla water generation, or wanting Thermal Expansion's liquid XP to work seamlessly with Ender IO? Fluid Oredict is designed specifically for you! It brings a true Ore Dictionary system to liquids via a simple, intuitive configuration file.

How It Works?

Setting up fluid unification is straightforward and takes less than a minute:

1.    Navigate to your instance's config folder and locate the configuration file (e.g., tfcfluidcompat.cfg).

2.    Open it using any standard text editor.

3.    Add new lines or modify existing ones, listing interchangeable fluids separated by commas (,).

4.    Save the file! You can now use TFC's fresh water in GregTech CE's electrolyzers and across all other machine recipes.

Note: Most integrated mods support hot-reloading your configuration changes directly in-game!

Q&A:"How does this work under the hood? 1.12.2 doesn't have a built-in fluid oredict!" 
The mod scans all crafting recipes in integrated mods. Whenever it detects a fluid you have registered in your configuration list, it automatically generates absolute copies of those recipes utilizing the alternative fluids from the same list.

What about permutations? If you replace vanilla water, then add modded lava, the mod doesn't just swap single fluids—it creates permutations for all combinations. If you list 10 different fluids, all of them will interoperate and mix seamlessly across recipes!

Priority Rule (Right-to-Left)

The further to the right a fluid is written in your list, the higher priority it holds. Some rigid mechanisms (such as certain Thermal Expansion machines) cannot duplicate recipes dynamically; in those cases, the mod will automatically assign the fluid written rightmost in your configuration list (e.g., if vanilla water = tfc fresh water, the Thermal Expansion Volcanic Press will prioritize and use the rightmost entry).

Starting with version 2.0

Modpack Maker Tools (QoL):

Command /tfcfluidcompat dump: Generates a tfcfluidcompat_fluids.txt file in the dumps folder with a complete list of all in-game fluids (System ID, In-Game Name, Owner Mod). Works independently of MCP mappings.

Smart Suggestions System (Heuristics): The mod automatically analyzes loaded fluids, matches word roots, and creates a tfcfluidcompat_suggestions.txt (config folder) file with ready-to-use templates to copy into your config.

Localization: system messages in the chat are now automatically translated into the client's language (all European languages ​​are supported).

Starting with version 3.0

How the New Equivalence System Works

In older versions, grouping fluids meant they were perfectly equal everywhere. If you linked Diesel, Biodiesel, and Crude Oil, any machine requiring Crude Oil would suddenly accept refined Diesel, completely breaking modpack progression.

Version 3.0 solves this by allowing one-way fluid substitutions. You can now define a "target" fluid and list its acceptable "substitutes."

The Intermediary Concept: You can configure machines requiring Diesel to accept both Biodiesel and Crude Oil as valid substitutes. However, a machine specifically requesting Biodiesel will strictly reject Crude Oil. Diesel acts as the flexible intermediary without breaking the logical rules of other machines.

Configuration Guide
The mod generates a tfcfluidcompat.cfg file where you define your fluid relationships. The system supports two formatting styles simultaneously:

Directed (One-Way) Mappings: Use a colon to define a target and its substitutes.
target_fluid: substitute_1, substitute_2
Example: diesel: biodiesel, oil (Machines needing diesel will accept biodiesel and oil. Machines needing oil do not accept diesel)

Mutual (Legacy) Mappings: Use a simple comma-separated list for fluids that should be perfectly interchangeable everywhere.
Example: water, fresh_water, salt_water

Compatibility List

Fluid Oredict currently features built-in integration with the following mods (Minecraft 1.12.2 Forge):

Thermal Expansion 5.5.7.1-universal
Industrial Upgrade 3.3.0.47
GregTech CEu (GTCEu) 2.8.10-beta (with addon support)
GalaxySpace 2.1.4
Ender IO 5.3.72 (EnderCore 0.5.78)
Tinkers' Construct 2.13.0.183 (with addon support)
Nuclear Tech Mod (NTM-CE) 2.5.0.5
Immersive Engineering 0.12-98 (full support for IT, IP, II)
Techguns (Community Edition) 2.1.3.0
Mekanism-CE-Unofficial-All-10.0.2.540 (and original version 9.8.3.390)
industrialcraft-2-2.8.222-ex112
CraftTweaker2-1.12-4.1.20.715
jei
pneumaticcraft-repressurized-1.12.2-0.11.15-398
nuclearcraft-1.12.2-2.19c
forestry_1.12.2-5.8.2.427
buildcraft-all-8.0.0 (BC remastered)
evil craft
blood magic
embers
rustic
Industrial Foregoing
Rockhounding Mod: Chemistry

Missing Your Favorite Mod?

Don't worry! Drop a comment on CurseForge, and I will do everything in my power to add support and expand the Fluid Oredict collection;)

Unsupported Mods / Blacklist

Galacticraft (1.12.2-4.0.6) — Please do not request support for Galacticraft; compatibility will not be implemented.:‹
(if you play with these mods, there will be no crashes)

CraftTweaker Integration: User Guide

CraftTweaker support allows modpack authors to flexibly manage fluid equivalences manually using ZenScript scripts, going beyond the standard configuration file. This is especially useful for integrating custom fluids from other mods on the fly.

How to use it with our mod:

1. Open the scripts folder in the root directory of your Minecraft profile.

2. Create a new text file with the .zs extension (e.g., tfcfluidcompat.zs) or open an existing script.

3. Use our mod's API methods to register new mappings.

Usage Example:

// 1. Import mod package for fluid management
import mods.tfcfluidcompat.Equivalence;

// 2. Example: Adding an entire fluid equivalence group
// All listed fluids will be treated as interchangeable across all supported machines.
Equivalence.addFluidGroup("oil,crude_oil,black_gold");

// 3. Example: Adding a specific fluid to an existing standard
// Now machines (IC2, Mekanism, etc.) that accept "water" will also accept "spring_water".
Equivalence.addEquivalent("water", "spring_water");

Note: CraftTweaker scripts are applied during game launch. Once added, all generated recipes (electrolyzers, fermenters, etc.) will automatically pick up these changes.