SubTerra

SubTerra adds multiple underground levels along with ways to transfer players, items, and power between levels.

Currently, the underground levels are intended for transportation only.

== This is a Work-In-Progress mod ==

• This is an alpha release. There are many features missing and there will be many bugs.
• Saves may not be compatible between versions at this time.
• Compatibility with most other mods has not been tested yet

Post any bugs at: https://github.com/Daedeross/Subterra/issues

Current Features:

• Multiple underground levels
• Stairs
• Belt-Elevators (speed equivalent to the three base belt types)
• Power transfer (one-way per pair, for now).
• Research to unlock deeper levels
• Subways, special faster trains only usable underground.
• Remoting call for other mods to white-list entities. (see change log for v 0.3.3 for details)
• Shortcut to flip rolling-stock (default: CONTROL + F).
• Ground Penetrating Radar research, allows radars to scan underground levels.
• HUD to help when placing entities that connect to other layers (like Stairs, for example.)
• Configurable blacklist and whitelists to customize what entities are allowed underground.

Features coming soon(ish?):

• Fluid transfer
• Signal transfer

Features far away:

• Underground mining
• Many more graphics

Mod Compatibility

I have not tested this with many mods yet. If there is a particular incompatible mod you would like me to support, please open an issue for it on GitHub.

Whistle Stop Factories

• Its 'Big' machines are not whitelisted and are removed if spawned underground.
• If you want to allow them to spawn underground, add this to the Underground Whitelist in SubTerra's startup

settings: wsf-big-assembly;wsf-big-refinery;wsf-big-furnace;express-loader

Changelog

Know Issues

• At this time, when Underground Locomotives, they will always point westward (or north if placed vertically).

See below below for a workaround.

• Other mods that place entities and do not raise the script_raised_built event may lead to unintended consequences.
• If a Stairs, Belt-Elevator, or Power transfer entity is destroyed, it will leave a ghost on only one of its layers.
• Endgame testing and balance is incomplete.

v0.6.0

Features:

• Added "Ground Penetrating Radar" technology. Researching this will change all radars to give vision to underground layers. Each level of this research allows radars to "see" one level deeper.
• Added placement help HUD. After researching "Ground Penetrating Radar," if a player has in their hand an item that bridges levels (Belt-Elevators, Stairs, Power-Converters) they will see colored boxes within a moderate radius showing where entities are built on the target layer (below of above, depending if holding an 'up' or 'down' item). Power Converters show all levels, above and below. Current colors are Orange for below layers, Blue for above layers.
• Added additional undergorund whitelist based on entity type. This has default values (see wiki) and can be added to by the startup setting.
• Added undergorund entity blacklist based on entity name. This will override any whitelist entry for that entity. Default is empty, but can be added to via a startup setting.

Changes:

• Power Converters now bridge all layers. The entire column (from the top to the bottom) now must be clear in order to place the converter. If migrating a save from a previous version, Subterra will try and extend existing power convertes to all layers. If there is a layer that it cannot place on at (usually due to something being in the way), it will skip that layer but then mark the pole (on layers it does exist) with a red circle and exclamation point: ( ! ). _Removing the entity will remove this warning._
• Renamed and combined "Power Converters - Top" and "- Bottom" to "Power Transfer Column".
• Changed Power Converters' output prioritiy to "tertiary". Input priority is unchanged ("secondary-input").
• Reduced Power Converter buffer size, giving a maximum throughput of MW through each column.

Graphics:

• Changed the look of the icon for Power Converters (now called "Power Transfer Column").

Optimization:

• Improved iteration performace for power transfer between layers.
• Added some caching and additional minor performace improvements in some event handlers.

Bugfixes:

• Added icon and EN Localization for power output and input entities so they show up properly in the Electric network info panel.
• Adding Subterra to an existing save which has researched Logistics 2 or 3 will now also unlock the exhange recipes.

v0.5.3

• Battery recharge recipes are now hidden until the requisite level of Subways is researched.
• Additional code refactoring and optimization.

v0.5.2

• Fixed initialization bug.

v0.5.1

Modified

• Changes some messages when a 2-layer entity is denied placement.

BuxFixes

• Picking up a power converter no longer crashes the game.

v0.5.0

NOTE: Compatibility with saves from previous versions is spotty at best.

New

• Updated to Factorio v 0.17.x
• Added Gui element to show current Depth. Simple text label for now.
• Added ability to add any entity to the Underground Whitelist via semicolon delimited list in the mod's startup settings.
• Added keyboard shortcut to flip the direction of any rolling stock under the cursor (Default: CONTROL + F). This can

be used to work-around the top know issue above.

Modified

• Completely changed how underground locomotives are handled. Now there is only one item and recipe that improves in performance the

further underground it is placed. The levels of the Subways technology unlocks the ability to place locomotives deeper.

• Changed the max-depth setting to default to 4, with a max of 5

Bugfixes

• Removing a belt-elevator now properly picks up the items on its input and output.