The examples are available in this workshop item and source files on GitHub.

http://gtm.steamproxy.vip/sharedfiles/filedetails/?id=757435228

https://github.com/Rectus/destinations_playarea_example

Each player has a HMD Anchor entity associated with them, positioned on the ground at the center of the VR play area. While it is not possbile to move a player entity directly, the position and orientation of the anchor can be changed, moving the player with it. The ancor can also be parented to another entity such as an elevator or roller coaster, making the player move along with it.

There are some limitations to this though. In particular, the changing the anchors orientation on the picth or roll axis causes the Vive motion controllers to render in the wrong position, as if the play area was still upright. This will make the player unable to teleport or access the game menu, althoguh it may still be useful when the player doesn't need to use the controllers, such as during a roller coaster ride.

The only way to access the HMD Anchor is through the scripting system. It is done through the CBasePlayer::GetHMDAnchor() method avaliable in the script handls of the players.

This example shows how to iteate through evary player and accessing their anchor.

To make the play area move along with another object such as an elevator, the anchor can be parented to it.


This example has a func_door elevator with a trigger_multiple parented to it. When the player walks/teleports onto the elevator, the trigger runs a script function that parents the players anchor to the elevator entity. When the player steps off the elevator, the anhor is unparented.

1. Creating the script
Use a text editor such as Notepad to write the script:


Save the script in \Destinations\game\steamtours_addons\playarea_example\scripts\vscripts\ (create the vscripts directory if needed), with the extension .lua.



2. Setting up the entitites
How to set up the elevator itself and the buttons is outside the scope of this guide.
Create the elevator, and add a trigger_multiple on top of it. Parent the trigger to the elevator, and set its Entity Scripts keyvalue to the file name of your script.


Add outputs on the trigger to call the script functions on itself.


If everything is set up correctly, the player should move with the elevator only when standing on it.

See the example map for a working elevator along with a roller coaster working on the same principle.

Moving the player of play area can be accomplished by setting the origin of the anchor to a new position using the CBaseEntity::SetOrigin() method. This can be useful for teleporting the player between different areas of the map.

This can also be used to move the player around (almost seamlessly), see the Barnacle Gun in my scripted item test range: https://gtm.steamproxy.vip/sharedfiles/filedetails/?id=744116848

The angles of the changed using CBaseEntity::SetAngles() method, rotating the play area. Howvever note that this is buggy, and will cause the motion controller to appear in the wrong place.


1. Create the script
In the same way as in the above example, create a script with the following content, and place it in \Destinations\game\steamtours_addons\playarea_example\scripts\vscripts\:


The function in this script moves the play area to the destionation marker, but adds the offest beween the player and the anchor to it, so that the player ends up on the marker.

2.
Create a trigger_multiple to teleport from, and add the script to it. Add an output from it to call the script function to teleport the player. Also create an info_target entity for the destionation, and name it teleport_dest.


Now when stepping into the teleport trigger, the player should appear on to of the destination marker.

The example map has a working version of this, as well as an example that also rotates the play area, letting players walk on walls.