{"id":13530738,"url":"https://github.com/kvark/vange-rs","last_synced_at":"2025-04-08T08:15:39.195Z","repository":{"id":9072443,"uuid":"60730286","full_name":"kvark/vange-rs","owner":"kvark","description":"Rusty Vangers clone","archived":false,"fork":false,"pushed_at":"2024-12-09T07:54:38.000Z","size":13333,"stargazers_count":446,"open_issues_count":46,"forks_count":19,"subscribers_count":17,"default_branch":"master","last_synced_at":"2025-04-01T05:38:14.697Z","etag":null,"topics":["game","graphics","rust","wgpu"],"latest_commit_sha":null,"homepage":"https://vange.rs","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kvark.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-06-08T20:57:32.000Z","updated_at":"2025-03-26T09:54:49.000Z","dependencies_parsed_at":"2024-01-03T03:58:06.476Z","dependency_job_id":"4f9bfa92-b9d4-4fd4-ba16-cf333af5b796","html_url":"https://github.com/kvark/vange-rs","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kvark%2Fvange-rs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kvark%2Fvange-rs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kvark%2Fvange-rs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kvark%2Fvange-rs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kvark","download_url":"https://codeload.github.com/kvark/vange-rs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247801175,"owners_count":20998339,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["game","graphics","rust","wgpu"],"created_at":"2024-08-01T07:00:54.360Z","updated_at":"2025-04-08T08:15:39.158Z","avatar_url":"https://github.com/kvark.png","language":"Rust","funding_links":[],"categories":["Racing"],"sub_categories":[],"readme":"# Vange-rs\n![Check](https://github.com/kvark/vange-rs/workflows/Check/badge.svg)\n[![Gitter](https://badges.gitter.im/kvark/vange-rs.svg)](https://gitter.im/vange-rs/Lobby?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge)\n\n[Vangers](https://www.gog.com/game/vangers) is a legendary game featuring unique gameplay and technical innovation.\nThe idea of this project is to replicate the old look and behavior, but with native hardware acceleration for the graphics.\n\nYou need the **original game** in order to try out `vange-rs`. The path to resources needs to be set in `config/settings.ron`.\n\n![logo](docs/assets/logo-cut.png)\n\n## Technology\n\nThe game uses:\n  - [wgpu](https://github.com/gfx-rs/wgpu) for graphics\n  - [winit](https://github.com/rust-windowing/winit) for windowing\n  - [egui](https://github.com/emilk/egui) for debug UI\n\nThe level can be rendered in a variety of ways, see [dedicated wiki page](https://github.com/kvark/vange-rs/wiki/Rendering-Techniques). The best of all is a voxelized ray tracing method, described [in our blog](https://vange.rs/2022/11/08/voxels.html).\n\n## Instructions\n\nThe project is structured to provide multiple binaries. `road` binary is for the main game, which includes mechouses, items, and the level. You can find the binaries produced automatically in the [releases](https://github.com/kvark/vange-rs/releases).\n\n\n```bash\ngit clone https://github.com/kvark/vange-rs\ncd vange-rs\ncp config/settings.template.ron config/settings.ron\nedit config/settings.ron # set the game path\ncargo run\n```\n\nNote: leaving the `level=\"\"` empty in the config would load a flat boring debug level.\n\nNote: with `backend=\"Auto\"` the engine tries the available backends in this order: Metal, Vulkan, DX12.\n\nControls:\n  - `WSAD`: movement in the game, rotating the camera around the car during the pause\n  - left shift: turbo\n  - left alt: jump\n  - `P`: enter/exit pause for debugging\n  - `R`: reset forces and orientation of the mechous\n  - `\u003c\u003e`: step physics frame back/forward during the pause\n  - `Esc`: exit\n\n\u003cimg alt=\"game\" src=\"etc/shots/Road11-pause.png\" width=\"25%\"\u003e\n\n### 3D model viewer\n`model` binary loads a selected \"m3d\" from games resource to observe.\n```bash\ncargo run --bin model resource/m3d/items/i21.m3d\n```\nControls:\n  - `AD`: rotate the camera\n  - `Esc`: exit\n\n\u003cimg alt=\"item view\" src=\"etc/shots/Road6a-item.png\" width=\"20%\"\u003e\n\nWithout the argument, the viewer shows configured car and debug collision info:\n\n\u003cimg alt=\"mechous debugging\" src=\"etc/shots/Road10-debug-shape.png\" width=\"25%\"\u003e\n\n### Level viewer\n`level` binary allows to fly over a level with free camera. Useful for debugging the level rendering shader.\n```bash\ncargo run --bin level\ncargo run --bin level -- resource/iscreen/ldata/l0/escave.ini # load menu\n```\nControls:\n  - `WSAD`: move the camera along X-Y plane\n  - `ZX`: move the camera along Z plane\n  - `Alt` + `WSAD`: rotate the camera\n  - `Esc`: exit\n\n\u003cimg alt=\"level view\" src=\"etc/shots/Road16-raymax.png\" width=\"50%\"\u003e\n\n### Converter\n`convert` binary is a command line utility for converting the game data into formats that are more interoperable. Please see the [wiki page](https://github.com/kvark/vange-rs/wiki/Resource-Converter) for the usage instructions.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkvark%2Fvange-rs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkvark%2Fvange-rs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkvark%2Fvange-rs/lists"}