Types of script
Beginner Programmer
There are three main types of script in Stride: startup scripts, synchronous scripts, and asynchronous scripts.
When you write your script, inherit from the type of script with the behavior that best fits your needs.
Startup scripts
Startup scripts only run when they are added or removed at runtime. They're mostly used to initialize game elements (eg spawning characters) and destroy them when the scene is unloaded. They have a Start method for initialization and a Cancel method. You can override either method if you need to.
public class Example : StartupScript
{
public override void Start()
{
// Do some stuff during initialization
}
}
For more information check out the startup script page.
Synchronous scripts
Synchronous scripts are initialized, then updated every frame, and finally canceled (when the script is removed).
- The initialization code, if any, goes in the Start method.
- The code performing the update goes in the Update method.
- The code performing the cancellation goes in the Cancel method.
The following script performs updates every frame, no matter what:
public class Example : SyncScript
{
public override void Update()
{
// Do stuff that needs to be executed every frame
}
}
For more information check out the sync script page.
Asynchronous scripts
Asynchronous scripts are initialized only once, then canceled when removed from the scene.
- Asynchronous code goes in the Execute function.
- Code performing the cancellation goes in the Cancel method.
The following script performs actions that depend on events and triggers:
public class Example : AsyncScript
{
public override async Task Execute()
{
// Execute asynchronous code
}
}
For more information check out the async script page.