01Getting Started

From zero to your first bot in under a minute

Companions are AI teammates you spawn and command. They follow you, fight for you, gather resources, craft gear, smelt ores, recycle junk, man your cannons, and even pilot your ships. Each companion is a real SentientPlayer bot — not a dumb NPC — with its own name, inventory, stats, and loyalty.

They belong to your team. When you spawn your first companion, a new hive is created called [Your Name]'s Team. All future companions you spawn join this same team automatically.

Your First 60 Seconds

Companion Limits

The number of bots you can have depends on your permission tier:

02Modes & Behavior

Six modes that define what your bots do right now

Modes control where your bots go and what they do when nothing's happening. You can set a team-wide mode, or set each bot individually through the Companion UI.

Combat Stances

Independent from movement mode, each bot has a stance that determines how it reacts to threats:

• Aggressive — Engages any hostile within sight. Default.
• Passive — Ignores everything. Even takes hits without retaliating. Useful for dedicated gatherer roles.
• Defensive — Only fights when attacked.

Toggle with /comp passive or /comp aggressive. The Companion UI has a per-bot toggle too.

Tether & Follow Radius

Two distance settings govern how far your bots can stray:

The /comp.tether and /comp.followradius commands accept a delta (like +10 or -20) rather than an absolute value. Repeat them to dial in your preferred radius.

03Commands Reference

Every chat command at a glance

Commands come in two families. The short /comp.* family is the quickest way to issue orders. The long-form /comp <subcommand> opens up everything else, including the UI.

Basic Bot Management

Movement & Mode

Storage

Naval & Captain

Long-Form Commands (/comp subcommand)

The /comp command also accepts many subcommands. These are the same ones you'd click in the UI:

UI & HUD

04Storage & Tags

Teach your bots where each item belongs

When you set a home TC with /comp.sethome, the plugin automatically discovers boxes nearby and assigns them to your team. Your companions will then use these boxes as their communal stash — dropping loot into them, pulling materials when they craft, and sharing resources across the team.

Category Tags

You can tag each box with a category so bots put items where they belong. When a bot wants to stash a rifle, they'll route it to a box tagged Weapons first. When they're out of medical supplies, they'll check a Medical box first. Tagging is optional — untagged boxes still accept any item — but it keeps your base organized.

Workflow

Furnaces, Lockers, Recyclers

Besides boxes, your team also tracks three other container types once you're set up:

• Furnaces auto-discovered near your home TC — bots fuel them, feed ores in, and collect smelted ingots.
• Lockers store combat loadouts — bots grab gear from here before heading into fights.
• Recyclers used by auto-recycle (see next section). Includes your base recycler if any, and monument recyclers on runs.

05Crafting & Auto-Systems

Automate the grind — crafting, smelting, recycling

Your companions can run four automation systems in parallel. Turn them on via the Companion UI's Automation tab. All of them respect your inventory presets (below) and tier restrictions on what they're allowed to craft.

Craft Queue

Each companion has a craft queue — a list of items they'll craft whenever they have the materials. You can add guns, armor, traps, and consumables to the queue with a target amount. When stock drops below target, they craft more.

Manage the queue in-game through the Companion UI. Priority items craft first. Items you don't have the tier permission for simply won't appear as craftable.

Inventory Presets

Presets are shortcuts that set dozens of inventory caps at once. Pick the one that matches your playstyle:

• Balanced — 3 rifles, 2 SMGs, 2 each armor piece, 500 rifle ammo. The default.
• Combat Focus — 5 rifles, 3 of each other class, 1000 rifle ammo. For raiders.
• Builder Focus — Slimmer gear, enables auto-recycle excess. For base builders.
• Minimal — Bare-minimum loadout (1 of each weapon type). Saves space.
• Unlimited — Uncapped. Hoards every weapon and armor piece. Admin/testing preset.

Monument Recycler Runs

When enabled (default on), your companions occasionally run scrap-heavy boxes to nearby monument recyclers when you have too much junk stacking up. Cooldown between runs: 5 minutes.

06Combat & Gear

How bots fight and what they can wield

Companion combat is driven by the same AI that powers enemy hive bots — they aim, take cover, flank, reload, and switch weapons based on range. Their effectiveness depends on three things: what mode they're in, what gear they have, and what tier their owner is.

Tier-Restricted Weapons

Top-tier gear is gated by permission. Companions will not equip a weapon their owner doesn't have permission to unlock, even if it's in the box:

Tier-Restricted Armor

Explosives

07Naval & Cannons

Companion pirates, ships, and broadsides

Companions can crew your ships. A designated captain pilots the helm and follows sailing orders, while others mount cannons, form boarding parties, or simply ride along.

Captain Mode

Activate Captain mode on a ship you own and have nearby, and your most-bravery companion mounts the steering wheel as your captain. You'll hear them acknowledge orders over team chat.

Cannon Gunners

If your ship has cannons (placed by CopyPaste or built on), companions can be assigned to man them. Each cannon has two positions (left/right side) and a fire mode:

• Weapons Free — Gunners fire at any detected target in range.
• Hold Fire — Gunners track targets but don't shoot until you say so.

Configure global cannon behavior through your team's settings (you can see it on My Companions under Team tab):

Ship Cleanup

Over time you may accumulate dozens of abandoned ships. Run /comp.cleanboats to destroy every boat you own except your current home ship — great for post-raid cleanup.

08Karma Economy

Why keeping bots loyal costs — and how to earn it back

Your karma with each hive isn't just a score — it's the currency that pays for bot services. Every follow minute, every unstuck teleport, every new hive membership draws from this pool. Drop too low and your bots desert you.

What Everything Costs

How to Earn Karma

• Trade with bots — giving them useful items earns you positive karma.
• Defend allied hives — killing their enemies (or NPCs threatening them) boosts your standing.
• Heal or revive — helping bots in combat earns you reputation.
• Complete hive requests — sometimes hives will broadcast asks in chat for specific items or deeds.

How Fast Does It Drain?

At the default rates, if your karma with your own team is +300%:

• You can follow-mode for 300 minutes (5 hours) before hitting zero.
• You can use /comp recall (unstuck TP) 20 times.
• Or some combination — each cost subtracts independently.

Check your current karma standing on your dashboard — the Overview tab shows your standing per hive plus how many follow-minutes and unstucks it'll buy at current rates.

09VIP / Elite Perks

What buying in unlocks

Tiers are granted by permissions. Admins award them, and typically VIP and Elite are available through the VIP Store. Here's what each tier unlocks:

The stack multiplier is a big one — an Elite companion can stack 3× the default quantity in each inventory slot. That means 3× more ammo hoarded, 3× more resources per-slot, less time sorting.

10Tips & Tricks

Patterns the experienced players use

Base Design for Companions

• Wide doorways — 1×1 doorways can trap bots. Use double-wide or tall doorways in key corridors.
• Boxes near TC — keep all boxes within ~20m of your TC so auto-discovery catches them.
• Dedicated furnace room — a separate fireproof room with your furnaces lets bots focus there without interfering with other tasks.
• Cannon line-of-sight — when designing sea bases, leave clear arcs of fire for your cannon gunners.

Getting the Most Out of Follow Mode

• Before a raid, set your bots to Follow and head to the target. The karma cost (-1%/min) is trivial for the firepower they provide.
• Adjust /comp.followradius based on terrain. Tight radius (5–20m) in cramped monuments, wide (50+m) on open fields.
• Use /comp recall if they get stuck — it's -15% karma but saves minutes of pathfinding.

Efficient Crafting

• Set up your craft queue with targets like "maintain 10 rifles, 1000 rifle ammo, 5 armor sets". Then just gather resources — your companions craft everything as materials arrive.
• Tag a box Components near your furnaces. Recycled parts accumulate there and feed the queue.
• Use the Builder Focus preset when raiding scrap — it enables auto-recycle so components build up automatically.

Naval Raiding

• Sail to a target coast, drop anchor off-shore, then switch your team to Follow mode and swim/boat in. Your captain guards the retreat vessel.
• Keep cannon gunners on Hold Fire until you spot threats, then switch to Weapons Free. This prevents accidental engagements with allied hives.
• /comp.returnhome is your panic button — sails the captain back to where you started the session even if you're swimming for your life.

Karma Management

• Build one "home hive" relationship by trading aggressively with them early. A stockpile of karma there pays for months of follow time.
• Avoid /comp recall spamming — at -15% each, ten recalls drains 150% karma. Walk your bots to you when possible.
• Never leave a hive voluntarily unless you have 300%+ karma to absorb the −200% hit without going negative.

Debugging Stuck Bots

• First try /comp recall — teleports all to you.
• If a specific bot is glitched, /comp reset clears stuck-state data.
• If all else fails, /comp.dismiss <name> and spawn a replacement.