Companion Gadgetroch Fork: personal fork of Companion Drones for Factorio 2.1. Adds the /companion command to hand out a build/defend drone when you join a server mid-game. See mod description.
Providing the player with new tools or adjusting the game interface, without fundamentally changing gameplay.
Version: 3.4.2
Date: 2026-11-21
Bugfixes:
- The companion no longer flies back to a finished job: it kept its last job in memory, and with the long Construction Range it returned there as soon as it was about 100 tiles away, then came back to the player, endlessly (after a deconstruction, a build or a fight).
- A full or damaged companion returns to the player instead of leaving again for its job.
- Marked areas (deconstruction planner, blueprint) are searched first again: the area queue was never filled. It is limited to the player's surface and to 1024 cells, and is dropped when the player changes surface or leaves.
- A full companion goes back to empty its inventory instead of looking for more work on every update.
- The "MAJOR MOD UPDATE" popup can be closed again (its OK button was overridden by the Guide window).
- No crash when: placing equipment in an armor grid, a speed effect expired, a companion spawns on a blocked spot, a blueprint book is empty, a companion of a removed player is destroyed, or a console command is run from the server console.
- A removed player's companions are removed with them.
- Companions keep ahead of a walking player in the right direction (16 directions in 2.x).
- Joining a server no longer interrupts the other players' companions.
- Research upgrades also reach a player who has no companion at that moment; equipment upgrades chain correctly and put the old equipment back when the new one does not fit.
- Voice lines no longer show "Unknown key" on their first use.
- Stash chest: a chest of another force is refused.
Locale:
- The "force search" key has a name and a description in the controls menu; the three companion keys show their descriptions.
- French: settings, keys and equipment names.
Version: 3.4.1
Date: 2026-11-19
Bugfixes:
- The companion's attack search never ran: its laser was not recognised in the equipment grid (the type was compared to the item name), so it never moved toward enemies on its own or held position while fighting. It now does, within the same limits as before.
Version: 3.4.0
Date: 2026-11-18
Features:
- Stash chest: the shortcut "Choose stash chest" gives a selection tool, click a chest to remember it (per player, shown with an alert and on the map). The shortcut "Stash everything in the chest" (or its key, unbound by default) moves your main inventory into it, except filtered slots. What does not fit stays with you, with a message saying how many and what. Direct transfer when the chest is within 50 tiles on the same surface (drones do not carry it); clear messages when the chest is gone, too far or on another surface.
Version: 3.3.6
Date: 2026-11-18
Bugfixes:
- Guide button no longer crashes the game or the server ("Require can't be used outside of control.lua parsing"): the guide list is now loaded with the mod.
Version: 3.3.5
Date: 2026-11-18
Features:
- Guide button in the shortcut bar: opens a Guide window (per player, rebuilt on each opening) with your companions, modes, recipe, current settings, commands and keys read from the game, plus the guide texts.
Version: 3.3.4
Date: 2026-11-18
Features:
- In-game guide: a Companion Drones entry in the Tips and tricks window (overview, Gadgetroch changes, gestures and commands, tip), in English and French.
Version: 3.3.3
Date: 2026-11-18
Bugfixes:
- With a personal roboport, the companion no longer targets ghosts that the player's construction robots are already flying to (the registered flag was read backwards), which made it fly far away and turn back.
- The companion no longer tries to repair the player character or other companions, which made it swap repair packs back and forth with the player's inventory.
- A stalled companion and one returning to the player now forget their old job target instead of leaving for it again.
Version: 3.3.2
Date: 2026-11-17
Bugfixes:
- No crash when a player is removed from the game (per-player loops now drop that player's data).
- Loading a save no longer crashes on a companion whose entity was destroyed while the mod was off.
- Clearing an active companion no longer raises an error when its update bucket is missing.
- Idle chatter reads the player setting only when a line is due, not every cycle.
- Debug helpers use helpers.write_file / helpers.remove_path (2.1) and print the right unit number.
Version: 3.3.1
Date: 2026-11-17
Features:
- New shortcut-bar button "Unstick companions": same action as the /reschedule_companions command, for when
companions get stuck. The console commands are kept.
Version: 3.3.0
Date: 2026-11-16
Balancing:
- The companion recipe (normal and challenge modes) no longer needs a spidertron: processing units, low density
structures, engines and robot frames only. Companions now come before the rocket, in vanilla and in overhaul
packs (SE, K2, Exotic Space Industries) where the spidertron is gated at the very end.
Version: 3.2.9
Date: 2026-11-16
Bugfixes:
- Multiplayer: companion speed, damage, job range and drone limit are now stored per player instead of
being shared, so one player's research or companions no longer change another player's companions.
Existing saves are migrated on configuration change.
Version: 3.2.8
Date: 2026-11-16
Features:
- New map setting "Construction Range" (0-10000, default 1000): how far from the player companions take
construction, deconstruction and repair jobs, for example a blueprint placed from the map. Combat and
everything else keep their normal range.
- With Factory With No Time, companions take the items they need from the core of the planet, at any distance.
Version: 3.2.7
Date: 2026-11-15
Bugfixes:
- The companion limit is now re-read from finished research on load and configuration change; it was
stored under the wrong name, so research done earlier never raised the limit (stuck at one drone).
Features:
- New map setting "Maximum Drones" (0-50): 0 keeps the mod's normal progression, any other value
sets a fixed companion limit that replaces it.
Version: 3.2.6
Date: 2026-11-15
Bugfixes:
- Companions placed in a save started with another Companion Drones mod no longer sit idle: on load,
every companion this mod does not know yet is reconnected to the player who placed it (or the
nearest player of its force), within the companion limit.
Version: 3.2.5
Date: 2026-10-29
Info:
- Clarified the 3.2.4 changelog: companions still deconstruct as before; only the item-loading scan
skips deconstruction, which needs no item.
Version: 3.2.4
Date: 2026-10-29
Optimizations:
- Fixed a periodic stutter while companions build and the player moves: the item-loading scan of
the job zone now runs once per second instead of every update; since deconstruction needs no
item, that scan no longer looks at it, nor at items already judged, nor repeats logistic
network lookups. Deconstruction itself still works as before.
- The robot stock is only refilled when it drops below half, instead of on every update.
- The companion's autopilot is only rewritten when its robots' average position really moved,
and searching for a free companion no longer redirects idle ones.
Version: 3.2.3
Date: 2026-10-25
Bugfixes:
- Companions no longer leave a fight to fly to a placed blueprint: while an enemy is within gun
range they keep attacking the remaining targets, and only head for the job once the area is clear.
Version: 3.2.2
Date: 2026-10-20
Bugfixes:
- Companions now pick the construction job closest to the player instead of the first one found
(usually the north-west-most), and ignore jobs farther from the player than their search range.
They no longer drift away until they fall dormant.
Version: 3.2.1
Date: 2026-10-20
Bugfixes:
- Fixed crash "LuaItemPrototype doesn't contain key fuel_category" when placing a companion
or refuelling it on Factorio 2.1.20+: fuel items are now detected via fuel_categories.
Version: 3.2.0
Date: 2026-07-03
Features:
- New /companion command: spawns a fresh build/defend companion drone at your position.
Useful when you join a server after the mod was already running and never received one.
Changes:
- Renamed mod to "Companion Gadgetroch Fork" to avoid confusion with the original Companion Drones.
- Renamed internal mod id to "companion-drones-gadgetroch".
- Updated for Factorio 2.1 (factorio_version and base dependency bumped to 2.1).
Bugfixes:
- Fixed startup crash on Factorio 2.1 ("max_speed must be >= speed") by capping the
companion construction bots at speed = max_speed = 0.4 (preserves the original slow behavior).
- Fixed 2.1 crash "LuaEntity::minable is read only" (on_configuration_changed and when bots
spawn) by switching entity.minable = ... to entity.minable_flag = ...
- Fixed 2.1 crash "LuaEntity::active is read only" (on player join / speed sticker) by dropping
the redundant sticker.active = true writes (stickers are active by default).
- Fixed latent crash when dropping a companion on a full inventory: spill_item_stack now uses
the required table-parameter form instead of the old positional arguments.
Version: 3.1.1
Date: 2025-09-01
Bugfixes:
- Fixed drone not constructing when personal roboport is disabled
Version: 3.1.0
Date: 2025-08-31
Features:
- New "forgiving mode" intended for massively complex modpacks such as Bob's, Angels, Py, etc.
- "Challenge Mode" and "Forgiving Mode" are both combined into one setting: "set mode."
This setting takes a number between 0 and 3 and sets the companion's behavior accordingly.
See the setting description for more details.
Minor Features:
- Added about 40 new idle dialogue options.
Graphics:
- Updated shadow sprite to be slightly blurry to give a better sense of distance
- Finally got the rocket engine sprite working
Debug:
- Hid debug commands behind a warning message if debug mode is not active
Changes:
- Reduced default chatter average interval to 5 minutes (was 10)
- New migration functions for the transfer of "challenge mode" to "set mode"
Bugfixes:
- Corrected smoke appearing in a weird place relative to the drone
- Possible fix for "arithmetic on radius" crash in multiplayer
- Fixed severe lag spiking when drone builds at the same time as many construction bots
Modding:
- Added Github integration
Version: 3.0.39
Date: 2025-08-24
Bugfixes:
- Fixed drones getting deleted and leaving you with only one on mod config change
Version: 3.0.38
Date: 2025-08-24
Bugfixes:
- Previous update was accidentally the wrong version
Version: 3.0.37
Date: 2025-08-24
Debug:
- Updated documentation
Bugfixes:
- Fixed update_interval crash
Version: 3.0.36
Date: 2025-08-23
Bugfixes:
- Now quality buildings work too
Version: 3.0.35
Date: 2025-08-23
Bugfixes:
- Partially fixed companion can't build certain items bug (quality buildings still don't work)
Version: 3.0.34
Date: 2025-08-23
Bugfixes:
- Attack damage used the wrong variable in one function, breaking companion attacks
Version: 3.0.33
Date: 2025-08-23
Debug:
- Forgot to turn off Debug mode
Version: 3.0.32
Date: 2025-08-23
Bugfixes:
- Fixed the upgrade table, attempt 2.
Version: 3.0.31
Date: 2025-08-23
Bugfixes:
- The fix from 3.0.29 broke the upgrade table, that should be fixed now
Version: 3.0.30
Date: 2025-08-23
Bugfixes:
- Possibly fixed on_configuration_changed crash
Version: 3.0.29
Date: 2025-08-23
Bugfixes:
- Fixed on_player_created crash
Version: 3.0.28
Date: 2025-08-23
Balance:
- Adjusted challenge mode upgrade values, especially for speed and damage.
Debug:
- Added command for testing speed changes
Bugfixes:
- Companion should now stay "attached" to player through all save / loads.
- Companion should no longer freeze when deconstruction jobs are out of range
- Companion no longer bounces back and forth when construction jobs are out of range
Migrations:
- Implemented new migrations checks for companion equipment
Version: 3.0.27
Date: 2025-08-19
Bugfixes:
- Fixed map crashing due to absurdly large speed sticker
Version: 3.0.26
Date: 2025-08-18
Bugfixes:
- Three main bugs were the source of all 26 updates:
- 1: Companion was extremely slow when doing jobs that were all in a line
- 2: Companion speed did not change when upgrade value changed
- 3: Companion would not upgrade equipment on research finished
Version: 3.0.0
Date: 2025-08-01
Major Features:
- Hard Mode: Make the companion kinda crappy to begin with, and expensive to craft,
so you'd better take care of your one and only companion. It gets better over time
as you research technologies, reaching peak strength at Space Science.
- Dialogue: The companion can speak now! It can say things when it finishes a job, when
it kills an enemy, or just randomly when it's floating around doing nothing. Configurable.
Minor Features:
- Can toggle use best fuel first or worst fuel first
Optimizations:
- Many small tweaks throughout the codebase to improve performance and resilience.
Debug:
- Added /debug_companion to check many technical stats about the drone
- Added /swap_equipment for testing purposes
Version: 2.0.10
Date: 2024-11-17
Bugfixes:
- Fixed crash when searching for module to insert in entity.
Version: 2.0.9
Date: 2024-11-16
Bugfixes:
- Fixed construction when uisng blueprint or blueprint book from inventory instead of library.
Version: 2.0.8
Date: 2024-11-15
Bugfixes:
- Fixed construction of entities with quality.
- Fixed inserting modules with quality.
- Fixed upgrading entities with quality.
- Fixed crash when trying to construct when riding a locomotive.
- Fixed crash when trying to constrict from verhicle or spidertron.
Changes:
- Prevent to teleport companions to another surface when using Remote View.
Version: 2.0.7
Date: 2024-11-08
Bugfixes:
- Bitters now fight with Companions. (thanks Keifer9)
- Fix crash when trying to place a blueprint from blueprint book, when the blueprint contains another blueprint book. (thanks Nirahiel)
Version: 2.0.6
Date: 2024-11-08
Bugfixes:
- Fix crash when trying to get item from players inventory while in map view.
Changes:
- Attacking bitters from map view is disabled to nerf Companion a bit.
- Constructing from map view is disabled to nerf Companion a bit.
Info:
- Bitters still don't fight with Companions - to be fixed latein next version.
Version: 2.0.5
Date: 2024-11-01
Bugfixes:
- Fix crash when trying to place a blueprint containing entity with modules.
- Fix crash when pasting 'blueprint' from cut/copy.
Info:
- Constructing from map view currently doesn't work.
Version: 2.0.4
Date: 2024-10-31
Bugfixes:
- Fix crash when trying to place a blueprint from blueprint book (for now not-so-fine workaround).
Version: 2.0.3
Date: 2024-10-29
Bugfixes:
- Fix crash when trying to place equipment to players armor.
Changes:
- Removed forgotten "armor" category from Companion equipment grid from previous debugging.
- Fixed Companion equipment grid size from 10x4 to 10x2
Info:
- If you have placed equipment in bottom 2 lanes, you can get it back by removing something from grid and then Ctrl+Clik on the empty grid slot.
Version: 2.0.2
Date: 2024-10-26
Bugfixes:
- Fix crash when trying to place a blueprint.
- Fix collision mask of the companion to prevent collison with wehicles.
Version: 2.0.1
Date: 2024-10-26
Features:
- Port to Factorio 2.0.
Version: 1.0.25
Date: 2023-02-21
Changes:
- Fix desync related to refuel items.
Version: 1.0.24
Date: 2022-08-01
Changes:
- Fix problem with repairing.
Version: 1.0.23
Date: 2022-07-31
Changes:
- Fix crash with players and companions on other surfaces
- Fixed not preserving item with tags data.
- Maybe fix some cases of the robots getting stuck.
Version: 1.0.22
Date: 2021-12-02
Changes:
- QoL and reactivity improvements related to the job searching queue, submitted by madmaxoft.
- Fix crash when loading with Alien biomes installed.
Version: 1.0.21
Date: 2021-02-22
Changes:
- Fix crash related to scenarios and players take 2.
Version: 1.0.20
Date: 2021-02-22
Changes:
- Fix crash related to scenarios and players.
Version: 1.0.19
Date: 2021-02-11
Changes:
- Made companions just spawn when the game starts instead of giving the items.
- Fix companions becoming unresponsive when toggling combat.
Version: 1.0.18
Date: 2021-01-17
Changes:
- Fixed bumping into companions with Space exploration/Alien biomes installed.
Version: 1.0.17
Date: 2021-01-06
Changes:
- Fix crash using tile only blueprints.
- Fixed the new shortcut not showing on old saves.
Version: 1.0.16
Date: 2021-01-05
Changes:
- Some fixes to the laser bot items.
- Added shortcuts for enabling/disabling the combat and construction.
- Made the companions more responsive to direct player deconstruction and blueprinting.
Version: 1.0.15
Date: 2020-12-12
Changes:
- Changing the way construction laser/robots are deployed to try to make them work nicer.
Version: 1.0.14
Date: 2020-12-08
Changes:
- Fix crash on entity destroyed in some circumstances.
- Simple attempt to fix interaction with the SpaceExploration navigation view.
- Make following a jetpacking player work a bit better.
Version: 1.0.13
Date: 2020-12-06
Changes:
- Prevent giving commands to the companions with spidertron remotes.
- Fix weird case of drone being stuck following but not responding to stimuli.
Version: 1.0.12
Date: 2020-12-05
Changes:
- Micro things, like follow adjust, map icon, working with editor controller, etc.
Version: 1.0.11
Date: 2020-12-05
Changes:
- Fix unresponsive drones. Also added a user command just in case.
- Added thumbnail.
Version: 1.0.10
Date: 2020-12-04
Changes:
- Fix for compatibility with Jetpack mod.
- Fix for compatibility with Mining drones mod.
Version: 1.0.9
Date: 2020-12-04
Changes:
- Fix drones going inactive when they have items to give to the player.
- Add check to make sure players don't start riding the companions.
Version: 1.0.8
Date: 2020-12-04
Changes:
- Removed the companion GUI.
- Companions are minable in the normal way.
Version: 1.0.7
Date: 2020-12-04
Changes:
- I rewrote the updating logic, so drones that are just following the player will not take much script time.
- Made the robots spawning and draggin behind the companions less of an issue.
Version: 1.0.6
Date: 2020-12-03
Changes:
- Removed the follow range options, using new built-in follow commands.
- Fixes for teleporting.
- Companions will pop offline when players do, and reappear when they join again.
- Companions will dynamically adjust their speed to keep up with players.
Version: 1.0.5
Date: 2020-11-30
Changes:
- Add logic detecting if other construction robots are working on something.
- Fix construction logic related to item requests of ghosts that cannot be built.
Version: 1.0.4
Date: 2020-11-29
Changes:
- Nearby attack searching.
- Fix crash when searching for a job the same tick as the companion returns to the player.
- Some safety changes related to getting valid companions, fixes edge case crashes.
Version: 1.0.3
Date: 2020-11-28
Changes:
- Nearby job searching.
- Workaround for stuck bots.
Version: 1.0.2
Date: 2020-11-28
Changes:
- Fix crash trying to give items to full player.
- Fix search offsets were duplicated for attack and work searching.
Version: 1.0.1
Date: 2020-11-28
Changes:
- Fixed some things with Auto fuel, and reduced fuel consumption.
Version: 1.0.0
Date: 2020-11-27
Changes:
- Initial release