The Scripted Item Testing Range contains many new tools and props, as well as a custom item spawn menu and a somewhat functional player physics and locomotion system.

To enable the asset pack, first subscribe to the workshop item.
https://steamhost.cn/steamcommunity_com/sharedfiles/filedetails/?id=929520573

Then follow the official guide on the developer wiki:
https://developer.valvesoftware.com/wiki/SteamVR/Environments/AssetPacks

If you wish to use the locomotion assets or the spawn menu, you need to add a map script to the environment. The map script is run automatically on map load as long as it is named and placed in the correct location.

https://github.com/Rectus/destinations_range/blob/master/range/scripts/vscripts/map_scripts/range.lua
Copy the above script, and place it in a text file named:
\SteamVR\tools\steamvr_environments\game\steamtours_addons\<addon name here>\scripts\vscripts\map_scripts\<map name here>.lua

The vscripts and map_scripts directories do not exist by default, so create them.

The spawn menu, player locomotion and the all menu items are enabled by default. To disable locomotion and player physics, edit the script and remove all lines with g_VRScript.playerPhysController in them. To disable the spawn menu, remove all lines with g_VRScript.pauseManager in them.

What tools and props can be spawned from the menu, and their order are determined by the SPAWN_ITEMS array. You can remove or modify the items to suit your map, or even add brand new ones in.

The custom quick inventory is always selectable from the menu. To set what items are in it by default, modify the quick_inv_items array in the MAP_PLAYER_DEFAULT_SETTINGS table. The numbers correspond to the items place in the SPAWN_ITEMS array, starting with 1 at the top. The Items are arranged left to right.

The Quick Locomotion system is also enabled by default. To disable it, remove these lines from the map script:
require("quick_locomotion")
g_VRScript.pauseManager:EnableQuickLocomotion()

The MAP_COMMANDS array allows you to set up custom buttons specific to your map. If you are not using the feature it is recommended to remove the MAP_COMMANDS parameter from the pause manger creation line below:
g_VRScript.pauseManager = CPauseManager(SPAWN_ITEMS, MAP_PLAYER_DEFAULT_SETTINGS)

To use custom map commands replace the lines in the MAP_COMMANDS array with your own. The cmd key for each command corresponds to an entry in the OnMapCommand() function in the map script, where you can implement any custom logic. The user ID of the player who triggered the command is passed to data.id.

In order to properly show text in the menu, please remove the file \steamvr_environments\game\steamtours_addons\<addon>\panorama\localization\addon_english.txt from your add-on.

If you are using Panorama localization, you will instead have to merge the contents of the file below with your localization file.
https://github.com/Rectus/destinations_range/blob/master/range/panorama/localization/addon_english.txt

While the sounds of the tools are included in the asset pack, they require Sound Events set up for them. The sound event script for each addon overrides the ones from asset packs, so the sound events for the tools need to be added to the sound event script of your addon.

The sound event script is located here: \SteamVR\tools\steamvr_environments\content\steamtours_addons\<addon name here>\soundevents\soundevents_addon.vsndevts

If you haven't added any custom sound events, you can simply open up the script in a text editor and replace its contents with the file here: https://github.com/Rectus/destinations_range/blob/master/range/soundevents/soundevents_addon.vsndevts

If you have any custom sound events, you would need to copy all the event entries and place them into your own file, between the main curly braces.

When placing scripted tools and props directly into a map, the script name for the appropriate item needs to be added to the entity properties Entity Scripts key in the Misc category.



Props - prop_destinations_physics



Tools - prop_destinations_tool



Locomotion Tools - prop_destinations_tool
Require the map script to be set up with player physics.
Turn off the Has Collision In Hand property for these.