README.md

GTA III Paths Visualizer is a P5.js-based 2D renderer that allows to visualize paths data for GTA III and GTA Vice City games. Examples of rendering could be found in the /render directory.

Prerequisites

• NodeJS v4 +
• npm v3 +

Usage

• Clone the repository

git clone https://github.com/x87/GTA-III-Paths-Visualizer.git
cd GTA-III-Paths-Visualizer

• Get the required dependencies by running

npm install

• Parse PATH data out of GTA III and/or Vice City files

node parse -p "/path/to/GTA III" -g gta3 > gta3.json
node parse -p "/path/to/GTA Vice City" -g vc > gtavc.json

Example:

node parse -p "D:\\Games\\GTA III" -g gta3 > gta3.json

Rendering Paths

• Run

  npm start

• Navigate to http://localhost:4444
  • You may navigate directly to the specific game renderer by providing the game parameter in the url, e.g.: http://localhost:4444?game=gta3 or http://localhost:4444?game=vc
• In the opened page select a desired game and kind of paths to render
  • paths can be customized by providing the type parameter in the url, e.g.:
    • type=car,ped - render both cars and peds paths
    • type=car - render only cars paths
    • type=ped - render only peds paths
• To save the rendered image click the Save to file button at top left corner.

Recommended browser: Google Chrome

Licence

MIT License.