GuysNight-Balanced_Items icon

Balanced Items

This mod gives you the power to customize item weights, scrap values, and spawn rates - even for custom items from other mods, and make equipment items sellable. With a unique approach to config files, you can dynamically adjust some settings as you play.

Last updated 9 months ago
Total downloads 52876
Total rating 12 
Categories Mods Client-side Server-side Equipment Items
Dependency string GuysNight-Balanced_Items-1.6.0
Dependants 83 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

Introduction

Balanced Items is a mod designed to give you complete control over the items in the game. You can set the weight of items, the scrap value of items, control which items spawn (and their likelihood of spawning) on every moon, as well as make equipment items sellable to the company! This even includes all custom items that come from other mods you have added!

This mod also fixes some bugs in the game like your current carry weight being displayed as 5% greater than your actual carry weight.

Support

If you're enjoying my mods and would like to support my work, consider making a donation. Every bit helps me continue creating and improving mods for Lethal Company. Thanks for your support!

ko-fi

Configuration

This mod introduces a unique approach to configuration file creation. Unlike most mods that generate their config file upon the game's initial load, this mod dynamically creates its configuration as you play. At the start of each round, a list of all equipment and spawnable scrap items is compiled and corresponding config entries are generated. This process encompasses all scrap on all moons and is completed before you even pull the lever on your ship to land.

You can even change certain config entries as you play! Some config entries are reflected on the next day, some require a session restart, and others are even more immediate. Read the config entries for more details on that.

If there is an existing override for an item's property specified in the mod, those values are set into the config during creation. Otherwise, default (vanilla) values are used. Please note that any values you manually set in the config file will always take precedence over both the vanilla values and any preset overrides within this mod.

Features

Item Weights

The weight of an item can be changed mid-game and be reflected at the start of the next day without restarting your session. The weight of the item actually updates as the item is spawned, so newly-purchased items will reflect config changes right away.

For weight specification, simply input the desired weight of the item in pounds in the config file.

Item Average Sell Value

The average sell value of an item can be changed mid-game and be reflected at the start of the next day without restarting your session.

The average sell value you set serves as the basis for calculating the item's minimum and maximum sell values, which will be +/- 20% of this average. For example, if you set the average sell value of an item to be 100, then the item's value when spawned will be between 80-120.

[!NOTE] Be aware that different moons in the game have different scrap multipliers, potentially resulting in actual in-game values being lower or higher than your specified averages.

[!NOTE] There are no preset overrides for item values in this mod, thus this mod simply narrows the variance between the minimum and maximum values compared to standard gameplay by default, ensuring balanced gameplay without creating overly easy or difficult scenarios.

Spawn Rarities

The spawn rarity of an item on a moon can be changed mid-game and be reflected at the start of the next day without restarting your session.

Lethal Company uses a relative weighting system to handle spawn rarities, making it a bit tricky to grasp the likelihood of an item spawning. Here are a few examples to help that make sense.

Example 1: Let's say you want only clown horns to spawn on Experimentation. In the config file for Experimentation, set the rarity of all items, except the clown horn, to 0. The clown horn's rarity can be any value except 0. Since it's the only one set, it represents 100% of the spawn weighting, accounting for all the scrap spawned.

Example 2: If you want 1/3 of the generated scrap on Assurance to be clown horns, 1/3 bottles, and the last 1/3 candy, set the rarity for those 3 items to the same value (let's say 1), and set all other items to 0.

Example 3: For Titan, suppose you want 1/2 of the scrap to be clown horns, 1/4 bottles, and the remaining 1/4 candy. Set the rarity for clown horns to 2, bottles to 1, and candy to 1. The sum of these values is 4. Since clown horns account for 2 out of 4, they represent half of the generated scrap. The other two account for only 1 of the 4, making them roughly a quarter of the generated scrap.

[!NOTE] Keep in mind that due to the randomness of scrap spawns, the specified values represent the relative weighting of items for that moon, not a guaranteed outcome.

[!NOTE] The Apparatus doesn't spawn like regular scrap. It's part of a room generated inside the moon's building, making its spawn rate uncontrollable.

Selling Equipment

The config toggle for making equipment sellable can be changed mid-game as you are selling items to the company and be reflected each time you sell items.

Are you annoyed that equipment items cannot be sold for any credits? Maybe you're only 10 credits shy of quota and need just that little bit more to meet it! You can now sell equipment items to the company! The average value you set in the config is the value that the equipment will sell for.

Terminal Item Purchase Prices

The config values for terminal item purchase prices can be changed mid-game at any time and updates are reflected every time you start using the terminal.

This feature gives you the power to set your own prices for items in the terminal. Want to adjust the cost of a weapon or a tool? No problem! Please note, this feature currently excludes ship decor and ship upgrades. Enjoy the freedom of customization!

Adjustments

Below are the preset overrides set in this mod by default. Other properties are available to be overridden in your config.

Scrap

Item Name Weight (Pounds)
Airhorn 1.5
Apparatus 50
Bee Hive 0.5
Big Bolt 7
Bottles Unchanged
Brass Bell 5
Candy 1
Cash Register 20
Chemical Jug 20
Clown Horn 1
Coffee Mug 2
Comedy Mask 2
Cookie Mold Pan 3
DIY Flashbang 1.5
Dust Pan 1
Egg Beater 0.5
Fancy Lamp 10
Flask 2
Gift Box Unchanged
Gold Bar 27.5
Golden Cup 4
Hair Brush 1
Hairdryer Unchanged
Jar of Pickles 3
Large axle 25
Laser Pointer 1
Magic 7 Ball 0.5
Magnifying Glass 4
Old Phone Unchanged
Painting Unchanged
Perfume Bottle 0.5
Pill Bottle 1
Plastic Fish 0.5
Red Soda 0.5
Remote 1
Ring 0.2
Robot Toy 5
Rubber Ducky 0.5
Steering Wheel 5
Stop Sign 6
Tattered Metal Sheet 7
Tea Kettle 5
Teeth 1.5
Toothpaste 1
Toy Cube 1
Tragedy Mask 2
V-Type Engine 30
Whoopie Cushion 0.5
Yield Sign 6

Equipment

Item Name Weight (Pounds)
Boombox 10
Extension Ladder 10
Flashlight 2
Jetpack Unchanged
Lockpicker 10
Pro-Flashlight 2
Radar-Booster Unchanged
Shovel 5
Spray Paint 1
Stun Grenade 2
TZP-Inhalant 1
Walkie-talkie 2
Zap Gun 7

Miscellaneous

Item Name Weight (Pounds)
Clipboard 0.1
Double-barrel 15
Key 0.1
Player Body 100
Sticky Note 0.1

Issues / Requests

If you have any feature requests, questions, or encounter any issues like item weights not being changed correctly you can open an issue on GitHub. Before opening an issue, please search to see if your request, question, or issue already has an open issue. Alternatively, feel free to open up a PR to address your inquiry yourself. PRs are welcome!

Known Issues / Roadmap / Oddities

  1. Given how the game handles item weights and item values, the item weights are not synced across players while the item values are synced across players. Syncing the weights across players is a planned feature.