Notebook Injector — A Shared Framework for Custom Notebook Content

Notebook Injector, or NI, is a shared framework that allows compatible mods to add new content to the in-game Notebook in The Sims 4.

It can create new categories and subcategories, organize Notebook entries, support several EA entry formats, and provide more flexible custom entries without relying on traditional XML overrides of EA Notebook resources.

==========================================
📓 Requirements

Notebook Injector does not require any Expansion, Game, or Stuff Pack by itself.

Compatible mods may have their own pack requirements.

***HIGHLY RECOMMENDED***: installing Mod Update Checker (by Demeterio) to receive update notifications for new release. As it is still awaiting approval on Mod The Sims, please use the SimFileShare link and download the PLAYER zip here: Mod Update Checker by Demeterio

==========================================
📓 General Information

Notebook Injector is mainly a framework for mod creators.

It provides a common system for adding Notebook content instead of requiring every creator to rebuild the same technical structure or override EA resources.

NI can:

• create custom Notebook categories;
• create custom subcategories;
• add subcategories to custom or compatible existing categories;
• assign entries to custom or existing subcategories;
• configure names, descriptions, icons, tooltips, sorting, and entry limits;
• support standard and specialized Notebook entries;
• allocate unused category and subcategory values;
• detect common enum-name and enum-value conflicts;
• generate logs for testing and troubleshooting.

Existing EA Notebook categories are preserved when NI adds compatible content.

==========================================
📓 For Players

Notebook Injector is a shared dependency.

Install it when another mod lists NI as a requirement. Compatible mods can then use it to add organized content to your Sims' Notebook.

Notebook Injector does not add gameplay content by itself.

Installing NI alone will not add new Notebook entries.

==========================================
📓 For Mod Creators

Mod creators can use NI to create:

• new Notebook categories and subcategories;
• entries inside existing or custom sections;
• recipe entries;
• bait entries;
• animal-feed entries;
• country-item entries;
• gardening-plant entries;
• standard EA-style entries;
• fully configurable CUSTOM entries.

The CUSTOM entry type can combine different content options, including:

• titles and text blocks;
• ingredient lists;
• optional ingredient quantities;
• footers;
• custom icons;
• custom tooltips.

See the screenshots for examples of categories, CUSTOM entries, and custom tooltips.

A complete Modder Guide, examples, and template packages are available in the MODDER ZIP.
Modder Guide is here too: Notebook Injector Modder Guide

==========================================
📓 Installation

1. Close The Sims 4.
2. Extract the downloaded zip (PLAYER or MODDER).
3. Place the following files in your Mods folder. Keep the `.ts4script` no more than one folder below the main Mods folder.
4. Enable Custom Content and Mods and Script Mods Allowed in the Game.
5. Delete `localthumbcache.package`, then restart the game completely.

When updating, remove the previous Notebook Injector files before installing the new version.

Do not keep duplicate or mixed-version NI files in the Mods folder.

==========================================
📓 Compatibility

NI does not use traditional XML overrides of EA Notebook resources.

Instead, it adds compatible content to the Notebook system while the game is loading.

Possible conflicts may occur if another script mod:

• uses the same Notebook enum name or numeric value;
• replaces the Notebook category mapping without preserving existing content;
• modifies the same Notebook entry;
• patches the same Notebook UI method without calling the previous implementation.

NI includes checks for known enum conflicts and records detected problems in its log.

Known external values are currently reserved for coexistence with mods listed in the file Compatibility.txt inside the ZIP.

These reservations do not modify those mods, and neither mod is required for Notebook Injector.

==========================================
📓 Troubleshooting

Notebook Injector creates the following technical log:


An older rotated section of the log may also be stored in:


When reporting an issue, include:

• your game version;
• your Notebook Injector version;
• the name and version of the compatible mod;
• clear reproduction steps;
• the NI log files;
• lastException.txt or lastUIException.txt, when present.