Remnants

Why pay corporate for it if you can just find it out in the wild? Let out your inner scavenger and find the tools that were left behind by former, less fortunate employees.

This mod spreads items from the store around on the moons for you to find along with your usual scrap. Battery levels may vary. For full battery levels, consult the Lethal Company store.

Adds store items as scrap, to be found on moons as scrap in Lethal Company. Along this, there is a small chance that you will find a corpse along the scrap you find.

Mechanics:

Register store items as scrap, also known as remnant items.

This mod takes the game's store items and registers them as scrap, so you can find these store items on moons alongside other scrap. Remnant items that use a battery will have a random battery charge to make it seem as if they have been used. This mod is also compatible with other mods that add more items to the game, which means that you can find modded store items on moons as well.

Spawn bodies near remnant items.

Now there is a chance that a body will spawn near a remnant item. There are four different types of bodies (default body, cocooned body, spring body, and head burst body). Each of these body types have unique enemies ascribed to them to determine which body is spawned in. As such, depending on the moon and the enemies that spawn there, a different body will spawn. Based on the enemy's spawn rate, their linked body types will also spawn more or less. For example: on your current moon, there is a high chance for a spider to spawn, so, when a body spawns, it is far more likely to be a cocooned body. The bodies used were part of the original version of Lethal Company, but they are loaded in via an asset bundle for easier access to the bodies.

Config

Here's what you can edit and change via the config.

Remnant items:

• The minimum and maximum spawn chance (rarity) on all moons.
• The individual minimum and maximum spawn chance (rarity) for vanilla moons.
• The individual minimum and maximum spawn chance (rarity) for modded moons.
• You can choose if you want a general rarity for all moons or a unique value for each moon.
• The battery charge of remnant items with a minimum and maximum charge.
• A list of banned items, preventing these items from being registered as scrap and becoming remnant items.
• Choosing spawn options per item, using credit cost, choosing your own spawn rarity or disabling spawning entirely.
• Makes you able to edit the minimum and maximum scrap cost of remnant items via the config.
• A list of scrap items that you can add in acting as remnant items for body spawning and randomizing batteries.

Spawning remnant items:

• The minimum and maximum remnant items spawned on moons.
• A modifier that increases the amount of remnant items that spawns on moons, depending on the risk level of that moon.
• The maximum duplicates of the same remnant item that can spawn on a moon.
• The minimum and maximum remnant items found on a body.

Spawning remnant items: (legacy spawning)

• Use legacy spawning, spawning like normal scrap. This will prevent the other way of spawning remnant items.
• Increasing the maximum spawning pool of scrap so there will be enough normal scrap to find.

Body spawning:

• To make them grabbbable with a scrap value or have them just as a prop and non interactable.
• The scrap value of a body.
• The spawn chance of bodies.
• The body spawn modifier in relation to the moon risk level.
• Banning suits from being put on bodies.

Save/Load:

• Save remnant items.
• Despawn remnant items on party wipe.
• Despawn all remnant items regardless where they are when leaving a moon.
• A list of banned items, preventing these items from being saved on the ship.

Installing

This mod is also available on the thunderstore website.

If you want to download this mod manually, you should know that it is dependent on BepInEx and Lethal Lib. When the dependencies are added, you can just copy the files in the plugins folder and add them in the BepInEx plugins folder.

Feedback and issues

If you find any bugs, issues, or have any feedback on how to improve the mod, you are always welcome to share it here on Github, Unofficial Lethal Company discord or on the LC Modding discord. When you report an issue, please be sure to add the error in question and what other mods you were using at the time of the error. This way I can easily find the bug and patch it.

Known Issues

Odd body behaviour

The scrap bodies you can find via this mod are at odd angles and might be annoying if you want to carry them. This is because the bodies shake too much before setting into position. If anyone has a good way of fixing this issue, be sure to let me know.

Possible incompatibilities

This mod has an issue that the normal game does not detect remnant items that easily, so to fix this issue it has to edit the despawning and saving of items. By doing so, it can create some incompatibilities with other mods, normally the despawning of remnant items should be fine. But saving can cause some issues and make it so that remnant items are not saved at all due to incompatibilities with other mods. Normally this should not break the gameplay of that mod, if you want to be sure you can go and disable remnant items from saving in the config. If there are other compatibility issues with other mods, there is a big chance that it can be fixed via the config.

Credits

I would like to thank the following people for the assistance their work and efforts have provided in creating the Remnants Mod:

• Lethal company modding wiki and its authors: For giving a very clear overview on how to create a mod.
• MrMiinxx: To their easy-to-follow guides on how to start programming a mod for Lethal Company.
• Bepinex and Harmony: For providing their framework and library. Without this, modding would be very difficult.
• Lethallib: This library made it easier to create this mod and taught me a lot about how the game and modding works.

Because of these people and their resources and contributions, I had everything I needed to start making the Remnants Mod and to further develop it.

The following mods were a great inspiration for the creation of the Remnants Mod:

• BuyableShotgunShells: An easy way to find objects in the game.
• Monsterdrops: Making it easier to synchronize scrap values on the network.
• Batteries: For finding a way to make items spawn in a more unique and separate way.

A special thanks to Sapphy for supporting and aiding me with editing and cleaning up the public texts. If you want to support her or check out her work, you can find her on Amazon!

And finally, I want to thank all of you for giving lots of feedback and support. I really appreciate it! I couldn't have made this mod into what it is now without all the bug reports, feature requests, and other helpful feedback.

#1.0.0

• Release

#1.1.0

• Increased the chance of store scrap items appearing from 1%-10% to 5%-25%.
• Fixed the battery scrap bug. This bug caused only the host to receive partially charged items, and whenever the host would buy an item from the store, the item wouldn't be fully charged. Now only the scrap items you find around the map have a random battery charge, which is consistent for all players currently present in the game.
• Fixed a bug where if multiple mods tried to register the same item as scrap, the game returned error prompts.

#1.1.1

• Added a new feature where you can determine which scrap items spawn and which don’t by editing a Json file. Explenation is in the README.
• Fixed a bug where the mod would only register mod items as scrap, instead of both mod and vanilla items

#1.1.2

• Fixed a bug where the item values were not displayed well or not displayed at all.

#1.1.3

• Added a config to use in the config files or in your mod manager, which means the appdata json save file has become obsolete. For now it can change, general rarity, battery of remnant items and a banning list of items to not be registered as scrap. There is already a list of all the remnant items in the config loaded when you join a lobby, but it does not work yet. (It does not save correctly)
• Removed the appdata save. If you still have it you can remove it.
• Fixed the battery bug that caused some items to not have a random charge due to network issues.

#1.1.4

• The remnant items in config work now, which means you can ban remnant items from spawning before loading the next moon.
• Fixed the battery bug that did not load the correct config data.

#1.1.5

• Fixed the compatibility problem with the mod LC Office.

#1.1.6

• Fixed the occlude error patch, now the patch triggers from when the networkmanager is shutting down rather than the player pressing the exit button which was in the ui.

#1.1.7

• Fixed the save item bug where registered items (remnants) were not present in the ship on loading the lobby again.

#1.2.0

• Added a config feature that gives option for separate rarity for each moon
• Added the bodies feature which now one of the four dead bodies can be spawned on top of a remnant item. The chance of the body spawning can be changed in the config.
• An asset bundle (remnants) that contains 4 bodies prefabs with dependencies from Lethal Company: default body, head burst body, coil head body and en-webbed body.
• Fixed the bug on party wipe, remnant items are still loaded in.
• Fixed the bug that items near the ship will be seen as items in the ship and be saved.

#1.2.1

• Fixed directory bug where it could not find the remnants asset bundle via the Thunderstore app.

#1.2.2

• Added a config feature to disable/enable this mod version of saving and despawning, so it can be more compatible with other mods.
• On the remnants github page, you can find the plugins folder to install the game manually. In that folder the dll file and the asset bundle can be found.
• Fixed the bug that crashes the game when unable to load the asset bundle remnants. Now it will signal that it could not load or find the asset bundle and it will cause no more crashes.
• Fixed the bug that too much things disappears on team wipe, now only the remnant items will be removed along with the normal items that would be removed.
• Updated the icon, so the feature bodies can be seen.

#1.2.3

• Added a feature that spawns varying types of bodies, based on which enemies usually spawn on that specific moon. As such, if there is a high chance for a spider to spawn, there will also be a high chance for a cocooned body to spawn. Curious what lurks in the dark this time? Your predecessors will answer that question for you.
• Added a feature that increases the body spawn rate relative to the difficulty of the moon. For example, Titan, a high risk moon, will have a higher chance for bodies to spawn compared to Vow. If you want to modify this value, you can do so in the config.
• Updated the manifest json description as follows: "Adds store items as scrap, to be found on moons as scrap in Lethal Company. You can now also find the bodies of previous crews accompanying their former gear."
• Fixed directory issues with finding the asset bundle named remnants.

#1.2.4

• Fixed a bug that would cause a crash when a custom moon was added.
• Fixed a bug that when using a lot of mods at once, something could break during registering items.

#1.2.5

• Added a feature gives bodies better spawning locations.
• Added a feature that reads costum/modded moons and makes them available to edit the remnant items rarity in the config.
• Added a feature that makes you able to edit the scrap cost of remnant items via the config.
• Update Readme for explaining the features better.

#1.2.6

• Added a feature that makes bodies grabbable and makes it so that you can sell them as scrap. You have the option to make bodies a prop instead, and you change the scrap value in the config. Do note that whenever you reload a lobby, the bodies created by this mod will move for a couple of seconds. This is a part of the process for preventing it from just T-posing.
• Added the "body" section in the config, and the config has been rearranged. You're advised to delete the current config and let it be remade.
• Fixed compatibility issues for registering store items as remnant items.
• Fixed bug percentage scrap cost.
• Fixed compatibility issue with custom moons which had illegal characters in its name. Now it skips the name and uses another moon's data in its place for spawning bodies.

#1.2.7

• Fixed bug where there was an audio echo if you re-entered a lobby without quitting the application.
• Fixed missing textures on webbed bodies.

#1.2.8

• Fixed a bug where despawning remnant items did not work as intended.
• Increased compatibility with LethalLib made store items.

#1.2.9

• Fixed bugs around despawn items, now it despawns remnant items accordingly making the occlude error patch obsolete. This also should mean that the mod has become stable.
• Updated version so it works with the latest Lethal lib version, making you able to see remnant items in custom levels in mods made with LethalLevelLoader. This means you can also edit the rarities seperately via the config now too.

#1.2.10

• Fixed a bug where items in your hand would disappear when lifting off from a moon.
• Fixed a bug where items in your hand would not save when lifting off from a moon or disconnecting.

#1.2.11

• Fixed a bug where items in your hand would disappear when lifting off from a moon for non hosts.
• Fixed a bug where items in your hand would not save when lifting off from a moon or disconnecting for non hosts.

#1.2.12

• Added the random suits feature, where bodies will have random suits on rather than just the default one.

#1.2.13

• Increased random suits feature stability, now when something breaks it should show the default suit instead of something wrong.
• Fixed bug saving issue with other mods that would detect some mod items as to be saved even if they were not in the ship.
• Increased compatibility with other mods for registering store items as remnant items.
• Tweaked the config default value of remnant items scrap cost from 0% to 5% of its credit cost, to show that you can tweak it in the config.

#1.2.14

• Fixed bug were game would crash on seed due to selecting body as prop and the suits feature not being able to adapt to it.
• Added feature that gives you the option via config to despawn all remnant items regardless where they are when leaving a moon.
• Added feature that gives you the option via config to ban suits from being put on bodies.
• Added feature that gives you the option via config that gives a list of scrap items that you can add in acting as remnant items for body spawning and randomizing batteries.
• Made some config descriptions more coherent.

#1.2.15

• Hotfix bug where the game would crash when you sold remnant items to the company.

#1.2.16

• Added feature that adds item spawning rarity per item, now you can edit it in the config in the section Remnants.
  -1 is default and uses the store cost to calculate the spawn rarity, 0 is banned from spawning it and 1-100 is its rarity in relative to the remnants spawn rarity on that moon.
• Added feature that gives more scrap to spawn on moons relative to how much chance remnants items can spawn there. This feature can be tweaked in the config in section Other.
• Added feature, rather than a fixed percentage cost for remnant items. You have a minimum and maximum percentage, which can be tweaked in the config.
• Made body spawning more stable, so it should not crash on seed anymore.
• Fixed typo in the default body.
• Config changes: the percentage cost is replaced by a minimum and maximum, spawning pool config added and the remnants items are changed fully, names included. It is requested that delete the config or delete only the Remnants section, to prevent cluttering the config and having unusable items names in there.

#1.3.0

• Added feature, remnant items spawn separately from normal scrap, now it does not spawn anymore in lockers. This gives a lot more options to edit the spawning which gives more options to change stuff via the config. Options you can change is in the README, here are some examples: amount of remnant items spawns, max duplicates and how many remnant items on a body.
• Added feature that makes the body suits able to use suits from other mods.
• Changed names of bodies types of death in more or less like in the Lethal Company Wiki.
• Updated feature, now the spawnable remnant items can be fully updated during the game, banned and unbanned.
• Fixed bug where only the default suit for bodies are found when you choose in the config feature, make bodies as scrap.
• Fixed incompatibility bug with other mods that made remnant items not despawn at all.

#1.3.1

• Added feature, minimum remnant items spawned on a body.
• Added feature, new list of items that are banned from saving it can be found in the config in section save/load.
• Changed save items on ship patch to a transpiler, making it more compatible with other mods.
• Added a transpiler to the despawn items with still a fail safe patch if the transpiler fails.
• Updated to new version of Lethallib.
• Updated readme, added section Possible incompatibilities.
• Fixed bug that caused no remnant items to spawn on moon Artifice.
• Fixed saving issue that would cause some remnant items to not be saved under very specific conditions when picked up.
• Fixed bug, that would keep previous items saved when no items were present on the ship.
• Fixed Bug, that remnant items could not be 0 as scrap value.

#1.3.2

• Change in registering items, made sure that the store items are not changed anymore, but only the remnant items to increase compatibility with other mods.
• Removed not used anymore newsoft json package.
• Improved performance in registering store items as remnant items.

#1.3.3

• Fixed bug config feature: Always despawn remnant items. This config feature works now but disables the despawning transpiler and uses the old one. This may cause issues with despawning remnant items.

#1.3.4

• Added feature that makes the mod: compatible with Lethal Config and can be edited in the game. This does not mean that this mod is dependable on Lethal Config, it just works with and without Lethal Config.

#1.3.5

• Fixed item bodies bug, now they act as before again.
• Fixed Bug body suit behaviour crash due to illegal characters for container.
• Fixed Bug random remnant spawning doesn't according to design.
• Fixed config description bug where the information for the items in the Remnant section were only partly present.
• Changed some default config values for spawning and rarity so they are more according to the new spawning of Remnant items rather than the legacy one.

#1.3.6

• Fixed bug where some remnant items and bodies don't spawn due to compatibility issue on modded maps.

#1.3.7

• Added feature that makes remnant items to be stored in the beltbag item, this includes a config feature that you can disable it.
• Changed config feature now body scrap value from this mod have a minimum and maximum.

#1.3.7

• Fixed issue where scanning the items via the terminal would not show the true amount and value, due to not being able to find remnant items in the scan.
• Added config feature where you can disable the fix of having the terminal be able to scan remnant items.