Advanced Fluid Handling for PyMods

Advanced Fluid Handling for PyMods is an unofficial Factorio 2.1 continuation of the original Advanced Fluid Handling For PyMods compatibility addon.

It adapts Advanced Fluid Handling for use with the Pyanodon mod suite by adjusting underground pipe tiers, underground distances, recipes, technology progression, graphics, and other compatibility details to better fit the PyMods ecosystem.

This mod is an addon and requires Advanced Fluid Handling.

What does this addon do?

Advanced Fluid Handling adds a collection of underground pipe junctions, underground pumps, and specialized fluid-handling tools.

Pyanodon's mods significantly change the normal Factorio progression and introduce their own pipe tiers, materials, and fluid infrastructure.

This addon bridges the two systems.

It adjusts Advanced Fluid Handling so that its underground fluid-handling components better follow Pyanodon's progression instead of using their normal vanilla-oriented balance and recipes.

Among other things, the addon:

• Integrates AFH's three underground pipe tiers with Pyanodon's pipe progression.
• Adjusts underground distances to match the corresponding Py pipe tiers.
• Adjusts maximum pipeline extents to match Pyanodon pipes.
• Supports Pyanodon's braided pipe connection categories.
• Adjusts underground pump recipes to use Py materials.
• Adjusts underground pipe component recipes.
• Adjusts technology prerequisites to fit Py progression.
• Matches underground pump speed and energy usage to the current vanilla pump values.
• Provides optional Pyanodon-style graphics for AFH underground pipe junctions.
• Removes AFH valves by default because PyMods already provides its own fluid-control options.
• Maintains compatibility with the current Factorio 2.1 prototype system.

The intention is to make Advanced Fluid Handling feel like it belongs inside a PyMods game rather than simply placing its standard progression on top of Pyanodon.

Requirements

This addon requires:

• Factorio 2.1
• Advanced Fluid Handling
• Py Industry
• Py High Tech

Optional compatibility is included for:

• Py Alien Life
• Py High Tech Pipes Reskin
• Configurable Valves

The mod is intentionally incompatible with the original addon:

underground-pipe-pack_for_py

Both versions should not be enabled at the same time.

Advanced Fluid Handling

This addon is designed specifically for:

Advanced Fluid Handling

Advanced Fluid Handling maintains the established internal item, entity, recipe, and technology prototype names from the original mod.

This allows the Py compatibility addon to continue working with the same underlying fluid-handling system.

Source code:

https://github.com/goakiller900/pipemod

Why does this continued version exist?

The original Advanced Fluid Handling For PyMods addon was created to integrate Advanced Fluid Handling with the Pyanodon mod suite.

As Factorio, Advanced Fluid Handling, and Pyanodon's mods evolved, the addon eventually required additional compatibility work for the current Factorio 2.1 environment.

This project continues development of that compatibility addon as a standalone Factorio 2.1 version with its own internal mod identity and version history.

Internal mod name:

advanced-fluid-handling-continued-for-py

The continuation starts with its own version history at:

0.0.1

Factorio 2.1 compatibility work

Updating the addon involved more than simply changing the Factorio version number.

Several areas of the original compatibility code required changes for current versions of Factorio, Advanced Fluid Handling, and PyMods.

The continued version includes fixes and updates for:

• Factorio 2.1 data-stage compatibility.
• The Factorio 2.1 valve prototype type.
• Correct removal of AFH valves and their associated items and recipes.
• Technology unlock cleanup when removed recipes are no longer available.
• Updated Advanced Fluid Handling dependencies.
• Updated Advanced Fluid Handling asset namespaces.
• Underground pipe distance handling.
• Pipeline extent handling.
• Pyanodon braided pipe connection categories.
• Underground pump configuration.
• Underground pump icon handling.
• Layered Pyanodon pipe graphics.
• Underground pipe direction arrows.
• Pipe cover inheritance.
• Directional sprite alignment.
• Current Advanced Fluid Handling prototype names and structure.
• Deterministic release packaging for the continued mod.

A malformed Lua statement inherited from the previous source was also corrected during the Factorio 2.1 update.

Pipe tiers

The addon adapts the three Advanced Fluid Handling pipe tiers to corresponding Pyanodon infrastructure.

Tier 1

The first underground pipe tier follows the standard iron pipe infrastructure.

Its underground distance and pipeline properties are derived from the current standard pipe-to-ground prototype.

An optional startup setting can slightly increase the Tier 1 underground distance.

Tier 2

The second underground pipe tier is integrated with Pyanodon's Niobium pipe infrastructure.

When braided pipes are enabled, Tier 2 underground connections use the appropriate Niobium pipe connection category.

Its recipes and progression also use Py materials.

Tier 3

The third underground pipe tier is integrated with the higher-tier Pyanodon pipe infrastructure.

When braided pipes are enabled, these connections use the corresponding high-tier pipe connection category.

Tier 3 recipes use materials appropriate for the later stages of the Py progression.

Underground pumps

Advanced Fluid Handling includes three tiers of underground pumps.

This addon adjusts those pumps for the Pyanodon environment.

The underground distances of the pumps follow their corresponding pipe tiers, while their pumping speed and energy usage are synchronized with the current standard Factorio pump prototype.

This avoids maintaining outdated hardcoded pump statistics when Factorio or other dependencies change.

The pump recipes are also adjusted to use appropriate Pyanodon materials and Advanced Fluid Handling pipe components.

AFH valves

By default, this addon removes the valves supplied by Advanced Fluid Handling.

This includes:

• Overflow valves.
• Top-up valves.
• Check valves.

This behavior originates from the original Py compatibility addon, where Advanced Fluid Handling's valves were disabled because the Pyanodon ecosystem already provides its own fluid-control options.

The Factorio 2.1 continuation correctly removes the complete valve prototype chain, including the entity prototypes, items, recipes, and related technology unlocks.

This prevents incomplete prototype references during PyPostProcessing.

Pipe graphics

The addon includes an optional startup setting that replaces Advanced Fluid Handling underground pipe junction graphics with graphics based on the corresponding Pyanodon pipe tiers.

Direction indicators are retained so that the connection layout of the different underground junctions remains visible.

The continued version also includes updated handling for layered Pyanodon sprites.

This is important because modern Py pipe graphics can contain multiple sprite layers rather than a single image definition.

The addon preserves those layers and adds the Advanced Fluid Handling direction arrows on top.

Startup settings

The addon provides settings for several compatibility options.

Reskin underground pipe junctions

Allows Advanced Fluid Handling underground pipe junctions to visually follow Pyanodon's pipe tiers.

Enabled by default.

Longer Tier 1 underground pipes

Optionally increases the normal Tier 1 underground distance by one tile.

Disabled by default.

Keep AFH valves

Allows the valves supplied by Advanced Fluid Handling to remain available.

The default PyMods configuration removes them because Pyanodon already provides its own fluid-control options.

Save compatibility and testing

The current continuation has been tested with Factorio 2.1 together with Advanced Fluid Handling and the required Pyanodon environment.

Version 0.0.3 successfully completes the Factorio data stage, PyPostProcessing, and reaches the main menu.

It has also been tested by successfully loading an existing Pyanodon world.

Because Factorio mod packs can contain hundreds of mods and every Py installation can be different, compatibility problems with combinations that have not been tested may still exist.

Please report problems specific to this continuation on GitHub.

When reporting an issue, including the Factorio log and your active mod list is extremely helpful.

Compatibility with the original addon

This continuation uses a new internal mod identity:

advanced-fluid-handling-continued-for-py

The original addon used:

underground-pipe-pack_for_py

The two addons are explicitly marked as incompatible and should not be enabled together.

When moving an existing save to the continued version, disable the original Py addon and enable this continuation together with Advanced Fluid Handling.

As always, making a backup of an important save before changing major mods is recommended.

Versioning

Advanced Fluid Handling for PyMods has its own version history.

The continued project started at:

0.0.1

0.0.1

Initial Factorio 2.1 continuation.

• Created a unique standalone mod identity.
• Updated dependencies for Advanced Fluid Handling.
• Added Factorio 2.1 support.
• Added automated release packaging.

0.0.2

• Fixed a malformed underground pump icon assignment that caused a Lua syntax error during startup.

0.0.3

• Fixed AFH valve removal for the Factorio 2.1 valve prototype system.
• Fixed dangling valve prototypes detected by PyPostProcessing.
• Cleaned removed recipe unlocks from technologies.
• Updated Advanced Fluid Handling graphics namespace references.
• Improved compatibility handling for current Pyanodon pipe graphics.
• Successfully tested startup and loading an existing world.

Original addon and credits

This project is based on the original Advanced Fluid Handling For PyMods addon.

The original addon was created and maintained by its original authors and contributors, including Sopel and Dremon.

The underlying Advanced Fluid Handling system was originally created by TheStaplergun.

This Factorio 2.1 PyMods continuation is currently maintained by goakiller900.

Full credit for the original concepts, code, and previous compatibility work remains with their respective original authors and contributors.

This continuation exists to keep the original compatibility work available for modern Factorio 2.1 and current versions of the Pyanodon mod suite.

Contact

Questions, compatibility reports, and feedback are welcome.

You can also contact me on Discord:

goakiller900

Advanced Fluid Handling for PyMods

Keeping Advanced Fluid Handling usable in the wonderful, terrifying, and occasionally completely unreasonable world of Pyanodon.