Bug Manager
Follow your friendly swarm as it moves across the world. Bug Tracker groups nearby bugs into readable map icons and reveals their surroundings for the teams you choose.
Customize team sharing, terrain discovery and map details without changing how your bugs behave.
Personal map controls
Every player can show or hide Bug Tracker’s group icons and counts independently.
Open the map and click the biter button in the shared mod toolbar beside the surface list:
- 1: Show Bug Tracker’s group icons and counts.
- 0: Hide them for you.
Your choice does not affect teammates, terrain discovery, map refresh or unrelated map markers. Normal Factorio unit blips remain wherever the game would normally display them.
The button appears while you are in map view, and your preference is saved between sessions.
Admin configuration shortcut
Admins can open configuration using the biter icon in Factorio’s shortcut bar beside the quickbar.
If it is hidden, open the shortcut selector and enable Bug Tracker. You can also run /bug-map config.
Use the configuration panel to manage sharing rules, choose display presets, filter displayed sources and adjust available tracking options. Configuration controls are restricted to admins.
Choose which teams share information
Fresh installations start with no sharing rules.
To get started:
- Run
/bug-map configas an admin. - Select Add rule.
- Choose the source team whose units you want to track.
- Choose the receiving team that should see their information.
- Configure the rule and apply it.
Sharing is one-way by default. Use Swap forces to reverse the direction, or enable Share in both directions for mutual sharing.
Team names are fully configurable. Bug Tracker does not require a particular custom team and does not create teams automatically.
Create multiple rules for different teams or surfaces. Each rule independently controls group icons, terrain discovery and map refresh around eligible units. Sharing covers those units’ surroundings, rather than automatically copying everything discovered by human players or unrelated radars.
Rules referencing a missing team remain inactive until that team exists or an admin changes the rule. Existing rules and preferences are preserved through saves, server restarts and supported upgrades.
Keep the map readable
Nearby bugs share a group icon with an optional label such as Friendly Swarm: 237 bugs.
Grouping works across grid boundaries and adjusts as bugs split up or gather together. Movement tolerance reduces unnecessary changes to group icons.
When the display cap is reached, larger groups take priority. Eligible bugs hidden by the cap still contribute terrain discovery and map refresh.
Choose Minimal, Balanced or Detailed, or use the server’s configured display settings. Available options include:
- Grouping distance and icon limits.
- Source-team labels and group counts.
- Reveal radius and update timing.
- Source filters and optional nest tracking.
- Entity and surface filters.
Locate group centres remote view on a displayed group’s last known position on your current surface. It does not grant additional visibility.
Multiplayer and modded units
Supports Factorio 2.1 multiplayer and dedicated servers.
Only the base game is required. Space Age is optional, and the toolbar uses Factorio’s bundled mod-gui library.
Track vanilla biters and spitters, compatible modded units, and optionally nests and worms. Prototype filters let you include or exclude specific entities.
Some mods use unit entities for soldiers, fish or other creatures. Use the filters to exclude these if you only want bugs.
The 1.3.0 release was tested on Factorio 2.1.23, including a 75-mod server setup. Testing included tracking vanilla, Armoured, Cold and Toxic bugs. This does not guarantee compatibility with every mod or configuration.
Your bugs keep their normal behaviour
Bug Tracker observes units without controlling them.
It does not change spawning, evolution, expansion, gathering, attacks, patrols, pathfinding, ownership or diplomacy. Movement remains controlled by Factorio, your other mods and any orders you issue.
How map visibility works
Terrain discovery follows Factorio’s chunk boundaries, so the revealed area can extend beyond the configured radius. Discovered terrain remains on the map after bugs leave.
Group icons and chart information update periodically. Update timing depends on your settings and server workload.
Bug Tracker does not provide continuous radar coverage. Zoomed-in remote viewing still requires normal live visibility.
Commands
Available to everyone
/bug-map reset-ui— Open or centre your Bug Tracker panel. Only controls available to you are shown.
Admin commands
/bug-map config— Open the configuration interface in-game./bug-map status— Show rule states, tracked entities, group-icon counts and processing progress./bug-map refresh— Queue a fresh scan and visibility update./bug-map on— Enable processing./bug-map off— Disable processing and remove Bug Tracker’s map details for everyone./bug-map clear— Disable processing and clear Bug Tracker’s map details before uninstalling.
The personal map button only changes your display. Admin commands such as /bug-map off affect the mod globally.
Updating and removing the mod
Back up your save before updating. Servers and joining players must use matching mod versions.
To uninstall, run /bug-map clear, save the game, then stop the server and remove the mod.
Cleanup preserves unrelated player-created tags and previously discovered terrain.