Class ResoniteAsyncEventSourceMonkey<TMonkey, TEvent1, TEvent2, TEvent3, TEvent4>
- 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 source for the TEvent generic parameter(s).
public abstract class ResoniteAsyncEventSourceMonkey<TMonkey, TEvent1, TEvent2, TEvent3, TEvent4> : ResoniteAsyncEventSourceMonkey<TMonkey, TEvent1, TEvent2, TEvent3>, IResoniteMonkey, IMonkey, IRun, IShutdown, IComparable<IMonkey>, INestedIdentifiable<Mod>, INestedIdentifiable, IIdentifiable, IAuthorable, IAsyncEventSource<TEvent1>, IAsyncEventSource<TEvent2>, IAsyncEventSource<TEvent3>, IAsyncEventSource<TEvent4> where TMonkey : ResoniteAsyncEventSourceMonkey<TMonkey, TEvent1, TEvent2, TEvent3, TEvent4>, new() where TEvent1 : AsyncEvent where TEvent2 : AsyncEvent where TEvent3 : AsyncEvent where TEvent4 : AsyncEventType Parameters
TMonkeyThe type of the actual patcher.
TEvent1The first AsyncEvent type to dispatch.
TEvent2The second AsyncEvent type to dispatch.
TEvent3The third AsyncEvent type to dispatch.
TEvent4The fourth AsyncEvent type to dispatch.
- Inheritance
-
MonkeyBase<TMonkey>Monkey<TMonkey>ResoniteMonkey<TMonkey>ResoniteAsyncEventSourceMonkey<TMonkey, TEvent1>ResoniteAsyncEventSourceMonkey<TMonkey, TEvent1, TEvent2>ResoniteAsyncEventSourceMonkey<TMonkey, TEvent1, TEvent2, TEvent3>ResoniteAsyncEventSourceMonkey<TMonkey, TEvent1, TEvent2, TEvent3, TEvent4>
- Implements
-
IAsyncEventSource<TEvent1>IAsyncEventSource<TEvent2>IAsyncEventSource<TEvent3>IAsyncEventSource<TEvent4>
- 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.
Constructors
ResoniteAsyncEventSourceMonkey()
Allows creating only a single TMonkey instance.
protected ResoniteAsyncEventSourceMonkey()Methods
DispatchAsync(TEvent4)
Dispatches the TEvent4 with the given data.
protected static Task DispatchAsync(TEvent4 eventData)Parameters
eventDataTEvent4The event data to dispatch.
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
applicationExitingboolWhether the shutdown was caused by the application exiting.
Returns
- bool
trueif it ran successfully; otherwise,false.
Remarks
By default: Unregisters
this monkey as an event source for TEvents
and removes all HarmonyLib.Harmony patches done
using this Monkey's Harmony instance,
if not exiting, and returns true.