reVCDOS Android.md

Deploying reVCDOS on Android (Termux) via TUR Wheels

1. Executive Summary & Problem History

We are deploying the reVCDOS (GTA: Vice City WebAssembly) server on Android.

• The Issue: The dependency pydantic-core requires Rust compilation. Compiling natively on Android fails due to memory limits (LLVM ERROR: out of memory) and toolchain incompatibilities (cargo-xwin errors).
• The Fix: We bypass compilation entirely by forcing pip to download pre-compiled binaries (wheels) from the Termux User Repository (TUR).
• Network Requirement: A VPN is required because some ISPs block the TUR repository, causing SSL connect errors.

---

2. Prerequisites

1. Android Device with Termux (F-Droid version).
2. VPN Active: Essential to prevent connection errors to the custom repository.
3. Game Files: vcbr and vcsky folders extracted in /sdcard/Download.

---

3. Deployment Protocol

Phase 1: Environment Initialization

Update the system and install base tools.

# Update system
pkg update && pkg upgrade -y

# Install Python, Git, and SSL tools
pkg install python git openssl-tool -y

# Grant storage access (Tap 'Allow' on screen)
termux-setup-storage

Phase 2: The "Binary-Only" Injection (VPN Required)

Objective: Force pip to find a pre-compiled version of Pydantic that matches the available Pydantic-Core in the Termux repository, bypassing all compilation.

⚠️ CRITICAL: Ensure your VPN is ON for this step to avoid connection errors with the custom repository.

# 1. Install Pydantic (and automatically resolve Pydantic-Core binary)
# We use --only-binary=:all: to prevent pip from trying to compile newer, unsupported versions.
pip install --extra-index-url https://termux-user-repository.github.io/pypi/ --only-binary=:all: pydantic

# 2. Install the remaining web server dependencies
# (Standard pip install is fine here as these are pure Python or standard packages)
pip install fastapi uvicorn httpx python-multipart brotli

Phase 3: Project Setup

Clone the game server code.

cd $HOME
rm -rf reVCDOS # Clear previous attempts
git clone --depth 1 https://github.com/Th3w33knd/reVCDOS
cd reVCDOS

Phase 4: Asset Injection (Manual)

Import the game assets from internal storage.

# Copy Core Data (vcbr) - The game logic
cp -r /sdcard/Download/vcbr ./

# Copy Assets (vcsky) - Audio and textures (Optional)
cp -r /sdcard/Download/vcsky ./

Phase 5: Server Execution

Run the server in offline/local mode to ensure it uses the files we just copied.

python server.py --vcsky_local --vcbr_local --custom_saves

---

4. Known Error States & Fixes

Symptom	Cause	Fix
SSL connect error / No matching distribution	ISP blocking TUR Repo	Turn on VPN and retry Phase 2.
Linker command failed / Aborted	Pip tried to compile source	Ensure you used --only-binary=:all: in Phase 2.
Could not find version for maturin	Maturin isn't in TUR	Ignore it. We don't need maturin when using binaries. Remove it from the install command.
Black Screen in Browser	Missing Game Files	Re-run Phase 4. Ensure vcbr folder contains .wasm files.

---

5. Final Success State

• Server is running in Termux.
• User opens Chrome to http://localhost:8000.
• Game loads without compilation errors.