/vstools

Toolset for Vagrant Story (2000, Square), written in JavaScript with Three.js
  1. JavaScript 93.7%
  2. HTML 5.2%
  3. CSS 1.1%
JavaScript HTML CSS
Switch branches/tags
Nothing to show
Find file
Clone or download

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Open in Desktop Download ZIP

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching Xcode...

If nothing happens, download Xcode and try again.

Launching Visual Studio...

If nothing happens, download the GitHub extension for Visual Studio and try again.

Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
css mpd improvements Aug 8, 2015
img readme update Sep 3, 2015
src wip sound Jun 10, 2018
.gitignore gitignore Jul 20, 2015
LICENSE.md update license Feb 5, 2017
P.bt some wip May 8, 2017
README.md typo Feb 3, 2016
collada.js some wip May 8, 2017
dragon.png sidebar, textures, export, dragons Mar 13, 2015
effects.js some wip May 8, 2017
image.html some wip May 8, 2017
index.html externalize libs, cleanups, add package.json, init SOUND Feb 5, 2017
index.js some wip May 8, 2017
package.json some wip May 8, 2017
sound.js some wip May 8, 2017
sound0.js wip sound Jun 10, 2018

README.md

Vagrant Story Tools

A toolset for Vagrant Story (2000, Square), written in JavaScript with Three.js. Contains a mostly working model viewer. Run in browser

(A prior version was written in Java, which can be found here.)

Run in browser

Runs in browsers supporting WebGL, like Chrome or Firefox. The viewer opens individual files obtained from a CD image which have to be extracted first from your copy of Vagrant Story.

This code 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 ridiculously 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 that has no equal.

Contributions and acknowledgments

Many thanks to Valendian and other people's tremendous work on analyzing Vagrant Story.

Most information on VS hacking can be found here: http://datacrystal.romhacking.net/wiki/Vagrant_Story