View source for Modding the Create-a-World Tool to Unlock Hidden Features

===Gameversions 1.63 and later===
For Sims 3 gameversion 1.63 and later, please use the following precompiled executables for SuperCAW.

1.63-1.67: [http://www.simlogical.com/ContentUploadsRemote/uploads/860/ Precompiled executable at Simlogical by A]

1.69: [http://www.modthesims.info/showthread.php?p=5087215#post5087215 Precompiled executable at MTS by kapaer]

Download the appropriate Worldtool from EA and replace the executable with the appropriate precompiled SuperCAW executable.

[http://lvlt.thesims3.com//content/global/downloads/caw/worldtool.exe Worldtool 1.67]

[http://lvlt.thesims3.com//content/global/downloads/caw/ts3caw.exe ts3caw 1.69]


===Overview===

'''Note: This tutorial is somewhat outdated, and unnecessary for gameversions 1.63 and above for which we have precompiled executables available above. Please use this tutorial for reference only.'''

This tutorial will explain how to update your copy of the Sims 3 Create-a-World tool to unlock several hidden features.

These features are apparently used in game development by EA, but omitted from the beta consumer download.

'''This tutorial and patch are for the versions of the CAW tool specified in the 'Instructions' section. This tutorial and patch should ''not'' be used on versions of the CAW tool other than those stated.'''

For help on finding your CAW and Sims 3 gameversions, please see [[Game Help:TS3 Patching Find Gameversion|this article.]]


''Nilxis has written a Spanish version of this article- see it [http://createaworld.foroactivo.net/t285-herramientas-ocultas-modificar-el-caw-para-que-aparezcan here!] (Registration required) Thanks Nilxis!''

''Jawusa has written a German version of this article- see it [http://www.simforum.de/showthread.php?t=184622 here!] Thanks Jawusa!''

''joaoh2009 has written a Brazilian-Portugese version of this article- see it [http://www.simsdomination.com/tutorial/exclusivo-em-ptbr-ative-funcoes-ocultas-do-criar-um-mundo-813/ here!] Thanks joaoh2009!''

''simsdetoi has written a French version of this article- see it [http://www.simcookie.com/tutoriels/le-mode-avance-de-creer-un-monde/ here!] Thanks simsdetoi!''

===Before beginning===
'''Please backup the following folder:'''
[Install Location] \Electronic Arts \The Sims 3 Create a World Tool.
On a default install this will be C:\Program Files (x86)\Electronic Arts\The Sims 3 Create a World Tool.

''You must make a safe copy of this folder, as we will be modifying the files contained within. If anything should go wrong you will be able to restore the original folder, so precluding the need to reinstall.''

'''NOTE: If you have your copy of CAW installed to the default location (i.e, C:\Program Files (x86)\Electronic Arts\The Sims 3 Create a World Tool) you will have to run each of the programs and utilities mentioned in this tutorial as an administrator. This means that you need to right click> Run as Administrator to allow full read/ write privileges.'''

''This patch will create a new version of the CAW executable which will allow you to access hidden developer features. Please note that the new executable may be in English, so could look slightly unfamiliar if you have the CAW Tool installed in a language other then English. However, your original executable will still be in your native language, so you can still choose to run the original version should you prefer. Note that if the new executable is compiled in English then the CAW user files will also be in English, so you may need to copy your previous CAW worlds into Documents \Electronic Arts \The Sims 3 Create A World Tool.''

===Notes===

Before using the developer tools unlocked by this patch you should know that some tools and features may be problematic. Notably, the 'Pond Tool' is apparently abandoned and not used by EA, due to [http://www.twitlonger.com/show/g3mkph 'known problems internally'.] For this reason it is advised that you instead use this [http://www.modthesims.info/showthread.php?t=453392 external water plane tool,] which has been used in worlds tested for several Sim generations.

===Errors===
''For CAW version 1.13.7 only:'' Some users were finding that they were experiencing errors when trying to apply the patch in Tortoise Merge. If this happens to you, please check that you are first running each program as an administrator. Then, please read [http://modthesims.info/showpost.php?p=3776797&postcount=54 this post by atavera.]

''For CAW version 1.16.2 only:'' Some users were finding that they were experiencing errors when trying to apply the patch in Tortoise Merge. If this happens to you, please check that you are first running each program as an administrator. Then, please apply [http://www.4shared.com/file/yajcFRFK/supercaw-11-alternate.html this alternative patch] instead of the one linked in Step 12 of the Instructions section. If this also fails, please post in one of the discussion threads linked at the bottom of this page.

''For CAW version 1.18.3, 1.18.4 and 1.19.3:'' If you experience problems with this patch, please let us know. You could also try [http://www.den.simlogical.com/denforum/index.php?topic=860.0 the pre-compiled executable in this thread.]

''For CAW version 1.18.5:'' If you have problems with this patch, please try [http://www.den.simlogical.com/denforum/index.php?topic=860.0 the pre-compiled executable in post #15 of this thread.]

===Instructions===

'''Step 1:''' Download ILSpy.

'''Important:''' 

If you have CAW version 1.13.7 then [http://sourceforge.net/projects/sharpdevelop/files/ILSpy/1.0/ILSpy_1.0.0.1000_Binaries.zip/download use this version 1.0.0.1000]

If you have CAW version 1.16.2 then [http://sourceforge.net/projects/sharpdevelop/files/ILSpy/2.0/ILSpy_Master_2.0.0.1564_Beta_Binaries.zip/download use this version 2.0.0.1564.]

If you have CAW version 1.18.3, 1.18.4, 1.18.5 or 1.19.3 then [http://sourceforge.net/projects/sharpdevelop/files/ILSpy/2.0/ILSpy_Master_2.1.0.1603_RTW_Binaries.zip/download use this version 2.1.0.1603.]

[[File:CAW_Extra_01a.jpg|200px|thumb|center]]
'''Step 2:''' Save it to a new folder- I made one called 'CAW Modification' in my Downloads folder. Right click on the file you just downloaded and choose 'Extract all' to unzip it. You will now have several DLL files and an executable file in the folder.
[[File:CAW Extra 02.jpg|200px|thumb|center]]
'''Step 3:''' Double click on ILSpy.exe to open it.

'''Step 4:''' In ILSpy, click File>Open and browse to your CAW executable. In a default installation this will be C:\Program Files (x86)\Electronic Arts\The Sims 3 Create a World Tool \CAW.exe. Click 'Open'.
[[File:CAW Extra 03.jpg|200px|thumb|center]]
'''Step 5:''' In the left panel of ILSpy, click on 'CAW' to highlight it in blue. Then click File>Save Code.
[[File:CAW Extra 04.jpg|200px|thumb|center]]
'''Step 6:''' In the window that appears, right click on a white space and choose New>Folder. 
[[File:CAW Extra 05.jpg|200px|thumb|center]]
'''Step 7:''' Name it 'Project', and click 'Open'.
[[File:CAW Extra 06.jpg|200px|thumb|center]]
'''Step 8:''' Click 'Save' and ILSpy will save the project under the default name, CAW.csproj. ILSpy will give a message that it is 'Decompiling', and then you will see the following screen:
[[File:CAW Extra 07.jpg|200px|thumb|center]]
'''Step 9:''' Close ILSpy by clicking File>Exit.

'''Step 10:''' Download Tortoise Diff by going to this URL:
http://sourceforge.net/projects/tortoisesvn/files/Tools/1.6.7/TortoiseDiff-1.6.7.zip/download Save it to the same folder as you previously saved ILSpy to (in my case, the 'CAW Modification' folder). 

'''Step 11:''' Right click on the file you just downloaded and choose 'Extract all' to unzip it. You will now have two files, TortoiseIDiff.exe and TortoiseMerge.exe.
[[File:CAW Extra 08.jpg|200px|thumb|center]]
'''Step 12:''' Download atavera's patch for CAW from one of these URLs. ''Make sure you choose the correct patch for your version of CAW!''

''For CAW version 1.13.7 (Sims 3 version 1.29.55) [http://www.4shared.com/file/fpJE5OU9/supercaw.html use this patch.]''

''For CAW version 1.16.2 (Sims 3 version 1.31 to 1.34) [http://www.4shared.com/archive/MWCRxQpu/supercaw-11.html use this patch.]''

''For CAW version 1.18.3 (Sims 3 version 1.36) or 1.19.3 (Sims 3 version 1.38), 1.18.4 (Sims 3 version 1.42) or 1.18.5 (Sims 3 version 1.42- note that this seems to be the latest stable version) [http://www.4shared.com/archive/ZDG7HQLq/supercaw-12-patch.html use this patch.]''

''If you are asked to log in, you can try one of the usernames on [http://www.bugmenot.com/view/4shared.com Bugmenot.] Alternatively, try the username '''4shared@veryrealemail.com''' and the password '''modthesims''' (all lower case).''


''For CAW version 1.18.4 (Sims 3 version 1.42) or 1.18.5 (Sims 3 version 1.42- note that this seems to be the latest stable version) [https://docs.google.com/file/d/0By3vmsNLP6W_RnlLYzZYMWFKZ28/edit use this patch.]''



'''Step 13:''' Save it to the same folder as the other files. Double click on TortoiseMerge.exe to run it. In the window that appears, click 'Apply Unified Diff'. Where it says 'Diff file', click the 'browse' button.
[[File:CAW Extra 09.jpg|200px|thumb|center]]
'''Step 14:''' Browse to the patch file that you just downloaded (in my case, the 'CAW Modification' folder), and click 'Open'.
[[File:CAW Extra 10.jpg|200px|thumb|center]]
'''Step 15:''' Where it says 'Directory', click the 'browse' button.
[[File:CAW Extra 11.jpg|200px|thumb|center]]
'''Step 16:''' Browse to the folder we made earlier, which is [Install Location]\Electronic Arts\The Sims 3 Create a World Tool \Project, and click 'OK'.
[[File:CAW Extra 12.jpg|200px|thumb|center]]
'''Step 17:''' Click 'OK' on the Tortoise Merge window.
[[File:CAW Extra 13.jpg|200px|thumb|center]]
'''Step 18:''' In the window that appears, right click> Patch all.
[[File:CAW Extra 14.jpg|200px|thumb|center]]
'''Step 19:''' The screen will flicker and then look something like this:
[[File:CAW Extra 15.jpg|200px|thumb|center]]
'''Step 20:''' Close Tortoise Merge.

'''Step 21:''' Go to the 'Visual Studio Express' download page: http://www.microsoft.com/visualstudio/en-us/products/2010-editions/visual-csharp-express Click the 'Install now' button.
[[File:CAW Extra 16.jpg|200px|thumb|center]]
'''Step 22:''' Choose 'Visual C# 2010 Express':
[[File:CAW Extra 17.jpg|200px|thumb|center]]
'''Step 23:''' Save the file- I put it into the 'CAW Modification' folder too.
[[File:CAW Extra 18.jpg|200px|thumb|center]]
'''Step 24:''' Double click the file ('vcs_web.exe') to run it, and follow the instructions to install the program onto your computer. You may have to click 'Yes' to 'Do you want to allow this program to make changes'. Once you have that program installed, click Start> All programs> Microsoft Visual Studio 2010 Express> Microsoft Visual C# 2010 Express to run the program.
[[File:CAW Extra 19.jpg|200px|thumb|center]]
'''Step 25:''' You may get a pop-up asking you to register, of course you can choose to do so but for the purposes of this tutorial you do not need to do so.
[[File:CAW Extra 20.jpg|200px|thumb|center]]
'''Step 26:''' In Visual C# 2010 Express, click File> Open Project.
[[File:CAW Extra 21.jpg|200px|thumb|center]]
'''Step 27:''' Browse to your project- [Install Location]\Electronic Arts\The Sims 3 Create a World Tool \Project. Click 'CAW.csproj' and click 'Open'.
[[File:CAW Extra 22.jpg|200px|thumb|center]]
'''Step 28:''' Click 'Debug> Start Debugging' (or you could just hit F5 as a shortcut):
[[File:CAW Extra 23.jpg|200px|thumb|center]]
'''Step 29:''' Visual C# 2010 Express will open up your completed project, a patched version of Create-A-World.
[[File:CAW Extra 24.jpg|200px|thumb|center]]
At first, it looks the same as every other version of the Create-A-World tool, but if you start a world and begin exploring you will see the differences!

===Features===
* Figures greater than 300 can be typed into the height box to create a world elevation outside default parameters.
[[File:CAW Extra 25.jpg|200px|thumb|center]]
[[File:CAW Extra 26.jpg|200px|thumb|center]]

* On the 'Terrain' tab, you will see some new tools.
[[File:CAW Extra 27.jpg|200px|thumb|center]]
The 'Vertex Count Tool' allows you to change the resolution of the wireframe of the world- so creating more accurate or more simple turrain sculpting.
[[File:CAW Extra 28.jpg|200px|thumb|center]]
[[File:CAW Extra 29.jpg|200px|thumb|center]]
Note that this feature will significantly impact upon the performance and appearance of your worlds, so should be left at default values unless you really have a good reason to change things.

The 'Pond Tool' allows you to create water planes above the level of the sea in your world, without the need for an  [http://www.modthesims.info/showthread.php?t=453392 external tool]. '''Warning:''' [http://simswiki.info/wiki.php?title=Modding_the_Create-a-World_Tool_to_Unlock_Hidden_Features#Notes please read Notes before using this feature.]
[[File:CAW Extra 30.jpg|200px|thumb|center]]
This tool is a one-click tool- make an indentation in the terrain, point your cursor and click and a water plane will be created. Note that if your pond is not bounded on all sides by adequate thickness of terrain, the pond will continue on to the extents of the CAW work space. So you will flood your entire terrain!
[[File:CAW Extra 31.jpg|200px|thumb|center]]
You will notice that the 'undo' button will not work for ponds you have created. Do not fear though, as you will find a solution in the next tool.

The 'Scene Statistics' tool allows you to view the number of objects in your world, as well as the ponds you have made. You will see the ponds displayed as co-ordinates; if you click on one you will see that you can click the 'delete' button to remove that pond.
[[File:CAW Extra 32.jpg|200px|thumb|center]]
[[File:CAW Extra 33.jpg|200px|thumb|center]]
The 'visible objects' panel in that tool will show you how many world, lot (indoor) and lot (outdoor) objects there are, which is only really of use for information.

* On the 'world description' panel, you will notice a new feature.
[[File:CAW Extra 34.jpg|200px|thumb|center]]
We now have the ability to flag the world as a suburb (base), vacation world or downtown (city). This actually modifies byte 0x06 of UNKN 0x296A6258 to be 00 (Suburb), 01 (vacation) or 02 (city). More information about the implications of doing this here: http://modthesims.info/showthread.php?s=636b0629233d7d3120f6d534f8b53966&t=424374

* Metadata now has many more objects and effects available.
[[File:CAW Extra 35.jpg|200px|thumb|center]]
''Please note that anything beginning with an asterisk <nowiki>(* symbol)</nowiki> is a debug object and should not be placed in your world.'' It appears that most in-game objects are available to place in the world environment with this unlocked version of CAW.
[[File:CAW Extra 36.jpg|200px|thumb|center]]
There are many effects available too, including the lighthouse fx and some of the others that we were previously obtaining through this method: http://www.modthesims.info/showthread.php?t=429946
[[File:CAW Extra 37.jpg|200px|thumb|center]]
As there are now so many items available in CAW metadata, it will be advantageous to use the filter box to find a particular object or effect.
[[File:CAW Extra 38.jpg|200px|thumb|center]]


''For new features in updated versions of the SuperCAW patch, please see the changelog [http://dino.drealm.info/den/denforum/index.php?topic=860.0 in this thread.]''

===Running Super CAW===
When you have finished exploring your new version of the CAW tool, you can close it and also close Visual C# 2010 Express (There is no need to save when prompted).

In future, when you want to run your patched version of the CAW tool, you should go to [Install Location]\Electronic Arts\The Sims 3 Create a World Tool and run WorldBuilderCS.exe. 
[[File:CAW Extra 39.jpg|200px|thumb|center]]
You may want to create a shortcut to that executable on your desktop or start menu, so that you don't have to keep browsing to find it. You will also notice that your original executable, CAW.exe, remains unchanged, and you can still run that version from your original start menu/ desktop shortcut. You now have a choice of which version of CAW you run!

''Note- you can change the name of WorldBuilderCS.exe by renaming it either in Windows or in Visual C# 2010 Express, although this is not necessary.''

===Large address aware===
You can make your new executable Large Adress Aware in the usual way.
[[File:CAW Extra 40.jpg|200px|thumb|center]]

''Note- although the 1.18.4 and 1.18.5 versions of CAW are already Large Address Aware, your newly patched executable may not be, and so you should check it before playing.''

[[Sims 3:Large Address Aware]]

===Future Versions of the CAW Tool Beta=== 
For future versions of the Create-a-World tool, it is likely that another patch will have to be created, and applied to the new CAW executable. Please be sure to only use the patches on the CAW versions they were intended for.

===Additional hidden Features of the CAW Tool===
It has also been discovered that CAW is capable of automatically packaging certain resources upon world export to Sims3Pack. For more details see this thread- http://www.modthesims.info/showthread.php?t=466283

===Discussion Thread===
There is a thread on the MTS forums where you can ask questions or discuss this modification:
http://www.modthesims.info/showthread.php?t=468279

It would also be useful if you could post bug reports or problems in [http://dino.drealm.info/den/denforum/index.php?topic=860.msg5989 this thread] for the patch developer to see.

===Credits===
All credit goes to [http://www.modthesims.info/m/13223 atavera] (a.k.a [http://www.modthesims.info/member.php?u=793875 atavera (retired)]) for the tutorial, patch and discovery.