Blueprints
Description
Looking for a content creator to create a tutorial video for this mod. Contact me on the Techtonica Discord server if you're interested, my display name is Equinox and you can find me in the modding channels.
Please read the entire description section before using this mod.
If installing manually, follow the instructions carefully.
This mod adds the ability to copy and paste sections of your factory and save regions as blueprints, to be reused or shared. This mod has not yet been tested with all machines / buildables. Copying and pasting large regions has also not been tested, and may cause game freezes (until future updates are complete). If you change the keybinds for this mod, please test them in game first. For example, if you change the keybind for rotating blueprints to 'R' and 'Shift + R', you will end up rotating buildables in your world, as I cannot block this input from the game yet. There is currently a bug where pasted machines / buildables will be partially or fully invisible. Once you are done pasting, save and reload to render them.
Techtonic Blueprints Partner Program
This mod's Blueprint Library GUI is a program that runs outside of Techtonica (until further advancements in modding this game are made). The first time this program runs, you may see a popup from Windows Defender blocking this program. This is because signing programs can be expensive, simply click 'More info' and then a 'Run Anyway' button will appear. If you want to read the program's source code to ensure its safety, it is available here. This program is automatically opened and closed by the Blueprints mod, you do not need to do that yourself. When you launch Techtonica, you will see the GUI open for a moment before hiding, this is normal and not a bug. You will need to play with the game in 'Borderless Fullscreen' mode to avoid having to click Techtonica in the task bar every time you open the Blueprints Library window. You may need to install the .NET 4.8.2 runtime framework if you haven't already. If you haven't you will see a popup the first time you run the mod with a download link. Install it, then reopen the game. If for any reason, this program does not work for you, or you do not wish to use it, you can still use the copying and pasting functionality of this mod. Please contact 'Equinox' @cube_suite_dev on the Techtonica Discord for support if needed.
Instructions
Copying A Region
- Aim at a buildable (machine, powerfloor etc.). Make sure you can see the information panel in the bottom left for that machine.
- Press Left Control + C (configurable) to begin copying.
- Move to the opposite corner of the region you would like to copy.
- Check that the blue box covers only what you want to copy.
- Sometimes, a bug can cause the copy region to be very large. If this happens, try looking away from the end buildable and back to it again.
- You can press the arrow keys to grow the box in any direction. Press Left Shift + Up / Down to expand vertically.
- Hold Left Control while pressing the arrow keys to shrink the box.
- You cannot shrink the box to be smaller than the region you drew with the mouse.
- Press Left Control + C (configurable) to end copying.
- Wait for the 'Finished Copying Region' notification to appear.
- This can take a few seconds for larger regions.
- Press backspace (configurable) to cancel copying if you change your mind during this process.
Pasting A Region
- Press Left Control + V to enter pasting mode.
- A notification will show at the top of the screen will show if you do not have the resources to paste a blueprint.
- Holograms will appear to show where the blueprint will be pasted.
- Press Z (configurabe) to rotate the blueprint clockwise.
- Press Left Control + Z (configurable) to rotate the blueprint anti-clockwise.
- Press the arrow keys to manually nudge the blueprint in that direction. Left Shift + Up / Down moves the blueprint vertically.
- You can press 'N' (configurable) to prevent the mouse moving the blueprint.
- Once you are happy with the blueprints placement, press Left Control + V (configurable) to paste the blueprint.
- Resources will be consumed as each building is placed.
- If a building can't be placed, it will be skipped.
Opening The Blueprints Library
- Press Left Control + X (configurable) to open the blueprints library.
- Your pause menu will open as you do this. This is to block mouse input being sent to the game.
- In the top right of the Blueprints Library window, there is a 'Close' button. Click it to close the menu and return to the game.
- You will need to click 'Resume' in the pause menu to return to the game. I am hoping to auto-resume in a future update.
Navigating The Blueprints Library
Note: A 'Blueprint Book' is a named collection of blueprints or other Blueprint Books, think of them like a folder on your computer.
The first time that you open the Blueprint Library each game, you will see the top level Blueprint Book called 'All Blueprints'. This one cannot be deleted. In the top right of this window, there are five buttons:
- New Blueprint - This button creates a new blueprint from the latest copied region. See the next section for more details.
- New Blueprint Book - This button creates a new Blueprint Book inside the Blueprint Book that you currently have open.
- Think of it as the 'New Folder' button in Windows Explorer.
- You will be asked a name for this new Blueprint Book when clicking this button. Names do not need to be unique.
- Import Blueprint - Used to import someone else's blueprint. Copy all the text that they shared, then click this button to add it to the current Blueprint Book.
- Import Blueprint Book - Used to import someone else's Blueprint Book. Copy all the text that they shared, then click this button to add it to the current Blueprint Book.
- Close - This button hide's the Blueprint Library Window and allows you to return to the game.
You can find my collection of blueprints here if you want some to get started with.
Below this, you will see a panel that shows the currently open Blueprint Book. At the top of this panel is the path of this book. For example: 'All Blueprints > Machines > Mk1'. To the right of this, are two / four more buttons. The first and last are hidden from view when viewing the 'All Blueprints' book.
- Back - This button display the parent of the current Blueprint Book.
- Change Name - This button allows you to change the name of the currently displayed Blueprint Book.
- Export Book - This button copies some text to your clipboard that you can paste elsewhere to share the currently displayed Blueprint Book with others.
- Delete Book - This button deletes the currently displayed Blueprint Book. This deletes all the child blueprints and Blueprint Books of the book, so please ensure you are certain before clicking this button.
- You will be asked for confirmation when clicking this button. Click 'No' to cancel.
- Deleting a book cannot be undone. Automatic backups are not (yet) created.
Below this, you will see the blueprints and Blueprint Books that are in the current book. This panel is empty for new books.
Blueprint Panels will have three buttons:
- Use - This button copies the blueprint and closes the Blueprints Library window and returns you to the pause menu. Press 'Resume' and paste the blueprint using the instructions above.
- Update - This button overwrites this blueprint with the latest copied region
- Export - This button copies some text to your clipboard that you can paste elsewhere to share the blueprint with others.
- Delete - This button deletes the blueprint.
- You will be asked for confirmation when clicking this button. Click 'No' to cancel.
- Deleting a blueprint cannot be undone. Automatic backups are not (yet) created.
Blueprint Book Panels will have one button:
- Open - This button displays the contents of the book.
Saving A Blueprint
- Copy a region by following the earlier instructions.
- Press Left Control + X (configurable) to open the Blueprints Library window.
- Navigate to the Blueprint Book that you want to save this blueprint inside.
- Click the 'New Blueprint' button.
- Enter a name for this blueprint in the box and click 'Confirm'.
- Names do not have to be unique.
- Click 'Cancel' to abort saving this blueprint.
- The blueprint will be added to the currently-open blueprint book.
Screenshots
Config Options
| Name |
Type |
Description |
Default Value |
| Copy Shortcut |
Keyboard Shortcut |
The key to press to start and end copying |
C + Left Control |
| Paste Shortcut |
Keyboard Shortcut |
The key to press to start and end pasting |
V + Left Control |
| Cancel Shortcut |
Keyboard Shortcut |
The key to press to cancel copying or pasting |
Backspace |
| CW Rotation Shortcut |
Keyboard Shortcut |
The key to press to rotate the blueprint clockwise |
Z |
| CCW Rotation Shortcut |
Keyboard Shortcut |
The key to press to rotate the blueprint anti-clockwise |
Z + Left Control |
| Open Blueprints Shortcut |
Keyboard Shortcut |
The key to press to open the Blueprints Library |
X + Left Control |
| Lock Position |
Keyboard Shortcut |
The key to press to lock the paste position for nudging |
N |
| Nudge Left |
Keyboard Shortcut |
The key to press to nudge left |
Left Arrow |
| Nudge Right |
Keyboard Shortcut |
The key to press to nudge right |
Right Arrow |
| Nudge Forward |
Keyboard Shortcut |
The key to press to nudge forward |
Up Arrow |
| Nudge Backward |
Keyboard Shortcut |
The key to press to nudge backward |
Down Arrow |
| Nudge Up |
Keyboard Shortcut |
The key to press to nudge up |
Up Arrow + Left Shift |
| Nudge Down |
Keyboard Shortcut |
The key to press to nudge down |
Down Arrow + Left Shift |
| Shrink Left |
Keyboard Shortcut |
The key to press to shrink left |
Left Arrow + Left Control |
| Shrink Right |
Keyboard Shortcut |
The key to press to shrink right |
Right Arrow + Left Control |
| Shrink Forward |
Keyboard Shortcut |
The key to press to shrink forward |
Up Arrow + Left Control |
| Shrink Backward |
Keyboard Shortcut |
The key to press to shrink backward |
Down Arrow + Left Control |
| Shrink Up |
Keyboard Shortcut |
The key to press to shrink up |
Up Arrow + Left Shift + Left Control |
| Shrink Down |
Keyboard Shortcut |
The key to press to shrink down |
Down Arrow + Left Shift + Left Control |
Installation
Do not use Thunderstore Mod Loader or r2modman to install this mod.
If you are using Techtonica Mod Loader (v1.1.0.0+) you can ignore this section.
Note, this mod requires use of the BepInEx Update function. If you have not already done so for another mod, follow these instructions:
- Find your game install folder.
- Navigate to BepInEx\config.
- Open BepInEx.cfg.
- Find the setting "HideGameManagerObject".
- Set it to "true".
- 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
- Download BepInEx v5.4.21 from here
- Follow the installation instructions here
- Extract the contents of the .zip file for this mod.
- Drag the contents of the "plugins" folder into '{Game Folder}/BepInEx/plugins'.
- Drag the contents of the "config" folder into '{Game Folder}/BepInEx/config'.
- Drag the contents of the "Techtonica" folder into your game folder.
- Change config options if desired.
Version Compatibility
| Mod Version |
Game Version |
| v2.x.x |
v0.3.0e |
| v1.x.x |
v0.2.1c |
Changelog
V2.0.0
- Updated for game version 0.3.0e
V1.1.0
New Features:
- Holograms are now rendered.
- Added Nudging when copying and pasting.
- Blueprints can now be placed on terrain.
- Performance improvements.
- Cancel copying or pasting by with a configurable shortcut.
- Imporoved the 'Not Enough Resources' notification.
- Game auto-unpauses when closing the blueprints GUI.
- Accumulators can now be copied.
- Existing blueprints can now be updated / overwritten.
- Warning popups in the blueprints GUI.
Bug Fixes:
- Fixed machines being invisible, except assemblers that have a recipe set.
- Fixed rotating blueprints, machines no longer overlap and fail to build.
- You can no longer start copying a region while pasting a blueprint.
- Removed some log spam.
V1.0.0
Initial release.
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.
