Rusty Vangers clone
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md

Vange-rs

Build Status Gitter

Vangers is a legendary game featuring unique gameplay and technical innovation. The idea of this project is to replicate the old look and behavior, but with native hardware acceleration for the graphics.

You need the original game in order to try out vange-rs. The path to resources needs to be set in config/settings.ron.

Instructions

The project is structured to provide multiple binaries. road binary is for the main game, which includes mechouses, items, and the level. Note: leaving the level="" empty in the config would load a flat boring debug level.

git clone https://github.com/kvark/vange-rs
cd vange-rs
cp config/settings.template.ron config/settings.ron
vi config/settings.toml # set the game path
cargo run --bin road

Controls:

  • WSAD: movement in the game, rotating the camera around the car during the pause
  • P: enter/exit pause for debugging
  • R: reset forces and orientation of the mechous
  • <>: step physics frame back/forward during the pause
  • Esc: exit

game

Mechous viewer/debugger

car binary allows to see the mechos with items selected by the configuration. It also shows the debug collision info.

cargo run --bin car

Controls:

  • WSAD: rotate the camera
  • Esc: exit

mechous debugging

3D model viewer

model binary loads a selected "m3d" from games resource to observe.

cargo run --bin model resource/m3d/items/i21.m3d

Controls:

  • AD: rotate the camera
  • Esc: exit

item view

Level viewer

level binary allows to fly over a level with free camera. Useful for debugging the level rendering shader.

cargo run --bin level

Controls:

  • WSAD: move the camera along X-Y plane
  • ZX: move the camera along Z plane
  • Alt + WSAD: rotate the camera
  • Esc: exit

level view (ray)

level view (tess)

Converter

convert binary is a command line utility for converting the game data into formats that are more interoperable. Basically you provide 2 arguments as fully-qualified file names (can be relative, but relative to the current directory - the settings paths are not used here), and the converter figures out the way to convert one into another. Note that only part after "--" makes sense when running a standalone binary.

Model (M3D) -> OBJ+RON

cargo run --bin convert -- resource/m3d/items/i21.m3d my_dir/model.ron

The body, wheels, and debris are saved as separate Wavefront OBJ files near the target RON, which contains model meta-data.

OBJ+RON -> Model(M3D)

You can change the OBJ files using popular mesh editors, save them, and even manually tweak RON, after which you may want to generate a new M3D file:

cargo run --bin convert -- my_dir/model.ron resource/m3d/items/i21-new.m3d

modified model

Level(INI+VMC/VMP) -> Image(BMP/PNG/TGA)

cargo run --bin convert -- thechain/fostral/world.ini my_dir/fostral.bmp

The output image contains the following info in the RGBA channels:

  • R stands for the bottom layer height
  • G stands for the top layer height
  • B stands for the delta between the bottom and the ground above
  • low 4 bits of A contain the material index of the bottom layer
  • high 4 bits of A contain the material index of the top layer

Image(BMP/PNG/TGA)+INI -> Level(VMP)

You can change the image in a photo editor, and then we can import it as a non-compressed level:

cargo run --bin convert -- my_dir/fostral.bmp thechain/fostral/world.ini

This command would write the VMP file in the target level. If you want the game to use it, set "Compressed Format Using = 0" in the INI file.

modified level

Technonolgy

The game uses gfx-rs pre-LL for graphics and glutin for context creation.

The level is drawn in a single full-screen draw call with a bit of ray tracing magic. There is also an experimental tessellation-based renderer, but neither produce results of sufficient quality.