Simple Trigger that calls Lua
…
This article has no links to other VDC articles. Please help improve this article by adding links that are relevant to the context within the existing text.
January 2024
January 2024
- Step 1: Create a box with the block tool (⇧ Shift+B). Make sure you have the "toolstrigger.vmat" material selected. This box will serve as the trigger area.
- Step 2: Select the box and go to Tools > Tie To Entity (Ctrl+T). This will create a trigger entity that is tied to your box.
- Step 3: Select the trigger and change its class to "trigger_hero". This trigger is meant to be used for when a player enters or leaves the trigger area. There are many types of triggers, but let's keep it simple for now.
- Step 4: Set a name for your trigger, and set the path to the script file you want to call functions from. Example: If you want to call a function from
scripts/vscripts/my_file.luawhen the trigger fires, you should set Entity Scripts: my_file.lua
Warning:When you set Entity Scripts: my_file.lua, the game will call the Activatefunction inmy_file.lua(if there is one) when your addon is first loaded. So don't set Entity Scripts: addon_game_mode.lua unless you want theActivatefunction inaddon_game_mode.luato be called several times.
- Step 5: With the trigger selected press Alt+↵ Enter to open the Object Properties window, then select the Outputs tabs.
- Step 6: Add an output named "OnStartTouch". Set the trigger as the target. The input should be "CallScriptFunction" and the parameter should be the name of the function you want to be called (e.g. OnStartTouch or OnEndTouch).
My Output Target Entity Target Input Parameter Delay Only Once 
OnStartTouch trigger_name CallScriptFunction MyFunction 0.00 No
- Step 7: Add another output with the same values, but the name should be "OnEndTouch". You probably want to set a different function name as well.
Example lua code:
function OnStartTouch(trigger)
print(trigger.activator)
print(trigger.caller)
end
function OnEndTouch(trigger)
print(trigger.activator)
print(trigger.caller)
end
