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

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

by Numenor Posted 26th Sep 2006 at 1:40 AM - Updated 27th Nov 2013 at 9:19 PM by Nysha
665 Comments / replies (Who?) - 25 Feedback 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: 132,315 · 30th Apr 2009
341.6 KB 132,315 30th Apr 2009

Size: 4.7 KB · Downloads: 82,757 · 26th Sep 2006
4.7 KB 82,757 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. Place in Downloads Folder: Cut and paste the .package file(s) into your Downloads folder:
  • Origin (Ultimate Collection): Users\(Current User Account)\Documents\EA Games\The Sims™ 2 Ultimate Collection\Downloads\
  • Non-Origin, Windows Vista/7/8/10: Users\(Current User Account)\Documents\EA Games\The Sims 2\Downloads\
  • Non-Origin, Windows XP: Documents and Settings\(Current User Account)\My Documents\EA Games\The Sims 2\Downloads\
  • Mac: Users\(Current User Account)\Documents\EA Games\The Sims 2\Downloads
  • Mac x64: /Library/Containers/com.aspyr.sims2.appstore/Data/Library/Application Support/Aspyr/The Sims 2/Downloads
Need more information?
665 Comments / Replies (Who?) - 612 Feedback Posts, 27 Thanks Posts
Hide Thanks Posts for this thread (Show only feedback)
Page 1 of 27
Retired Moderator
retired moderator
#2 Old 26th Sep 2006 at 1:49 AM
Fantastic job again
Slacker of Immense Slackness
retired moderator
#3 Old 26th Sep 2006 at 1:55 AM
Dear Lawdy,

Thank you for sending us NumNum for our TS2 games. This is the uber.

<:3))~~ Loverat
"In some cultures what I do is considered normal" Check it out for other recolours & lot uploads =D
Top Secret Researcher
#4 Old 26th Sep 2006 at 1:55 AM
Thank you Numenor this is all Greek to me but i'm sure it's not to others LOL

You will find my older and newest creations here
#5 Old 26th Sep 2006 at 2:08 AM
This is what we call "genius."
Lab Assistant
#6 Old 26th Sep 2006 at 2:32 AM
Default Ty Ty Ty
Thanks so much for making it so much easier for all of us gamers/wannabe-modders!! There have been times when I've installed, then had to go back and remove, re-read instructions, re-install cuz, duh, did it wrong....well, just thanks. :D
#7 Old 26th Sep 2006 at 2:32 AM
Looks interesting. I want to play around with it
#8 Old 26th Sep 2006 at 2:33 AM
It's wonderful having someone as brilliant as you in our community!

"You must be the change you want to see in the world." -- Gandhi
Field Researcher
#9 Old 26th Sep 2006 at 2:33 AM
Oh, dear Numenor! May I worship your genius? :D
#10 Old 26th Sep 2006 at 2:41 AM
Does this mean that your modular wooden steps are easy to access then before. I always had to do it the manual way but yours had no text file included so there was a bit stuffing around. No more??
Test Subject
#11 Old 26th Sep 2006 at 3:04 AM
..... B.R.I.L.L.I.A.N.T...... and the ModFather strikes again!
Thank you!

That's all for today folks ... thanx for your attention!
Marianne Alpert
Test Subject
#12 Old 26th Sep 2006 at 3:17 AM
Thank you so much! This is brilliant!! *Bows* May I ask a question? If we uninstall this after having installed the radiance mod, do lights revert to Maxis? In other words, it is still neccesary to back-up the lighting files?
Lab Assistant
#13 Old 26th Sep 2006 at 3:20 AM
WooHoo.. It's Great!! Thanks...

If I already have GunMod Radiance light installed, can I untick the "Light" options in the Scriptorium installer?

Woof !
The ModFather
retired moderator
Original Poster
#14 Old 26th Sep 2006 at 3:27 AM
Originally Posted by corvidophile2
Thank you Numenor this is all Greek to me but i'm sure it's not to others LOL

Believe me, it's a long post that describes an extremely easy thing.
Download the installer, run it without modifying anything, and you're done.

The next time you will download a custom modular stair, and you will see how much easier is installing it, you will thank me
Of course, creators must comply to the simple posting rules suggested above; if they don't, yell at them!

Originally Posted by motherspet
Does this mean that your modular wooden steps are easy to access then before. I always had to do it the manual way but yours had no text file included so there was a bit stuffing around. No more??

My modular stairs (all of them) are just replacements of the Maxis ones: they don't need any special installation.
Custom modular stairs, like Brasstex's ones (just to mention the first that created one of them), on the contrary, needed the special manual editing procedure, that now is no longer required.

I've finally started my Journal. Information only, no questions.

My latest activity: CEP 9.2.0! - AnyGameStarter 2.1.1 (UPD) - Scriptorium v.2.2f - Photo & Plaques hide with walls - Magazine Rack (UPD) - Animated Windows Hack (UPD) - Custom Instrument Hack (UPD) - Drivable Cars Without Nightlife (UPD) - Courtesy Lights (FIX) - Custom Fence-Arches - Painting-TV - Smarter Lights (UPD)

I *DON'T* accept requests, sorry.
Test Subject
#15 Old 26th Sep 2006 at 3:27 AM
WooHOO! Thanks so much. So easy it must be magic. I just created a text file with the code and named it after the creator and wawwlaa! I never liked messing with my core files and now I don't have to.


"Your just jealous because the voices only talk to me."
Simpley Ashley | The Sims Link Directory
The Quiet One
retired moderator
#16 Old 26th Sep 2006 at 3:36 AM
I don't like messing with those core files, too, but I have edited the one to add custom stairs and had no problems with them showing up in game as long as I did the edits correctly. Thanks for making this so simple for us! You're the best, Numenor!

Test Subject
#17 Old 26th Sep 2006 at 3:38 AM
Your mods never cease to amaze me! Thank you so much for all you've done for the game.
#18 Old 26th Sep 2006 at 3:57 AM
Gread work master, you're always amazing in your work
Top Secret Researcher
#19 Old 26th Sep 2006 at 4:51 AM
Now this shall make life easier for us. Thanks for another wonderful item from you!!!
Mad Poster
#20 Old 26th Sep 2006 at 7:06 AM
This is brilliant! Thank you. I haven't put back in my game any of the custom stairs I used but when I'll do it will definitely be much easier with this mod.
One horse disagreer of the Apocalypse
#21 Old 26th Sep 2006 at 7:40 AM
This is going to revolutionise the experience. I know how to do the stuff by hand but it always gives me this "do I have to?" feeling, instead of being fun :D
Field Researcher
#22 Old 26th Sep 2006 at 8:33 AM
Totally awesome Numenor, Once again you rocked the Maxis empire ^^
Forum Resident
#23 Old 26th Sep 2006 at 9:17 AM
This sound wonderful to me... I am one of those people you describe.. who would rather don't download the object than to go fumbling around files I know nothing about and am afraid to mess up.

Thank you for thinking of us,


Live Well
Laugh Often
Love Much

"If you don't live for something...You'll die for nothing.."
Test Subject
#24 Old 26th Sep 2006 at 9:26 AM
Ah very good, thank you so much.
#25 Old 26th Sep 2006 at 10:23 AM
could I ask...does this work for existing stairs (both on this site and TSR) for example, I have already editied mine the hard way and have a nice selection of stairs and fireplaces...if I were to delete the entries to those and re-downloaded the objects again are they going to be installed with this system...or are the creators going to have to modify the downloads before this system can be used?...other then that I can see this being a godsend. It took me ages before I was brave enough to install/edit for stairs and

Never wake a sleeping Dragon...for you are small and crunchy and taste good with ketchup!
Page 1 of 27