https://github.com/morris/vstools

Toolset for Vagrant Story (2000, Square), written in JavaScript with Three.js
https://github.com/morris/vstools

playstation reverse-engineering squaresoft

Last synced: 2 months ago
JSON representation

Toolset for Vagrant Story (2000, Square), written in JavaScript with Three.js

• Host: GitHub
• URL: https://github.com/morris/vstools
• Owner: morris
• License: mit
• Created: 2015-03-12T17:53:29.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2022-12-30T20:36:14.000Z (about 2 years ago)
• Last Synced: 2024-10-11T12:57:42.841Z (3 months ago)
• Topics: playstation, reverse-engineering, squaresoft
• Language: JavaScript
• Homepage: https://morris.github.io/vstools/
• Size: 2.82 MB
• Stars: 97
• Watchers: 23
• Forks: 9
• Open Issues: 14
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# 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](https://morris.github.io/vstools)





## [Run in Browser](https://morris.github.io/vstools)

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](http://datacrystal.romhacking.net/wiki/Vagrant_Story:rooms_list).

## 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](https://github.com/collinsmichael)

- WEP textures fixed by [Oliver Barraza](https://github.com/MercurialForge)

- SHP with vertex colors found and reversed by [korobetski](https://github.com/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](https://github.com/morris/vstools-java).