{"id":42557768,"url":"https://github.com/Argonaut-PS1-Reverse/Stratigise","last_synced_at":"2026-04-01T23:00:56.061Z","repository":{"id":111797690,"uuid":"410690691","full_name":"Argonaut-PS1-Reverse/Stratigise","owner":"Argonaut-PS1-Reverse","description":"WIP tool for disassembling and (re)assembling ASL binaries for Croc 1","archived":false,"fork":false,"pushed_at":"2025-06-13T20:45:49.000Z","size":1018,"stargazers_count":12,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"trunk","last_synced_at":"2025-06-13T21:33:35.488Z","etag":null,"topics":["argonaut-games","assembler","croc","croc-legend-of-the-gobbos","disassembler","legend-of-the-gobbos","reverse-engineering"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Argonaut-PS1-Reverse.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":"2021-09-27T00:02:42.000Z","updated_at":"2025-06-13T20:45:53.000Z","dependencies_parsed_at":null,"dependency_job_id":"6fd77887-be88-4da5-90ea-839efb581606","html_url":"https://github.com/Argonaut-PS1-Reverse/Stratigise","commit_stats":null,"previous_names":["argonaut-ps1-reverse/stratigise"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/Argonaut-PS1-Reverse/Stratigise","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Argonaut-PS1-Reverse%2FStratigise","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Argonaut-PS1-Reverse%2FStratigise/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Argonaut-PS1-Reverse%2FStratigise/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Argonaut-PS1-Reverse%2FStratigise/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Argonaut-PS1-Reverse","download_url":"https://codeload.github.com/Argonaut-PS1-Reverse/Stratigise/tar.gz/refs/heads/trunk","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Argonaut-PS1-Reverse%2FStratigise/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31292781,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T21:15:39.731Z","status":"ssl_error","status_checked_at":"2026-04-01T21:15:34.046Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["argonaut-games","assembler","croc","croc-legend-of-the-gobbos","disassembler","legend-of-the-gobbos","reverse-engineering"],"created_at":"2026-01-28T20:00:26.602Z","updated_at":"2026-04-01T23:00:56.043Z","avatar_url":"https://github.com/Argonaut-PS1-Reverse.png","language":"Python","funding_links":[],"categories":["Game \u0026 Studio Tools"],"sub_categories":["Argonaut Games"],"readme":"# Stratigise: Argonaut Strategy Language Reverse Engineering and Tools\n\nThis is a work-in-progress assembler and dissassembler meant to aid in understanding what strats are doing in games created by Argonaut Games. There is a general bias towards the first *Croc: Legend of the Gobbos*, but we welcome contributions that benefit any game.\n\nIt is not currently meant for serious use.\n\nArgonaut PSX reversing Discord: [![Discord](https://img.shields.io/discord/1013732315186335764?label=Join%20our%20Discord%20%21\u0026logo=discord)](https://discord.gg/feMkSQeFms)\n\n## Disclaimer(s)\n\n\u003e **Warning**: This project does not always produce vaild disassemblies at time of writing. If you see `CommandError`, `__unknown_operation_0x`[...] or anything suspicous, that means something went wrong and you can't trust anything written after or slightly before that instruction.\n\n\u003e **Note**: Our reassembler is currently only designed to handle Croc 1 and is in general quite messy code. In fact, the entire project is quite messy.\n\n## Usage\n\nTo disassemble a single strat, put it as `decompile.py`'s first argument:\n\n```zsh\n$ ./disassemble.py path/to/the/STRAT.BIN\n```\n\nIt will output two files with the original name plus the `.DIS` and `.AXX` extensions.\n\nTo reassemble a strat, use assemble with the first argument as the original strat name (witohut `.BIN`) and the second as the output bin file name:\n\n```zsh\n$ ./assemble.py path/to/the/INPUT.BIN path/to/the/OUTPUT.BIN\n```\n\n### Example\n\nThere are some examples strats from Croc DE in the `strats` folder:\n\n```\n$ ./disassemble.py strats/croc-de130/CROC.BIN\nProcessing \"strats/croc-de130/CROC.BIN\" with spec \"croc1\" ⋅⋅⋅\n```\n\nPart of the example output:\n\n```c\nLabel_b55:\n\tTurnRight { PushExternGlobal 10 ReturnTop }\n\tIf { GetAVar 12 PushInt32 8 BitAnd ReturnTop } Label_ba9\n\tIf { PushExternGlobal 10 PushInt32 747110 CmpTopGreater ReturnTop } Label_b80\n\tLetXGVar 10 { PushInt32 747110 ReturnTop }\n\tElse Label_ba6\n\nLabel_b80:\n\tIf { PushExternGlobal 10 PushInt32 2621440 CmpTopGreater ReturnTop } Label_b9d\n\tLetXGVar 10 { PushExternGlobal 10 PushInt32 85196 Divide ReturnTop }\n\tElse Label_ba6\n\nLabel_b9d:\n\tLetXGVar 10 { PushInt32 2621440 ReturnTop }\n\nLabel_ba6:\n\tElse Label_bca\n\nLabel_ba9:\n\tIf { PushExternGlobal 10 PushInt32 229376 CmpTopLess ReturnTop } Label_bc6\n\tLetXGVar 10 { PushExternGlobal 10 PushInt32 6553 Divide ReturnTop }\n\tElse Label_bca\n\nLabel_bc6:\n\tLetXGVar 10 { ReturnZero }\n\nLabel_bca:\n\tEndProc\n\t\n```\n\n### Advanced usage\n\nYou can pass in multipule files and use `--spec` to set the disassembler:\n\n```\ndisassemble.py --spec gamename1 file1 file2 ... --spec gamename2 file1 file2 ...\n```\n\n## Scripting language\n\nThere are several tools that support translation of Croc 1 strat disassemblies into some\nhigher level scripting language (a.k.a. C1S) and compiling them back.\n\n```\nreconstruct.py dis_file output_c1s_files_prefix\ncompile.py c1s_file1 c1s_file2 ... output_bin_file\n```\n\nMore info about the language and features [here](/doc/Stratigise/C1Script.md)\n\n## Health check\n\nTo perform a full health check against all Croc 1 strat files, run this:\n\n```\nspecs/croc1/health_check.py croc1_strats_dir strats_csv_path result_dir\n```\n\nIt runs the following stages for each strat file and prints the stats:\n * Disassebly\n * Re-assembly\n * Comparison of original and reassembled binaries for differences\n * Reconstruction of C1S code from disassembly\n * Compilation of reconstructed C1S code\n\n## Todo\n\n### Documentation\n\n * Reverse engineer opcode arguments and fill in the rest of the opcode list (close to done)\n * Also, `stEvaluate` (good progress)\n * Documenting other strat functions/the C API would be a good idea too\n\n### Disassembler\n\n * Cleaner parsing and an actual intermediate representation\n * Re-assembling dissassembled files\n * Clean implementation, possibly in C\n\n### Assembler\n\n * Make it more generic, currently only doing Croc 1 properly\n\n## More Info\n\nMake sure to read things in the `doc` folder if you want to know more.\n\nYou can also read more info about strats on [my modding notes](https://gist.github.com/knot126/bb80efbc838972e8e477ed7eaabdb221#stratigies-script-information), which also links to other resources.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FArgonaut-PS1-Reverse%2FStratigise","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FArgonaut-PS1-Reverse%2FStratigise","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FArgonaut-PS1-Reverse%2FStratigise/lists"}