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.

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.

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 but will not be reflected at the start of the next day. You must restart your session (but not the game) for these changes to take effect.

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.

Adjustments

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

Scrap

Equipment

Miscellaneous

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.

Version 1.6.0

1. You can now modify the purchase price of any item bought from the terminal. Custom items from other mods are supported!
2. Config changes for moon rarities no longer require a restart of the game session. You can modify them and they will take effect on the next day!

Version 1.5.2

1. Fix issue where starting a game with the moon rarity feature toggle set to OFF resulted in the round not starting properly. This would likely have manifested in an odd "days remaining" display on the monitor and other mods not loading.
2. Fix issue where starting a game with the weight override feature toggle set to OFF resulted in some NullReferenceExceptions for items that aren't included in the allItemsList collection.

Version 1.5.1

Fix issue where the apparatus sell value is not being updated based on your config.

Version 1.5.0

Minor update, but a new feature nonetheless. Keys will now show up on the ship's map like all the other scrap items.

Version 1.4.1

This release fixes some very serious performance issues when you have other mods that add a bunch of moons and/or scrap. Thanks to NiranV for the report!

For additional performance improvements, I recommend setting your console log level to "None" in your BepInEx.cfg file. Under "Logging.Console" section in your BepInEx.cfg file, set "LogLevels" to "None".

Version 1.4.0

Added

1. You can now enable or disable entire sections of the config to better tweak how you want the game to be. Some settings will require exiting to menu and restarting your session. View the config description for more information.
2. Add feature toggle for allowing you to sell equipment items for their average value instead of for 0 credits.

Changed

1. Config description entries now list the default vanilla values for that override.

Removed

Nothing.

Version 1.3.1

1. Fix issue when another mod is loaded that adds moons that have invalid characters for BepInEx configuration in their names.

Version 1.3.0

Added

1. Allow specifying the item rarity values per item per moon.
2. Change total scrap value to instantly display instead of counting up.
3. Change total scrap value to display values > 10,000 and shrink font size as needed so that it doesn't wrap.

Changed

1. Set allowable ranges for config entries to help with setting valid values.
2. The mod now only saves to the config file when needed instead of everytime we bind a value to the config. This increases performance by reducing the number of save requests to your disk.

Removed

Nothing.

Version 1.2.0

Added

1. Config file support. Huzzah! All items in the game (including custom items from other mods) will be registered into your config when you start a round, and reflected in-game at the start of each day.
2. Fixed bug in the game where the carry weight was being displayed as 5% higher than actual.

Changed

Nothing.

Removed

Nothing.

Version 1.1.0

Added

1. Print debug output in the game's log when starting a session to display all spawnable scrap on all levels with the name and vanilla min/max values from the game.
2. Server-side overrides of item sell values. The values are currently the vanilla values, but the min/max range in the value is set to +/- 20% of the average value instead of an arbitrary min/max range.

Changed

1. Fixed cash register overrides not being applied.

Removed

Nothing.

Version 1.0.1

Added

Nothing.

Changed

1. Fixed some namespaces just to avoid any confusion.

Removed

Nothing.

Version 1.0.0

Added

1. Client-side overrides of item weights. These values do not sync to other players in your lobby, regardless of who is hosting the session.

Changed

Nothing.

Removed

Nothing.