Equinox's Mod Utils

Description

This is a collection of tools for modders to use to make developing mods easier and avoid duplicating code.

Modders: Please look at the GitHub link to see what this library provides and how to use it.

Installation

If you are using Techtonica Mod Loader, you can ignore these steps.

Note, this mod requires use of the BepInEx Update function. If you have not already done so for another mod, follow these instructions:

1. Find your game install folder.
2. Navigate to BepInEx\config.
3. Open BepInEx.cfg.
4. Find the setting "HideGameManagerObject".
5. Set it to "true".
6. Save & close.

Techtonica Mod Loader Installation

You can download the Techtonica Mod Loader from here and use that to install this mod.

Manual Install Instructions

Note: If you are playing on Gamepass, your game version is likely behind the steam version. Please check the version compatibility chart below.

Your game folder is likely in one of these places:
    • Steam: (A-Z):/steam/steamapps/common/Techtonica
    • Gamepass: (A-Z):/XboxGames/Techtonica/Content
    • Gamepass: Could also be in C:/Program Data/WindowsApps

1. Download BepInEx v5.4.21 from here
2. Follow the installation instructions here
3. Download and install any dependencies.
4. Extract the contents of the .zip file for this mod.
5. Drag the "BepInEx" folder into your game folder.

Known Issues

• Second Load
  • Custom unlocks will not load correctly except for during the first load of a session.

Changelog

V4.1.0

• Added: Custom Data Exists Function
  • Added a function that can be used to check if custom data has been added for a given isntanceId

V4.0.0

• Added: Data Saving Functions
  • Add functions that allows modders to attach data to the world's save file and save & load it with the world.
• Added: Add Resource
  • Add a function that allows modders to easily add a new item to the game.
• Added: Add Recipe
  • Add a function that allows modders to easily add a new recipe to the game
• Fixed: Non-Unique Fields
  • If two unlocks have the same name or description, an error will occur when adding them to the translation dictionary.
• Fixed: Save Unlock Name
  • Uninstalling a mod will cause it's unlock state to be used for a different mod's unlock
• Changed: Unique Names
  • Reject new Unlocks that do not have unique names
• Added: Game Saved Event
  • Add an event that is fired as a postfix to the game saving, with the world name as the sender
• Changed: Logging Format
  • Use BepInEx logger instead of Unity logger

• Added: Debug Object Function

• Changed: SaveStateLoaded
  • Change the SaveStateLoaded checking code to wait until SaveState.instance.metadata.worldName is not null or empty
• Added: PacedLog
  • Add a function that calls Debug.Log() if enough time has passed since the last call

V3.3.1

• Fixed EMU UnlockState saving, for realsies this time. (Hopefully).

V3.3.0

• Added:
  • public static bool hasMachineManagerLoaded;
  • public static event EventHandler MachineManagerLoaded;
• Fixed EMU saving things it shouldn't.
  • This should prevent the two bugs that were partially fixed in the last release.
• Added IsModInstalled()
• Added GetImageForResource()

V3.2.0

• Added ResourceNames.SafeResources
  • This is a list of all resource names that have had any spoilers removed.
• Fixed a bug that caused the Tech Tree Menu to not open (maybe).
• Fixed a bug that caused the Energy tab of the Tech Tree Menu to not open (maybe).

V3.1.0

• Honestly don't know, forgot to write this at the time of release.

V3.0.0

• Updated for game version 0.3.0e
• Fixed a bug that caused errors for missing custom unlocks from other mods.
• Added function NullCheck()

V2.3.1

• Fixed a bug where certain buildings wouldn't be removed from the inventory when built.
• Added some functions for finding Schematics

V2.3.0

• Added ability to build variations of structures.
• Added TryFindRecipe() function.

V2.2.0

• Fixed a bug that caused duplicate UnlockStates to be created for custom Unlocks.
• Added functions to build machines without their static meshes being invisible.

V2.1.0

• Added UpdateUnlockTier() function.
• Removed wrong info from function comments.

V2.0.1

• Removed log spam

V2.0.0

• Updated for game version V0.2.1c
• Fixed adding new custom unlocks
• Reduced log spam with new function arguments (Developers see the linked GitHub repo)
• Updated ResourceNames
• Updated UnlockNames

V1.0.0

• Initial release.

Credits

Disclaimer

Note: NEW Games must be loaded, saved, and reloaded for mods to take effect. Existing saves will auto-apply mods. Please be sure to backup your saves before using mods: AppData\LocalLow\Fire Hose Games\Techtonica USE AT YOUR OWN RISK! Techtonica Devs do not provide support for Mods, and cannot recover saves damaged by mod usage.

Some assets may come from Techtonica or from the website created and owned by Fire Hose Games, who hold the copyright of Techtonica. All trademarks and registered trademarks present in any images are proprietary to Fire Hose Games.