JeviLib Debug

A multifunction library for code modders, containing serialization utilities and tweening.

What's the difference between "Debug" and "Normal"?

This version was built with the DEBUG compiler flag. This means that there are extra checks and log points. This means slightly decreased performance, but you will be warned when you attempt to perform invalid operations and have greater insight on what's going on.

You should not rely on the increased checks for your code. This version should not be the version you depend on. You should depend on the normal version of JeviLib.

What does it do?

JeviLib 3.0.0 with the plugin will force-regenerate proxy assemblies. The first load after installing will take extra time.

This library holds a bunch of utilities I found necessary to create whilst I created BW Chaos, and that continues to remain useful on other projects. In these utilities are my Prefs system, numerous extension methods, and my serialization utilities (byte array lossless joiner and separator, Vector3 byte converter).

JeviLib also includes many extra utilities I created because I can see others having a use for them, organized by namespace.

• Jevil: Contains countless utilities and extension methods I created during development of Chaos, maps, and other parts of JeviLib.
• Jevil.Prefs: Described above, a way to quickly and easily create MelonPreferences and BoneMenu entries.
• Jevil.Tweening: An extensible tweener that modders can use to smoothly transition the state of values from a starting value to another, with multiple tweeners built in.
• Jevil.IMGUI: Contains utilities for drawing quick debug things to IMGUI. Use via DebugDraw class's methods.
• Jevil.Patching: Easily hook/replace/disable methods using Actions and Funcs (And disable methods using namespace, type name, and method names).
• Jevil.Waiting: Replacements for WaitUntil and WaitDuring, as well as a WaitForSceneInit awaitable. As well as CallDelayed to invoke things at a later time.
• Jevil.PostProcessing: A custom postprocessing layer, with support for custom shaders, including access to the depth buffer (on PC)

Be specific: what else does the JeviLib contain?

• Asset management: The BundledAsset class makes it easy to reference assets contained in AssetBundles, with support for async asset loading to avoid halting the main thread, and ULazy to only load things when you need them.
• Various other utilities: The Utilities class has a lot of reflection and serialization utilities, so you can quickly serialize objects and save them to a file or send them over the network.
• Asynchronous coding: The AsyncUtilities and AsyncExtensions classes let you run all your code without halting the game, and minimizing lag.
• Compiler services: [IsUnmanagedAttribute], so that your type constraints can have T : unmanaged.*

Thanks

• Adamdev: making BoneMenu
• WNP78: Making FieldInjector & helping me with advanced patching, used in the older version of Jevil.Patching, but used in the bedrock of postprocessing.
• Adi: Carrying the code modding category while I waste a bunch of time fucking with Unity for Septic Survival and other things. Also bringing a seafaring misnomer to my attention.
• Simpleflips: Shoutouts to simpleflips. Its a meme you dip.

Changelog

• 3.0.0

  • Patch 6 release, because i missed 4 and 5, lol. Basically like a year and a half of development. Now on ML 0.6.x!
  • Added JeviLib.PostProcessing, after much ado and delay, and also testing and finetuning.
  • Added JevilPlugin to modify proxy assembly generation instead of using a forked process and Cecil.
  • Many more things, check out the GitHub repo for everything new.
  • uhhh basically just released so i could get this out here for SugarCoat

• 2.2.1

  • Rebuilt fix process. This is necessary for release build.
  • Added normal ways to create a OneOf.

• 2.2.0

  • Added Jevil.Stats namespace for use with the ModStats API. (You need a ModStats category first. If you want to know more/use it yourself, contact me for details)
  • Added optional subcategory support to Method Prefs (see summary for the [Pref] constructors)
  • Added support for custom interpolators to tweens. See TweenTweenExtensions.UseCustomInterpolator for more info.
  • Probably some other stuff I can't discern because I forgot to commit after releasing 2.1.1, but general preparation for SSBL.

• 2.1.1

  • Fixed fixer process waiting
  • Made prefSubCategory not apply to method preferences & added override for RegisterUnder

• 2.1.0

  • Added AsyncExtensions, AsyncUtilities, and BundledAsset.
  • Defined CallerArgumentExpressionAttribute.
  • Refactored a lot of internal Prefs stuff - you can now call Prefs.RegisterUnder.
  • Removed off-main-thread patching. It was pointless anyway lol.
  • Made fork process fix the ToString and GetHashCode methods on UnityEngine IL2CPP types.
  • Optimized Extensions.ToBytes(Vector3) to decrease GC alloc using "unsafe" code that is effectively a paste of BitConverter.GetBytes (tested working using SceneSaver)

• 2.0.0

  • Make mod development easier!
  • UniTasks and Coroutines now work how they should (UniTasks are now awaitable, you still must set your return type to Task though)
  • Added utility methods to check if the coroutine/unitask fixes have already been applied and restart the game to apply them if not.
  • Brought the debug build back after testing and fixing Tweening and Barcodes (mostly)
  • Fixed scene initialization error(s)
  • Added Hook.OntoComponentInit
  • Improved documentation for Redirect and Hook

• 1.1.0

  • Add more functionality to Preferences, for Nichrome (which I need to fix a part of before releasing) and likely for Chaos, eventually.
  • Fixed Const.RigManagerName (oops! theres a reason i said you probably shouldn't use it)

• 1.0.0

  • Initial BONELAB port