GTA Vice City — HTML5 Port (DOS Zone)

Web-based port of GTA: Vice City running in browser via WebAssembly.

Requirements

• Python 3.8+
• Dependencies from requirements.txt

Setup & Running

Option 1: Using Docker (Recommended)

The easiest way to get started is using Docker Compose:

docker compose up -d --build

To configure server options via environment variables:

# Set port, enable auth and custom saves
IN_PORT=3000 AUTH_LOGIN=admin AUTH_PASSWORD=secret CUSTOM_SAVES=1 docker compose up -d --build

Environment Variable	Description
OUT_HOST	External host (default: 0.0.0.0)
OUT_PORT	External port (default: 8000)
IN_PORT	Internal container port (default: 8000)
AUTH_LOGIN	HTTP Basic Auth username
AUTH_PASSWORD	HTTP Basic Auth password
CUSTOM_SAVES	Enable local saves (set to 1)
VCSKY_LOCAL	Serve vcsky from local directory (set to 1)
VCBR_LOCAL	Serve vcbr from local directory (set to 1)
VCSKY_URL	Custom vcsky proxy URL
VCBR_URL	Custom vcbr proxy URL

Option 2: Local Installation

1. Install Python dependencies:

pip install -r requirements.txt

2. Start the server:

python server.py

Server starts at http://localhost:8000

Server Options

Option	Type	Default	Description
--port	int	8000	Server port
--custom_saves	flag	disabled	Enable local save files (saves router)
--login	string	none	HTTP Basic Auth username
--password	string	none	HTTP Basic Auth password
--vcsky_local	flag	disabled	Serve vcsky from local vcsky/ directory
--vcbr_local	flag	disabled	Serve vcbr from local vcbr/ directory
--vcsky_url	string	https://cdn.dos.zone/vcsky/	Custom vcsky proxy URL
--vcbr_url	string	https://br.cdn.dos.zone/vcsky/	Custom vcbr proxy URL

Examples:

# Start on custom port
python server.py --port 3000

# Enable local saves
python server.py --custom_saves

# Enable HTTP Basic Authentication
python server.py --login admin --password secret123

# Use local vcsky and vcbr files (offline mode)
python server.py --vcsky_local --vcbr_local

# Use custom proxy URLs
python server.py --vcsky_url https://my-cdn.example.com/vcsky/ --vcbr_url https://my-cdn.example.com/vcbr/

# All options combined
python server.py --port 3000 --custom_saves --login admin --password secret123 --vcsky_local --vcbr_local

Note: HTTP Basic Auth is only enabled when both --login and --password are provided.

Note: By default, vcsky and vcbr are proxied from DOS Zone CDN. Use --vcsky_local and --vcbr_local flags to serve files from local directories instead.

URL Parameters

Parameter	Values	Description
lang	en, ru	Game language
cheats	1	Enable cheat menu (F3)

Examples:

• http://localhost:8000/?lang=ru — Russian version
• http://localhost:8000/?lang=en&cheats=1 — English + cheats

Project Structure

├── server.py           # FastAPI proxy server
├── requirements.txt    # Python dependencies
├── additions/          # Server extensions
│   ├── auth.py         # HTTP Basic Auth middleware
│   └── saves.py        # Local saves router
├── dist/               # Game client files
│   ├── index.html      # Main page
│   ├── game.js         # Game loader
│   ├── index.js        # Module loader
│   ├── GamepadEmulator.js  # Touch controls
│   ├── idbfs.js        # IndexedDB filesystem
│   ├── jsdos-cloud-sdk.js  # Cloud saves (DOS Zone)
│   ├── jsdos-cloud-sdk-local.js  # Local saves (--custom_saves)
│   └── modules/        # WASM modules
│       ├── runtime.js      # WASM runtime initialization
│       ├── loader.js       # Asset/package loading
│       ├── fs.js           # Virtual filesystem
│       ├── audio.js        # Audio system
│       ├── graphics.js     # Rendering pipeline
│       ├── events.js       # Input events handling
│       ├── fetch.js        # Network requests (Real-time asset streaming)
│       ├── syscalls.js     # System calls
│       ├── main.js         # Main entry point
│       ├── cheats.js       # Cheat engine (F3)
│       ├── asm_consts/     # Language-specific ASM constants
│       │   ├── en.js
│       │   └── ru.js
│       └── packages/       # Language-specific data packages
│           ├── en.js
│           └── ru.js
├── vcbr/               # Brotli-compressed game data (optional)
│   ├── vc-sky-en-v6.data.br
│   ├── vc-sky-en-v6.wasm.br
│   ├── vc-sky-ru-v6.data.br
│   └── vc-sky-ru-v6.wasm.br
└── vcsky/              # Additional assets (optional)
    ├── data/
    ├── audio/
    ├── models/
    └── anim/

Features

• 🎮 Gamepad emulation for touch devices
• ☁️ Cloud saves via js-dos key
• 💾 Local saves (with --custom_saves flag)
• 🌍 English/Russian language support
• 🔧 Built-in cheat engine (memory scanner, cheats)
• 📱 Mobile touch controls

Local Saves

When local saves are enabled (--custom_saves flag), enter any 5-character identifier in the "js-dos key" input field on the start page. This identifier will be used to store your saves in the saves/ directory on the server.

Example: Enter mykey or 12345 — saves will be stored as mykey_vcsky.saves or 12345_vcsky.saves.

Controls (Touch)

Touch controls appear automatically on mobile devices. Virtual joysticks for movement and camera, context-sensitive action buttons.

Cheats

Enable with ?cheats=1, press F3 to open menu:

• Memory scanner (find/edit values)
• All classic GTA VC cheats
• AirBreak (noclip mode)

License

Do what you want. Not affiliated with Rockstar Games.

---

Authors: DOS Zone (@specialist003, @caiiiycuk, @SerGen)

Deobfuscated by: @Lolendor

Russian translation: GamesVoice

Support me

If you find this project useful:

• TON / USDT (TON) UQAyBchGEKi9NnNQ3AKMQMuO-SGEhMIAKFAbkwwrsiOPj9Gy