Lethal Quantities

A flexible customization mod that works with other mods. Now comes with a WEB UI! All configs are disabled by default. Please request features or report issues here. Configs are generated after you host or join a game

Features

• Provides optional(disabled by default) settings to enhance your Lethal Company experience
• Some more control over how many enemies spawn, and on what moons
• Change scrap min and max values, and rarity per moon
• Change scrap amount and value multipliers per moon
• Works with custom levels
• Works with custom items
• Works with custom enemies
• Works with custom traps
• Works with custom dungeon flows
• Works with per-moon prices to travel to other moons
  • Make travel cheaper between certain moons to emulate star maps!
• Should work with custom events and other mods that change enemy spawn settings
• Comes with a web UI to make it easier to edit

Known Incompatibilities

• Moon price changing mods
  • If you modify moon prices with LethalQuantities, other mods may not be able to change the price correctly, or at all.
  • For developers:
    • The moon prices are set in a prefix for StartOfRound.ChangeLevel with a priority of 200. You can add your own prefix(with a higher priority value) or postfix to ensure that your prices are set properly.

Pictures

Configuration

Web UI

Configuration is now managed through the web UI. The old config files are deprecated and should not be used. To use the new web UI, first host or join a game, then edit the LethalQuantities/Advanced/Preset.json file in the config folder with the web UI. Once complete, download and save it to the same file(LethalQuantities/Advanced/Preset.json), and restart the game.

Legacy

However, in the case that you need to or can only use the config files, you can enable the UseLegacy option in the global config to allow the legacy configuration files to take priority over whatever is set through the web UI. You must host or join a game at least once to generate the configuration files. Any missing or deleted files will be generated with the default options. By default, the only file that is generated is Configuration.cfg. You must enable global config files and individual moon config files in order to modify anything.

• Configuration.cfg - Enable/disable other configuration files here

Global/local option inheritance

This mod uses global/local config files to reduce the amount of configuration and files required. For certain options in the configs, you can use the value DEFAULT(case insensitive) to use the vanilla value that would normally be used. For certain options in the moon config files, you can use the option GLOBAL(case insensitive) to use values in the global config files. If the global config file is DEFAULT, then it will use the vanilla value. If the global config does not normally have a default value, for example, rarity(since it's moon specific), then it will use the moon's default value. So, if a moon has GLOBAL for an enemy's rarity, and the global config does not exist or has DEFAULT, then it is the same as if the moon option is DEFAULT. Moons have higher priority over global config options, so if both have a value set, the moon's value will be used instead. For options that allow GLOBAL, a blank value is the same as GLOBAL, and for options that allow DEFAULT but not GLOBAL, a blank value is the same as DEFAULT. If a global config file is disabled, then it will have no effect on moon options that are set to GLOBAL and is equivalent to DEFAULT. A value of DEFAULT should not override values set by other mods.

Complex config types:

• AnimationCurve - Represents a curve comprised of Keyframes. Each frame represents a key, and a value at that key(generally time). For more information, and a visual representation, check out the mechanics.
  • A curve with no frames is specified with a 0.
  • A curve with one keyframe is described with a single number. This option is recommended for most users unless you know what you are doing.
  • A curve with multiple keyframes is comprised of a keyframes(key:value) separated by commas
• Global/inheritable options - Represents an option that can be inherited from the global configuration. Generally found in the moon configs.
  • GLOBAL or no value uses the global value
  • DEFAULT uses the default local value
  • Any value that is neither will be used directly instead
• Defaultable options - Represents an option that can be modified, or left default/empty to do nothing. Generally found in the global config. If a moon specific option(like rarity) is left default, then it will use the moon's default value
  • DEFAULT or no value uses the default value
  • Any value that is not DEFAULT or empty will be used directly

Spawn Logic

The enemy spawn logic in Lethal Company is a bit complex, and there are many additional variables that I did not make configurable. It would require a fairly large recode, and it would be more likely to cause problems with other mods. That said, here are some basic things to keep in mind when configuring enemy spawning:

• This is the vanilla behavior. This does not apply to mods that implement custom spawning algorithms.
• The number of vents does not limit how many enemies can spawn indoors
• The AnimationCurves dependent on time are always from 0 to 1. This includes if the total amount of hours is changed by another mod, or if the day progresses slower/faster.
• The AnimationCurves are not a linear progression from one frame to another. It is modelled by Unity's AnimationCurve, and therefore probably a smooth line
• The total enemy power level will not exceed but can equal the maximum power count
• There is a minimum amount of enemies that will spawn if certain conditions are met, such as an eclipse
• No more than 20 enemies can spawn at once
• The total amount of enemies that can spawn is calculated first; the enemy types to spawn are determined afterwards
• The chance of an enemy spawning is weight of enemy type / total weight, where the total weight is the sum of the weights of all enemy types
• The weight of an enemy type is rarity * spawn chance at the current time . If UseSpawnFalloff is enabled(like baboon hawks), then it is rarity * spawn chance at the current time * spawn falloff multiplier at the current time. Spawn falloff multiplier has a curve with a key that is the total amount of that mob / 10.

Roadmap

• Copy and paste functionality on web UI
• Add host config syncing
• Preferences for the web UI
• Moon difficulty rating and description editing
• Default values for empty fields in the web UI
• Statistical display of overall generated presets
• Weather customization
• Per dungeon flow and weather settings
• Additional settings
• Lights out?