{"id":20060108,"url":"https://github.com/jose-lico/godot-renderdoc-launcher","last_synced_at":"2025-10-26T07:06:00.752Z","repository":{"id":163221175,"uuid":"638168004","full_name":"jose-lico/Godot-RenderDoc-Launcher","owner":"jose-lico","description":"Plugin tool to easily launch RenderDoc from within Godot","archived":false,"fork":false,"pushed_at":"2024-09-10T16:19:44.000Z","size":1005,"stargazers_count":26,"open_issues_count":1,"forks_count":4,"subscribers_count":3,"default_branch":"4.x-GDScript","last_synced_at":"2024-09-10T18:15:33.064Z","etag":null,"topics":["gdscript","godot","godot-plugin","godot3","godot4","renderdoc"],"latest_commit_sha":null,"homepage":"","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/jose-lico.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}},"created_at":"2023-05-09T08:18:39.000Z","updated_at":"2024-09-10T16:19:48.000Z","dependencies_parsed_at":null,"dependency_job_id":"5cc1dd21-4250-4df3-91b7-aaf138a9fa77","html_url":"https://github.com/jose-lico/Godot-RenderDoc-Launcher","commit_stats":null,"previous_names":["jose-lico/godot-renderdoc-launcher"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jose-lico%2FGodot-RenderDoc-Launcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jose-lico%2FGodot-RenderDoc-Launcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jose-lico%2FGodot-RenderDoc-Launcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jose-lico%2FGodot-RenderDoc-Launcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jose-lico","download_url":"https://codeload.github.com/jose-lico/Godot-RenderDoc-Launcher/tar.gz/refs/heads/4.x-GDScript","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224452789,"owners_count":17313668,"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","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":["gdscript","godot","godot-plugin","godot3","godot4","renderdoc"],"created_at":"2024-11-13T13:13:00.226Z","updated_at":"2025-10-26T07:06:00.733Z","avatar_url":"https://github.com/jose-lico.png","language":"GDScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GodotRenderDocLauncher\n\nThis plugin tool adds a button to Godot's editor allowing you to easily launch [RenderDoc](https://renderdoc.org/) so you can quickly see how your changes are affecting the game's rendering.\n\nWorks with Godot 3.5 and 4.x.\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"addons/renderdoc_launcher/res/renderdoc_logo.png\" alt= \"renderdoc-icon\" width=\"128\"\u003e\n\u003cimg src=\"https://godotengine.org/assets/press/logo_large_color_light.png\" alt= \"godot-icon\" height=\"128\"\u003e\n\u003c/p\u003e\n\n## Motivation\n\nWhen developing a game, it is always important to be mindful of its performance. This can be measured in a few areas, namely rendering.\n\nEspecially when working with an engine like Godot or Unity, one might not be fully aware of the impact of actions such as adding that extra Node or GameObject, changing up the SceneTree or Hierarchy in a certain way, etc.\n\nHow do these actions translate to the engine’s renderer and ultimately, API calls?\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"addons/renderdoc_launcher/res/renderdoc_logo.png\" alt= \"RenderDocLogo\" \u003e\n\u003c/p\u003e\n\n[RenderDoc](https://renderdoc.org/) is a tool which can help us with that.\n\nNot only can it help us identify bottlenecks in our scene, it can also serve as debugger to check the state of pipeline when looking for what went wrong drawing that piece of custom geometry.\n\nI created this plugin to simplify my workflow when using RenderDoc.\n\nPreviously, I had to export my game and adjust RenderDoc's settings each time I made a change, which was tedious. I later discovered that I could directly launch a Godot project with the command-line argument `--path \u003cpath_to_your_project\u003e` instead of having to export the game's executable, which made things easier.\n\nHowever, I still wanted quicker access to RenderDoc without having to navigate through multiple menus or search for file paths.\n\n## Walkthrough\n\nOn project startup a button is added to the toolbar. Click it to launch RenderDoc. If you click on the dropdown, you can also select the scene RenderDoc will open on.\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\".github/RenderDocLauncherButton.png\" alt= \"RenderDocLauncherButton\" width=\"75%\"\u003e\n\u003c/p\u003e\n\nThe first time you click the button you will be prompted to provide RenderDoc's location. This will be saved to a resource file so you do not need to do it again.\n\n_For Windows this would typically be_ `C:\\\\Program Files\\\\RenderDoc\\\\qrenderdoc.exe` _if the installer was used._\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\".github/RenderDocLauncherLocation.png\" alt=\"RenderDocLauncherLocation\" width=\"75%\"\u003e\n\u003c/p\u003e\n\nAfter you provide RenderDoc's location, it will be launched and the game will automatically start. This and other settings can be found at `addons/renderdoc_launcher/res/default_settings.cap`. Edit this file according to your needs.\n\nThese settings are copied into `addons/renderdoc_launcher/res/settings.cap` for the actual launch.\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\".github/RenderDocLauncherExample.png\" alt=\"RenderDocLauncherExample\" width=\"75%\"\u003e\n\u003c/p\u003e\n\n**Notes:** `addons/renderdoc_launcher/res/renderdoc_path.tres` which is where the path to RenderDoc is saved is in the `.gitignore` of the addon.\nThis is the default because if you are working with other people on a project, your RenderDoc locations will differ. Same logic applies for the settings, but the default ones.\n\nIf working on a project alone, feel free to remove the `.gitignore`, the path Resource even supports multiple OSs if you do test your project on multiple of them.\n\n---\n\nHope this small tool can make your life easier when optimizing and iterating 😃\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjose-lico%2Fgodot-renderdoc-launcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjose-lico%2Fgodot-renderdoc-launcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjose-lico%2Fgodot-renderdoc-launcher/lists"}