A framework library for client modders to make writing efficient, allocation-free code easier.
What is this library for?
This library aims to provide additional tools to client modders which will (hopefully) allow them to write more optimised code and reduce the performance cost and memory allocation of their code even further.
How to install this library (For users):
- Download the latest release
- Open the .7z file with 7-Zip
- Drag and drop the "BepInEx" folder into your SPT folder
How to use this library (For mod developers):
- Download the latest release
- Copy the assemblies EXCEPT the UnityToolkit.dll from the release zip to where you store your project's assembly references
- Add all the assemblies as assembly references to your project
- Add [BepInDependency("com.Arys.UnityToolkit")] attribute to your plugin class
- You can now use UniTask and Unity.Collections in your mod
What features does this library provide?
- UniTask is a near zero-allocating, performant version of C# Tasks that's suited for Unity than the standard C# implementation.
- It doesn't use threads or SynchronizationContext/ExecutionContext so the result is faster performance and lower allocation while matching Unity threading (single-thread).
- It is also possible to replace Unity Coroutine usage, which has poor performance and higher memory allocation, with UniTask instead.
- Documentation: https://github.com/Cysharp/UniTask
- Unity.Collections is included in this library for the additional NativeContainer types it provides such as NativeList, NativeHashMap, NativeMultiHashMap, and NativeQueue.
- These are useful data types when you are working with Unity's Job system as they are thread-safe.
- Documentation: https://docs.unity3d.com/Packages/com.unity.collections@0.9/manual/index.html
Is it safe?
Yes, both assemblies are just compiled versions of their original git repo I've also included a VirusTotal scan of both on the GitHub releases page
5.7K Downloads
Added Dependency Injection Container and Event Bus structures for mod developers
25.8K Downloads
New in this release
- Fixed issue where UniTask's PlayerLoopSystem was not being injected correctly
- Updated UniTask from v2.5.5 to v2.5.10
- Added ZString v2.4.4 as a near zero-allocation string builder alternative
- Added new structures: Closure<TContext>, ObjectPool<T>, and IProcessor<TProcessor, TData>
- Added a new ModulePatchManager class which can be used in your client mod plugin to automatically enable your mod patches
See details in the release notes: https://github.com/Nympfonic/UnityToolkit/releases/tag/v1.1.0
143.3K Downloads
Updated UniTask from v2.5.4 to v2.5.5
2.5K Downloads
Initial release
Not quite yet...