MTS has all free content, all the time. Find out how YOU can help to keep it running. Tell me how...

The Spellbook Injector

by r3m Posted 5th Oct 2019 at 6:19 PM - Updated 12th Nov 2019 at 8:23 PM by r3m
1,513 Thanks  Thanks     373 Favourited

2019.11.12: Update for patch 1.58
2019.10.6: Fixed a bug that would cause a LE if the game was in a language other than English. Should not affect English users, please re-download if you play in another language.

Mod Overview

The Spellbook Injector is a utility mod that loads custom spells into the game. These spells won't override any EAxian tuning, which ensures that creations from different modders will be compatible!

If you're a modder interested in making new spells for Spellcasters, then this is for you! The Spellbook Injector will take care of all the scripting required to inject a new spell, so you don't have to worry about maintaining a Python script. Instead you can focus on the tuning of you spell.

I have included both a PDF tutorial and a Tuning Description that will serve as useful guides to create your own spell. Do note though that this tutorial is meant for modders that have previous experience with XML tuning. I presupose familiarity with tuning resources, string tables, and some modding lingo.


Below is a list of what the Spellbook Injector (V1) actually does:

  • injects spells to the spellbook
  • allows injected spells to be learned randomly through one of the following interactions:
    • "Ask to Teach Spell"
    • "Duel for Knowledge"
    • "Practice Magic"
  • makes custom magic tomes purchaseable in Caster's Alley's market stall
  • makes custom magic tomes findable through the "Search for Tomes" interaction
  • unlocks custom spells for newly generated Sages
  • allows injection of potential outcomes that result from the Curse of Scrambled Spells
  • allows injection of interactions that are exclusive to spellcasters

Feedback and suggestions on new features are welcome! Post here if something comes to mind!

Installation & Testing

Note there is two downloads! Download only the correct one.

r3m_spellbook_injector.7z is the main download meant for users. It contains 3 files, which must go (no deeper than one 1 folder) inside your "Mods" folder.

r3m_spellbook_injector.packageRequired tuning for the Spellbook Injector
r3m_spellbook_injector.ts4scriptRequired script for the Spellbook Injector
r3m_spells_test.packageTest spell (can be deleted after testing that everything's working correctly)

The main download comes with a test spell called "DEBUG: Test." To check that you have installed this mod properly look for this spell's entry in the spellbook. Sages should be able to teach it to you, and it can also be learned from winning a magic duel or from the Practice Practical Magic self interaction. Additionally, there's a "DEBUG: Tome of Test" that your Sims may occasionally find in the bookshelves of the Magic HQ or as a purchasable option in the market stall of Caster's Alley.

The spell itself doesn't do much. Once learned your Sim will have a new self-interaction to cast this spell. Click on your Sim and look for it under the "Spells" pie menu. After the casting animation, you should get a notification.

If the Test spell is working proceed to delete it from your "Mods" folder and download some actual custom spells!

Custom Spells


r3m_spellbook_injector_documentation.7z is meant for modders. Skip this file if you're not a modder willing to create your own spells.

Creating custom spells with the Spellbook Injector.pdfPDF tutorial guide detailing how to use the Spellbook Injector to add new spells to the game
CustomSpells.tdescTuning description for the Custom Spells Snippet
SpellbookInjector.tdescTuning description for the Spellbook Injector Snippet

Study these resources and start your own project! If you need any help understanding something or you're stuck, feel free to start a new thread in the Modding Discussion forum and link it to me, so I or other modders can help you.

Zer0_ has also written a step-by-step tutorial that is more suitable for beginners. Check it out!

When you release your project, you don't have to include the Spellbook Injector script with your download. Instead, direct your users to download the latest version from this thread, which I will keep updated with upcoming game versions.


The Spellbook Injector was built to work with game version 1.58 and The Sims 4 Realm of Magic.


It shouldn't conflict with any other mod as it uses its own resources and doesn't override anything.


If you have issues installing this mod, please make sure of the following before posting:

  • Your game is up-to-date
  • You have unzipped with 7-zip (for some reason, WinRAR will sometimes mess up with packages and scripts)
  • Both r3m_spellbook_injector.package and r3m_spellbook_injector.ts4script are inside your "Mods" folder
  • These files are not deeper than 1 folder inside your "Mods" folder (e.g., "Mods/Spells" is ok, but "Mods/Script Mods/Spells" is too deep)
  • "Script Mods" are enabled in your Game Options

If you've checked all of the above and still have a problem, check your "The Sims 4" or "Mods" folder for any "spellbook_injector.log" file and also check for any relevant "LastException.txt." If any, attach these files and try to be descriptive when reporting a possible bug. I will try my best to fix it!

Additional Credits

  • Sims4Studio
  • fetusdip, for his reload script
  • scumbumbo, for all the tools and resources he has shared with the modding community
  • Fellow modders from Deaderpool's Discord, for their support

Download files

Filename Size Downloads Date

Size: 14.8 KB · Downloads: 87,345 · 12th Nov 2019
14.8 KB 87,345 12th Nov 2019

Size: 628.7 KB · Downloads: 24,100 · 6th Oct 2019
628.7 KB 24,100 6th Oct 2019

Key: - File was updated after upload was posted
Tip: You can click the magnifying glass to see the archive contents

Need help with downloading or installing content? Click here!
191 Comments / Replies (Who?)