[OUTDATED] How To Make Custom Maps

I figured out how to make and import custom maps into Half-Life: Alyx. I'm not sure if this is new, but I thought I'd share this with you guys as you're no doubt much better at map making than me!

Setting Up

You need a few things to get set up, first you'll need a VR HMD, obviously, and a copy of the game, also obviously. You also need to be able to access the developer console, to do this, right click on the game from your library, go under Properties > Launch Options and enter '-console' and '-vconsole'. I'm not sure if this is necessary, but I recommend installing the Half LIfe Alyx asset pack on the Steam VR workshop.

To begin with, open up Steam VR, without opening any applications. Right click at the top of the Steam VR window and under workshop hit 'Create/modify an environment.'


From their, click 'Create Empty Addon' and call it whatever you like.


(If you have installed the Half Life Alyx asset pack, select the addon and click 'Edit Dependencies' in the bottom right, and select 'Half Life: Alyx Asset Pack')

From their, double click your addon or select it and click 'Launch Tools', this will open the asset browser.
There's a lot of stuff you can do in this window, I'm not gonna pretend to understand it all, but to start mapping open the hammer editor (top left).

Using The Hammer Editor

Now I am by no means a mapper, but I feel like without including just a little bit about the editor this guide would be incomplete.

To start off, go File > New to create a new map file, and then just start mapping. As I said I am by no means a mapper so I can't help you there, but there are plenty of online resources to help you learn!

After you've finished mapping, go File>Build Map and perform a Full Compile (you can un-check 'Load in engine after building' since you're just going to port the map into HLA anyway) by clicking 'Full Compile' and then 'Build'.


Tips

Make sure you add a light to your level! I made the mistake of forgetting this and for hours thought the game was just not rendering my level!

Entities from HLA do work in the editor, but they won't appear until you compile and run it in HLA. Just give the entity the appropriate name, for example, npc_zombie for a zombie and it will work!

Use assets from the assets pack where possible, otherwise you could run into issues of missing textures or models.

Importing Your Map Into The Game

To finally play your map in glorious virtual reality, find it in your Steam VR addons (usually under Steam\steamapps\common\SteamVR\tools\steamvr_environments\game\steamtours_addons\*Addon Name*) and copy the content into the HLA folder hlvr (usually under Steam\steamapps\common\Half-Life Alyx\game\hlvr) you'll know it's the right folder because it will have the maps folder within it.
IMPORTANT: DO NOT REPLACE ANY .pak FILES OR IT MAY MAKE YOUR GAME UNPLAYABLE, IF THIS DOES HAPPEN YOU CAN VERIFY THE GAME'S INTEGRITY TO FIX IT


Now, open HLA and enter the developer console by pressing the key below escape (varies depending on your keyboard layout) and entering 'map your_map_name' (make sure this is the name of the .vpk file you compiled, and not the name of the addon you made in Steam VR)




If you've done all this correctly, you should now be able to play your Half Life Alyx custom map! Hoooray!

More

If you want to do more advanced stuff we recommend you join our modding discord https://discord.gg/JeB6BtY where you can get much better support!

[ecfcae]

https://youtu.be/DZo5bByrync

[TNMPlayer]

prototype I think you just have to build walls around a hole

[prototype0410]

How to make hole or window in the wall? can't find carve tool or boolean operation with objects

[Raymond the cat]

Worth noting you can import textures and everything else from the game, and use the SDK even tho it's not released: https://www.youtube.com/watch?v=338OCffvyzc

This is for all the models, textures and sounds from the game. This also makes it so that you can see NPC in the hammer editor.

[SecondSword]

gmod vr is already a mod tho...

[EDI3793]

Imagine Gmod VR.

[Jackerino]

I honestly just recommend waiting until the official tools come out.

[alessandro.donofrio]

I managed to launch the editor and prepare the first map, I put the original .vpk files in a "backup" folder and replaced them with those of my map, but how can I launch the game and enter the console? Not having the original files, the game does not start ...

[alessandro.donofrio]

I have this error message:

Please verify you are running the latest version of SteamVR by fully exiting and relaunching Steam, then manually launch SteamVR from your Steam Library

Minimum supported version is v1.9.16


But i have 1.10.32 ...
HELP ME !

[Jackerino]

This isn't the official tools, but it'll do for now.