View source for HLA SDK/Installing and Launching Tools

{{Dead end|date=January 2024}}

== Half-Life Alyx SDK Description ==
The purpose of this repo is to automate the process of enabling the SteamVR environments tools to be used to create and compile maps for use with Half Life Alyx.  Big credit for this script goes to Gvarados https://www.twitch.tv/gvarados as I learned how to do this by watching his live stream while he set this up and painstakingly recreated it on my own.

== Download the required files ==
https://github.com/thenayr/Half-Life-Alyx-SDK

This repo includes a batch (.bat) script that you can run on your machine to facilitate the creation of a Alyx SDK "standalone" app.  This will make a copy of some files to run as a standalone application that will enable you to use all of the Half-Life Alyx assets to start creating custom Half Life Alyx maps before the official toolkit arrives!  This works because the existing SteamVR environments editor is ALSO based on source 2 and fairly compatible with HL Alyx assets.

== Run the hl-alyx-sdk-setup.bat script ==
The script tries to find where your steam/alyx/steamvr installs are located by default, but should prompt you if any/all of those don't exist.

The script will copy over files that it needs to launch the base editor, there are additonal required files: see below.

== Follow additional instructions at the end of .bat script ==

You MUST download the `.FGD` files required by Half-Life Alyx to load entities into Hammer or none of the entities will show up correctly on your map.

You can download those from https://github.com/gvarados1/Half-Life-Alyx-FGD
Download the latest FGD/gameinfo.gi from gvardos in a folder nearby to your designated "Bootleg SDK Directory".

Backup/rename your original gameinfo.gi under ~/BootlegSDKDirectory/game/hlvr 
(ex: rename gameinfo.gi to gameinfo_original.gi)

Copy the .fgd files from github you downloaded/cloned earlier into ~/BootlegSDKDirectory/game/hlvr

== Target the compile directory to the Half-Life: Alyx directory ==

The NTFS file system supports a facility known as hard links (referred to herein as Hardlinks). Hardlinks provide the ability to keep a single copy of a file yet have it appear in multiple folders (directories). I highly suggest you install the Link Shell Extension for Windows if you don't wait to touch the command line. https://schinagl.priv.at/nt/hardlinkshellext/linkshellextension.html

Go to your new SDK folder and navigate to ''game/hlvr''. Delete the maps folder. Now go to the Half-Life: Alyx folder and pick ''maps'' as a link source. Finally, go back to the SDK folder, navigate to ''game/hlvr'' and drop it as a Junction.

[[File:HLA_SDK_Installing_Img1.png]]

== Run Editor launch script ==
Double click the bat file located in your new SDK folder to launch the editor.

== Errors compiling ==

I haven't experienced this particular issue, but a lot of folks have been describing it in discord so I will capture it here.  If you build your map and get an `access violation` error that looks like the following:

https://cdn.discordapp.com/attachments/692785095748354109/699311072016072766/unknown.png

Then here is the fix:

Go to game/hlvr/soundstacks and change the one that says `soundstacks_manifest.vrcman_c` and change it to `soundstacks_manifest.vrman_c.old`

== Error on editor load ==

This error can be ignored, the editor will still load fine after you click OK

https://cdn.discordapp.com/attachments/692785095748354109/699318907072151682/unknown.png

== Known issues ==
<ul>
<li>Random crashes</li>
</ul>
== Resolved Issues ==
<ul>
<li>Navmesh is not working: You are not using the latest FGDs: https://github.com/gvarados1/Half-Life-Alyx-FGD</li>
<li>Running in editor causes a crash: Resolved in updates to setup script(s)</li>
</ul>

== Compiling maps ==
Maps *should* compile from the hammer editor.

{{shortpagetitle}}

[[Category:HLA SDK]]