TechtonicaLoading...Blueprints2.1.0

You are viewing a potentially older version of this package. View Latest Version

Install

Date Uploaded

2 years ago

Downloads

4.7K

Size

409KB

Dependency string

Equinox-Blueprints-2.1.0

Download

Details Required (1)Versions

Blueprints

Banner Image

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.
The holograms will stay in place and the buildings will be added to the build queue.
Buildings in the build queue are built every 0.25 seconds.
Buildings will be taken from your inventory as they are built.
If you don't have enough of a building in your inventory, it will stay in the build queue until you do.
Important: The build queue does not save. Do not quit the game while there are items in the queue, it will be very hard to manually finish the blueprint.
Once the build queue is empty, the GUI showing it on the right side of the screen will disappear.
You cannot deconstruct holograms that are in the build queue, you must wait for them to build and then deconstruct them.
You can continue to paste blueprints while waiting for the build queue to process.

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

A blueprint before pasting

A building built with a blueprint

The blueprints GUI

The build queue

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.1.0

Added the Build Queue

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.