Advanced Fluid Handling Continued

Advanced Fluid Handling Continued, or AFHC, is an unofficial Factorio 2.1 continuation of the original Advanced Fluid Handling mod created by TheStaplergun.

The goal of this continuation is simple: keep Advanced Fluid Handling working properly with Factorio 2.1 while preserving the original gameplay, design, graphics and progression as closely as possible.

AFHC is primarily a compatibility and maintenance continuation, not a redesign of the original mod.

What does the mod add?

Advanced Fluid Handling greatly expands the possibilities for building fluid networks by adding specialized underground pipes, pumps and valves.

The mod includes:

• Three tiers of underground pipe systems.
• Independently rotatable multi-port pipes-to-ground.
• One-to-one, one-to-two and one-to-three underground pipe connections.
• I, L, T and cross-shaped underground pipe configurations.
• Longer underground pipe distances at higher tiers.
• Three tiers of underground pumps.
• Adjustable overflow valves.
• Adjustable top-up valves.
• Check valves.
• Upgrade paths between the different pipe tiers.

This gives you considerably more freedom when designing compact factories and complex fluid networks without having to route every connection above ground.

Underground pipe controls

Underground pipe ports can be rotated using:

• Ctrl + R
• Ctrl + Shift + R

Adjustable valve controls

Valve thresholds can be adjusted using:

• Numpad +
• Numpad -

Why does this continued version exist?

I wanted to continue using Advanced Fluid Handling with Factorio 2.1.

The original mod received a version update for newer Factorio releases, but several underlying compatibility problems remained and parts of the mod did not work correctly with Factorio 2.1.

I started fixing these problems for my own game and eventually updated the code to properly support Factorio 2.1, while also fixing additional issues I encountered along the way.

I did not immediately create a separate continuation.

The complete Factorio 2.1 compatibility work and fixes were first offered back to the original project through a pull request so that the original maintainer could review and merge the changes into the official version.

At the time of publishing AFHC, that pull request is still waiting for review or acceptance and I have not received a response from the original maintainer.

Because the compatibility work was already complete and working, I decided to make the updated version available separately as:

Advanced Fluid Handling Continued

This project is not intended to take ownership of, replace or compete with the original mod.

The complete compatibility work was offered back to the original project first, and I would still be happy to see those fixes incorporated into the original version.

AFHC exists so that players who enjoy Advanced Fluid Handling can continue using it on Factorio 2.1 while those fixes remain unmerged.

What has been changed?

AFHC focuses primarily on compatibility, bug fixes and maintenance.

The intention is to preserve the original experience rather than redesign the mod or substantially change how it plays.

The Factorio 2.1 compatibility work includes:

• Updating prototypes for Factorio 2.1 compatibility.
• Updating pipe connection definitions for the current Factorio API.
• Updating valve prototypes for the Factorio 2.1 fluid system.
• Fixing obsolete and invalid prototype fields.
• Fixing underground pipe upgrade chains.
• Fixing underground pump upgrade behavior.
• Preserving fluids when rotating underground pipe connections.
• Preserving fluids when changing adjustable valve settings.
• Preserving entity quality during scripted replacements.
• Preserving entity health during scripted replacements.
• Preserving the last user associated with an entity.
• Preserving blueprint ghost tags.
• Restoring the original entity if a scripted replacement fails.
• Maintaining support for pipe-to-ground ghost rotation.
• Removing incomplete compatibility prototypes that could no longer function correctly.
• Updating the mod for optional Space Age support.
• Creating a separate standalone identity and release system for AFHC.

Wherever possible, the original gameplay, balance, graphics, recipes and overall design have been left unchanged.

Standalone mod and save compatibility

AFHC has its own internal mod identity:

advanced-fluid-handling-continued

The established item, recipe, technology and entity prototype names have intentionally been preserved to maintain compatibility with existing saves using the original mod.

Migration from the original Advanced Fluid Handling mod to AFHC has been tested and works with existing saves.

To migrate from the original mod:

1. Save and close your game.
2. Disable or remove the original Advanced Fluid Handling mod.
3. Install and enable Advanced Fluid Handling Continued.
4. Load your existing save.

Because AFHC and the original Advanced Fluid Handling mod share many of the same internal prototype names, both mods cannot be enabled at the same time.

AFHC explicitly marks the original mod as incompatible to prevent both versions from accidentally loading together.

Creating a backup before changing mods is still recommended, especially for large or heavily modded saves.

Versioning

AFHC has its own version history, completely separate from the original project.

The continuation starts at:

0.0.1

This provides AFHC with a clean version history and avoids presenting continued releases as official versions of the original mod.

Future AFHC releases will continue using this independent version system.

Compatibility

AFHC currently targets:

Factorio 2.1

Optional compatibility is included for:

• Space Age
• Dectorio
• Bob's Logistics

Some legacy compatibility code from the original project is also retained where practical.

The mod has been tested in-game, including migration from an existing save using the original Advanced Fluid Handling mod.

Because Factorio mod combinations can vary enormously, compatibility problems may still exist with combinations I have not personally tested.

If you encounter an issue specific to AFHC, please report it on the AFHC GitHub repository.

Original mod and credits

Advanced Fluid Handling Continued is based on the original Advanced Fluid Handling mod.

The original Advanced Fluid Handling mod, its concept, graphics and original implementation were created by TheStaplergun.

Additional historical fixes and translations were contributed by the contributors to the original project.

The Factorio 2.1 compatibility work, maintenance fixes and AFHC continuation are maintained by goakiller900.

Full credit for the original work remains with TheStaplergun and the original contributors.

AFHC would not exist without the work that went into creating the original Advanced Fluid Handling mod.

Important licensing notice

The original project is licensed under the Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International license.

I am aware that the NoDerivatives clause creates a licensing issue for publicly distributing a modified version of the original project.

Before creating this continuation, I submitted the complete Factorio 2.1 compatibility work and fixes back to the original project and am still waiting for that pull request to be reviewed or accepted.

AFHC is being provided in good faith as an unofficial compatibility and maintenance continuation so that players can continue using the mod with Factorio 2.1 while those fixes remain pending.

I do not claim ownership of the original work, and this continuation is not intended for commercial use.

If TheStaplergun, as the original author and rights holder, asks me to remove this continuation or its distributed builds, I will respect that request.

If the original project becomes actively maintained again and the submitted compatibility work is merged or otherwise implemented upstream, the need for this continuation can also be reconsidered.

Source code, issues and development

The source code, development and issue tracking for AFHC are available on GitHub:

https://github.com/goakiller900/pipemod

Please report problems specific to Advanced Fluid Handling Continued on the AFHC repository rather than contacting the original author about problems specific to this continued version.

For the original mod and its official releases, visit:

Advanced Fluid Handling on the Factorio Mod Portal

Advanced Fluid Handling Continued

Keeping Advanced Fluid Handling working for Factorio 2.1.