0 of 0
About this mod
Lets you configure the spawn rates and how damaged items are when you board a derelict ship
- Requirements
- Permissions and credits
- Changelogs
- Donations
Scarcity
Winning too hard? Game is not challenging enough? Try Scarcity ; )
This mod lets you configure the spawn rates and how damaged items are when you board a derelict ship. Requires BepInEx.
All options can be enabled or disabled through a configuration text file.
The mod v1.0 has been tested with Ostranauts v0.14.2.1 (6th December 2024).
Updated for Ostranauts v0.14.2.7 (19th December 2024).
- Fix for Null Reference Exception error
Please Note:
- As the game is still in the Early Access phase and the awesome devs put out frequent updates to the game, it can happen that a new update breaks this mod. I'll try to keep the mod up to date and to test it with the new releases.
- I have tested all of the options roughly. But as this is the first version of this mod, please let me know when an option does not work as expected for you.
- Back up your save files before using this mod, just to be safe. On windows, the save files should be located at:
C:\Users\<User Name>\AppData\LocalLow\Blue Bottle Games\Ostranauts\
Please use the "Bugs" tab to inform me when you encounter an error with this mod.
When boarding derelict ships, you sometimes find a lot of juicy items, such as power tools, EVA Suits or Reactor components on a ship.
This instantly makes the game a lot easier and gives you a lot of funds from selling these items.
For me, this ruined the immersion a bit, as being a scavenger in space, I would assume that the most valuable parts of a ship would already have been looted by other scavengers. It also spoils the excitement of genuinly finding a rare item on a ship.
Please note: The mod will only change the loot when you board a new derelict ship. When you board a ship, that you have already boarded before, then the ship will look exactly the same how you left it the last time.
Options
The configuration text file is located at BepInEx \ plugins \ Scarcity.txt.
In the configuration file of this mod, you can set the spawn rates (probability that an item appears) and how damaged the items are when you board a derelict ship.
Please note: I did not thoroughly balance the categories, but just configured them to my liking. Feel free to change them as you see fit.
You can define these parameters based on item categories (e.g. Tools, Food, Weapons etc.) or you can define it for each item separately. It is recommended, to only change the categories, as this is much less effort to configure items separately.
e.g. parameters for the category "Space Suits" looks like this:
# Categories | Minimum Health (Percent) | Maximum Health (Percent) | Spawn Probability (Percent) | Category Condition Name |
Category: Space Suits | 10 | 95 | 33 | IsCategorySpaceSuits |
The first two numbers (10 and 95 above) determine the damage, or the item's health points that the items are spawned with. In the example above, all Space Suit items, such as an EVA Suit will be spawned with a random health between 10% and 95%. So, as an example you might get an EVA helmet with 33% percent health and an EVA Suit with 88% percent health, when you board a derelict ship. As another example, if you set the two parameters to (10 | 10), then items will always be spawned with a fixed 10% health only.
Note that the health > 66% represents an item in working state, while the health < 66% represents a damaged item.
The third number (33 above) is the spawn probability of an item. It works as follows: when you board a ship, vanilla Ostranauts will randomly add loot to that ship. This mod only removes items that the vanilla functionality has already put there. The mod does not add extra loot items to a ship, even if you set the spawn probability to 100%. The spawn probabilty determines the chance, whether the vanilla loot item, that has already been added, will be removed or not. For example, for the Space Suit category above, the spawn probability is 33%. If you now board a derelict ship, vanilla Ostranauts may add two loot items to the ship: an EVA Suit and an EVA helmet. For each of these two items, a random number between 0% and 100% will be generated. If that number is above the spawn probability, then the item will remain on the ship. If the number is below the spawn probability, then the item is removed. For example, for the EVA Suit, if the random number 22% is generated, then the EVA Suit will be removed. For the Helmet, if the randomly generated number is, say 66%, then the EVA Helmet will not be removed from the ship.
If you feel that an individual item spawns too often or not often enough, then you can change the parameters for that specific item in the configuration file, e.g.
# - Bingham-12 EVA Suit | 10 | 95 | 33 | OutfitEVA03 | IsCategorySpaceSuits |
Note that you must remove the "#" at the beginning of the line, for the parameter to be used by the mod:
- Bingham-12 EVA Suit | 10 | 95 | 50 | OutfitEVA03 | IsCategorySpaceSuits |
Also, when you are not sure, which items belong to which category, you can just look up the item names in the configuration file. The item's category is listed on the very right side of the item.
Boarding a ship may take a long time
Please note: when you board large ships, then the boarding process (engaging the boarding clams) can take a long time, up to several minutes. It might seem that the Ostranauts game hangs or freezes, but this is due to this mod. Please be patient.
The reason for this is that a lot of items are being processed, mainly floors, walls and power conduits. I recommmend grabbing a coffee when this happens. This is only during the boarding, though. So once the boarding is completed, you can save your game. When re-loading your save, it will instantly load the ship in the same state as it was modified by this mod, and will load it without delays.
Installation
To use this mod, you need to use BepInEx:
https://github.com/BepInEx/BepInEx/releases/
BepInEx is a modding framework to change the code of Unity games. Ostranauts is made with the Unity game engine.
Be aware that using BepInEx generally poses a risk to your computer, as all of a game's coding can be changed with BepInEx.
Use at your own risk. I will not be held responsible or liable for any damages that might occur by using BepInEx or this mod.
Download the latest release from BepInEx (currently v5.4.23.2). Use the Windows x64 version.
The file name should be "BepInEx_win_x64_5.4.23.2.zip" (as of version v5.4.23.2).
Note: Please do not use the BepInEx 6.0.0 Pre version, as this mod is not tested with this version.
Extract this file into the Ostranauts root directory, where the "Ostranauts.exe" is located.
After the extraction, the Ostranauts game directory should then have these subdirectories and files in them (among others):
- BepInEx
- Ostranauts_Data
- MonoBleedingEdge
o Ostranauts.exe
o doorstop_config.ini
o winhttp.dll
Run Ostranauts once to activate BepInEx.
After you've run Ostranauts once, there should be several subfolders in the BepInEx directory, including the "plugins" subdirectory, e.g.:
Ostranauts \ BepInEx \ plugins.
Finally, download this mod and extract it to the Ostranauts game directory.
You should now have the following files:
- BepInEx
- plugins
o Scarcity.dll
o Scarcity.txt
Make sure that the files are exactly as described above, otherwise the mod will not work.
Uninstallation
It should be safe to install and uninstall this mod during playthroughs.
To remove the mod, delete the "Scarcity" files in the BepInEx\plugins folder.
To remove BepInEx completely, delete the BepInEx subdirectory, as well as the "doorstop_config.ini" and "winhttp.dll" files from the Ostranauts root directory.
See also my other Ostranauts mods:
- Quality of Life Fixes
- Player Control
- Consistent Interactions
- Floor And Walls Vis
- Skip Logos
Winning too hard? Game is not challenging enough? Try Scarcity ; )
This mod lets you configure the spawn rates and how damaged items are when you board a derelict ship. Requires BepInEx.
All options can be enabled or disabled through a configuration text file.
The mod v1.0 has been tested with Ostranauts v0.14.2.1 (6th December 2024).
Updated for Ostranauts v0.14.2.7 (19th December 2024).
- Fix for Null Reference Exception error
Please Note:
- As the game is still in the Early Access phase and the awesome devs put out frequent updates to the game, it can happen that a new update breaks this mod. I'll try to keep the mod up to date and to test it with the new releases.
- I have tested all of the options roughly. But as this is the first version of this mod, please let me know when an option does not work as expected for you.
- Back up your save files before using this mod, just to be safe. On windows, the save files should be located at:
C:\Users\<User Name>\AppData\LocalLow\Blue Bottle Games\Ostranauts\
Please use the "Bugs" tab to inform me when you encounter an error with this mod.
When boarding derelict ships, you sometimes find a lot of juicy items, such as power tools, EVA Suits or Reactor components on a ship.
This instantly makes the game a lot easier and gives you a lot of funds from selling these items.
For me, this ruined the immersion a bit, as being a scavenger in space, I would assume that the most valuable parts of a ship would already have been looted by other scavengers. It also spoils the excitement of genuinly finding a rare item on a ship.
Please note: The mod will only change the loot when you board a new derelict ship. When you board a ship, that you have already boarded before, then the ship will look exactly the same how you left it the last time.
Options
The configuration text file is located at BepInEx \ plugins \ Scarcity.txt.
In the configuration file of this mod, you can set the spawn rates (probability that an item appears) and how damaged the items are when you board a derelict ship.
Please note: I did not thoroughly balance the categories, but just configured them to my liking. Feel free to change them as you see fit.
You can define these parameters based on item categories (e.g. Tools, Food, Weapons etc.) or you can define it for each item separately. It is recommended, to only change the categories, as this is much less effort to configure items separately.
e.g. parameters for the category "Space Suits" looks like this:
# Categories | Minimum Health (Percent) | Maximum Health (Percent) | Spawn Probability (Percent) | Category Condition Name |
Category: Space Suits | 10 | 95 | 33 | IsCategorySpaceSuits |
The first two numbers (10 and 95 above) determine the damage, or the item's health points that the items are spawned with. In the example above, all Space Suit items, such as an EVA Suit will be spawned with a random health between 10% and 95%. So, as an example you might get an EVA helmet with 33% percent health and an EVA Suit with 88% percent health, when you board a derelict ship. As another example, if you set the two parameters to (10 | 10), then items will always be spawned with a fixed 10% health only.
Note that the health > 66% represents an item in working state, while the health < 66% represents a damaged item.
The third number (33 above) is the spawn probability of an item. It works as follows: when you board a ship, vanilla Ostranauts will randomly add loot to that ship. This mod only removes items that the vanilla functionality has already put there. The mod does not add extra loot items to a ship, even if you set the spawn probability to 100%. The spawn probabilty determines the chance, whether the vanilla loot item, that has already been added, will be removed or not. For example, for the Space Suit category above, the spawn probability is 33%. If you now board a derelict ship, vanilla Ostranauts may add two loot items to the ship: an EVA Suit and an EVA helmet. For each of these two items, a random number between 0% and 100% will be generated. If that number is above the spawn probability, then the item will remain on the ship. If the number is below the spawn probability, then the item is removed. For example, for the EVA Suit, if the random number 22% is generated, then the EVA Suit will be removed. For the Helmet, if the randomly generated number is, say 66%, then the EVA Helmet will not be removed from the ship.
If you feel that an individual item spawns too often or not often enough, then you can change the parameters for that specific item in the configuration file, e.g.
# - Bingham-12 EVA Suit | 10 | 95 | 33 | OutfitEVA03 | IsCategorySpaceSuits |
Note that you must remove the "#" at the beginning of the line, for the parameter to be used by the mod:
- Bingham-12 EVA Suit | 10 | 95 | 50 | OutfitEVA03 | IsCategorySpaceSuits |
Also, when you are not sure, which items belong to which category, you can just look up the item names in the configuration file. The item's category is listed on the very right side of the item.
Boarding a ship may take a long time
Please note: when you board large ships, then the boarding process (engaging the boarding clams) can take a long time, up to several minutes. It might seem that the Ostranauts game hangs or freezes, but this is due to this mod. Please be patient.
The reason for this is that a lot of items are being processed, mainly floors, walls and power conduits. I recommmend grabbing a coffee when this happens. This is only during the boarding, though. So once the boarding is completed, you can save your game. When re-loading your save, it will instantly load the ship in the same state as it was modified by this mod, and will load it without delays.
Installation
To use this mod, you need to use BepInEx:
https://github.com/BepInEx/BepInEx/releases/
BepInEx is a modding framework to change the code of Unity games. Ostranauts is made with the Unity game engine.
Be aware that using BepInEx generally poses a risk to your computer, as all of a game's coding can be changed with BepInEx.
Use at your own risk. I will not be held responsible or liable for any damages that might occur by using BepInEx or this mod.
Download the latest release from BepInEx (currently v5.4.23.2). Use the Windows x64 version.
The file name should be "BepInEx_win_x64_5.4.23.2.zip" (as of version v5.4.23.2).
Note: Please do not use the BepInEx 6.0.0 Pre version, as this mod is not tested with this version.
Extract this file into the Ostranauts root directory, where the "Ostranauts.exe" is located.
After the extraction, the Ostranauts game directory should then have these subdirectories and files in them (among others):
- BepInEx
- Ostranauts_Data
- MonoBleedingEdge
o Ostranauts.exe
o doorstop_config.ini
o winhttp.dll
Run Ostranauts once to activate BepInEx.
After you've run Ostranauts once, there should be several subfolders in the BepInEx directory, including the "plugins" subdirectory, e.g.:
Ostranauts \ BepInEx \ plugins.
Finally, download this mod and extract it to the Ostranauts game directory.
You should now have the following files:
- BepInEx
- plugins
o Scarcity.dll
o Scarcity.txt
Make sure that the files are exactly as described above, otherwise the mod will not work.
Uninstallation
It should be safe to install and uninstall this mod during playthroughs.
To remove the mod, delete the "Scarcity" files in the BepInEx\plugins folder.
To remove BepInEx completely, delete the BepInEx subdirectory, as well as the "doorstop_config.ini" and "winhttp.dll" files from the Ostranauts root directory.
See also my other Ostranauts mods:
- Quality of Life Fixes
- Player Control
- Consistent Interactions
- Floor And Walls Vis
- Skip Logos