{"id":18084159,"url":"https://github.com/burloe/gologger","last_synced_at":"2026-03-04T07:05:35.565Z","repository":{"id":258837817,"uuid":"855773925","full_name":"Burloe/GoLogger","owner":"Burloe","description":"GoLogger is a framework that logs any user-defined game events and data into external and sharable .log files. Made for Godot 4.3+.","archived":false,"fork":false,"pushed_at":"2025-07-19T20:51:05.000Z","size":24870,"stargazers_count":47,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-19T23:11:09.219Z","etag":null,"topics":["framework","godot","godot4","log","logger","logging","plugin"],"latest_commit_sha":null,"homepage":"https://godotengine.org/asset-library/asset/3365","language":"GDScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Burloe.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-09-11T12:52:57.000Z","updated_at":"2025-07-19T20:51:09.000Z","dependencies_parsed_at":"2024-11-10T19:25:50.500Z","dependency_job_id":"0a838381-f1a9-4921-944d-1d200857a759","html_url":"https://github.com/Burloe/GoLogger","commit_stats":null,"previous_names":["burloe/gologger"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/Burloe/GoLogger","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Burloe%2FGoLogger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Burloe%2FGoLogger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Burloe%2FGoLogger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Burloe%2FGoLogger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Burloe","download_url":"https://codeload.github.com/Burloe/GoLogger/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Burloe%2FGoLogger/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270108495,"owners_count":24528760,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-12T02:00:09.011Z","response_time":80,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["framework","godot","godot4","log","logger","logging","plugin"],"created_at":"2024-10-31T15:05:54.109Z","updated_at":"2026-03-04T07:05:35.559Z","avatar_url":"https://github.com/Burloe.png","language":"GDScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/2856b4fb-8d18-49b5-bd60-8a8015b6723a\" alt=\"GoLogger Icon\" height=\"120\"\u003e\n  \u003ca href=\"https://godotengine.org/download/windows/\"\u003e\u003cimg src=\"https://img.shields.io/static/v1?label=Godot\u0026message=4.3\u0026color=blue\u0026logo=godotengine\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://godotengine.org/download/windows/\"\u003e\u003cimg src=\"https://img.shields.io/static/v1?label=Godot\u0026message=4.4\u0026color=blue\u0026logo=godotengine\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://godotengine.org/download/windows/\"\u003e\u003cimg src=\"https://img.shields.io/static/v1?label=Godot\u0026message=4.5\u0026color=blue\u0026logo=godotengine\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/Burloe/GoLogger/archive/refs/tags/1.3.1.zip\"\u003e\n    \u003cimg alt=\"Download\" src=\"https://img.shields.io/badge/Download GoLogger 1.3.1-29903b?color=29903b\u0026logo=data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9Im5vIj8+CjwhLS0gVXBsb2FkZWQgdG86IFNWRyBSZXBvLCB3d3cuc3ZncmVwby5jb20sIEdlbmVyYXRvcjogU1ZHIFJlcG8gTWl4ZXIgVG9vbHMgLS0+Cgo8c3ZnCiAgIGZpbGw9IiMwMDAwMDAiCiAgIGhlaWdodD0iODAwcHgiCiAgIHdpZHRoPSI4MDBweCIKICAgdmVyc2lvbj0iMS4xIgogICBpZD0iQ2FwYV8xIgogICB2aWV3Qm94PSIwIDAgMjkuOTc4IDI5Ljk3OCIKICAgeG1sOnNwYWNlPSJwcmVzZXJ2ZSIKICAgc29kaXBvZGk6ZG9jbmFtZT0iZG93bmxvYWQtYnV0dG9uLnN2ZyIKICAgaW5rc2NhcGU6dmVyc2lvbj0iMS4zLjIgKDA5MWUyMGUsIDIwMjMtMTEtMjUsIGN1c3RvbSkiCiAgIHhtbG5zOmlua3NjYXBlPSJodHRwOi8vd3d3Lmlua3NjYXBlLm9yZy9uYW1lc3BhY2VzL2lua3NjYXBlIgogICB4bWxuczpzb2RpcG9kaT0iaHR0cDovL3NvZGlwb2RpLnNvdXJjZWZvcmdlLm5ldC9EVEQvc29kaXBvZGktMC5kdGQiCiAgIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIKICAgeG1sbnM6c3ZnPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+PGRlZnMKICAgaWQ9ImRlZnMxNyIgLz48c29kaXBvZGk6bmFtZWR2aWV3CiAgIGlkPSJuYW1lZHZpZXcxNyIKICAgcGFnZWNvbG9yPSIjZmZmZmZmIgogICBib3JkZXJjb2xvcj0iIzAwMDAwMCIKICAgYm9yZGVyb3BhY2l0eT0iMC4yNSIKICAgaW5rc2NhcGU6c2hvd3BhZ2VzaGFkb3c9IjIiCiAgIGlua3NjYXBlOnBhZ2VvcGFjaXR5PSIwLjAiCiAgIGlua3NjYXBlOnBhZ2VjaGVja2VyYm9hcmQ9IjAiCiAgIGlua3NjYXBlOmRlc2tjb2xvcj0iI2QxZDFkMSIKICAgaW5rc2NhcGU6em9vbT0iMS40ODg3NSIKICAgaW5rc2NhcGU6Y3g9IjM5OS42NjQxNSIKICAgaW5rc2NhcGU6Y3k9IjQwMCIKICAgaW5rc2NhcGU6d2luZG93LXdpZHRoPSIyNTYwIgogICBpbmtzY2FwZTp3aW5kb3ctaGVpZ2h0PSIxMzg3IgogICBpbmtzY2FwZTp3aW5kb3cteD0iLTgiCiAgIGlua3NjYXBlOndpbmRvdy15PSIxMCIKICAgaW5rc2NhcGU6d2luZG93LW1heGltaXplZD0iMSIKICAgaW5rc2NhcGU6Y3VycmVudC1sYXllcj0iQ2FwYV8xIiAvPgo8ZwogICBpZD0iZzE3IgogICBzdHlsZT0iZmlsbDojZmZmZmZmIj4KCTxwYXRoCiAgIGQ9Ik0yNS40NjIsMTkuMTA1djYuODQ4SDQuNTE1di02Ljg0OEgwLjQ4OXY4Ljg2MWMwLDEuMTExLDAuOSwyLjAxMiwyLjAxNiwyLjAxMmgyNC45NjdjMS4xMTUsMCwyLjAxNi0wLjksMi4wMTYtMi4wMTIgICB2LTguODYxSDI1LjQ2MnoiCiAgIGlkPSJwYXRoMSIKICAgc3R5bGU9ImZpbGw6I2ZmZmZmZiIgLz4KCTxwYXRoCiAgIGQ9Ik0xNC42MiwxOC40MjZsLTUuNzY0LTYuOTY1YzAsMC0wLjg3Ny0wLjgyOCwwLjA3NC0wLjgyOHMzLjI0OCwwLDMuMjQ4LDBzMC0wLjU1NywwLTEuNDE2YzAtMi40NDksMC02LjkwNiwwLTguNzIzICAgYzAsMC0wLjEyOS0wLjQ5NCwwLjYxNS0wLjQ5NGMwLjc1LDAsNC4wMzUsMCw0LjU3MiwwYzAuNTM2LDAsMC41MjQsMC40MTYsMC41MjQsMC40MTZjMCwxLjc2MiwwLDYuMzczLDAsOC43NDIgICBjMCwwLjc2OCwwLDEuMjY2LDAsMS4yNjZzMS44NDIsMCwyLjk5OCwwYzEuMTU0LDAsMC4yODUsMC44NjcsMC4yODUsMC44NjdzLTQuOTA0LDYuNTEtNS41ODgsNy4xOTMgICBDMTUuMDkyLDE4Ljk3OSwxNC42MiwxOC40MjYsMTQuNjIsMTguNDI2eiIKICAgaWQ9InBhdGgyIgogICBzdHlsZT0iZmlsbDojZmZmZmZmIiAvPgoJPGcKICAgaWQ9ImcyIgogICBzdHlsZT0iZmlsbDojZmZmZmZmIj4KCTwvZz4KCTxnCiAgIGlkPSJnMyIKICAgc3R5bGU9ImZpbGw6I2ZmZmZmZiI+Cgk8L2c+Cgk8ZwogICBpZD0iZzQiCiAgIHN0eWxlPSJmaWxsOiNmZmZmZmYiPgoJPC9nPgoJPGcKICAgaWQ9Imc1IgogICBzdHlsZT0iZmlsbDojZmZmZmZmIj4KCTwvZz4KCTxnCiAgIGlkPSJnNiIKICAgc3R5bGU9ImZpbGw6I2ZmZmZmZiI+Cgk8L2c+Cgk8ZwogICBpZD0iZzciCiAgIHN0eWxlPSJmaWxsOiNmZmZmZmYiPgoJPC9nPgoJPGcKICAgaWQ9Imc4IgogICBzdHlsZT0iZmlsbDojZmZmZmZmIj4KCTwvZz4KCTxnCiAgIGlkPSJnOSIKICAgc3R5bGU9ImZpbGw6I2ZmZmZmZiI+Cgk8L2c+Cgk8ZwogICBpZD0iZzEwIgogICBzdHlsZT0iZmlsbDojZmZmZmZmIj4KCTwvZz4KCTxnCiAgIGlkPSJnMTEiCiAgIHN0eWxlPSJmaWxsOiNmZmZmZmYiPgoJPC9nPgoJPGcKICAgaWQ9ImcxMiIKICAgc3R5bGU9ImZpbGw6I2ZmZmZmZiI+Cgk8L2c+Cgk8ZwogICBpZD0iZzEzIgogICBzdHlsZT0iZmlsbDojZmZmZmZmIj4KCTwvZz4KCTxnCiAgIGlkPSJnMTQiCiAgIHN0eWxlPSJmaWxsOiNmZmZmZmYiPgoJPC9nPgoJPGcKICAgaWQ9ImcxNSIKICAgc3R5bGU9ImZpbGw6I2ZmZmZmZiI+Cgk8L2c+Cgk8ZwogICBpZD0iZzE2IgogICBzdHlsZT0iZmlsbDojZmZmZmZmIj4KCTwvZz4KPC9nPgo8L3N2Zz4K\u0026logoWidth=20\u0026logoColor=white\"\u003e\n  \u003c/a\u003e\n\u003c/h1\u003e\n\n\u003cbr\u003e\n\n\u003cp\u003e\u003cstrong\u003eGoLogger\u003c/strong\u003e is a simple yet flexible logging framework for \u003cem\u003eGodot 4.3+\u003c/em\u003e, which captures and stores game events (and data) into external \u003ccode\u003e.log\u003c/code\u003e 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. With plenty of customization options available, log entries can be tailored to fit your project's needs and make debugging and investigating issues easier.\u003c/p\u003e\n\n\u003cp\u003e\u003cimg src=\"https://github.com/user-attachments/assets/a2b43670-e2ff-4450-a6d1-373ee9df3658\" alt=\"GoLogger Screenshot\"\u003e\u003c/p\u003e\n\n\u003cp\u003eDefining log entries is as easy as writing a `print()` statement, only requiring a simple string, which can include any data (that can be converted into a string) and an integer to determine which category/file to log the entry in. 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:\u003c/p\u003e\n\n\u003cpre\u003e\u003ccode\u003eLog.entry(\"Player's current health: \" + str(current_health) + \" / \" + str(max_health), 1)\n\nLog.entry(str(\"Player's current health: \", current_health, \" / \", max_health), 1)\n\nLog.entry(str(\"Player's current health: %s / %s\" % current_health, max_health), 1)\n\n# Resulting entry: [19:17:27] Player's current health: 74 / 100\n\u003c/code\u003e\u003c/pre\u003e\n\n\u003cp\u003e\u003cem\u003eThe integer identifier \u003ccode\u003ecategory_index\u003c/code\u003e defined after the log entry string dictates which log category (or log file) the entry should be stored in. Each category has it's own integer identifier at the top in the dock's Categories tab(and can be changed).\u003c/em\u003e\u003c/p\u003e\n\n\u003cp\u003e\u003cimg src=\"https://github.com/user-attachments/assets/5ca86c2b-326b-4897-b954-1df829f986ca\" alt=\"Category Index Showcase\" align=center\u003e\u003c/p\u003e\n\n\u003cp\u003e\u003cimg src=\"https://github.com/user-attachments/assets/8f5de66b-3bb0-48d6-9c74-2171b0b7bd1c\" align=center\u003e\u003c/p\u003e\n\n\n\n\u003ch2\u003eDocumentation / Wiki\u003c/h2\u003e\n\u003cp\u003eSee the \u003ca href=\"https://github.com/Burloe/GoLogger/wiki/\"\u003eWiki\u003c/a\u003e for more information on \n  \u003ca href=\"https://github.com/Burloe/GoLogger/wiki/Installation-\u0026-Setup\"\u003eInstallation \u0026amp; Setup\u003c/a\u003e, \n  \u003ca href=\"https://github.com/Burloe/GoLogger/wiki/Getting-Started\"\u003eHow to use GoLogger\u003c/a\u003e and \n  \u003ca href=\"https://github.com/Burloe/GoLogger/wiki#how-gologger-works\"\u003eHow it works\u003c/a\u003e.\n\u003c/p\u003e\n\u003cp\u003eIf you haven't touched the settings in a while or just need a refresher. The dock panel contains a TL;DR version of the wiki in the Help section with vital information so you never have to leave the editor to lookup a website.\u003c/p\u003e\n\n\u003ch2\u003eLatest Patch Notes - 1.3 / 1.3.1:\u003c/h2\u003e\n\u003cp\u003eSee the \u003ca href=\"https://github.com/Burloe/GoLogger/releases/tag/1.3.1\"\u003erelease page\u003c/a\u003e for more info\u003c/p\u003e\n1.3.1:\n\u003cul\u003e\n  \u003cli\u003eSettings tab remade. \u003c/li\u003e\n  \u003cli\u003eFixed settings tab theme and alignment issues on smaller resolutions.\u003c/li\u003e\n  \u003cli\u003eAdded new `Help` tab containing the essential documentation on how to use GoLogger.\u003c/li\u003e\n\u003c/ul\u003e\n1.3:\n\u003cul\u003e\n  \u003cli\u003eCleaner visuals and theme.\u003c/li\u003e\n  \u003cli\u003e'Unsaved changes' problem fixed.\u003c/li\u003e\n  \u003cli\u003eYou can now call \u003ccode\u003eLog.save_copy(\"my_copy\")\u003c/code\u003e in your code. Bypassing the popup and giving you control to setup save copy automatically.\u003c/li\u003e\n  \u003cli\u003eThe category index can be manually changed in the 'Categories' tab! The index is also numerically ordered automatically.\u003c/li\u003e\n  \u003cli\u003eColumn slider allows you to set the number of columns visible in the GridContainer holding the categories.\u003c/li\u003e\n  \u003cli\u003eProper tooltips have been added that show on mouse over which de-clutters the dock massively.\u003c/li\u003e\n  \u003cli\u003eRemoved excessive settings.\u003c/li\u003e\n  \u003cli\u003eMore!\u003c/li\u003e\n\u003c/ul\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fburloe%2Fgologger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fburloe%2Fgologger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fburloe%2Fgologger/lists"}