Other user's assetsAll the assets in this file belong to the author, or are from free-to-use modder's resources
Upload permissionYou are not allowed to upload this file to other sites under any circumstances
Modification permissionYou must get permission from me before you are allowed to modify my files to improve it
Conversion permissionYou are not allowed to convert this file to work on other games under any circumstances
Asset use permissionYou must get permission from me before you are allowed to use any of the assets in this file
Asset use permission in mods/files that are being soldYou are not allowed to use assets from this file in any mods/files that are being sold, for money, on Steam Workshop or other platforms
Asset use permission in mods/files that earn donation pointsYou are not allowed to earn Donation Points for your mods if they use my assets
Author notes
This author has not provided any additional notes regarding file permissions
File credits
This author has not credited anyone else in this file
Donation Points system
Please log in to find out whether this mod is receiving Donation Points
Changelogs
Version 1.2.1
Fixed a bug where standard batteries would be consumed by tools
For full details, visit the GitHub repo https://github.com/PrimeSonic/PrimeSonicSubnauticaMods/pull/134
Version 1.2.0
New AddToFabricator bool property added to CbBattery class
When AddToFabricator is set to false, the custom battery item will not be added to the Fabricator crafting tree
Bug fix for whenever the CustomIcon property is not set
For full details, visit the GitHub repo https://github.com/PrimeSonic/PrimeSonicSubnauticaMods/pull/131
This update is for modders who prefer to manually control where their items are added to the crafting tree?
Version 1.1.1
Fixes some issues with batteries not applying indoor lighting
Optimized placement code already handled by Decorations Mod
For full details, visit the GitHub repo https://github.com/PrimeSonic/PrimeSonicSubnauticaMods/pull/128
Version 1.1.0
New APIs release!
Enables custom items from both Text Packs and DLL mods to use the Ion Battery and Ion Power Cell skins
Enables DLL mods to provide custom skins for batteries and power cells (credit MrPurple)
Enables DLL mods to patch a battery or power cell, without the need to do both
Enables DLLs mods to further enhance the item's gameobject as it is being spawned
Custom Batteries can be made Placeable if the option is enabled in Decorations Mod (credit OSubmarin)
Adds a new GetEquipmentType method to CustomBatteriesService
New wiki page for Text Packs https://github.com/PrimeSonic/PrimeSonicSubnauticaMods/wiki/Text-Pack-Patching
New wiki page for DLL mods https://github.com/PrimeSonic/PrimeSonicSubnauticaMods/wiki/CbItem-Patching
For full details, visit the GitHub repo https://github.com/PrimeSonic/PrimeSonicSubnauticaMods/pull/109
Version 1.0.2
This update was made possible by MrPurple
Updated to QModManager 4 libraries
Now displays custom models in power cell sockets when available
Added VersionChecker support
Added QMod SAM support
Version 1.0.1
Updates of CompatibleTech collections moved to PostPatch
Enables custom power cells to work with the HCP without the need to first construct a PowerCellCharger
Version 1.0.0
Initial release
Plugin packs available to replace MidGameBatteries and EnzymeChargedBatteries
Public API available for external mods to use
For full details visit the GitHub repo https://github.com/PrimeSonic/PrimeSonicSubnauticaMods/pull/82
Ready for QModManager 3.0
Custom Batteries
If you've ever wanted to add a new battery and power cell to the game, with your own choice of crafting materials and your choice of energy capacity, then this mod is for you.
This mod formalizes the common code of old MidGameBatteries and EnzymeChargedBattery mods into a flexible mod library that handles all the common patches needed to add new batteries and power cells to the game.
Sample plugin pack files for the original Deep Batteries and Enzyme Charged Batteries can be found here You can use these as a starting point to create your own custom batteries.
Batteries and Power Cells are placed into their own Fabricator crafting tabs
This mod will add two new crafting tab nodes to the Electronics tab of the Fabricator: One for batteries, one for power cells.
Custom Batteries can be created and configured by non-coders using Text file plugins
Instructions on how to make a text plugin pack are on this wiki
Text plugin packs can be made with nothing more than a simple text editor
Text plugin packs support custom sprites which can be made with any image editor
Custom Batteries can be created through public mod APIs
Modders who wish to do a little more with their custom batteries, and prefer to avoid copy/pasting the same patch methods all custom batteries would be using, can use this mod as an API
Simply add a DLL reference to your project and check out the example code available on GitHub
Instantiate a new CbBattery and CbPowerCell instance, populate the required properties, and call the provided Patch() method when ready.
There are many optional properties you can set which will allow further customization of your batteries in both appearance and function
For all item references, you must use the spawn ID (aka, debug ID) of the item you want to reference. You can find all of this in the Subnautica Fandom Wiki
Installation Requirements
CustomBatteries uses the newer APIs of QModManager 4 for better cross-mod compatibility.
You should also have SMLHelper installed. Preferably version 2.5 or later.
Outline of a Text Plugin Pack Text plugin packs use EasyMarkup format. If you have played around with CustomCraft2 at all, this should feel familiar. Remember that colons, semi-colons, parenthesis, and commas are special characters. You can use the files provided as a starting point you can customize to your liking. Instructions on how to make a text plugin pack are on this wiki Full Example CustomBatteriesPack: ( PluginPackName:MyCustomBatteries; BatteryCapacity:120; UnlocksWith:Copper; BatteryID:MyBattery; BatteryName:"My Own Battery"; BatteryFlavorText:"Flavor text goes here"; BatteryParts: Titanium,Lithium,Magnetite; BatteryIconFile:"MyBattery.png"; PowerCellID:MyPowerCell; PowerCellName:"My own Power Cell"; PowerCellFlavorText:"Other flavor text in here"; PowerCellAdditionalParts:; PowerCellIconFile:"MyPowerCell.png"; );