Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
SimpleBlackBox
Cruiser flight recorder with automatic crash post-mortems (/bb) and position recall. Written by Claude & Chonk.
By Chonkzilla
| Last updated | 2 hours ago |
| Total downloads | 39 |
| Total rating | 0 |
| Categories | Mods Tools BepInEx Client-side Server-side Tweaks & Quality Of Life AI Generated |
| Dependency string | Chonkzilla-SimpleBlackBox-0.1.6 |
| Dependants | 0 other packages depend on this package |
This mod requires the following mods to function
BepInEx-BepInExPack
BepInEx pack for Mono Unity games. Preconfigured and ready to use.
Preferred version: 5.4.2100README
SimpleBlackBox
Written by Claude & Chonk
A flight recorder for the Company Cruiser, plus tools for testing and saving positions, for Lethal Company v81.
When the cruiser blows up or someone in it dies, SimpleBlackBox explains why, in chat, and saves a full report for a closer look.
It's a testing tool. Every command below works only when you're alone, or when everyone in the lobby has SimpleBlackBox too (for group testing). If anyone without it is in the lobby, the commands are locked, you're told why, and god mode and cruiser invulnerability switch off.
It's quiet until you turn it on. Recording, crash reports and jump reports all start off, so nothing shows up in chat until you ask for it.
Recorder
| Command | What it does |
|---|---|
/bb |
Status: whether it's recording, samples saved, and crashes this session |
/bb on|off |
Start or stop recording |
/bb report |
Explains what the cruiser has been doing, without waiting for a crash |
/bb auto on|off |
Post a crash report in chat automatically when the cruiser is destroyed or someone dies |
/bb feedback on|off |
A short report after every jump: distance, airtime, turbo timing and how it landed |
/bb jumps |
Stats across every jump it has saved: airtime, distance, turbo timing, and how they landed |
/bb wheels |
Right now: which wheels are touching the ground, and how far the cruiser is above it |
While recording, it keeps the last 120 seconds of cruiser movement and every collision, damage and stress event.
How it explains a crash
- Stress explosion: what stressed the cruiser, and for how long before it blew.
- Battle damage: every hit, how big it was, and where it came from.
- Deaths in the cruiser: a sudden stop (with the speed before and after), a fall, being crushed in a rollover, an explosion, or drowning. It also counts deaths within 5 seconds of leaving the seat, which covers being thrown out.
- What contributed: top speed, turbo, time in the air, time rolled over, and brakes.
Full reports are saved to BepInEx/config/SimpleBlackBox/incident_*.txt.
It records crashes even when another player is driving. The data is most detailed when the host is the one driving.
Lag tracking
While recording, it also logs any frame that takes more than 80 ms and is at least three times slower than normal, with what the cruiser was doing at the time. Separately, it always times the slowest parts of landing and takeoff, such as saving and the magnet. Both go to the BepInEx log.
HP on the HUD
| Command | What it does |
|---|---|
/bb hp on|off |
Shows your health as a number above the weight counter, coloured by how hurt you are. Off by default, since it isn't vanilla |
Saved positions
Save where you or the cruiser are, then return there later. Host only, because these move things.
| Command | What it does |
|---|---|
/log me pos <name> |
Saves your current position |
/log cruiser pos <name> |
Saves the cruiser's current position |
/log list |
Lists saved positions |
/move me pos <name> |
Moves you to a saved position |
/move cruiser pos <name> |
Moves the cruiser to a saved position |
/delete pos <name> |
Deletes a saved position |
Testing tools
For practising and testing. They change how the game plays.
| Command | What it does |
|---|---|
/bb god on|off |
You can't take damage. /bb god <name> on|off does it for another player |
/bb invuln on|off |
The cruiser can't be damaged |
/bb seed scan <moon> <interior> [count] |
Host: lists seeds that give that interior on that moon, each with its scrap count, and marks single-item days. Add scrap <n>, single [item], `infest [nut |
/bb seed dump |
Host: writes every moon's numbers to BepInEx/config/SimpleBlackBox/moons.txt |
/bb seed <number> |
Host: every landing uses this seed until /bb seed off. Weather isn't part of the seed, it's rolled in orbit |
/bb keyspy |
For 15 seconds, logs every game action a key press triggers. Useful for finding what a mystery key is bound to |
God mode and cruiser invulnerability last until you restart the game.
At the terminal
Type bb at the terminal to open the BlackBox screen. Every command above works there without
the slash or the bb (seed scan experimentation mansion 20, report, log list), and the reply
shows on the terminal instead of chat. Long commands only fit on the BlackBox screen: the game's
own screens allow 25 characters.
Settings
Everything is configurable in local.simpleblackbox.cfg.
Install
Drop SimpleBlackBox.dll into BepInEx/plugins, or install with a mod manager. Requires
BepInEx 5.4.2100.
