LethalCardLoader

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

• Install the mod and launch the game
• Load any save file
• 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

• 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

| Field | Description |

|---|---|

| Name | Display name shown in the terminal |

| Key | Unique identifier used for folder and file names. No spaces. |

| Id | Unique numeric ID for the set. Each set must have a different Id. |

| Spawn Group | The spawn group that controls which moons this set's cards appear on. |

• 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.
• 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:

| Field | Description |

|---|---|

| Id | Set Id |

| Key | The Key for the set, should match the Key in the config |

| Name | The in game display name for the set, should match the Name in the config |

| Number | Expected number of cards in the set |

| CardBackTexturePath | Image file in the Shared/ folder |

Pack fields:

| Field | Description |

|---|---|

| Key | The Key for the pack, should be unique |

| Name | Display name of the pack |

| BlacklistedCardIds | Card Numbers within this set which will not drop from this pack |

| ItemTexturePath | Filename of the pack's image inside the Shared/ folder |

Card fields:

| Field | Description |

|---|---|

| Number | Display Number, and Unique Identifier of this card within this Set |

| Name | Display name of the card |

| ItemTexturePath | Filename of the card's image inside the Cards/ folder |

| Rarity | Must match a rarity key defined in the config (e.g. Common, Uncommon, Rare) |

| Metallic | (Optional) Determines if the card acts as a metallic scrap item |

| SpawnGroup | (Optional) Determines moons card can spawn on, and with what frequency |

| ValueMultiplier | (Optional) Multiplier on Scrap Value |

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 We