Vstools
Toolset for Vagrant Story (2000, Square), written in JavaScript with Three.js
Install / Use
npx skills add morris/vstoolsInstalls into whichever agent you are using.
README
Vagrant Story Tools
A toolset for Vagrant Story (2000, Square), written in JavaScript with Three.js. Contains a mostly working model viewer.
<img src="img/screenshot1.jpg"> <img src="img/screenshot2.jpg">Run in Browser
Runs in browsers supporting WebGL, like Firefox. The viewer opens individual files obtained from a CD image which have to be extracted first from your copy of Vagrant Story.
The toolset is developed for the US Version of Vagrant Story but should work with any.
Supported File Types
- WEP (weapons)
- SHP (characters)
- SEQ (animations)
- ZUD (basically SHP + SEQ + WEP)
- ZND (zone data)
- MPD (map)
- ARM (minimap)
To open an MPD file, you'll need the correct ZND file. You can find the Zone/Map list here.
Motivation
Reverse engineering is very rewarding. You get to know assembly, debuggers, system architecture, hacking live programs and much more. Making sense of undocumented file formats is great, kind of archeological fun.
Vagrant Story itself is a unique piece of art, featuring an outstanding character and level design.
Contributions and Acknowledgments
- Tremendous work in deciphering Vagrant Story by Michael Collins
- WEP textures fixed by Oliver Barraza
- SHP with vertex colors found and reversed by korobetski
A lot of information on Vagrant Story hacking can be found here: http://datacrystal.romhacking.net/wiki/Vagrant_Story
A prior version was written in Java, which can be found here.
Related Skills
node-connect
385.6kDiagnose OpenClaw Android, iOS, or macOS node pairing, QR/setup code, route, auth, and connection failures.
blender-python-addon
40.5kBlender Python add-on rules for operators, panels, properties, registration, testing, and API-safe scripting
flutter-development-guidelines-cursorrules-prompt-file
40.5kCursor rules for Flutter development with MVVM architecture, Riverpod state management, Material widgets, and Dart style guidelines.
commit-push-pr
140.7kCommit, push, and open a PR
