debug-resonite-mod

Diagnose Resonite mod runtime issues using BepInEx log tailing, DLL decompilation, and container launch control.

3|Updated Jun 7, 2026
One-click install
npx skills add https://github.com/MLShukai/ResoniteIO --skill debug-resonite-mod-mlshukai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-resonite-mod
Source: https://github.com/MLShukai/ResoniteIO/tree/main/.agents/skills/debug-resonite-mod
Command: npx skills add https://github.com/MLShukai/ResoniteIO --skill debug-resonite-mod-mlshukai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Debugging a BepInEx mod running inside the Resonite client is hard because .NET debugger attach is not set up and Renderite IPC behavior is undocumented. This Skill provides a print-debugging workflow for the resonite-io mod: tailing BepInEx logs, decompiling Resonite first-party DLLs, and launching or stopping Resonite inside the devcontainer. ## Core Features & Use Cases - Log Tailing: Follow mod output via just log, which tails gale/BepInEx/LogOutput.log across Resonite restarts and log rotations. - DLL Decompilation: Run just decompile to expand Resonite and Renderite Unity DLLs into a readable project under decompiled/ using ilspycmd, essential for understanding undocumented Renderite IPC. - Container Launch Control: Start the mod-loaded client with just resonite-launch and stop it with just resonite-stop, with staged SIGTERM/SIGKILL of both engine and renderer processes. - Use Case: When a TypeLoadException appears after adding a Protobuf dependency, use this Skill to check the BepInEx log, identify the Google.Protobuf 3.11.4 conflict bundled with Resonite, and consult the linked memory notes for the fix. ## Quick Start Ask the AI to start Resonite with the mod loaded and tail the BepInEx log to diagnose why the mod is not behaving as expected.

Frequently Asked Questions about debug-resonite-mod

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug a BepInEx mod running inside Resonite?

Use print-debugging with BepInEx ManualLogSource logging and tail gale/BepInEx/LogOutput.log via the just log recipe. .NET debugger attach is not configured, so log tailing across Resonite restarts is the primary debugging path.

How do I read undocumented Renderite IPC or Resonite internals?

Run just decompile to expand Resonite first-party DLLs, including Renderite Unity DLLs, into a project under decompiled/ using ilspycmd. The ResonitePath variable in .env must be set, and findings should be recorded in memory/feedback notes.

Why does TypeLoadException occur when using Google.Protobuf in a Resonite mod?

Resonite bundles Google.Protobuf 3.11.4, which conflicts with newer 3.15+ APIs like UnsafeByteOperations used by the mod. The PluginAssemblyResolver cannot always resolve this, so the mod must target the bundled 3.11.4 API surface.

Why is the Renderer-side BepInEx plugin not loading in Resonite?

The hook winhttp.dll doorstop requires WINEDLLOVERRIDES="winhttp=n,b" on both launch paths. The resoio launch command exports it automatically in the container, but host Steam launches need it set manually in Launch Options; check gale/Renderer/BepInEx/LogOutput.log.

How do I start and stop Resonite with the mod inside a container?

Run just resonite-launch to start Resonite with the mod loaded and just resonite-stop to terminate it. Stop uses psutil to SIGTERM then SIGKILL both the dotnet engine process and Renderite.Renderer.exe after a three-second wait.