View source for Sims 3:Creating a game compatible Visual Studio project

==Step 1: Create a New Project==
[[Image:Sims 3-VS New Project.png|thumb|320px]]

* Set the framework version to '''.NET Framework 2.0'''.
* Use the Visual C# '''Class Library''' template.
* Preferably prefix the name of the library with your name / handle. ''Eg, '''Gibbed.'''Sims3Game.Test is what I would use. &mdash;[[User:Rick|Rick]]''

<div style="clear:both"></div>

==Step 2: Remove all existing references==
[[Image:Sims 3-VS Remove References.png|thumb]]

* Select all references, this is usually System, System.Data, and System.Xml..
* Right-click the selected references, and select '''Remove'''.

<div style="clear:both"></div>

==Step 3: Set the project to not reference mscorlib.dll==
[[Image:Sims 3-VS Do Not Reference.png|thumb|320px]]

* Open the project properties.
* Set the active configuraiton to '''All Configurations'''.
* Change to the Build tab.
* Click '''Advanced''' to open the '''Advanced Build Settings''' window.
* Check '''Do not reference mscorlib.dll''' and click OK.


<div style="clear:both"></div>

==Step 4: Add references to the Sims 3 assemblies==
[[Image:Sims 3-VS Add References.png|thumb]]
[[Image:Sims 3-VS Add References Browse.png|thumb]]

You will need to have already extracted and decrypted the Sims 3 assemblies to do this step.  See [[Tutorial:Sims 3 Pure Scripting Modding#Getting Started|Getting Started with Scripting Modding]] if you haven't done this already.

* Right-click the References item in the Solution Explorer.
* Select '''Add Reference...'''.
* Select the '''Browse''' tab.
* Select all of the Sims 3 assemblies. The assemblies you want to add are mscorlib, ScriptCore, SimIFace, Sims3GameplayObjects, Sims3GameplaySystems, Sims3StoreObjects, Sims3Metadata, System, System.Xml, and UI.
* Click OK.

'''VS 2012 Users:''' You will see the following warning when you compile:
<blockquote>
1>C:\Windows\Microsoft.NET\Framework\v4.0.30319\Microsoft.Common.targets(1578,5): warning MSB3270: There was a mismatch between the processor architecture of the project being built "MSIL" and the processor architecture of the reference "Sims3Metadata", "x86". This mismatch may cause runtime failures. Please consider changing the targeted processor architecture of your project through the Configuration Manager so as to align the processor architectures between your project and references, or take a dependency on references with a processor architecture that matches the targeted processor architecture of your project.
</blockquote>

To prevent this warning, you must change your project from Any CPU to x86. Use the drop down menu in the second tool bar to do this. You may need to use the Configuration Manager to add x86 to the drop down menu.

<div style="clear:both"></div>

==Step 5: Set the references to not Copy Local==
[[Image:Sims 3-VS Select References.png|thumb]]
[[Image:Sims 3-VS Set Copy Local.png|thumb]]

* Select all references.
* Set the '''Copy Local''' property to '''False'''.

'''VS 2010 and 2012 Users''' will now have to manually alter the .csproj in order to reference the correct mscorlib.dll. The process is the same for both versions of VS.

# Save your project and close VS.
# Go to the folder where you VS project is saved and find the .csproj file for your project.
# Right-click on file and choose Edit with Notepad++. If you don't have Notepad++ you may need to choose NotePad from a list of programs.
# Between the last </PropertyGroup> and the the first existing <ItemGroup>, add this:
<pre>
<ItemGroup>
    <Reference Include="mscorlib">
      <HintPath>... Path to where Sims 3 mscorlib.dll is on your computer ...</HintPath>
      <Private>False</Private>
    </Reference>
</ItemGroup>
</pre>

''Note:'' you can also just drop this into the same <ItemGroup></ItemGroup> as your other references.

: 5. Save the .csproj and close Notepad++. Try to open your project in VS now. If your get an error when you try to open your project, you probably forgot to close a node somewhere in your .csproj, or you may have use the wrong path for mscorlib.

<div style="clear:both"></div>

==Step 6: Fin==

You're now ready for coding. :)