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

Featured upload! The SCRIPTORIUM: v. 2.2f (BugFix + Radiance 2.4)

by Numenor Posted 26th Sep 2006 at 2:40 AM - Updated 27th Nov 2013 at 10:19 PM by Nysha
664 Comments / replies (Who?) - 8 Feedback Posts, 4 Thanks Posts
This is a featured upload! It showcases the best talent and creativity available on MTS and in the community.
THE SCRIPTORIUM: Easy support for custom scripts
(Modular Stairs, Fireplaces, Walls, Lights)
with *optional* installation of GunMod's RADIANCE

(Read older news and ChangeLog at the end of the post)

30 APR 2009 - Scriptorium v. 2.2f: BUGFIX + RADIANCE UPDATE.
- Fixed a bug that left (harmless) M&G files after uninstallation.
- Newest Radiance 2.4 (by dDefender) is now included in the installer.
- Outdated and superseded Radiance v. 2.1, 2.2 and 2.3 have been removed from the installer.


Creators of custom modular stairs, fireplaces, walls (not wallpapers, but custom walls), and lamps/mods using custom lights are tired of spending half of their time explaining the users how to edit the game files, and where to find them.
And users are (rightly) afraid to manually edit the game files, and to rummage their hard disks to find the folders where they hide.

But from now on, with the SCRIPTORIUM, all these things are just a remembrance of the past! :D


  • In brief: it helps users to install custom fireplaces, modular stairs, walls and lights.
  • In detail: Basically, it's a revolutionary new approach to the custom scripts (modular stairs etc...). And, of course, the Scriptorium is also an installer (for Windows) that sets up your game to easily accept new custom scripts.
    The installer, in addition to enabling the support for custom script, also has the *option* (not active by default) to install the "RADIANCE" lighting mod (latest version)


  • In brief: It creates the special folders where to put the text files for the custom modular stairs etc., and instructs the game to automatically load all the file found in those folders.
  • In detail: the Installer creates three special folders named "Scriptorium_ModularStairs", "Scriptorium_Fireplaces" and "Scriptorium_Walls" in the folder (gamedir)\The Sims 2\TSData\Res\Catalog\Scripts.
    Then appends one single line to the game files "modularstairs.txt", "fireplaces.txt" and "walls.txt": wildInclude Scriptorium_Fireplaces\*.*
    These two simple steps ensure the needed support for the custom content.
    As an added bonus, the installer creates some shortcuts in the Downloads folder, to easily access the various "Scriptorium..." folders. (These shortcuts are ignored by the game when loading).
    The support for the custom lights is identical: only difference, the "lighting.txt" and the "Scriptorium_CustomLights" folder are located in (gamedir)\The Sims 2\TSData\Res\Lights.
    To know *exactly* what happens to your system, using the installer, read the "Manual-Installation" instructions, attached below.


Windows users have the option to use the provided installer, or to perform the required steps manually. Mac users, unfortunately, can only install it by hand.
  • AUTOMATIC INSTALLATION (Windows users only): download the file "", unpack it to a temporary folder (the desktop is fine), and double click on the setup icon. After the Disclaimer (that you must read ), the install options will appear:

    Here you can choose whether you want or not the support for the various custom scripts. In particular, if you enable the support for custom light, you can choose to keep the normal Maxis lighting system (selected by default), or to install the Radiance lighting system.
    I strongly suggest NOT to change the default installation options, unless you *know* what you are doing.
    Please note that - beside the (optional) Radiance - the SCRIPTORIUM doesn't add any custom content to your game: it just enables it!
    Please note that the Scriptorium installer doesn't overwrite any customized file: if you have already installed (by hand, the "old way") some custom fireplaces, stairs, walls or lights, they will still be available in your game.
    NOTE: If you want to install the Radiance and you have customized your userStartup.config, rest assured that it will NOT be overwritten: this version of the Radiance uses the Maxis shaders, so it doesn't require to overwrite the userStartup.
  • AUTOMATIC UNINSTALLATION: *DON'T* USE THE ADD/REMOVE PROGRAM WINDOW! In order to completely uninstall the Scriptorium, you must run the installer and choose the option "Restore Maxis lights & Uninstall Scriptorium". After the uninstallation, the custom scripts located in the various "Scriptorium_..." folders will NOT be removed, so don't be afraid to lose anything during the automatic uninstallation.

  • MANUAL INSTALLATION (Win and Mac users): download the attached file "MANUAL-INSTALLATION_(MAC_and_WIN).txt" and follow the instructions. The manual installation only enables the support for custom scripts (the Radiance can be manually installed following the instructions provided in the Radiance threads).

  • END-USERS - When you download a custom modular stair, a fireplace, etc., the creator will provide, along with the object itself, a simple text file. Open your Download folder, and you will find 4 new shortcuts, all marked with this icon: icon.
    Choose the proper one ("Scriptorium_Fireplaces" for a fireplace, "Scriptorium_ModularStairs" for a modular stair, etc.), open it will automatically open the right folder where to put the text file. That's all! No more manual editing with Notepad, no more fear to delete by mistake something important
    And removing a custom fireplace etc. is extremely easy, too: delete the .package from the Downloads, and delete the related text files from the Scriptorium folder, and you're done!

  • CREATORS: from now on, you don't need any more to give long instructions to the users: just create yourself a simple text file, and put in it all the code required for the fireplace etc. to work.

    The filename to assign to the text file is important: use the pattern "Number_CustomName.txt, where "Number" is the unique number you have chosen for your custom object (for example: "fireplace 88", or "wall 90"). By putting the unique number in front of the filename, the users will be immediately aware if they have two conflicting scripts.
    When you post your object, include the text file in the attachments, and then tell the users to open their Downloads and put the text file in the right Scriptorium folder (of course, the users must have installed the Scriptorium ).


The SCRIPTORIUM installer is freeware, and can be used by anyone for personal use. DO NOT REPOST OR REDISTRIBUITE ANYWHERE!
When you post your custom stairs etc (at MTS2 or any other site), post a link to this very thread at MTS2, to let your downloaders get the Scriptorium and easily install your creations.

Also, note that I've included the Radiance Lighting System in this installer just to ensure the best compatibility with the support for custom lights, but I'm not the creator of the Radiance, nor I'm involved in any way in that project.
The Radiance mod included in this installer has been created by dDefinder and is based on the original work of GunMod, Chocolate Pi and Chesspieceface; the official discussion threads for the Radiance can be found here:
- V. 2.1
- V. 2.2
- V. 2.3 / 2.4.
If you have questions/problems related to the Radiance mods, post in the mentioned threads.


You have two options
  1. You can just leave them alone: the "old" custom content will stay in the main script files (modularstairs.txt, fireplaces.txt or walls.txt); if you are tired of a custom object, you must uninstall it "by hand", deleting the related section from the main script.
  2. If you are anal like me, and don't like such "hybrid" installations, you can "convert" all the older custom scripts to the new format:
    • First, uninstall the Scriptorium, to restore the original situation.
    • Open the script file (modularstairs.txt, fireplaces.txt or walls.txt)
    • One by one, CUT the custom sections from the main script and PASTE it into a text file of its own; SAVE the new text file as "NN_CustomName.txt" ("NN" is the unique number written at the beginning of the custom text: e.g. "fireplace 99" or "modularStair 77").
    • Repeat for every custom section, until the main script contains only Maxis definitions.
    • When done, install the Scriptorium, and put each new text file into the proper Scriptorium folder.

FAQ 2: HOUSTON, WE HAVE A PROBLEM...! - What to do if the Installer gives error, or doesn't install the shortcuts in the Downloads, or... (any other unexpected behaviour)
  1. First off, redownload the latest version of the Scriptorium (even if you already have it: it might be corrupted) and try installing again.
  2. If this doesn't help, go to the folder where you have unpacked the installer (the .exe), right-click on it and choose "Create Shortcut".
  3. Right-click on the shortcut and choose "Properties".
  4. In the very first field, delete everything and write exactly: Scriptorium_Setup.exe /LOG=log.txt then click OK.
  5. Double-click on the shortcut to run the installer; if an error window pops up, click "Ignore" or "Continue" whenever possible.
  6. When finished, you will find a text file named log.txt in the same folder as the Scriptorium_Setup.exe: post the log.txt file as an attachment in this thread, and I will examine it.

FAQ 3: THE CREATOR DIDN'T PROVIDE A SEPARATE TEXT FILE TO GO WITH THE MODULAR STAIRS, WALL, FIREPLACE ETC.! - What to do to "convert" the downloaded stuff to the new Scriptorium format.
sometimes the creators forget / don't want to update their modular stairs, fireplaces etc to the Scriptorium format. In these cases, they provide a text code in the download page, suggesting to manually append it to the "modularstairs.txt" or other game file.
You MUST NOT manually change any game file. Instead, do this:
  1. Copy the text from the download page;
  2. Open the Notepad (or any simple text editor) and paste the text there;
  3. Take mentally note of the *number* of the stairs (i.e. "modularstairs XYZ")
  4. Save the text file as "XYZ_AnyNameYouLike.txt"
  5. Put this txt file in the proper Scriptorium folder.
When done, you can do a great favour to other users if you contact the creator and ask him to convert his stairs to the Sciptorium format



23 JAN 2009 - Scriptorium v. 2.2e: RADIANCE UPDATE.
The Radiance 2.3 (by dDefender) contained in this installer has been updated to v. 2.3 beta 2.0 (released today).
Also, fixed a bug that prevented the Scriptorium to correctly install the Radiance files for Mansion & Garden.

28 NOV 2008 - Scriptorium v. 2.2d: RADIANCE UPDATE.
The Radiance 2.3 (by dDefender) contained in this installer has been updated to v. 2.3 beta 1.9 (released today), that is compatible with Mansion and Garden. Also, included Chesspieceface in the Radiance credits.

25 NOV 2008 - Scriptorium v. 2.2c: BUGFIX. Improved the internal code so to solve the problem of the diagonal pool becoming not usable after installing custom fence-arches. Thanks again to ClicknPsycho for reporting.

23 NOV 2008 - Scriptorium v. 2.2b: BUGFIX. Fixed the path for the "Scriptorium_Decks-Foundations-Pools" shortcut (in the Downloads). Thanks to ClicknPsycho for reporting. Also, extended the credits for the Radiance mods to include Chocolate Pi and dDefender.

22 NOV 2008 - Scriptorium v. 2.2 released.
  • NEW FEATURE: Added support for custom Decks, Foundations and Pools.
  • BUGFIX: The support for custom FenceArches now works properly (no one noticed this bug because so far no one has created a custom FenceArch )
  • UPDATE: The Radiance 2.3 (by dDefender) contained in this installer has been updated to v. 2.3 beta 1.8.

22 SEPT 2008 - Scriptorium v. 2.1c released.
  • UPDATE: The Radiance 2.3 (by dDefender) contained in this installer has been updated to v. 2.3 beta 1.7.
  • BUGFIX: When installing the Radiance 2.2 or 2.3, the installer now correctly finds the right installation paths in Deluxe and DoubleDeluxe games.

22 SEPT 2008 - Scriptorium v. 2.1b released.
  • BUGFIX: The "Maxis Original Lighting" contained one broken file, that caused the UNI windows and objects not cast light.

18 SEPT 2008 - Scriptorium v. 2.1a released.
  • UPDATE: The Radiance 2.3 (by dDefender) contained in this installer has been updated to v. 2.3 beta 1.6a.
  • IMPROVEMENT: When the Radiance 2.3 is selected, the installer now automatically adds the needed lines to the userStartup.cheat. Please note that the userStartup.cheat is NOT overwritten, but only updated: all the custom cheats and command previously added by the user are perfectly retained.

09 SEPT 2008 - Scriptorium v. 2.1 released.
  • BUGFIX: The "Maxis Original Lighting" actually contained some parts of the Radiance code, causing unwanted changes in dawns, sunsets and window-less rooms. Now, selecting the "Maxis Original Lighting" option really restores the Maxis lights (also useful to repair a messed up manual installation).
  • BUGFIX: No error is issued any more when the "userstartup.cheat" file is not found in the player's game.
  • IMPROVEMENT: The Scriptorium should now be fully compatible with Deluxe and DoubleDeluxe games.
  • UPDATE: The Radiance 2.3 (by dDefender) contained in this installer has been updated to v. 2.3 beta 1.6.

03 JULY 2008 - Scriptorium v. 2.0 released.
  • Added optional installation for the new Radiance 2.3 beta 1.3 (by dDefender).
  • Easier installation of custom TXT files when using Vista: now it should be possible to manually copy TXT files into the Scriptorium folders (Vista sometimes denied permission to do that); in any case, it is possible to install TXT files by dragging and dropping them over the proper Scriptorium shortcut (placed in the Downloads folder).
  • Improved internal code: the installer should now be capable of restoring the original Maxis lighting system in any case, even if you messed up the lights while manually installing/removing the Radiance.
  • New uninstallation routine: in order to completely uninstall the Scriptorium and restore the original Maxis lights, you must run the installer again and choose the option "Restore Maxis lights & Uninstall Scriptorium". This is the only way of correctly uninstall it.

13 OCT 2006 - UPD to v. 1.0e - Completed the Spanish translation, that now includes also the License Agreement and the Additional info after installation.

11 OCT 2006 - UPD to v. 1.0d (bugfix) - The last version 1.0c, released only a couple of days ago, had a bug (now fixed) that forced the installer to always install the Radiance mod.
This bugfix concernes only the users that downloaded the Scriptorium v. 1.0c] in the last two days (you can check the version of the Scriptorium from the Add/Remove window); if you are unsure, redownload anyway

09 OCT 2006 - UPD to v. 1.0c (Minor update) -Multiple languages are now available for the installer (only the installer messages: the Licence Agreement and the final notes are only Eng/Ita).
Also, the graphics shown during installation have been renewed.

26 SEPT 2006 - UPD to v. 1.0b (Bug fix) - After only few hours since the first release, I've discovered a bug: the Scriptorium didn't enable correctly the support for the fireplaces. The new version 1.0b fixes this bug.

27 SEPT 2006 - MAC USERS! - There was a typo in the previous installation instruction: the wildInclude... lines must end with a quotation mark![/B] Now the instructions have been corrected.

26 SEPT 2006 - Version 1.0 released - The SCRIPTORIUM replaces the older Custom Walls installer (now removed), and also includes the custom light support & Radiance formerly provided by the CEP installer (that now is again a CEP-only installer).
Tags: #modular, #stairs, #fireplace, #walls

Operating System: Windows Linux Mac OS X
Utility Type: CC Managers
Plugin Type: Not Applicable

You must have the expansion or stuff packs listed below installed to use this custom content. Please see the post text for any exceptions.

Sims 2
Key: - File was updated after upload was posted
Filename - Tip: You can click the magnifying glass to see the archive contents Size Downloads Date | Windows installer - Compatible with all Sims2 games

Size: 341.6 KB · Downloads: 126,137 · 30th Apr 2009
341.6 KB 126,137 30th Apr 2009

Size: 4.7 KB · Downloads: 81,872 · 26th Sep 2006
4.7 KB 81,872 26th Sep 2006
Don't forget to Thank the creator after downloading! Use the Thanks button located above the screenshots above.
Basic Download and Install Instructions:

1. Download: Click the download link to save the .rar or .zip file(s) to your computer.

2. Extract the zip, rar, or 7z file.

3. Follow the instruction provided in the "Overview" post for the AUTOMATIC or MANUAL installation.
NOTE - The Scriptorium is an installer: DO NOT put it in the Downloads folder! Read the Overview for info about using the Scriptorium.

Need more information?
664 Comments / Replies (Who?) - 612 Feedback Posts, 26 Thanks Posts
Hide Thanks Posts for this thread (Show only feedback)
Page 27 of 27
Lab Assistant
#651 Old 29th Oct 2016 at 5:40 PM Last edited by lilyeverlasting : 30th Oct 2016 at 1:19 AM.
Originally Posted by Caliby
For anyone having trouble using Scriptorium with the Ultimate Collection, it seems the simplest fix is to move the files to the Mansions and Gardens folder (SP9) of Fun With Pets instead of the Base folder in Double Deluxe.

In other words, first copying the Scriptorium folders from ’[Wherever you installed TS2]\The Sims 2 Ultimate Collection\Double Deluxe\Base\TSData\Res\Catalog\Scripts’ as well as the Scriptorium lights folder from ’…\The Sims 2 Ultimate Collection\Double Deluxe\Base\TSData\Res\Lights’.
Then paste those folders into (for scripts) ’…\The Sims 2 Ultimate Collection\Fun with Pets\SP9\TSData\Res\Catalog\Scripts’ and (for lights) ’…\The Sims 2 Ultimate Collection\Fun with Pets\SP9\TSData\Res\Lights’

Make sure you paste it into the ‘SP9’ subfolder, not one of the others in 'Fun With Pets’.

You can make new shortcuts in your downloads folder if you like, or just remember to place any further ones in SP9 and not DD Base.
I’d guess that the creators have moved on from this project and any updating would be unlikely, so this is the easiest workaround I’ve tried.

Just wanted to say thanks for the suggestion, Caliby. Haven't gone in-game yet but I've been searching for a fix. I'll try this out.

EDIT: this worked! Thanks again!
Lab Assistant
14th Mar 2017 at 10:57 PM
This message has been deleted by Gazelove.
Test Subject
#652 Old 12th Apr 2017 at 12:13 AM
Field Researcher
#653 Old 20th Dec 2017 at 9:05 PM Last edited by jasperville : 21st Dec 2017 at 10:48 PM.
the installer is trying to create files in the E Drive, which I do not have?

EDIT1 I've tried moving all the files to the SP9, but custom stairs aren't showing up. Any suggestions?
#654 Old 5th Feb 2018 at 4:06 PM
Reporting that the Radiance 2.4 installer inside Scriptorium NOT fully compatible with Ultimate Collection. RLS files meant to be in Base Game folders install fine, but the ones in the EPs are not installed correctly (aka lighting files in EPs are still not commented out). Only discovered this when I edited the RLS files myself.
#655 Old 27th Jun 2018 at 7:13 PM
Confirming that Scriptorium worked perfectly for me using UC and Windows 7. No adjustments needed.
Top Secret Researcher
#656 Old 10th Jul 2018 at 11:20 AM
What version of UltimateCollection do you guys have? To me it returns this error while attempting to install radiance:

Why would it do this? I thought all UC's are the same. But apparently, scriptorium installer can't find the path specified.
Test Subject
10th Dec 2018 at 10:24 PM
This message has been deleted by mynameisremedy.
Test Subject
#657 Old 29th Dec 2018 at 6:47 PM Last edited by phebe86 : 30th Dec 2018 at 10:53 AM.
Default tool missing
UPDATE: I had replace the *.txt script file from DVD The sims 2....and I solved almost problems. now only the road and the driveway are invisible and some icons of construction tools are not in their right place....

Hello I have a problem: I started playing The Sims 2 again after a long time, but my modular open stairs could no longer be seen in the stairs folder.
so today I decided to uninstall the scriptorium and reinstall it, I also downloaded the stairs and their related documents again. I solved the problem of stairs, but Unfortunately others have arisen ..... the foundations, the tools to level the ground and others are disappeared .... what can I do?
Test Subject
#658 Old 30th Dec 2018 at 11:54 AM
I had replace the *.txt script file from the Sims 2 and EP's DVDand then I had reinstall the Scriptorium and now every thing is ok
Lab Assistant
#659 Old 13th Jun 2019 at 10:03 PM
I just installed UC today on my PC (running on Windows 7), I have multiple hard-drives and it worked for me. Though I only used it to install the radiance system; checked it out in-game and everything seems to be working properly.
Test Subject
#660 Old 28th Sep 2019 at 10:26 PM Last edited by Rolopolo5 : 28th Sep 2019 at 11:34 PM.
Hello, Thanks a million for this...quick question(s)
I'm a Mac user but I'm very nervous about modifying scripts etc as I know nothing, and all the verifying the changes with a password just makes me more nervous.

Also I'm running Super Collection for Mac so my game has this pathway:

My Documents version
/Users/me/Library/Containers/com.aspyr.sims2.appstore/Data/Library/Application Support/Aspyr

Applications / My Computer version
/Applications/The Sims

Does anyone know:
(1) Do I just copy the text anywhere in the txt file I was directed to or is it supposed to be somewhere in particular within the relevant text file?
(2) Do I just create an alias by selecting the alias button in the "Finder" - "File" drop down menu/right click menu OR when I google Sims 2 alias I get - userstartup.cheat - Are any of these correct?
(3) Will this change any of the install proceedures? i.e. will I need to change any of the text to allow for my directory/pathway?
(4) Do I then just cut and paste that file/alias inside my downloads folder OR into the "Config" folder located the Sims 2 folder via my documents (as the userstartup.cheat guide says)?
(5) I keep all my cc in individual folders within my "Downloads" folder, literally the only loose file I have in there is the CEP _EnableColorOptionsGMND.package file. Will this effect The Scriptorium?

I'm sorry for all the questions but I really don't have a clue and I don't want my computer to explode or any thing. Any and all replies / help would be greatly appreciated

Also I don't know if this is relevant but my computer specs are; iMac OS Sierra 10.12, Processor: 3.2 GHz Intel Core i5, Memory 24 GB 1867 MHz DDR3, Graphics: AMD Radeon R9 M380 2048 MB
Test Subject
28th Sep 2019 at 10:43 PM
This message has been deleted by Rolopolo5.
Lab Assistant
#661 Old 14th Nov 2019 at 9:50 PM
Default Modular stairs corrupting my game?
My game has been acting weird and crashing ever since I downloaded some modular stairs I believe. I’m trying to figure out how to uninstall modular stairs from my game. Is there a way to?? I can’t figure it out..
Test Subject
#662 Old 16th Aug 2020 at 11:55 PM
I sent you a present! I've always enjoyed your work!
Page 27 of 27