Lucky Lottery Ticket
A small, vanilla-feeling gambling scrap item for Lethal Company (V81).
The Lucky Lottery Ticket spawns rarely as scrap. You can sell it as-is for a few
credits, or scratch it for a chance at a much bigger payout. The catch: scratching
only reveals the prize and changes the ticket's scrap value — you still have to
survive and sell it at the Company building to actually get paid.
Built as a real BepInEx + LethalLib mod with Unity Netcode multiplayer syncing,
structured so more custom items can be added later.
No Unity required. By default the ticket is built entirely in code, so the mod works
with no asset bundle and no Unity install — the model is just a simple gold "card"
placeholder. You can later swap in a custom 3D model via an optional asset bundle
(see docs/ASSETS.md).
How it plays
- Find a Lucky Lottery Ticket in the scrap on a moon.
- (Optional) While holding it, press Use to scratch it.
- Any player can scratch.
- There's a short delay (default 2.5s), then the prize is revealed.
- The host decides the prize, once. The result is synced to everyone.
- The ticket's scrap value becomes the prize amount. It can't be scratched again.
- Carry the ticket back and sell it at the Company to collect the credits.
Scratching never gives you credits directly. An unsold scratched ticket is worth
nothing until it's sold.
Default prize table
| Chance |
Payout |
| 25% |
$25 |
| 25% |
$50 |
| 18% |
$100 |
| 12% |
$250 |
| 8% |
$500 |
| 5% |
$1,000 |
| 3% |
$2,500 |
| 2% |
$5,000 |
| 1.5% |
$10,000 |
| 0.5% |
$25,000 |
An unscratched ticket is worth about $10–15 (configurable; like all scrap, the
shown value is scaled by the moon's scrap multiplier).
Requirements
Install with a mod manager (r2modman / Thunderstore Mod Manager) and these are pulled in
automatically.
Installation (players)
Use a mod manager and install the package, or manually:
- Install BepInEx + LethalLib.
- Copy
LuckyLotteryTicket.dll and icon.png into BepInEx/plugins/LuckyLotteryTicket/.
(If you built a custom-model lotteryticket bundle, put it there too — it's optional.)
- Launch the game. All players in a lobby should have the mod installed.
Multiplayer
- Any player can scratch a ticket.
- Only the host/server rolls the result (using the host's config), so the prize
can't be tampered with by clients and payouts can't be duplicated.
- The result and the new scrap value are synced to all clients via NetworkVariables, so
they also reach players who join after a ticket was scratched.
- A scratched ticket keeps its result/value if it's dropped, picked up by someone else,
or carried between rounds.
- Client config only affects that player's local display (sounds, whether they see
other players' results). Spawn weight, value, odds and payouts come from the host.
Compatibility
Designed to play nice with scrap-management mods. In particular, LethalLevelLoader (and
mods like LethalQuantities) can rebuild each moon's scrap pool from their own config, which
would otherwise silently exclude any newly-registered scrap. To handle this, the mod
re-injects the ticket into the moon's scrap pool right before scrap spawns — running after
those mods — so it appears regardless of how the pool was built. On each landing you'll see:
Injected Lucky Lottery Ticket into 'Experimentation' scrap pool (weight 15).
(If the ticket is already in the pool, e.g. on vanilla/non-override setups, it's left alone —
no duplicate.)
Configuration
Config file: BepInEx/config/YourName.LuckyLotteryTicket.cfg (generated on first run).
| Section |
Key |
Default |
What it does |
| Spawning |
SpawnWeight |
15 |
Spawn weight relative to other scrap (higher = more common). |
| Unscratched Value |
MinValue / MaxValue |
12 / 18 |
Raw scrap value range of an unscratched ticket (before moon scaling). |
| Scratch |
ScratchDurationSeconds |
2.5 |
Delay before the prize is revealed. |
| Polish |
EnableSounds |
true |
Play the scratch sound (local). |
| Polish |
EnableJackpotAnnouncement |
true |
Show the big jackpot banner to everyone. |
| Polish |
AnnounceWinsToAll |
false |
Announce normal wins to all players, or just the scratcher. |
| Polish |
JackpotThreshold |
5000 |
Prize at/above this triggers the jackpot banner. |
| Prize Table |
Tier1..10.Amount |
25/50/100/250/500/1000/2500/5000/10000/25000 |
Payout per tier. |
| Prize Table |
Tier1..10.Chance |
25/25/18/12/8/5/3/2/1.5/0.5 |
Relative weight per tier (don't have to sum to 100). |
Building from source
See docs/BUILDING.md for the full setup (install the .NET SDK,
drop LethalLib.dll into libs/, then dotnet build). The build auto-runs NetcodePatcher
so the multiplayer RPCs work.
No Unity is needed: the item is built in code. If you later want a nicer custom model,
build an optional asset bundle named lotteryticket (see docs/ASSETS.md)
and the mod uses it automatically instead of the code-built placeholder.
Project structure
LuckyLotteryTicket/
src/
Plugin.cs # BepInEx entry point (loads config, assets, netcode, items)
PluginInfo.cs # GUID / name / version constants
Config/
LotteryConfig.cs # BepInEx config -> shared settings
Items/
LotterySettings.cs # plain shared settings (also used inside Unity)
LotteryTicketItem.cs # the item behaviour + multiplayer logic (also used inside Unity)
Registry/
ItemRegistry.cs # LethalLib registration (add future items here)
Assets/
Bundles.cs # asset bundle loader
assets/ # OPTIONAL custom-model bundle goes here (not needed by default)
thunderstore/ # Thunderstore packaging (manifest/icon/readme + tcli config)
docs/ # BUILDING.md, ASSETS.md
libs/ # local LethalLib.dll (you download this; not redistributed)
manifest.json # Thunderstore manifest
icon.png # 256x256 package icon (placeholder included)
CHANGELOG.md
README.md
Adding more items later
The structure is built to grow. To add e.g. a Security Keycard, Hard Drive,
Company Credit Card, Coffee, or Scanner Drone:
- Build its prefab +
Item asset into the same Unity asset bundle.
- (If it has custom behaviour) add a
GrabbableObject subclass in src/Items/.
- Add a
Register...() call in src/Registry/ItemRegistry.cs.
ItemRegistry.LoadAndPrepare(...) already handles the repetitive wiring
(load → fix mixer → register network prefab).
