PetsCompanions

Companion Pets for Techtonica

A comprehensive companion pet mod for Techtonica that adds five unique robotic companions to accompany you on your factory-building adventures. Each pet features distinct behaviors, visual styles, and passive buffs to enhance your gameplay experience.

Table of Contents

• Features
  • Companion Types
  • Pet Behaviors
  • Buff System
• Getting Started
  • Unlocking Companion Technology
  • Crafting Companions
  • Using Your Pets
• Controls
• Configuration
• Installation
• Requirements
• Compatibility
• Troubleshooting
• Changelog
• Credits
• License
• Links

Features

Companion Types

PetsCompanions introduces five unique robotic companions, each with their own appearance, movement style, and special abilities:

Companion Drone

A small flying drone that gracefully orbits around you at head height. Designed for speed enthusiasts, it provides a passive movement speed buff, helping you traverse your factory more efficiently.

Companion Crawler

A spider-like ground companion that scuttles along the terrain near your feet. Built for miners, it enhances your mining speed, making resource extraction faster and more productive.

Companion Floater

A hovering companion with integrated storage technology. It floats at mid-level and increases your inventory capacity, perfect for extended mining expeditions or factory reorganization.

Guardian Bot

A sturdy, robust guardian bot that maintains a protective stance near you. Its reinforced design provides damage reduction, keeping you safer during hazardous exploration.

Scout Drone

A fast, sensor-equipped scout drone that zips around at high altitude. Its advanced detection systems highlight nearby resources and points of interest, making exploration more rewarding.

Pet Behaviors

All companions feature sophisticated AI behaviors:

• Orbital Movement: Pets smoothly orbit around the player at a configurable distance
• Natural Motion: Each pet type has unique movement characteristics:
  • Flying pets maintain higher altitude with gentle bobbing
  • Hovering pets float at mid-level with subtle oscillation
  • Ground pets stay close to terrain level
• Smooth Following: Pets use interpolated movement for natural, non-jerky following
• Directional Facing: Companions automatically rotate to face their movement direction
• Height Variation: Different pet types maintain appropriate heights based on their design
• Bobbing Animation: Subtle vertical oscillation adds life-like movement to airborne pets

Buff System

When enabled, each companion provides passive buffs while active:

Note: Buff effects can be toggled on/off in the configuration.

Getting Started

Unlocking Companion Technology

Before you can craft any companions, you must first unlock the Companion Technology research:

1. Progress to Tier 12 (XRAY) in the tech tree
2. Navigate to the Modded category in the research menu
3. Research Companion Technology using 150 Purple Research Cores

Crafting Companions

Once unlocked, companions can be crafted in Assemblers. Each companion requires different materials:

Companion Drone

Companion Crawler

Companion Floater

Guardian Bot

Scout Drone

Crafting time: 60 seconds per companion

Using Your Pets

1. Summon: Press the Summon Key (default: , Comma) to spawn your first companion
2. Cycle: Press the Summon Key again to dismiss current pet and spawn the next type
3. Dismiss: Press the Dismiss Key (default: . Period) to dismiss your active pet

Controls

All keybindings are configurable in the mod configuration file.

Configuration

The mod configuration file is located at:

BepInEx/config/com.certifired.PetsCompanions.cfg

Configuration Options

General Settings

Behavior Settings

Buff Settings

Control Settings

Example Configuration

[General]
Enable Pets = true
Max Active Pets = 1
Debug Mode = false

[Behavior]
Follow Distance = 3
Pet Speed = 8

[Buffs]
Pets Provide Buffs = true

[Controls]
Summon Pet Key = Comma
Dismiss Pet Key = Period

Installation

Prerequisites

Ensure you have the following installed before proceeding:

1. BepInEx 5.4.2100 or newer
2. EquinoxsModUtils v6.1.3 or newer
3. EMUAdditions v2.0.0 or newer
4. TechtonicaFramework v1.0.2 or newer

Manual Installation

1. Download the latest release of PetsCompanions
2. Extract the contents of the archive
3. Copy PetsCompanions.dll to your BepInEx/plugins folder
4. Launch Techtonica

Installation via Thunderstore (Recommended)

1. Install r2modman or Thunderstore Mod Manager
2. Search for "PetsCompanions" in the mod browser
3. Click "Install" - dependencies will be installed automatically
4. Launch the game through the mod manager

Requirements

Required Dependencies

Game Version

• Tested with Techtonica v0.3.x and later
• Compatible with the latest stable release

Compatibility

Known Compatible Mods

PetsCompanions is designed to work alongside other Techtonica mods. The mod uses the Modded category for tech tree entries to avoid conflicts.

Potential Conflicts

• Mods that significantly alter player movement may affect pet following behavior
• Mods that modify the tech tree structure should be tested for compatibility

Troubleshooting

Pets Not Spawning

1. Verify that Enable Pets is set to true in the configuration
2. Check that all dependencies are installed and up to date
3. Enable Debug Mode and check the BepInEx console for error messages

Pets Moving Erratically

1. Adjust the Pet Speed setting to a lower value
2. Increase the Follow Distance to give pets more room
3. Verify no other mods are conflicting with player transforms

Research Not Appearing

1. Ensure you have progressed to at least Tier 6 in the tech tree
2. Check the Modded category in the research menu
3. Verify TechtonicaFramework is properly installed

Configuration Not Saving

1. Close the game completely before editing the configuration file
2. Ensure the config file path is correct: BepInEx/config/com.certifired.PetsCompanions.cfg
3. Check file permissions on the BepInEx folder

Changelog

v1.4.0 (Current)

• Tech tree positioning improvements
• Enhanced stability and compatibility
• Configuration system refinements

v1.3.0

• Added debug mode for troubleshooting
• Improved pet following behavior
• Fixed unlock linking issues

v1.2.0

• Added Guardian Bot and Scout Drone companions
• Implemented buff system framework
• Enhanced visual feedback for pet types

v1.1.0

• Added configuration options for controls
• Improved pet movement smoothing
• Added pet cycling functionality

v1.0.0

• Initial release
• 5 companion pet types (Drone, Crawler, Floater, Guardian, Scout)
• Following AI with orbital behavior
• Configurable keybinds and behavior settings
• Research unlock and crafting recipes

Credits

Development

• Certifired - Lead Developer
• Claude Code (Anthropic) - AI Development Assistant

Special Thanks

• Equinox - For creating EquinoxsModUtils and EMUAdditions, essential frameworks for Techtonica modding
• Fire Totem Games - For creating Techtonica
• The Techtonica Modding Community - For testing, feedback, and support

Tools & Resources

• BepInEx - Unity modding framework
• Harmony - Runtime patching library
• dnSpy - .NET decompiler for reverse engineering

License

This mod is licensed under the GNU General Public License v3.0.

PetsCompanions - Companion Pets for Techtonica
Copyright (C) 2024 Certifired

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.

What This Means

• You are free to use, modify, and distribute this mod
• Any derivative works must also be licensed under GPL v3
• You must provide attribution to the original author
• Source code must be made available for any distributed versions

Links

Official Resources

• Thunderstore: PetsCompanions on Thunderstore
• GitHub: Source Code Repository
• Discord: Techtonica Modding Discord

Dependencies

• BepInEx
• EquinoxsModUtils
• EMUAdditions
• TechtonicaFramework

Game

• Techtonica on Steam
• Official Techtonica Website

Made with passion for the Techtonica community.