View source for Half-Life: Alyx Workshop Tools/Modding/Source2mod/Creating a mod

{{lang|Half-Life: Alyx Workshop Tools/Modding/Source2mod/Creating a mod}}
== Setting up the directory ==

If you haven't done this already, create the folder <code>source2mods</code> inside your <code>steamapps</code> directory:
* <code>Steam\steamapps\source2mods</code>

Inside the <code>source2mods</code>, create a folder, without special characters, representing your mod content. For example:
* <code>Steam\steamapps\source2mods\mysource2mod</code>

[[File:Creating the mod folder.png|border]]

== Copying the required files ==

In order to get the barebones of your mod working, copy the <code>cfg</code> and the <code>webui</code> folder from <code>Half-Life Alyx\game\hlvr</code>, and the files <code>gameinfo.gi</code> and <code>gameinfo_branchspecific.gi</code> to your mod folder.
{{Note|If your mod is going to be flat only, you don't need to include the <code>webui</code> folder.}}

[[File:Copying the required files 2.png|border]]

== Editing the gameinfo.gi ==

=== Title ===
Open the <code>gameinfo.gi</code> file. Change the title keyvalue to the name of your mod.
{{Warning|Do not change the game keyvalue, or it won't work.}}

=== Screen mode ===

Below the first keyvalues, add a screenmode key with one of the following values:
* <code>vr_only</code>: It will only run in VR.
* <code>flat_only</code>: It will only run in flat mode.
* <code>both</code>: It can be run both in VR and flat modes.

=== File system ===

In the filesystem group, insert in the first line a new Game key and set its value exactly like your mod folder name. Modify the Mod and Write values to also match your mod folder name.

[[File:Gameinfo.png|border]]

== Finishing up ==

Your mod now can run with source2mod. Start source2mod.exe and select your mod, or run source2mod.exe with the -game parameter and the name of your mod folder.

[[File:My source2mod menu.png|800px|left|thumb]]

[[Category:Half-Life:_Alyx_Workshop_Tools]]
[[Category:Modding]]