Changelog

Version: 4.1.4
Date: 2026-10-27
  Fixes:
    - Fix a non-recoverable error when a full companion inventory prevents reserving all materials for a task batch.
    - Return partially reserved materials through the normal manager cargo path and retry pending tasks when space becomes available.

Version: 4.1.3
Date: 2026-10-24
  Fixes:
    - Bound blocked cargo return retries and share companion trunk unloading between returning workers.
    - Keep all cargo until space becomes available, without repeatedly scanning every loaded worker slot each tick.

Version: 4.1.2
Date: 2026-10-15
  Fixes:
    - Stop companions blocking flying characters and other Spidertrons.

Version: 4.1.1
Date: 2026-10-13
  Changes:
    - Increase crafter, task manager and combat escort flight speeds by 50%; keep the configured speed multiplier.

Version: 4.1.0
Date: 2026-10-13
  Features:
    - Use chests covered by the closest connected electrical network, alongside logistics supplies.
    - Show intermediate recipes, upcoming steps, counts and progress above each crafter.
    - Landed crafters finish their reserved work when the owner walks away, then return with the output.
  Changes:
    - Halve the main companion's size and reduce mini drone base flight speeds.
    - Strengthen combat escorts with military tiers; keep laser damage and firing-speed bonuses.
  Fixes:
    - Share nearby companion cargo, finished crafter cargo and intermediate recipe surplus across crews.
    - Keep crafted materials reserved through delivery so other crews do not duplicate the craft.
    - Keep manager assignments long enough to reach targets at the slower flight speed.

Version: 4.0.6
Date: 2026-10-13
  Optimizations:
    - Spread routine damage checks across searches instead of inspecting every healthy entity each time.
    - Bound processing of large upgrade, construction and deconstruction requests.
    - Stop batching jobs when their available materials are exhausted.
    - Check marked jobs and urgent repairs every search.

Version: 4.0.5
Date: 2026-10-12
  Optimizations:
    - Prevent large concrete pastes from repeatedly scanning impossible crafting batches.
    - Stop searching for crafting jobs when all crafter slots are occupied.
    - Spread bulk tile scans across searches while checking entity work and repairs every time.

Version: 4.0.4
Date: 2026-10-11
  Optimizations:
    - Look up only recipes needed for autocrafting instead of rebuilding the full recipe list.
    - Cache recipe names while checking current unlocks, crafting permissions and planet restrictions.
    - Spread idle companion work scans across ticks without reducing their frequency.

Version: 4.0.3
Date: 2026-10-10
  Bugfixes:
    - Fix startup with More Quality Scaling when robot cargo scaling is enabled.
    - Keep generated planet research compatible with dedicated labs, including Panglia datacells.

Version: 4.0.2
Date: 2026-10-10
  Bugfixes:
    - Release crafting task claims when an owner disconnects, dies or parks their drones.
    - Return reserved materials to the companion, retaining any cargo that cannot fit.
    - Stop recreating worker graphics while their owner is offline.

Version: 4.0.1
Date: 2026-10-10
  Changes:
    - Shorten the mod name to Entourage and remove filler from its description.

Version: 4.0.0
Date: 2026-10-10
  Features:
    - Rename the mod to Entourage, preserving its mod ID and save data.
    - Add distinct Blender-rendered companion, utility and plasma interceptor models, icons and cover artwork.
    - Animate smooth turning, duct rotors, plasma exhaust and deploying utility landing gear.
    - Apply companion paint to armor masks across the crew, preserving unpainted hardware.
    - Give each player a permanent companion that follows between planets and survives death.
    - Deploy up to six managers with exact task batches and private construction inventories.
    - Deploy six independent stationary crafters, with batch planning and overhead progress.
    - Launch custom combat escorts while the companion continues construction work.
    - Use supplies from the player, vehicle, companion and all chests in the owner's network.
    - Add expensive development research for every non-Nauvis planet, including modded planets.
    - Grant another companion per two developed planets, plus infinite promethium expansion.
    - Start crafting at configurable 2x speed; research improves speed and crafter capacity.
  Changes:
    - Default mini drone movement to half speed with an immediately adjustable runtime setting.
    - Remove fuel, charging delays and obsolete drone/equipment crafting recipes.
    - Preserve legacy items, equipment and mode settings for existing saves.
    - Separate gentle cyan construction beams from red combat lasers.
    - Keep companions near the owner and suspend their work on space platforms.
    - Skip blocked or unaffordable work without monopolizing the task queue.
  Bugfixes:
    - Remove competing native flight steering to keep following, stopping and turning smooth.
    - Reserve exact item counts instead of taking all matching inventory items.
    - Preserve full-chest salvage, repair-pack durability and cargo awaiting return space.
    - Cache supply and recipe checks during dispatch to avoid repeated inventory scans.
    - Retire old-force combat escorts and recall crew assignments when the owner changes force.
    - Honor the construction toggle for active crafters and handle invalid migration entities.
    - Prevent old drone blueprints from bypassing researched fleet capacity.

Version: 3.2.1
Date: 2026-09-30
  Bugfixes:
    - Fix drone placement and refueling crashes on Factorio 2.1 by reading fuel_categories.
    - Accept chemical fuel in any category position, preserving the player's fuel preference.
  Changes:
    - Fork Companion Gadgetroch Fork 3.2.0 as companion-drones-luan.
    - Preserve upstream credits and GNU LGPLv3 licensing.

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