This is the ultimate loading guide to how the game loads your script files. I sat down and tested numerous different combinations of trial and error in figuring out the loader. Here’s what I discovered:

Folder Structure


The special Scripts folder mentioned below is treated like normal mod folder here. Thus Scripts/Scripts would still work but Scripts would not.

/Mods/Name of Mod

In this part we’re going to cover adding custom interactions to existing objects.

Make sure you start at part 1

We’re starting to leave the beginner stage

Currently, the only known way at this time to debug is by using PyCharm Pro. Back in Jul 28 of this year, Sigma1202 discovered that PyCharm pro has a package that can be given to running code to add debugging capability and Sigma1202 worked out how to make that happen for The Sims 4.

This is a link to Sigma1202’s video which explains the process.

If you’re not using my boilerplate template then the link above should be easy to follow but an exciting update I made to the boilerplate template is I added the ability to automate most of…

This is the tutorial for the project template I made which lays out the new project groundwork for you and comes with scripting to automate much of the modding process.

I’m using Windows, but this ~ should ~ be cross-platform compatible. Please let me know if it’s not either by leaving a comment on here or by filing an issue at the issue tracker here.

Major Updates have been made since I wrote this

This is going to be a much easier and shorter tutorial and a bit more fun. You’re going to learn how to extend an in-game list. Extending a list is much safer because it’s often the least likely to conflict with other mods because we’re not replacing anything yet can add additional options or functionality to the entire game.

As briefly mentioned in part 4, there’s an official list of words/strings considered to be “true” and another list for “false”. These 2 lists are used in any command that takes a yes or no / true or false argument. Most…

What we’re going to do is replace another piece of code to get more practice at it and we’re going to step it up a small bit to make thing just a tiny bit more challenging.

This tutorial was fairly difficult to make happen because it took a long time to track down the needed code and then go through the many road blocks that happened. I’d say it took me close to three days to get to this point and quite a bit of frustration, just remember patience and practice is key to mastering Sims 4 python scripting.


Python has the ability to replace code with other code. This is an important and often easy skill that is frequently overlooked. It allows you to alter existing code in a way that wouldn’t be possible without replacing it which comes in handy with modding. This tutorial shows you how to do exactly that.

It’s worth noting that anytime you make a mod that replaces code with other code you need to tell players who download your mod about that. Replacing code means 2 mods cannot replace the same code without creating issues so players need to know this. …

In this part we’re going to create a mod that prints Hello World to the console. This gets you familiar with the process of writing the code and converting it into a mod that can run inside the game. It also familiarizes you with the Sims 4 python library that we decompiled in part 1 and I briefly talked about.

This part assumes you have finished part 1, if not, you need to read through and go through part 1.

The simplest program we can make

Why I’m writing this article

I’ve been programming for many years but I’m very new to Sims 4 modding and was ashamed and baffled by the state of Sims 4 scripting tutorials online. Most tutorials are from 2014–2018 and are terribly written and put together using bad teaching practices and are very much out of date. Explanations were also very lacking. You can’t just be told what to do, you obviously want to be a great modder and to do that you have to understand what you’re doing.

The tutorials are so bad that for the past 6 years all people have been talking about…

June Hanabi

I just love creating art, taking photographs, programming, and teaching new skills to people.

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store