![WNP78-FieldInjector-1.0.0 icon](https://gcdn.thunderstore.io/live/repository/icons/WNP78-FieldInjector-1.0.0.png.128x128_q95.png)
FieldInjector
A utility for other mods to inject monobehaviour fields into the IL2CPP domain.
By WNP78
Date uploaded | a year ago |
Version | 1.0.0 |
Download link | WNP78-FieldInjector-1.0.0.zip |
Downloads | 13870 |
Dependency string | WNP78-FieldInjector-1.0.0 |
README
This mod is a utility for other mods to utilise MonoBehaviour field serialisation injection. Original mod for Boneworks now ported to Bonelab.
Instructions for players
- To install the mod, just extract
FieldInjector.dll
into yourMods
folder in the game install location.
Instructions for programmers
If you want to utilise custom MonoBehaviours with properly serialised fields from asset bundles, reference this mod as a dependency. Note: instead of using this mod directly, I might recommend using Maranara's "Cauldron" system for a more unified end-to-end experience and integration with the Unity editor, that uses this mod under the hood. The instructions below apply only if you want to roll your own systems and just use this to apply serialisation.
Writing a custom MonoBehaviour
This is fairly simple, and there is very little difference between a normal unity MonoBehaviour and this. There is only a small amount of boilerplate code to add:
using UnityEngine;
class MyScript : MonoBehaviour
{
// all of your normal MonoBehaviour code can go here
#if !UNITY_EDITOR
public TestMB(IntPtr ptr) : base(ptr) { }
#endif
}
the #if
instruction means that this code should compile in both the Unity Editor and in a MelonLoader mod, so that you can keep your code unified and test in the editor with ease.
This tech is still not totally mature, so I recommend testing out whatever you're doing first before relying on it working. As a general rule, here are some of the things that will and won't work. Will work:
- primitive types like float, int, string, bool
- structs that are defined by Unity or the game (ie, Vector3, Quaternion)
- references to objects defined by the game or unity, e.g. GameObject or Transform
- you might have success with references to mod classes, as long as those classes are injected before the class with the reference to them is injected. If this throws up issues remember you can always just have a serialised reference to the GameObject and then use GetComponent in Start.
Won't work - not impossible to fix, could work given future work / overhauls:
- custom structs (structs defined in mods)
- classes with cyclic field references (ie, if class A has a field of type B, and class B has a field of type A, that's not going to work, since you would have to inject both types before the other)
Injecting a custom MonoBehaviour
This is what this mod is used for, and it is very simple:
FieldInjector.SerialisationHandler.Inject<MyScript>();
in the OnApplicationStart
method is all that is needed. Do not register the class in Il2Cpp with MelonLoader or UnhollowerBaseLib - this mod does that itself and it won't be able to inject the class with fields if it's already injected without fields. Makers of frameworks that load code should consider registering fields for loaded behaviours automatically.