GoLogger is a simple yet flexible logging framework for Godot 4.3+, which captures and stores game events (and data) into external .log files accessible by both developers and players to aid in development and maintenance of your projects. With minimal setup, it can be quickly integrated into any project to run in the background at all times or log specific events during testing. GoLogger allows you to customize its settings to suit your needs, providing timestamped log entries that make debugging and investigating issues easier.

Defining log entries is simple and only requires a string, which can include any data (that can be converted into a string). Formatting strings to include data can be done in multiple ways and is no different than normal. Here are 3 examples that result in the same log entry:

Log.entry("Player's current health: " + str(current_health) + " / " + str(max_health), 1)

Log.entry(str("Player's current health: ", current_health, " / ", max_health), 1)

Log.entry(str("Player's current health: %s / %s" % current_health, max_health), 1)

# Resulting entry: [19:17:27] Player's current health: 74 / 100

The integer identifier category_index defined after the log entry string dictates which log category (or log file) the entry should be stored in. Each category respectively has their own integer identifier at the top in the dock's Categories tab.

Wiki for more information

See the Wiki for more information on Installation & Setup, How to use GoLogger and How it works.

Latest Patch Notes - 1.3:

See the release page for more info

• Cleaner visuals and theme.
• 'Unsaved changes' problem fixed.
• You can now call Log.save_copy("my_copy") in your code. Bypassing the popup and giving you control to setup save copy automatically.
• The category index can be manually changed in the 'Categories' tab! The index is also numerically ordered automatically.
• Column slider allows you to set the number of columns visible in the GridContainer holding the categories.
• Proper tooltips have been added that show on mouse over which de-clutters the dock massively.
• Removed excessive settings.
• More!