Godot Advanced Logger

Godot Advanced Logger is a robust, high-performance, and structured logging framework for Godot 4.x .NET projects, usable from both C# and GDScript.

Moving beyond standard GD.Print console outputs, this plugin introduces a standard logging architecture. It is built from the ground up to prevent garbage collector spikes (Zero-Allocation), support structured data (JSON), stream logs in real-time to external dashboards like Seq, and provide a fully extensible In-Game Debug UI.

Warning: The main implementation of this plugin lies within a C# implementation. Your project must be initialised with C# (.NET) support in order to work properly. Please see the provided README in the project for further information or contact me via GitHub!

Key Features

• Zero-Cost Debugging: Debug() calls utilize C#'s [Conditional("DEBUG")] attribute. In your final Release builds, the compiler completely strips these calls, ensuring zero CPU overhead and memory allocation.
• In-Game Debug Screen: A toggleable overlay with five built-in tabs: Logs, Console, Watch, Performance and System. Readable directly inside your standalone game exports. Fully extensible via the IDebugPanel API to add your own custom developer tools.
• In-Game Console: Register commands from anywhere with DebugConsole.Register(...) and run them at a prompt, with history, Tab completion and quoted arguments.
• GDScript Support: A GodotLogger facade exposes logging, channel muting, console commands and the Watch panel to GDScript, with caller file and line resolved from the GDScript stack.
• Production Safe: Automatically detects Release exports (OS.IsDebugBuild()) and hard-disables developer tools (like the UI and network writers) while intelligently throttling log verbosity based on separate Editor/Release settings.
• Structured Logging: Stop parsing messy text strings. Send exact data points via C# Dictionaries, making your logs fully searchable and filterable in external tools.
• Editor Integration: Warnings and errors are reported to Godot's error stream, so they show up in Debugger --> Errors with a stack trace instead of scrolling past in Output.
• Multi-Target Output: Write simultaneously to:
  • Godot Console (with Rich Text BBCode colors)
  • In-Game UI Overlay
  • Text Files (.txt for quick reading)
  • JSON Lines Files (.jsonl for programmatic parsing)
  • Seq HTTP Server (Real-time dashboard streaming)

Level Up Your Debugging

Context Loggers

Keep your larger projects organized by creating dedicated loggers for specific game systems (e.g., Combat, Inventory, Networking). This allows you to tag logs by channel, easily filtering messages and muting noisy channels directly from a visual interface in the Godot Project Settings.

Real-Time Analytics with Seq

This plugin includes native support for Seq, a free local log server that acts as a real-time database for your game. Stream your logs live and use powerful search queries to instantly track down bugs and analyze game data as it happens.

Custom Debug Panels

The built-in debug screen doesn't just show logs. You can easily hook into the framework to build your own custom performance metrics, entity inspectors, or cheat menus using standard Godot UI controls. These custom panels are highly optimized and will only run their update logic when actively visible on the screen.

Using the plugin from GDScript

Everything above works from GDScript too, through the GodotLogger facade. It is a class_name script, so there is nothing to preload and no extra autoload to configure.

This does not remove the .NET requirement. The core of the plugin is C#, so your project must still be a Godot .NET (Mono) build with the C# solution compiled. GDScript support means you can use the logger from GDScript, not that it runs on standard Godot.

Support, Bugs & Feature Requests

Found a bug or have an idea for a new feature? Please report all issues and feature requests directly on the GitHub Issues Page. Keeping track of tickets on GitHub helps me address your feedback quickly and keeps the development process organized. If you need help, feel free to open a discussion or contact me there as well!

Requirements

• Godot 4.x
• Your project must be initialised with C# (.NET) support

Ready to clean up your console, eliminate stuttering, and debug like a pro? Download Godot Advanced Logger today!