openvibers/source.openvibe.games

OpenVibe: Source

Linux-first Source SDK 2013 multiplayer project for OpenVibe: Source.

• Public identity: OpenVibe.Games — openvibe.games
• Source mod folder: game/openvibe.games
• Backend/API: backend/
• Tracked OpenVibe C++ patch sources: sdk/openvibe/
• VScript game logic: game/openvibe.games/scripts/vscripts/
• Editable maps: hammer/vmf/
• Compiled maps: game/openvibe.games/maps/
• API bridge sidecar: tools/ov-sidecar.mjs

Current State

Implemented and tested locally:

• Backend API - Fastify/TypeScript with dev auth, Steam Web API ticket auth, player profiles, shop, inventory, server registry, travel tokens, match rewards, leaderboard, admin shop management, CDN asset manifest, and optional Redis-backed sessions.
• Database - PostgreSQL migrations for players, inventory, shop, servers, join tokens, currency ledger, and match results.
• C++ GameDLL patch - tracked in sdk/openvibe/ and applied into the local Valve SDK checkout with tools/apply-openvibe-sdk.sh.
• Authenticated travel - ov_join <mode> requests /v1/travel/request, stores a join token in userinfo, and connects to the selected server.
• Server-side arrival validation - the destination server validates join tokens with /v1/travel/validate.
• OpenVibe menu hooks - VGUI commands openvibe_menu / ov_menu plus resource/GameMenu.res expose OpenVibe hub actions instead of relying on the stock server browser.
• Prop Hunt C++ disguise command - ov_prophunt_disguise <model> swaps the player to an allowlisted prop model; ov_prophunt_reset_disguise restores the player model.
• Fort Wars C++ placement command - ov_fortwars_spawn <crate|barrel|fence|plate|concrete> spawns allowlisted physics props during the build phase.
• VScript game logic - Squirrel scripts for hub, Prop Hunt, Deathrun, Fort Wars, and Traitor Town prototypes.
• Portal maps - generated VMFs and compiled BSPs use direct local connects for the current Proton fallback; set OPENVIBE_USE_OV_JOIN=1 when generating maps for a rebuilt custom client DLL.
• Sidecars - tail SRCDS logs and bridge [OV] events to the backend API.
• Production infra skeleton - Docker Compose, Docker Swarm stack, and Kubernetes manifests for API, PostgreSQL, Redis, and CDN/static assets.
• Hardening routes - party invites, capacity-aware party travel, moderation/audit events, Prometheus-style metrics, and backup tooling.

Verified locally on June 28, 2026:

• backend: TypeScript build passes.
• backend: 11 Vitest tests pass.
• Source SDK 2013 Linux64 build passes with the OpenVibe C++ patch applied.
• SRCDS smoke test passes for all five maps: ov_hub, ph_openvibe_dev, dr_openvibe_dev, fw_openvibe_dev, tt_openvibe_dev.
• Full dev stack registers all five servers and returns travel targets for hub, Prop Hunt, Deathrun, Fort Wars, and Traitor Town.

Commands

| Command | Side | Purpose |
| --- | --- | --- |
| ov_join <mode> | Client | Requests backend travel, stores join token, connects to target server. |
| ov_auth_steam | Client | Requests a Steam Web API ticket and posts it to /v1/auth/steam. |
| openvibe_menu / ov_menu | Client | Opens the OpenVibe VGUI hub menu. |
| ov_open_url <url> | Client | Opens OpenVibe web surfaces such as auth/inventory in Steam overlay/browser. |
| ov_prophunt_disguise <model> | Server | Applies allowlisted Prop Hunt disguise model. |
| ov_prophunt_reset_disguise | Server | Restores the normal player model. |
| ov_fortwars_spawn <type> | Server | Spawns allowlisted Fort Wars build props. |

Quick Start

Backend

cd ~/src/openvibe-source/backend
npm install
npm run build
npm test

Build Source SDK GameDLLs

cd ~/src/openvibe-source
tools/build-sdk-linux.sh
tools/setup-openvibe-bin.sh

tools/build-sdk-linux.sh applies sdk/openvibe/ into engine/source-sdk-2013/, patches the VPC files, and builds the HL2MP client/server Linux64 game DLLs.

Full Dev Stack

cd ~/src/openvibe-source
OPENVIBE_SRCDS_MAP_DELAY=3 tools/dev-up.sh

This starts:

• PostgreSQL
• OpenVibe API
• Hub SRCDS
• Prop Hunt SRCDS
• Deathrun SRCDS
• Fort Wars SRCDS
• Traitor Town SRCDS
• one sidecar per server

Stop everything:

cd ~/src/openvibe-source
tools/dev-down.sh

Smoke Tests

cd ~/src/openvibe-source
node tools/smoke-api.mjs
OPENVIBE_SRCDS_MAP_DELAY=3 OPENVIBE_SRCDS_SMOKE_TIMEOUT=45 tools/smoke-srcds.sh

Maps

cd ~/src/openvibe-source
node tools/generate-dev-vmfs.mjs
tools/compile-dev-maps-wine.sh

Hammer++ is currently launched as a non-Steam game with Proton Experimental. The repo also keeps direct Wine launchers:

tools/run-hammerpp.sh
tools/run-hammerpp-wined3d.sh

Recommended Hammer++ paths through Wine:

Game directory:
Z:\home\workstation\src\openvibe-source\game\openvibe.games

VMF directory:
Z:\home\workstation\src\openvibe-source\hammer\vmf

Map output:
Z:\home\workstation\src\openvibe-source\game\openvibe.games\maps

Dedicated Server Runtime

The installed Source SDK Base 2013 Dedicated Server path:

/mnt/6tb/ssd_offload/home/workstation/.steam/debian-installation/steamapps/common/Source SDK Base 2013 Dedicated Server

contains Windows server binaries in this environment. The working local Linux64 runtime is the TF2 dedicated server install at:

~/srcds/tf2

tools/run-server.sh defaults to ~/srcds/tf2 and uses the OpenVibe mod directory at game/openvibe.games.

Architecture

Source client
  -> OpenVibe VGUI menu / launcher
  -> Steam auth ticket or dev auth
  -> OpenVibe.Games API
  -> Hub SRCDS
  -> portal pads
  -> Minigame SRCDS shards

OpenVibe.Games API
  -> PostgreSQL for durable game data
  -> Redis for sessions when configured
  -> CDN/static asset manifest for cosmetics

Gameplay remains Source-style authoritative SRCDS instances. The MMO-style part is the shared OpenVibe.Games account, inventory, currency, travel, and server orchestration layer.

Local Proton builds use direct portal connects so the maps work even when the Windows client DLL has not been rebuilt. The authenticated C++ travel path is still available by regenerating maps with OPENVIBE_USE_OV_JOIN=1.

API Endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | /health | Health check |
| POST | /v1/auth/dev | Local dev auth |
| POST | /v1/auth/steam | Steam Web API ticket auth |
| GET | /v1/me?steamId= | Player profile + inventory + shop |
| GET | /v1/shop | Shop catalog |
| GET | /v1/assets/manifest | CDN-backed cosmetic asset manifest |
| POST | /v1/shop/buy | Purchase item |
| POST | /v1/equip | Equip owned item |
| GET | /v1/leaderboard | Top players by XP |
| POST | /v1/servers/register | Register game server |
| POST | /v1/servers/heartbeat | Update server status |
| GET | /v1/servers | List live servers |
| POST | /v1/travel/request | Reserve travel token |
| POST | /v1/travel/validate | Consume travel token |
| POST | /v1/parties | Create party |
| GET | /v1/parties?partyId= | Get party members |
| POST | /v1/parties/invite | Invite friend to party |
| POST | /v1/parties/invite/accept | Accept party invite |
| POST | /v1/parties/travel | Reserve one server for the whole party |
| POST | /v1/matches/end | Record match result + reward |
| POST | /v1/admin/shop/items | Admin: upsert shop item |
| POST | /v1/admin/audit/events | Admin: record moderation/audit event |
| GET | /v1/admin/audit/events | Admin: list audit events |
| GET | /metrics | Prometheus-style service metrics |

Production Configuration

Production auth requires:

• STEAM_WEB_API_KEY
• STEAM_APP_ID
• OPENVIBE_ADMIN_SECRET
• DATABASE_URL
• SESSION_REDIS_URL
• OPENVIBE_CDN_BASE_URL

Infrastructure templates live in:

• infra/docker-compose.yml
• infra/production/docker-stack.yml
• infra/kubernetes/openvibe.yaml
• infra/cdn/nginx.conf

Local database backups:

cd ~/src/openvibe-source
tools/backup-postgres.sh

Remaining Work

The foundation is running. The next real work is content and hardening:

• Replace dev models/trails with real OpenVibe cosmetic assets.
• Add real hosted CDN storage behind openvibe.games.
• Wire Steam production credentials and app identity.
• Expand Prop Hunt, Deathrun, Fort Wars, and Traitor Town into full game rules.
• Add full admin web views, alert routing, and deployment secrets management.