{"id":16229256,"url":"https://github.com/morris/vstools","last_synced_at":"2025-07-09T23:06:10.272Z","repository":{"id":28574707,"uuid":"32092518","full_name":"morris/vstools","owner":"morris","description":"Toolset for Vagrant Story (2000, Square), written in JavaScript with Three.js","archived":false,"fork":false,"pushed_at":"2022-12-30T20:36:14.000Z","size":2959,"stargazers_count":103,"open_issues_count":14,"forks_count":9,"subscribers_count":23,"default_branch":"master","last_synced_at":"2025-04-01T21:04:57.969Z","etag":null,"topics":["playstation","reverse-engineering","squaresoft"],"latest_commit_sha":null,"homepage":"https://morris.github.io/vstools/","language":"JavaScript","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/morris.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-03-12T17:53:29.000Z","updated_at":"2025-03-04T11:26:36.000Z","dependencies_parsed_at":"2023-01-14T09:05:12.877Z","dependency_job_id":null,"html_url":"https://github.com/morris/vstools","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/morris/vstools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/morris%2Fvstools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/morris%2Fvstools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/morris%2Fvstools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/morris%2Fvstools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/morris","download_url":"https://codeload.github.com/morris/vstools/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/morris%2Fvstools/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263120693,"owners_count":23416873,"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":["playstation","reverse-engineering","squaresoft"],"created_at":"2024-10-10T12:57:49.503Z","updated_at":"2025-07-02T10:32:14.067Z","avatar_url":"https://github.com/morris.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Vagrant Story Tools\n\nA toolset for Vagrant Story (2000, Square), written in JavaScript with Three.js.\nContains a mostly working model viewer.\n\n[Run in Browser](https://morris.github.io/vstools)\n\n\u003cimg src=\"img/screenshot1.jpg\"\u003e\n\n\u003cimg src=\"img/screenshot2.jpg\"\u003e\n\n## [Run in Browser](https://morris.github.io/vstools)\n\nRuns in browsers supporting WebGL, like Firefox.\nThe viewer opens individual files obtained from a CD image\nwhich have to be extracted first from your copy of Vagrant Story.\n\nThe toolset is developed for the US Version of Vagrant Story but should work with any.\n\n## Supported File Types\n\n- WEP (weapons)\n- SHP (characters)\n- SEQ (animations)\n- ZUD (basically SHP + SEQ + WEP)\n- ZND (zone data)\n- MPD (map)\n- ARM (minimap)\n\nTo open an MPD file, you'll need the correct ZND file.\nYou can find the Zone/Map list\n[here](http://datacrystal.romhacking.net/wiki/Vagrant_Story:rooms_list).\n\n## Motivation\n\nReverse engineering is very rewarding.\nYou get to know assembly, debuggers, system architecture, hacking live programs and much more.\nMaking sense of undocumented file formats is great, kind of archeological fun.\n\nVagrant Story itself is a unique piece of art,\nfeaturing an outstanding character and level design.\n\n## Contributions and Acknowledgments\n\n- Tremendous work in deciphering Vagrant Story by [Michael Collins](https://github.com/collinsmichael)\n- WEP textures fixed by [Oliver Barraza](https://github.com/MercurialForge)\n- SHP with vertex colors found and reversed by [korobetski](https://github.com/korobetski)\n\nA lot of information on Vagrant Story hacking can be found here:\nhttp://datacrystal.romhacking.net/wiki/Vagrant_Story\n\nA prior version was written in Java, which can be found [here](https://github.com/morris/vstools-java).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmorris%2Fvstools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmorris%2Fvstools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmorris%2Fvstools/lists"}