Godot Advanced Logger (C#)
Godot Advanced Logger is a robust, high-performance, and structured logging framework designed specifically for Godot 4.x C# projects.
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.
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, right-aligned overlay to read logs directly inside your standalone game exports. Fully extensible via the
IDebugPanelAPI to add your own custom developer tools. - 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.
- Multi-Target Output: Write simultaneously to:
- Godot Console (with Rich Text BBCode colors)
- In-Game UI Overlay
- Text Files (
.txtfor quick reading) - JSON Lines Files (
.jsonlfor 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.
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!
Changelog for version v2.2.0
No changelog provided for this version.