The VCI script is implemented with Lua language.
Here, we will be using the VCI we created in Creation of VCI to write and add a script into it.
You can debug while running it in Virtual Cast.
To debug the script, tick on [Script Enable Debugging] checkbox during export.
The working folder (or workspace) for the script is
Note: If the AppData folder is hidden, in [Folder options] tick [View] > [Hidden file].
Open the workspace in VS Code.
In the menu, click on [File] > [Open folder] and open the path mentioned above.
It will show the directory for the workspace on the side-menu of VS Code, handy for referencing sources.
When you spawn an item on Virtual Cast, a folder for the target VCI is created automatically.
For instance, if the name of the item was “VCISample,” a folder with the name “VCISample” is created.
The folder is created with the first spawning of the VCI item.
You can edit the main.lua in this folder to rewrite the script.
The script is automatically reloaded after being saved, so you don't have to re-upload it to THE SEED ONLINE.
From the VirtualCast settings screen, select the [VCI] tab and enable [Display debug information in the studio] to display the console in the VR space.
|ActionCountPerSec||The number of operations (such as SetPosition) per second||1.9.2d|
|ActionCountPerSec (ALL)||The number of _All_ operations (such as SetPosition) per second||1.9.2d|
|LuaProcessingTimePerFrame (ms)||lua code processing time (milli second) per frame||1.9.2d|
The lower the values shown on the statistics, the faster the processing speed of the VCI. If you feel a VCI is slow, check these values and optimize it.
On the VCI configuration screen, specify a port number greater than 0 for [TCP port number to host logger for VCI scripts] and [TCP port number for VCI script debugger]. And access [localhost:`port number`] from a web browser while you are in the studio to view debugging information for VCI items.
1. Copy and paste the below code into [main.lua] inside the VCI folder.
GrabCount = 0 function onGrab(target) GrabCount = GrabCount + 1 print("Grab: "..GrabCount) print(target) end
2. In Virtual Cast, grab the VCI object. If you see the number of times you grabbed the object on the console, it's a success.
Note: this is just a quick sample script for this tutorial.
Note: For detailed information on VCI script, see VCI Script Reference.
1. Open the project you used to create the VCI item, and load the Scene.
2. In [VCIObject], change [Scripts] > [Size] to 1 and press enter.
3. The inspector expands. Type the following.
[Source]: [Paste the script you created]
You may encounter an error if the code is too long (More than 1.5 thousand characters).
4. Save the Scene and once again export the VCI.
On the menu bar, select [VRM] > [UniVCI-x.xx] > [Export], and save it.
5. Overwrite the item on THE SEED ONLINE with the new VCI you just exported. Now you have made a VCI with a script enabled.