LethalCardLoader

A Lethal Company mod that lets you load custom card sets and booster packs into the game using nothing but images and a JSON config. Cards and booster packs spawn as scrap on moons, and can be collected, opened, and browsed via the ship terminal.

This mod does not include any cards by default, they will need configuring and adding as Content.

First Time Setup

1. Install the mod and launch the game
2. Load any save file
3. Exit back to the main menu

This will generate the config file at:

BepInEx/config/com.sholiver.lethalcardloader.cfg

The config will be pre-populated with all available moons and the default rarity tiers (Common, Uncommon, Rare) and the Default spawn group.

Adding a Card Set

1. Register the Set in the Config

Open com.sholiver.lethalcardloader.cfg and add the following at the bottom:

[Set: Base Set]
Name = Base Set
Key = BaseSet
Id = 1
Spawn Group = Default

2. Create the Folder Structure

Inside Plugin/LethalCardLoader folder, create a Content folder with the following structure:

Content/
├── BaseSet/
│   ├── BaseSet.json
│   └── Cards/
│       ├── Card1.png
│       ├── Card2.png
│       └── ...
└── Shared/
    ├── BaseSet_CardBack.png
    └── BaseSet_BoosterPack.png

• BaseSet/ — named after your set's Key
• Cards/ — contains the front face image for each card
• Shared/ — contains the card back and booster pack images, prefixed with your set key
• Working image formats include png and jpg, although others may work. Images should be 250px by 350px.

3. Create the Set JSON

Create BaseSet.json inside your set's folder. This defines every card and booster pack in the set:

{
  "Id": 1,
  "Key": "BaseSet",
  "Name": "Base Set",
  "Number": 102,
  "CardBackTexturePath": "BaseSet_CardBack.png",
  "Packs": [
    {
      "Key": "BoosterPack",
      "Name": Booster Pack",
      "BlacklistedCardIds": [1, 10],
      "ItemTexturePath": "BaseSet_BoosterPack.png"
    }
  ],
  "Cards": [
    {
      "Number": 1,
      "Name": "My Card",
      "ItemTexturePath": "Card1.jpg",
      "Rarity": "Common"
    },
    {
      "Number": 2,
      "Name": "My Rare Card",
      "ItemTexturePath": "Card2.jpg",
      "Rarity": "Rare",
      "Metallic": true,
      "SpawnGroup": "Default",
      "ValueMultiplier": 1.5
    }
  ]
}

Root fields:

Pack fields:

Card fields:

Config Reference

Rarity Tiers

Three default rarities are created on first launch. You can edit their values or add new ones:

[Rarity: Common]
Key = Common
Value = 30
Spawn Weight = 80
Card Pack Weight = 70

[Rarity: Uncommon]
Key = Uncommon
Value = 50
Spawn Weight = 15
Card Pack Weight = 20

[Rarity: Rare]
Key = Rare
Value = 80
Spawn Weight = 5
Card Pack Weight = 10

Spawn Groups

Spawn groups control which moons a card/set can appear on, and at what rate. The Default group is created automatically on first launch with all known moons at a weight of 1.0:

[Spawn Group: Default]
Key = Default
ExperimentationLevel = 1.0
AssuranceLevel = 1.0
VowLevel = 1.0
TitanLevel = 1.0
...

This is a multiplier to the Rarity Spawn Weight. If a card has no Spawn Group, it will try to find a Spawn Group with the same name as it's Rarity. Failing that, will use the Default Spawn Group.

Because both Sets and Cards have a Spawn Group, their relative weight will be: Set Spawn Group Multiplier * Card Spawn Group Multiplier * Rarity Spawn Weight

Moon Scrap Rarities

The overall frequency of Base Card and Base Pack items spawning as scrap (relative to other scrap on a moon) is configured per moon:

[Moon: 41 Experimentation]
Planet Name = 41 Experimentation
Internal Name = ExperimentationLevel
Card Scrap Rarity = 100
Pack Scrap Rarity = 100

These are populated automatically for every moon when you first launch the game and load a save.

These weights are shared between all cards, to ensure that all cards can spawn without diluting the regular scrap pool.

Terminal Commands

Use the ship terminal to browse your collection: