translators
8,446
edits
Changes
Jump to navigation
Jump to search
Line 186:
Line 186: − + − + − DataTriggers.RegisterTrigger("Some.ModId_OnItemReceived");+ − + − DataTriggers.Raise("Some.ModId_OnItemReceived");+ − DataTriggers.RegisterAction("Some.ModId_PlaySound", this.PlaySound);+ − + − +
Modding:Trigger actions (view source)
Revision as of 05:46, 17 December 2023
, 05:46, 17 December 2023→Extensibility: update for naming in latest alpha build
===Extensibility===
===Extensibility===
C# mods can use the <samp>StardewValley.Triggers.DataTriggers</samp> class to interact with data triggers.
C# mods can use the <samp>StardewValley.Triggers.TriggerActionManager</samp> class to interact with trigger actions.
For example, you can add a new trigger type:
For example, you can add a new trigger type:
<syntaxhighlight lang="js">
<syntaxhighlight lang="js">
// register custom hook type
// register custom trigger type
TriggerActionManager.RegisterTrigger("Some.ModId_OnItemReceived");
// raise trigger as needed
// run actions for the custom trigger
TriggerActionManager.Raise("Some.ModId_OnItemReceived");
</syntaxhighlight>
</syntaxhighlight>
Or you can add a new action handler:
Or you can add a new action handler:
<syntaxhighlight lang="js">
<syntaxhighlight lang="js">
TriggerActionManager.RegisterAction("Some.ModId_PlaySound", this.PlaySound);
...
...
/// <inheritdoc cref="DataTriggerActionDelegate" />
/// <inheritdoc cref="TriggerActionDelegate" />
public static bool PlaySound(string[] args, string trigger, TriggerActionData data)
public static bool PlaySound(string[] args, string trigger, TriggerActionData data)
{
{
// get args
// get args
if (!ArgUtility.TryGet(args, 1, out string soundId, out string error, allowBlank: false))
if (!ArgUtility.TryGet(args, 1, out string soundId, out string error, allowBlank: false))
return DataTriggers.Helpers.LogActionError(args, trigger, data, error);
return TriggerActionManager.Helpers.LogActionError(args, trigger, data, error);
// apply
// apply