Chonkzilla-SimpleHQ icon

SimpleHQ

Scrap bank for long runs plus tournament mode. Bank ship scrap with /bank to cut lag, see it in the terminal, sell it at the Company. Kit codes set the moon, seed, weather and gear for set-seed tournaments. Written by Claude & Chonk.

Last updated 5 hours ago
Total downloads 3
Total rating 0 
Categories Mods Tools Client-side Server-side Performance Tweaks & Quality Of Life AI Generated
Dependency string Chonkzilla-SimpleHQ-0.4.4
Dependants 0 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2100 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2100

README

SimpleHQ

Written by Claude & Chonk

A scrap bank for long Lethal Company v81 runs. Hundreds of items on the ship make landing and takeoff lag. Deposit them into the bank instead: they leave the ship, their value is kept, and you sell straight from the bank at the Company.

Commands

Anyone can type /bank to see the total. Everything else is for the host and whitelisted players. The whitelist is SimpleSell's, managed with its /whitelist command; without SimpleSell, only the host can use bank commands. The host needs SimpleHQ; other players don't need it to type commands, only to use the terminal versions.

Command What it does
/bank How much is in the bank. The total also shows in orange beside your credits at the top right of the terminal
/bank deposit <amount> Deposits scrap adding up to at least that value, for example /bank deposit 500
/bank deposit all Deposits all the scrap on the ship
/bank deposit <item> [count|all] Deposits one kind of item, for example /bank deposit gold bar 3
/bank withdraw <item> [count|all] Takes items back out onto the ship, most valuable first. No count means 1, for example /bank withdraw gold bar 2
/bank auto on|off Deposits all the ship's scrap automatically at the end of each day. Off by default
/bank list Everything in the bank, in chat
/bank info Tells everyone in the lobby about the bank and how to use it from chat
/sell bank <amount> At the Company, sells banked scrap worth at least that many credits
/sell bank quota Sells enough to meet the quota
/sell bank all Sells the whole bank

Type bank in the terminal to see the total and a list by item. The commands work in the terminal too, without the slash: bank deposit 100, bank deposit all, bank list, bank sell 300. The result shows in chat.

! works in place of / (for example !bank) if another chat mod takes / commands first.

What gets deposited

Deposits and withdrawals only work in orbit or at the Company, never while landing on or exploring a moon.

Scrap on the ship, and in the Company Cruiser unless [Bank] IncludeCruiser = false. Never deposited: anything a player is holding, bodies, belt bags and what's inside them, and the items on [Bank] KeepOnShip (Shotgun and Kitchen knife by default).

Withdrawn items come back as real items with their exact value, at your feet if you're in the ship, otherwise at the ship's spawn point. Items banked before withdraw existed come back too.

Same rules as the ship

  • Crew wiped out: vanilla loses all the scrap on the ship, so the bank is lost too.
  • Fired: the bank is emptied with the rest of the run.
  • Selling: banked scrap sells at the Company's buying rate for the day, through the Company desk like any sale. Credits, quota and the end of run stats all count it. Items are picked the same way as /sell, so a sale can go slightly over the amount, never under.
  • Private lobbies only. In a public lobby the bank is locked (nothing is lost). Challenge moons don't use the bank.

Tournament mode

For organised tournament runs. A kit (its moons, seeds, weather, starting gear, credits and format) is carried by a code the organisers hand out when the event starts, the way old games kept a save in a password. Nothing ships inside the mod, and any organiser can make their own kits.

  1. The host, in orbit, types tournament at the terminal (or /tournament start in chat). No code yet.
  2. Everyone in the lobby types /agree in chat within 2 minutes. Every player needs SimpleHQ for tournament mode: the game has no way to send weather, so each player's SimpleHQ sets it.
  3. Tournament mode is on: the lobby locks, every Simple Suite mod switches its commands and extras off (bug fixes and performance work stay), and the ship flies to the Company and waits there. Routing is locked to the Company and the lever won't land.
  4. When the organisers release the code, the host types tournament at the terminal again and then the code on the next line (or /tournament load <code>). Dashes and case don't matter, and a mistyped code is refused rather than loading something wrong. Straight away:
    • the ship routes to the kit's moon, and routing is locked to it;
    • the moon's weather is fixed to the kit's, for everyone, and shows on the terminal;
    • the kit's seed is set, so the interior, scrap and single-item day are the same for every team;
    • credits are set to the kit's, and its tools are on the ship floor;
    • the lever unlocks: land when ready.

Formats. Each kit sets its format, its days and the crew size it's for (a different lobby size is refused when the code is entered):

  • 1o, a one-off: one day, then the run is over.
  • 1q, 3q and so on: that many quotas, three moon days each. The ship routes itself to each day's moon, with its own seed and weather, as soon as it's back in orbit.
    • Normal: after each quota's three days, the ship goes to the Company for a day. The banked scrap is put back on the ship to sell, shop and meet the quota, vanilla style. Missing it gets the crew fired and ends the run. A wipe loses that day's scrap; the run total stays.
    • Hardcore: no Company days. After the third day the quota is checked against the scrap banked in those three days. Met, the next quota starts; missed, or a wipe, the run is over.
  • The deadline reads 3, 2, 1 days on each quota's moon days, like vanilla. Kits can fix the quotas so every team faces the same ones.

Scoring and a clean ship. Entering the code clears the ship (use a spare save), then places the kit's tools and sets its credits, once. At the end of every moon day, the scrap brought back goes into the bank and onto the run total and off the ship (found shotguns and knives count, kit items never do); equipment stays for the next day. When the run is over, chat posts the results, the ship goes to the Company with the lever locked, and tournament mode stays on until the host ends it.

A series of codes. Loading another code in the same lobby starts the next run and adds its score to the last: one code per round, handed out when the whole bracket has finished that round, with nobody leaving the lobby. Each code brings its own moons, gear and credits, and the ship is cleared between runs. /tournament end posts every run and the final score.

/tournament shows the state, the run total and the series total. Entering another code in orbit swaps the kit (the old kit's tools still on the floor are taken back). /tournament end turns it all off and puts the weather and seed back to normal. A kit that asks for a cruiser starts with one on the ship's magnet, in orbit, so it drops with you. The run record comes in a later update.

Making your own code. Type tournament builder at the terminal and answer six questions: moon, seed, weather, crew size, starting items and format. Items are typed the way you buy them, several to a line (shovel 2 weed 4 jet 1 pro 2), and short names work when they match one item. Type cruiser 1 there for a Company Cruiser on the magnet. The code comes back on screen and is written to BepInEx\config\SimpleHQ\kits.txt, with the kit in plain words, so you can copy it and send it on. Every code is decoded and checked against what you typed before you get it. One-off runs for now; longer formats are still built by hand. Nothing is sent anywhere, so anyone can build a code, not just the host.

Saving

Your game save is never changed. The bank is kept in its own file per save slot, in LocalLow\ZeekerssRBLX\Lethal Company\SimpleHQ\, and is written right after the game saves the ship in orbit. If the game closes before a save, the bank and the ship both go back to that save together, so scrap can't be lost or doubled.

With SimpleSell

If the host also runs SimpleSell, sell works at the terminal too: sell 500, sell quota, sell all, sell gold bar 2 (same as SimpleSell's /sell), plus sell bank 300. Other players can only sell this way if the host's SimpleSell whitelist allows them to, same as in chat. With SimpleSell alone and no SimpleHQ, nothing is added to the terminal.

/sell bank works alongside SimpleSell's /sell. Normal /sell still sells items on the ship. SimpleSell's /stock shows the bank's value and counts it in the total.

Install

Drop SimpleHQ.dll into BepInEx/plugins, or install with a mod manager. Requires BepInEx 5.4.2100. Settings are in local.simplehq.cfg.