BeeOverlay

BeeOverlay visualizes RedLocustBees spatial checks for practicing the Bee AI Break glitch.

Compatibility

• Lethal Company v81 (2026-04-17 UTC, Manifest ID: 6423525044216269478)
  • Test environment
    • BepInExPack v5.4.2305 (2026-03-17 UTC)

Screenshots

Bee AI Break glitch

Bee AI Break is the community name for a glitch in which players move a hive away from Circuit Bees without the bees recognizing that it is missing, which can make hive collection safer.

When the glitch is active, the bees stay calm. They do not become defensive merely because a player is nearby; they must also see that player inside the hive's defense radius.

While a Circuit Bee is near its hive, it leaves its calm behavior when either condition is met:

• Hive defense.
  • The bee sees a player within 16 units of the bee.
  • The player is within 10 units of the hive.
• Missing hive.
  • The bee-to-known-hive probe reaches the known-hive position:
    • The bee is less than 4 units away.
    • The bee is less than 8 units away with a clear probe line.

For Bee AI Break to work, both conditions must remain false while the hive is carried away. NavMesh boundaries or terrain features can sometimes make these conditions possible.

While carrying the hive away:

• Keep the player carrying the hive outside the bee's 16-unit sight range or block the bee-to-player sight line.
• Do not hold the hive while the bee is less than 4 units from its known-hive position.
• When the bee is 4 to less than 8 units from its known-hive position, block the probe line with solid cover.
• When the bee is 8 units or more from its known-hive position, it does not notice that a held hive is missing, but the 16-unit sight condition must still remain false.

BeeOverlay shows the relevant ranges, marker, and probe line without changing game behavior. See the Bee AI Break documentation for technical details.

What it does

• Displays a HUD summary for each RedLocustBees instance.
• Draws the bee, hive, known-hive position, and local-player spatial guides.
• Shows relevant sight, distance, and line-of-sight conditions without changing game behavior.

Who needs to install

Lobby hosts must install BeeOverlay. This prevents non-host players from using BeeOverlay's diagnostic features in a lobby without the host's knowledge.

Non-host players only need to install BeeOverlay when they want to use its diagnostic overlay. Their overlay remains disabled unless the lobby host has also installed BeeOverlay.

Configuration

BepInEx creates BepInEx/config/com.aoirint.BeeOverlay.cfg after the first launch.

Changes made through a BepInEx configuration UI apply on the next HUD update. BeeOverlay does not watch direct edits to the generated configuration file.

AI Disclosure

Some parts of this project were developed with AI tools based on large language models (LLMs), including agent-based tools. The project maintainer reviews the code. This disclosure is made in compliance with Thunderstore and community policies.

Changelog

v0.3.1 - 2026-07-25 UTC

Fixed

• BeeOverlay now displays a HUD Tip when the host does not permit target selection.
• BeeOverlay resets the selected bee when leaving or disconnecting from a lobby.

v0.3.0 - 2026-07-25 UTC

Added

• Added bee selection for the overlay.
  • Press Select Next Bee (B by default) to select a bee and cycle through the available bees.
  • The HUD and world guides show the selected bee only.

Notes

• Requires LethalCompany InputUtils v0.7.13.
• Compatibility: Lethal Company v81 (2026-04-17 UTC, Manifest ID: 6423525044216269478).

v0.2.0 - 2026-07-25 UTC

Added

• Added General.Enabled to disable all BeeOverlay functionality.
• Added General.AllowGuestEnabled to let lobby hosts allow or disallow guest use.
• Added Overlay.Enabled and controls for independently choosing BeeOverlay's HUD and world-guide elements.

Changed

• Updated Lethal Company compatibility from v73 to v81.
• Lobby hosts must install BeeOverlay before non-host players can use its diagnostic overlay. This keeps diagnostic features from being used in a lobby without the host's knowledge.
• Hosts can disable guest use with General.AllowGuestEnabled.

Notes

• Compatibility: Lethal Company v81 (2026-04-17 UTC, Manifest ID: 6423525044216269478).

v0.1.0 - 2026-07-18 UTC

Added

• Added a diagnostic overlay for RedLocustBees in Lethal Company v73. It shows bee and hive information alongside relevant spatial checks, so you can see why the game's bee behavior is taking place.
• Added three-dimensional wireframe spheres for distance guides. They replace flat circular guides to make the displayed ranges easier to interpret from different camera angles.

Notes

• Compatibility:
  • Compatible with Lethal Company v73 (2025-10-04 UTC, Manifest ID: 1749099131234587692).
    • Backfilled as reference compatibility information while preparing the v0.2.0 release.
• Install BeeOverlay only on the client where you want to see the diagnostic overlay; it does not change game behavior.