SimpleOptimize
Per-player FPS optimizer for hoard runs (/opt): item sleeper, shadow killer, culling. Written by Claude & Chonk.
About this mod Author’s original text
SimpleOptimize
Written by Claude & Chonk
Performance work and bug fixes for Lethal Company v81, built for runs where hundreds of
collected items tank the frame rate.
Anyone can install it. Almost everything runs only on your own machine and doesn't
affect other players. The exceptions are called out below.
Commands
Type these in the in-game chat.
| Command | What it does |
|---|---|
| /opt (/optimize) | Status: items sleeping, shadows removed, items culled, frame time and FPS, and which features are on |
| /opt sleep on\|off | Item sleeper |
| /opt snap on\|off | Instant settle for items dropped aboard |
| /opt shadows on\|off | Shadow remover |
| /opt cull on\|off | Hides ship items when you're far away |
| /opt yeet on\|off | Cruiser launch fix |
| /opt spray | Spray colour status, and how many colours are available |
| /opt spray | Use one of the game's own spray colours. Your colour is yours: other players running SimpleOptimize see it on the marks you spray, and you see theirs |
| /opt spray #RRGGBB | Use any colour, for example /opt spray #20B2AA |
| /opt spray off | Back to the normal colour |
| /opt dropship | Cargo dropship status and the speed table |
| /opt dropship on\|off | Fast cargo dropship |
| /opt dropship speed | 1 is normal (40s), 2 is 20s, 3 is 13s, 4 is 10s to arrive. Only at the Company: deliveries on a moon stay vanilla |
| /opt dropship wait on\|off | Keeps the dropship waiting until someone opens it |
| /opt transit on\|off | Fast player ship landing and takeoff (off by default) |
/opt cargo and /opt paint work the same as dropship and spray.
Every command also works with!, such as!opt or!opt spray #FF69B4. Use it if /opt
replies "unknown command". That message comes from another chat mod grabbing every /
command before SimpleOptimize sees it, and those mods ignore!.
Settings are saved in local.simpleoptimize.cfg.
Performance
- Item sleeper. The game updates the position of every item that isn't being held,
every frame, forever. Items resting aboard now skip that update, and wake up the moment
they're grabbed, moved or used.
- Shadow remover. Resting items stop casting shadows, and get them back when picked up
or taken off the ship. Hundreds of shadows is the biggest graphics cost of a big hoard.
- Instant settle. A falling item can't sleep, so after a big merge or organize, hundreds
of items spend seconds dropping into place. Items dropped aboard now land instantly.
Items dropped outside still fall normally.
- Distance culling. While you're out collecting, items on the ship stop being drawn
once you're more than 45 m away, and reappear as you come back.
Cargo dropship
Normally you wait 40 seconds for a terminal order to arrive, and the dropship leaves
after 30 seconds whether or not anyone opened it. If it leaves unopened, you lose the
items and the credits.
SimpleOptimize makes it arrive faster and, by default, keeps it waiting until someone
opens it, so you can't miss an order you paid for. Once it's opened, it leaves at your
chosen speed.
Only the host needs this. The host controls the dropship timer, so players without
the mod still see it arrive early, with nothing out of sync.
Spray paint colour
The game picks each spray can's colour at random. /opt spray lets you choose it.
Only players with the mod see your colour. The game never sends spray colour between
players, so anyone without SimpleOptimize sees the original colour on the same cans and
the same paint. Nothing breaks. You just see different colours.
Players who have SimpleOptimize get the host's colour automatically when they join and
whenever it changes. To keep your own colour, set [Spray] AcceptHostColor = false.
Picking one of the game's colours always works. A custom colour depends on the paint
material supporting it. If it doesn't, the command tells you instead of silently doing
nothing.
Paint that's already on a wall keeps its colour. Only new spray changes.
Bug fixes
| Fix | What it fixes |
|---|---|
Install & use Install: BepInEx plugin
- The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
- Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
- Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
- Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.
Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file.
Install these first, or the mod will not work: