{"id":13529394,"url":"https://github.com/PokeMMO/gdx-dbgagent","last_synced_at":"2025-04-01T16:31:23.296Z","repository":{"id":173471640,"uuid":"190945201","full_name":"PokeMMO/gdx-dbgagent","owner":"PokeMMO","description":"Java Agent for debugging common libgdx related issues.","archived":false,"fork":false,"pushed_at":"2022-03-25T22:36:32.000Z","size":118,"stargazers_count":30,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-11-02T16:34:50.638Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PokeMMO.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2019-06-08T23:37:32.000Z","updated_at":"2024-09-20T02:04:28.000Z","dependencies_parsed_at":"2024-01-03T03:54:37.705Z","dependency_job_id":"25f52b82-74fd-4468-a5a8-1a5fea04159b","html_url":"https://github.com/PokeMMO/gdx-dbgagent","commit_stats":null,"previous_names":["pokemmo/gdx-dbgagent"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PokeMMO%2Fgdx-dbgagent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PokeMMO%2Fgdx-dbgagent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PokeMMO%2Fgdx-dbgagent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PokeMMO%2Fgdx-dbgagent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PokeMMO","download_url":"https://codeload.github.com/PokeMMO/gdx-dbgagent/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246670543,"owners_count":20815002,"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":[],"created_at":"2024-08-01T07:00:35.936Z","updated_at":"2025-04-01T16:31:22.948Z","avatar_url":"https://github.com/PokeMMO.png","language":"Java","funding_links":[],"categories":["Resources"],"sub_categories":["Others"],"readme":"# gdx-dbgagent\n\nJava Agent for debugging common libgdx related issues.\n\n# Debug utilities\n\n* UNDISPOSED (-Dgdxdbg.debug.undisposed=true)\n  - Enables debugging if a Disposable object is finalized without being properly disposed.\n* DEBUG_UNCLOSED (-Dgdxdbg.debug.unclosed=true)\n  - Enables debugging if a java.io.Closeable object is finalized without being properly disposed.\n  - Cannot currently debug classes which are loaded before java agent is loaded. :(\n* MODIFIABLE_CONSTANTS (-Dgdxdbg.debug.modifiable_constants=true)\n  - Enables debugging if certain `modifiable constant`'s values change during runtime.\n  - Things constants like Color.WHITE can be accidently modified, leading to unexpected results.\n  - This utility will alert you that this has occurred, but not what has caused it.\n* GL_THREAD (-Dgdxdbg.debug.gl_thread=true)\n  - Enables debugging of methods/constructors called from incorrect threads.\n  - Any method or constructor that has an annotation with the name `@RequireGLThread` will throw a warning when called from a thread other than the main GL thread.\n  - Certain scene2d methods are included by default in this detection.\n\n# Usage\n\n1. Build the `gdx-dbgagent.jar` file from this project via the instructions in the 'Build' section below\n2. Copy the `gdx-dbgagent.jar` to any directory (henceforth called `\u003ccwd\u003e`)\n3. Start your libgdx application with `-javaagent:\u003ccwd\u003e/gdx-dbgagent.jar`\n    1. when using the command line, it should look like: `java -javaagent:\u003ccwd\u003e/gdx-dbgagent.jar -cp all/the/jars your.main.Class`\n    2. when using Eclipse, right-click your class with the `main()` method, goto 'Run As \u003e Run Configurations...' and on the 'Arguments' tab inside the 'VM Arguments:' field enter `-javaagent:\u003ccwd\u003e/gdx-dbgagent.jar`\n\n# Build\n\n1. `./gradlew assemble`\n2. see `build/libs/gdx-dbgagent.jar`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPokeMMO%2Fgdx-dbgagent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FPokeMMO%2Fgdx-dbgagent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPokeMMO%2Fgdx-dbgagent/lists"}