C# Script Utility
MTS has all free content, all the time. Donate to help keep it running.
SCREENSHOTS
Created by Battery
Uploaded: 15th Jul 2018 at 12:06 PM
Updated: 17th May 2023 at 6:46 PM
Updated: 17th May 2023 at 6:46 PM
If you are looking for my other mods you can now find some of them aswell as future updates on the Sims 3 Nexus
What is this mod ?
This mod is a C# Library of Methods and Classes that enable script modders to implement varios functionality in a simpler way then without it (see Features)
Tutorials/Resources for Script modders:
Modder Functionality Overview (incomplete)
PuddingFace
PuddingFace
Part 1: Checking if another scriptmod is installed (Video)
Part 2: NRaas like styled menus aswell as menu trees (Video)
Mods using this Utility and their C# Utility requirement
Mod | Author | Utility version |
---|---|---|
Enhanced Vampires | PuddingFace | >=1.041 |
Nosy sims interaction | FloTheory | Any |
How old are You Social Interaction | >=1.041 | |
Break into house Mod | xantak22 | Any |
Sims 3 Script Extender | >=1.041 | |
Ultimate Careers Updated | SonyaYU | Any |
Better Polyamory | izcandor | >=1.041 |
Harder Romance | lizcandor | >=1.041 |
Enhanced Witches | PuddingFace | >=1.041 |
Abductor | >=1.041 | |
Enhanced Hospitals | PuddingFace | >=1.041 |
Quick Recolor | 1.042 |
Usage / Installation:
For Players:
[spoiler]Just drop the Package file into your Mods/packages folder or subfolder
[spoiler]Just drop the Package file into your Mods/packages folder or subfolder
For Modders:
Extract the dll from the package file and reference it in your assembly. Your Project should now have access to all Utility Functionality.
You of course need to put the used package file into your mods/packages folder aswell if you want to use it in game.
Policy for Modders Using this mod:
Do not include the package in your mods download instead link to this page and give instructions of which version of this mod is required for Players of your mod.
Other Uscases
Ask for permission before using code/contend or any derivative code/contend from this mod, add a link to this mod in your mod Description/Credits and give me Credit for it.
Any derivative Work has to include a link to this mod. (If youre giving away parts of your mod which contains work based on this mod wait for my permission to do so. In any case every derivative work has to include a crediting link to my mod)
Why this mod ?
The mods i have created so far all share some similar functionallity that was only achievable through heavy modification of the original methods and classes. So my idea was instead of every mod reinventing all the changes and packaging their own version of the changes, i could just create a common library that my mods would use. After migrating the functionality to the new library i made changes to the methods and classes so that they became more flexible. This new flexibility gave me the idea to open up the mod for everyone who was interested in using similar functionality in their mod(s).
Features
- Slider
Make changes a Sims appearance in game by changing the Size of the eyes, ears and other Sliders. (This mod does not contain custom Sliders but it should be able to set the value of them) - Menus
Make a Nraas like menu to control your Settings and let the player customize them in game. - Export/Import
At one point you might wnat to give the player the option to store their cusomized settings of your mod more permanently and further give them the option to import those to other saves. The export and import capabilities of this mod could be worth a look. - Tasks
Got a Method that is heavy on Compute time and you dont want it to freeze your game for a short moment ? With the included threading functionality of the library its even more simple to run scripts on the simulator. - ANNA (Artificial Neural Network Application)
A general Artificial Neural Network Framework for AI Tasks like Classification of Data - S3SE
Sims 3 Script Extender support enables you to do input/output operations or play global sounds - And more like Remoting and predifined generic delegates
Challenges:
Be aware that updated versions might require you to change your code slightly, i will however not remove functionality of the mod in updates if not absolutly necessary. I will do my best to keep Compatibility from this version upwards.
Future plans:
Gathering feedback/listening to suggestions (ongoing)
Improve the Documentation and add missing Methods
Performance tweaks
Work on Easier Accessibility and better flexibility
DONT take features away
Bugfixing based on feedback
Improve the Documentation and add missing Methods
Performance tweaks
Work on Easier Accessibility and better flexibility
DONT take features away
Bugfixing based on feedback
Changelog
15.07.2018 Version 1.0.0
Initial Release
18.07.2018 Version 1.0.0
Added SetObjectValue to the Menu Creation and gave an example in the documentation no change of the version number
22.07.2018 Version 1.0.1
Menus:
- Added Support for Dictionary<object,MenuContainer> in the MenuController for Multi menus.
- Added Cycleable Menu Option This option Allows you to cycle through a Ilist of given Values and assigning the picked one. See forum thread
- Moved the menu Objects to their own namespace you will now find them under "Battery.Utility.MenuObjects" and made these Options sealed classes for security reasons.
- Added Constructor for Action<object> Delegates so you can now run Methods with one Parameter on the Simulator Directly yay... .(The cycleable Menu Object makes use of that)
15.03.2020 Version 1.0.2b1 and 1.02b
- Rearranged namespaces for a cleaner look
- Added a Version that can Automatically creates menus
07.10.2020 Version 1.0.2b5 Anna Update
- Added Auto Scaling for the Menus to fit the contained items
- Added ANNA (Artificial Neural Network Application) this is a framework for creating Neural nets for Classification in Sims3
14.02.2021 Prototype only 1.0.2b6
- Added Interfacing for the Sims 3 Script Extender
- Added Command System IO for S3SE
- File methods (e.g. Save, Load)
- LoadAssemblies at runtime
- Directory methods
16.04.2021 Version 1.0.2b8
- S3SE support is now a default
- Added MenuContainer Presets (Currently for Sim picking)
30.05.2021 Version 1.0.2b9
- Added: Missing Show(MenuGetter getter, params object[] Parameter) method
- Fixed: AddMenuObject(int TabNumber, MenuObject MenueItem, bool CheckForDuplicates) now works correctly
01.10.2021 Version 1.0.3
- Added: S3SE features updated to S3SE Update 2
- Fixed: Export_Import should now work correctly so you can serialize/deserialize your mods settings
- Added: Menu Preset for Importing Custom Save files (CreateFileImportMenu_S3SE)
- Changed: RemoteUtil.InvokerUtil methods moved to RemoteUtil directly and improved naming to make their purpose/usage clearer
03.10.2021 Version 1.0.31
- Fixed: Export_Import added support for Type Serialization
- Fixed: Added missing localization for Serialization menu presets
- Changed: Export_Import "ExportSave" renamed to "ExportObject" to better reflect the purpose of the method
16.10.2021 Version 1.0.32
- Changed: Export_Import changed serializer internally
- Changed: Battery.CommandSystem renamed to Battery.S3SE
- Added: missing Localization Tables for the Import Menu Preset (still missing actual Localization)
17.10.2021 Version 1.0.33
- Fixed: Deserialize null exception when not supplying custom instructions
01.11.2021 Version 1.0.34
- Changed: The Save/Load Preset now defaults to Modname/Settings instead of Modname/ModSettings *Suggestion by MissPat*
- Added: AddinteractionToObjectsOfType can now be used to add Inventory Interactions
20.11.2021 Version 1.0.35
- Added: CustomizableNotification
- Added: GetPetAgeInRealYears
- Fixed: AddInventoryInteractionToObject now correctly checks for duplicates
06.01.2022 Version 1.0.36
- Added: New Constructor for Cycleable MenuObject
- Added: AddinteractionToObjectsOfType can now be used with a predicate delegate to filter Objects
- Changed: CustomPieMenu Limiter method now returns a bool to tell when to stop
18.03.2022 Version 1.0.37
- Added: New Constructor for MenuContainer (MenuID as parameter for simple Menus)
- Added: ChangeSex method
- Added: TransformInto method
- Added: CreateFileImportMenuCustomLocation_S3SE method
- Fixed: Corrected a typo that was preventing most Dictionary objects to be serialized and deserialized correctly
30.03.2022 Version 1.0.37a
- Fixed: Updated AutoMenu functionality to allow for properties within containers to be set (Only applies to the AutoMenu version and S3SEReminder version)
08.05.2022 Version 1.0.38
- Changed: Added Reset functionality to the TransformSim method
- Added: A new overload for the ChangeSex method that additionally takes in an delegate
02.06.2022 Version 1.0.39
- Added: SetTextAlignement method
- Added: SnapToBottom method for UI
30.09.2022 Version 1.0.40
- Added: LINQ like IList Queries
11.03.2023 Version 1.0.43
- Added: SimBuilderFTORs (These Can be used with the SimTools.SimbuilderProcess method to change the appearance of a human sim)
- SetEyeColor_FTOR
- SetHair_FTOR
- SetSlider_FTOR
- SetSkin_FTOR
- SetMakeupColor_FTOR
Additional Credits ♥:
Nraas industries for some insight on their menus and Tuning
PuddingFace for being so nice to do some proof of concept testing and giving feedback
TreyNutz for giving feedback on an early prototype of the menu system.
Zoe22 and FloTheory for helping to test the Auto Menu feature
Consort for helping me fix an issue with some Sliders
SonjaYU testing new iterations of the custom pie menu
PuddingFace , Clang2, KittyTheSnowcat and Lyralei for showing their interest in the mod so that i did go through with it rather then dumping it.
Nraas industries for some insight on their menus and Tuning
PuddingFace for being so nice to do some proof of concept testing and giving feedback
TreyNutz for giving feedback on an early prototype of the menu system.
Zoe22 and FloTheory for helping to test the Auto Menu feature
Consort for helping me fix an issue with some Sliders
SonjaYU testing new iterations of the custom pie menu
PuddingFace , Clang2, KittyTheSnowcat and Lyralei for showing their interest in the mod so that i did go through with it rather then dumping it.
If you have feedback or questions feel free to ask them either in the comments or in the mods forum thread
Filename | Type | Size |
---|---|---|
Battery_Utility_1.043.7z | 7z | |
Battery_Utility_1.043.package | package | 837749 |
This mod has specific instructions!
Only use one of the *.package files in your gameFilename | Size | Downloads | Date | |||||
Battery_Utility_1.043.7z
Size: 772.1 KB · Downloads: 30,546 · 11th Mar 2023 |
772.1 KB | 30,546 | 11th Mar 2023 | |||||
For a detailed look at individual files, see the Information tab. |
Key:
- - File was updated after upload was posted
Install Instructions
Quick Guide:
1. Click the file listed on the Files tab to download the file to your computer.
2. Extract the zip, rar, or 7z file. Now you will have either a .package or a .sims3pack file.
For Package files:
1. Cut and paste the file into your Documents\Electronic Arts\The Sims 3\Mods\Packages folder. If you do not already have this folder, you should read the full guide to Package files first: Sims 3:Installing Package Fileswiki, so you can make sure your game is fully patched and you have the correct Resource.cfg file.
2. Run the game, and find your content where the creator said it would be (build mode, buy mode, Create-a-Sim, etc.).
For Sims3Pack files:
1. Cut and paste it into your Documents\Electronic Arts\The Sims 3\Downloads folder. If you do not have this folder yet, it is recommended that you open the game and then close it again so that this folder will be automatically created. Then you can place the .sims3pack into your Downloads folder.
2. Load the game's Launcher, and click on the Downloads tab. Find the item in the list and tick the box beside it. Then press the Install button below the list.
3. Wait for the installer to load, and it will install the content to the game. You will get a message letting you know when it's done.
4. Run the game, and find your content where the creator said it would be (build mode, buy mode, Create-a-Sim, etc.).
Extracting from RAR, ZIP, or 7z: You will need a special program for this. For Windows, we recommend 7-Zip and for Mac OSX, we recommend Keka. Both are free and safe to use.
Need more help?
If you need more info, see:
1. Click the file listed on the Files tab to download the file to your computer.
2. Extract the zip, rar, or 7z file. Now you will have either a .package or a .sims3pack file.
For Package files:
1. Cut and paste the file into your Documents\Electronic Arts\The Sims 3\Mods\Packages folder. If you do not already have this folder, you should read the full guide to Package files first: Sims 3:Installing Package Fileswiki, so you can make sure your game is fully patched and you have the correct Resource.cfg file.
2. Run the game, and find your content where the creator said it would be (build mode, buy mode, Create-a-Sim, etc.).
For Sims3Pack files:
1. Cut and paste it into your Documents\Electronic Arts\The Sims 3\Downloads folder. If you do not have this folder yet, it is recommended that you open the game and then close it again so that this folder will be automatically created. Then you can place the .sims3pack into your Downloads folder.
2. Load the game's Launcher, and click on the Downloads tab. Find the item in the list and tick the box beside it. Then press the Install button below the list.
3. Wait for the installer to load, and it will install the content to the game. You will get a message letting you know when it's done.
4. Run the game, and find your content where the creator said it would be (build mode, buy mode, Create-a-Sim, etc.).
Extracting from RAR, ZIP, or 7z: You will need a special program for this. For Windows, we recommend 7-Zip and for Mac OSX, we recommend Keka. Both are free and safe to use.
Need more help?
If you need more info, see:
- For package files: Sims 3:Installing Package Fileswiki
- For Sims3pack files: Game Help:Installing TS3 Packswiki
Also Thanked - Users who thanked this download also thanked:
Packs Needed
None, this is Sims 3 base game compatible!
Other Information
Operating System:
– Windows
: Windows XP, Windows Vista, Windows 7, etc
Utility Type:
– Miscellaneous
: Tools which do not fit into the above categories.
Plugin Type:
– Not Applicable
: Standalone tools
Tags