Fire On Change Nodes will only fire if the OnlyForUser (User) provided has seen the value on their local machine change.
When this node triggers from the OnlyForUser (User) provided it can be used to execute code that requires the impulse be from a specific user. This is useful for things like:
- changing world properties
- physics
- cloud variables
- other Local User sensitive nodes.
This node does not runs the calculation on every frame[1][2].
Inputs
OnlyForUser (User)
Is the User "watching" for changes, if the Value (Generic) is localized and only changes for the OnlyForUser User, then it will send out a impulse for every change vs someone else who wouldn't see those changes.
Determining the Owner of the Impulse
When this node is used the user who fires the impulse is determined using the following steps:
- If the OnlyForUser (User) property is set to ProtoFlux:Local User, fire for all users in a session.
- If the OnlyForUser (User) property is not null only fire for this user.
- If the Node is parented under a User, fire only for that user.
- Otherwise fire for all users in a session.
Value (Generic)
The value or reference that OnlyForUser (User) should watch for changes on their client.
Outputs
OnChanged (impulse)
Will fire a single impulse from the OnlyForUser (User) input every time the value provided changes.
Use Notes
Because FireOnChange functions based on the trigger for whatever node it is connected to, it may not fire when the node it is connected to is changed if that node does not account for the calculation before it. Therefore, if a node is firing unreiably, an easy fix would be to connect FireOnChange's value to a node below it, preferably whatever value is most critical to the change.[1]
Examples
-
Fire On Change being used to tell when someone is on the ground according to the host user of a session.
See Also
Sources
- ↑ Nuki's message on Discord (requires account) https://discord.com/channels/1040316820650991766/1154514007479287942/1251599026479169627
- ↑ Frooxiu's messge on Dicord (requires account) https://discord.com/channels/1040316820650991766/1154514007479287942/1251600403926351933