Wick

Roslyn-angereicherte C#-Ausnahme-Telemetrie für die Godot Engine, bereitgestellt über MCP.

Was ist Wick?

Wenn ein Godot-C#-Spiel abstürzt, sieht dein KI-Assistent einen rohen Stack-Trace und verschwendet 8+ Interaktionen damit, dich zum Öffnen von Dateien aufzufordern. Wick erfasst diese Ausnahme, reichert sie mit Roslyn-basiertem Quellcode-Kontext an (der tatsächliche Methodenkörper, Aufrufkette, aktuelle Protokolle, Szenenzustand) und übergibt das vollständige Bild in einem einzigen Aufruf an die KI. Eine Interaktion zur Diagnose statt zehn.

Was macht Wick anders?

Andere Godot-MCP-Server (wie das exzellente GoPeak) konzentrieren sich auf Szenenmanipulation und GDScript-Tools. Wick konzentriert sich auf die C#/.NET-Entwicklererfahrung:

• Roslyn-angereicherte Ausnahme-Telemetrie -- über stderr erfasste C#-Ausnahmen, angereichert mit dem aufrufenden Methodenkörper, umgebenden Quellcodezeilen, umschließendem Typ und Aufrufkette. Kein anderer Godot-MCP-Server bietet dies.

• In-Process-Ausnahmeerfassung -- das optionale NuGet-Add-on Wick.Runtime fängt TaskScheduler.UnobservedTaskException und asynchrone Ausnahmen ab, die stderr nicht sehen kann.

• Build-Diagnose mit Quellcode-Kontext -- dotnet-Build-Fehler, die über dieselbe Pipeline wie Laufzeitausnahmen mit Roslyn-Quellcode-Kontext angereichert werden.

• C#-Analysetools -- Symbolsuche, Referenzsuche, Mitgliedssignaturen via Roslyn-Workspace.

• 5-Säulen-Toolgruppensystem -- aktiviere nur, was du brauchst: core, runtime, csharp, build, scene.

Erste Schritte

Voraussetzungen

• .NET 10 SDK (10.0.201 oder neuer)

• Godot 4.6.1+ mit .NET/Mono-Unterstützung

Installation

git clone https://github.com/buildepicshit/Wick.git
cd Wick
dotnet build Wick.slnx --configuration Release

MCP-Konfiguration

Füge Wick zur MCP-Konfiguration deines KI-Coding-Assistenten hinzu:

{
  "mcpServers": {
    "wick": {
      "command": "dotnet",
      "args": ["run", "--project", "path/to/Wick/src/Wick.Server"],
      "env": {
        "WICK_GROUPS": "core,runtime,csharp,build",
        "WICK_GODOT_BIN": "/path/to/godot",
        "WICK_PROJECT_PATH": "/path/to/your/godot-project"
      }
    }
  }
}

Tool-Gruppen

Aktiviere Tool-Säulen über die Umgebungsvariable WICK_GROUPS oder das CLI-Flag --groups:

Beispiel: WICK_GROUPS=core,runtime,csharp,build oder --groups=all.

Optional: Wick.Runtime Companion

Für die In-Process-Ausnahmeerfassung (asynchrone Ausnahmen, TaskScheduler-Fehler), füge das Wick.Runtime NuGet zu deinem Godot-Projekt hinzu:

// In your Godot project's autoload or entry point:
WickRuntime.Install();

Dies erfasst Ausnahmen, die stderr nicht sehen kann, und meldet sie über eine TCP-Brücke an den Wick-Server.

Architektur

Wick läuft als externer Prozess -- es läuft NICHT innerhalb von Godot. Kommunikation:

• stdio -- MCP-Protokoll zum KI-Client

• TCP 6505 -- Editor-Brücke (Godot-Plugin zum Wick-Server)

• TCP 7777 -- Laufzeit-Brücke (laufendes Spiel zum Wick-Server)

• TCP 7878 -- Wick.Runtime-Companion-Brücke (In-Process zum Wick-Server)

Diese Architektur ermöglicht es Wick, .NET 10 anzusprechen, obwohl die Laufzeitumgebung von Godot 4.6.1 auf .NET 8 feststeckt.

Attribution

Wick ist eine Clean-Room-Neuimplementierung, inspiriert von GoPeak (MIT-Lizenz, (c) 2025 Solomon Elias / HaD0Yun). Siehe ATTRIBUTION.md für detaillierte Credits.

Mitwirken

Wir freuen uns über Beiträge! Bitte lies CONTRIBUTING.md, bevor du einen PR einreichst.

Demo

Klone das Repo und öffne docs/demo/player.html in einem Browser, um die Demo anzusehen, oder spiele die Cast-Datei direkt ab:

asciinema play docs/demo/wick-demo.cast

Lizenz

MIT