Joof-JoofOTHFramework icon

JoofOTHFramework

Shared library for the Joof mods: shared game hooks and multiplayer messaging. Does nothing on its own; install it if a mod needs it.

Last updated 18 hours ago
Total downloads 5
Total rating 0 
Categories
Dependency string Joof-JoofOTHFramework-1.2.0
Dependants 4 other packages depend on this package

This mod requires the following mods to function

LavaGang-MelonLoader-0.7.3 icon
LavaGang-MelonLoader

The World's First Universal Mod Loader for Unity Games compatible with both Il2Cpp and Mono

Preferred version: 0.7.3

README

JoofOTHFramework

JoofOTHFramework

The shared MelonLoader library behind the Joof mods for Over the Hill: WinchUnlimited, RealisticWinch, AnimalColliders and JeepNaturals. It does nothing on its own.

Download: Nexus Mods (mod 116, file 339).

The game hooks several mods need live here, patched once with Harmony and shared through events, so each mod doesn't hook them again. It also gives mods a way to message each other across a multiplayer session.

Install

  1. Install MelonLoader 0.7.x into Over the Hill. Start the game once so it sets itself up, then quit.
  2. Put JoofOTHFramework.dll into the game's UserLibs/ folder.

Linux / Steam Deck (native build): MelonLoader needs the .NET 6 runtime, for example extracted to ~/.local/share/dotnet6. Steam launch options:

LD_LIBRARY_PATH="$PWD" LD_PRELOAD="MelonLoader.Bootstrap.so" DOTNET_ROOT="$HOME/.local/share/dotnet6" %command%

Multiplayer: every player using a Joof mod needs it.

For mod authors

Reference UserLibs/JoofOTHFramework.dll from your mod and using JoofOTHFramework;.

WinchHooks.BeforeTick, AfterTick Run before and after the game's winch network tick (the host for every car, clients for prediction)
WinchHooks.AnchorsGathered Runs after the game builds a winch's list of anchor points; handlers append to it and return how many they added
HillNet.Register, SendToHost, SendTo, Broadcast JSON messages on a named channel, sent only to players who have that channel
HillNet.HostHas, PlayerHas, IsAuthority Whether the host or a player has a channel, and whether this game runs the physics
HillNet.SessionReset, PlayerLeft A new session or host migration; a player leaving
Patches.Method Looks up a game method to patch, failing loudly if the game renamed it. Mods patch their own hooks with Harmony as usual
Core.DiagnosticsRequested Raised by DevTestTools (F8) so each mod can log its state

Building

The project builds against the DLLs in your game folder, so it needs:

  • the .NET SDK (6.0 or newer)
  • MelonLoader installed and run once, so MelonLoader/Il2CppAssemblies/ exists
dotnet build

GameDir defaults to the Steam path on Linux. Override it with -p:GameDir="/path/to/over the hill". The build copies the DLL into the game's UserLibs/ folder. Build this before the mods that use it.

License

MIT. Not affiliated with Funselektor.