Jump to content

The Sims 4 Community Library 3.4

   (5 reviews)

1 Screenshot

About This File


The Sims 4 Community Library


An API, for The Sims 4, used to make creating/writing mods using Python much easier and more accessible. On its own it does only a few debug commands/interactions. Only install this API if you also have a mod installed that requires it! This mod is intended to always be backwards compatible, so it is recommended to always keep it up to date!

Game/Creator:  The Sims 4 [EA]
Modder: ColonolNutty - Documentation - Github Wiki - Wiki - Discord (Pre Release Builds Available There)
Language: English
Game Version: (For Rent) and above




A Short List Of Current Features (Not all utilities are listed here because they are waaay too numerous!):
For a complete list of features and utilities, check out the documentation at the top of this description!

  • A vast library of Vanilla Tuning identifiers for easy retrieval (Enums)
  • Logging
  • Exception Handling
  • Custom Dialogs
    • Choose Dialogs, Outfit Dialog, Purchase Dialogs, and more!
  • Custom Notifications
  • Custom Interactions
  • Custom Icons
  • Event Handling (Creating, Dispatching, and Listening)
    • Dispatching of Vanilla Events, such as Age Changes, Traits Added/Removed, Buffs Added/Removed, and more!
  • Miscellaneous Utilities
    • Manipulate Sims, Objects,. the Weather, the Terrain, the UI, and many more!
    • Manipulate Sim Voices, Households, Gender Options, Genders, Situation States, Object Repair States,
  • Test Framework
    • Write and run tests (Can be run from within the game)
  • There are a TON more features not listed here! You may see all utilities/classes available to you at the Documentation link at the top of this description!



  1. Download the API using the links at the bottom of this description
  2. Unpack the archive using your favorite archiving tool.
  3. Drag the files and folders to your The Sims 4 directory. The files will be at `The Sims 4/Mods`. Overwrite All if asked!
  4. Keep in mind the ts4script file MUST be either top level (Directly in the Mods/folder) or one folder deep (Mods/Blah/). Any deeper and it will not work.
    The final paths for the files should be the following:

    The Sims 4/Mods/sims4communitylib.package
    The Sims 4/Mods/sims4communitylib.ts4script



  • Q: S4CL is throwing a ton of errors in my game! Can you fix it??
    • A: S4CL can catch errors caused by other mods. It is extremely rare that S4CL itself is the one breaking.
  • Q: Is S4CL compatible with X???
    • A: S4CL is compatible with ALL mods, it is intended to be an extension of The Sims 4 and not replace functionality of it.
  • Q: I don't want to use S4CL because it contains Adult Content!!
    • A: S4CL does not contain any adult content whatsoever. It may be available on Sites that permit Adult Content, however it does contain any adult content itself.




Usage (For Mod Authors):


A nifty tutorial has been created on the Github Wiki to help those wishing to either get into modding The Sims 4 or to begin utilizing S4CL, you may find it here




The changelog is kept up to date and is located here

Edited by ColonolNutty

What's New in Version 3.4   See changelog


- Fixed an error when removing relationship bits via "s4clib.remove_relationship_bit" where it would try to add a relationship bit instead.
- Added an event to occur whenever a Relationship Bit is added or removed from/to a Sim.
- Fixed a conversion issue inside `CommonSpecies.convert_to_localized_string_id`
- Added functions to `CommonAgeUtils` to retrieve the birth age of Sims by Sim Info and by Species.
- Added functions for checking if a Species value is Large Dog or Small Dog inside `CommonSpeciesUtils`.
- Added fit fat commands to modify fit and fat levels of Sims.
- Added functions to `CommonSimBodyUtils` to control fit and fat levels
- CommonConsoleCommand now automatically registers aliases without underscores.
- Added utilities for getting all Sims that match a demographic and performing an action on all Sims that match a demographic.
- Updated the Choose Sim Demographics dialog to enable hiding the All Sims and No Sims and also an option to not reopen the dialog when selections are made.
- The current Sims 4 version is now logged to the S4CL log file on start up.

  • Like 8
  • Thanks 8
  • Haha 1
  • Agree 1
  • Merry Christmas! 1
  • Yes! 1

User Feedback

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.



   11 of 11 members found this review helpful 11 / 11 members

I had no problems with this at all - honestly, the only reason I write this review is to counteract the 1-star, as I feel like that is a troll account!

  • Like 1
Link to review

   4 of 4 members found this review helpful 4 / 4 members

This mod is essential, I really like how easy it is to use. ColNutty made a rock-solid mod.

  • Like 1
Link to review

   1 of 1 member found this review helpful 1 / 1 member

I was bummed when I couldn't find this. I enjoy playing with this mod. Game isn't the same without it. Thanks for all your hard work keeping this mod going!

  • Like 1
Link to review

   3 of 4 members found this review helpful 3 / 4 members

Just to balance out the 1 star from the troll

  • Like 1
Link to review

   0 of 17 members found this review helpful 0 / 17 members

downloading this mod broke my downloads folder. it won't open anymore.

Response from the author:

Define "broke my downloads folder", because this API does not make any modifications to the game and thus would not "break your downloads folder". Did you mean your mods folder?

  • Confused 3
Link to review

  • Create New...