Wick.Runtime 1.0.0

dotnet add package Wick.Runtime --version 1.0.0
                    
NuGet\Install-Package Wick.Runtime -Version 1.0.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Wick.Runtime" Version="1.0.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Wick.Runtime" Version="1.0.0" />
                    
Directory.Packages.props
<PackageReference Include="Wick.Runtime" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Wick.Runtime --version 1.0.0
                    
#r "nuget: Wick.Runtime, 1.0.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Wick.Runtime@1.0.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Wick.Runtime&version=1.0.0
                    
Install as a Cake Addin
#tool nuget:?package=Wick.Runtime&version=1.0.0
                    
Install as a Cake Tool

Wick.Runtime

In-process runtime companion for Wick — captures C# exceptions, logs, and live state from a running Godot game and forwards them to the Wick MCP server over a localhost JSON-RPC bridge.

This package is the second tier of Wick's exception capture. The first tier (stderr parsing of an agent-launched Godot subprocess) ships with the Wick MCP server itself. This companion adds:

  • AppDomain.UnhandledException capture (catches non-fatal crashes the editor would silently swallow)
  • TaskScheduler.UnobservedTaskException capture (catches async fire-and-forget exceptions)
  • Structured-logging provider that mirrors Microsoft.Extensions.Logging calls into Wick's log buffer
  • TCP bridge server that lets the Wick MCP server query live scene state, node properties, and arbitrary methods on running Godot nodes

Install

dotnet add package Wick.Runtime

Usage

using Wick.Runtime;

public partial class Main : Node
{
    public override void _Ready() => WickRuntime.Install();

    public override void _Process(double delta) => WickRuntime.Tick();
}

Install() registers exception hooks and starts the bridge listener. Tick() drains the main-thread dispatcher each frame so live-bridge RPC handlers run on Godot's main thread (required — Godot's scene tree is not thread-safe).

Without Tick(), exception capture still works but live RPC calls (e.g. runtime_query_scene_tree from the MCP side) will block forever.

Configuration

Env var Default Purpose
WICK_RUNTIME_PORT 7878 Loopback TCP port for the bridge listener. Override only when 7878 is taken.

Compatibility

  • Targets net8.0 to match Godot 4.6.1's mono/.NET runtime.
  • Linked into your Godot C# project as a normal NuGet dependency.

License

MIT — see LICENSE.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.0 104 4/19/2026