Class ResoniteCancelableAsyncEventHandlerMonkey<TMonkey, TEvent1, TEvent2, TEvent3, TEvent4, TEvent5>
- Namespace
- MonkeyLoader.Resonite
- Assembly
- MonkeyLoader.Resonite.Integration.dll
Represents the base class for patchers that run after Resonite's assemblies have been loaded and that hook into the game's lifecycle.
Specifically, to act as an async event handler for the cancelable TEvent
generic parameter(s).
public abstract class ResoniteCancelableAsyncEventHandlerMonkey<TMonkey, TEvent1, TEvent2, TEvent3, TEvent4, TEvent5> : ResoniteCancelableAsyncEventHandlerMonkey<TMonkey, TEvent1, TEvent2, TEvent3, TEvent4>, IResoniteMonkey, IMonkey, IRun, IShutdown, IComparable<IMonkey>, INestedIdentifiable<Mod>, INestedIdentifiable, IIdentifiable, IAuthorable, ICancelableAsyncEventHandler<TEvent1>, ICancelableAsyncEventHandler<TEvent2>, ICancelableAsyncEventHandler<TEvent3>, ICancelableAsyncEventHandler<TEvent4>, ICancelableAsyncEventHandler<TEvent5>, IPrioritizable where TMonkey : ResoniteCancelableAsyncEventHandlerMonkey<TMonkey, TEvent1, TEvent2, TEvent3, TEvent4, TEvent5>, new() where TEvent1 : CancelableAsyncEvent where TEvent2 : CancelableAsyncEvent where TEvent3 : CancelableAsyncEvent where TEvent4 : CancelableAsyncEvent where TEvent5 : CancelableAsyncEvent
Type Parameters
TMonkey
The type of the actual patcher.
TEvent1
The first CancelableAsyncEvent type to handle.
TEvent2
The second CancelableAsyncEvent type to handle.
TEvent3
The third CancelableAsyncEvent type to handle.
TEvent4
The fourth CancelableAsyncEvent type to handle.
TEvent5
The fifth CancelableAsyncEvent type to handle.
- Inheritance
-
MonkeyBase<TMonkey>Monkey<TMonkey>ResoniteMonkey<TMonkey>ResoniteCancelableAsyncEventHandlerMonkey<TMonkey, TEvent1>ResoniteCancelableAsyncEventHandlerMonkey<TMonkey, TEvent1, TEvent2>ResoniteCancelableAsyncEventHandlerMonkey<TMonkey, TEvent1, TEvent2, TEvent3>ResoniteCancelableAsyncEventHandlerMonkey<TMonkey, TEvent1, TEvent2, TEvent3, TEvent4>ResoniteCancelableAsyncEventHandlerMonkey<TMonkey, TEvent1, TEvent2, TEvent3, TEvent4, TEvent5>
- Implements
-
ICancelableAsyncEventHandler<TEvent1>ICancelableAsyncEventHandler<TEvent2>ICancelableAsyncEventHandler<TEvent3>ICancelableAsyncEventHandler<TEvent4>ICancelableAsyncEventHandler<TEvent5>
- Derived
- Inherited Members
- Extension Methods
Remarks
Game assemblies and their types can be directly referenced from these.
Contains useful overridable methods that are hooked to different points in the game's lifecycle.
Methods
AppliesTo(TEvent5)
Determines whether the given event should be handled by this event handler based on its data.
protected virtual bool AppliesTo(TEvent5 eventData)
Parameters
eventData
TEvent5An object containing all the relevant information for the event.
Returns
- bool
true
if this event handler applies to the event; otherwise,false
.
Remarks
By default: Returns this monkey's Enabled state.
Handle(TEvent5)
Handles the given event based on its data, if AppliesTo returned true
.
protected abstract Task Handle(TEvent5 eventData)
Parameters
eventData
TEvent5An object containing all the relevant information for the applicable event.
Returns
OnEngineReady()
Override this method to be called when the FrooxEngine.Engine is ready.
This is the primary method for patching used by Resonite Mods as basic facilities of the game
are ready to use, while most other code hasn't been run yet.
Return true
if patching was successful.
protected override bool OnEngineReady()
Returns
- bool
Whether the patching was successful.
Remarks
Override OnLoaded() to patch before anything is initialized,
but strongly consider also overriding this method if you do that.
Otherwise your patches will be applied twice, if you're using [HarmonyLib.HarmonyPatchCategory(nameof(MyPatcher))]
attributes.
Easy to apply by using
[HarmonyLib.HarmonyPatchCategory(nameof(MyPatcher))]
attribute.
OnShutdown(bool)
Lets this monkey cleanup and shutdown.
protected override bool OnShutdown(bool applicationExiting)
Parameters
applicationExiting
boolWhether the shutdown was caused by the application exiting.
Returns
- bool
true
if it ran successfully; otherwise,false
.
Remarks
By default: Unregisters
this monkey as an event handler and removes all HarmonyLib.Harmony patches done
using this Monkey's Harmony instance,
if not exiting, and returns true
.