NEVR Runtime

Overview

Runtime patches for Echo VR (echovr.exe) that enable it to connect to echovrce community game services. Both the game client and dedicated game server use these DLLs to communicate with the Nakama-based backend.

Part of the nEVR project — keeping Echo VR alive.

Components

Core DLLs

• gamepatches → dbgcore.dll — Runtime game modifications (CLI flags, headless/server modes, Detours-based hooks). Used by both client and dedicated server.
• gameserver → pnsradgameserver.dll — Game server networking (session management, events, external service communication). Used by the dedicated server only.
• telemetryagent — Game state monitoring and telemetry streaming

Quest Runtime

• quest — Standalone runtime patches for Oculus Quest (Android/ARM64)

Legacy Components

• gamepatcheslegacy — Frozen v1 implementation (self-contained with local common/)
• gameserverlegacy — Frozen v1 implementation (self-contained with local common/)

Development Tools

• dbghooks — Debugging hooks and function tracing for reverse engineering
• supervisor — PowerShell scripts for server orchestration (firewall, ports, instance management)

Shared Code

• common — Shared utilities (logging, globals, base64, symbol resolution)
• protobufnevr — Protocol buffer code generation from extern/nevr-proto submodule

Directory Structure

nevr-runtime/
├── src/
│   ├── gamepatches/         # Game runtime patches DLL (PC)
│   ├── gameserver/          # Game server networking DLL (PC)
│   ├── quest/               # Quest standalone runtime (Android/ARM64)
│   ├── telemetryagent/      # Telemetry collection DLL
│   ├── legacy/              # Frozen v1 implementations
│   ├── common/              # Shared C++ utilities
│   └── protobufnevr/        # Protocol buffer definitions
├── extern/                  # External dependencies (minhook, nevr-proto)
├── cmake/                   # Build configuration helpers
├── scripts/                 # Build scripts (Wine cross-compilation)
├── docs/                    # Documentation
├── CMakeLists.txt           # Top-level CMake configuration
├── CMakePresets.json        # CMake build presets
├── vcpkg.json               # Dependency manifest
└── Makefile                 # Build convenience wrapper

Building the Project

Prerequisites

• CMake 3.20 or higher Download
• One of:
  • MinGW (cross-compile from Linux) - Recommended
  • MSVC via Wine (Linux with Windows SDK mounted)
  • Visual Studio 2022 (native Windows)

MinGW Build (Linux - Recommended)

make configure  # Configure with MinGW toolchain
make build      # Build all components

MSVC via Wine (Linux)

./scripts/setup-msvc-wine.sh   # One-time setup
./scripts/build-with-wine.sh   # Full build using MSVC via Wine

Visual Studio (Windows)

Open the command palette (CTRL+P) and CMake build, when asked to select a kit, select Visual Studio Community 2022 Release - x86_amd64.

Or from command line:

mkdir build
cd build
cmake ..
cmake --build .

Usage

After building, DLL artifacts are in build/mingw-release/bin/ (MinGW) or build/release/bin/ (MSVC):

• gamepatches.dll → Deploy as dbgcore.dll to game directory
• gameserver.dll → Deploy as pnsradgameserver.dll to game directory
• dbghooks.dll → For debugging/development only
• telemetryagent.dll → For telemetry collection

See component-specific README files for detailed usage.

Architecture & Data Flow

• GamePatches and GameServer are loaded into the game process (DLLs)
• GameServer communicates with the game via in-process hooks and with external services (ServerDB, WebSocket, HTTP)
• TelemetryAgent polls game state via HTTP API or direct memory access
• All protocol types are defined in extern/nevr-proto submodule

Related Projects

Project	Description
nevr-runtime (this repo)	Runtime patches for echovr.exe (PC + Quest)
nevr-server	Custom game server (Rust)
nakama	echovrce game service backend

Development

Build Scripts

• scripts/build-with-wine.sh - End-to-end MSVC build via Wine
• scripts/cl-wine.sh, lib-wine.sh, link-wine.sh - MSVC toolchain wrappers
• scripts/protoc-wine.sh - Protobuf compiler wrapper
• scripts/setup-msvc-wine.sh - Wine environment setup

Local Configuration

Add local customizations to cmake/local.cmake (auto-included if exists). This file can override settings or add custom install rules.

Example:

# Deploy DLLs to game directory after build
set(GAME_DIR "C:/Program Files/Echo VR")
add_custom_command(TARGET gamepatches POST_BUILD
    COMMAND ${CMAKE_COMMAND} -E copy $<TARGET_FILE:gamepatches> "${GAME_DIR}/dbgcore.dll"
)

Dependencies

Dependencies are managed via vcpkg (see vcpkg.json):

• curl - HTTP client for external API communication
• jsoncpp - JSON parsing
• minhook - Function hooking (Windows API)
• opus - Audio codec
• protobuf - Protocol buffer serialization

External submodules (in extern/):

• nevr-proto - Shared protocol definitions and game structures

Project Conventions

• Logging: Use Log(level, format, ...) from common/logging.h
• Game flags: CLI/mode flags (isHeadless, isServer) are in gamepatches/patches.cpp
• Protocol messages: Symbol IDs defined in gameserver/messages.h
• Protobuf: All types generated from extern/nevr-proto - never edit generated files

Distribution

Create distribution packages:

make dist       # Full package with debug symbols
make dist-lite  # Stripped binaries without debug symbols

Outputs:

• dist/nevr-runtime-v{VERSION}.tar.zst
• dist/nevr-runtime-v{VERSION}.zip
• dist/nevr-runtime-v{VERSION}-lite.tar.zst
• dist/nevr-runtime-v{VERSION}-lite.zip

License

See LICENSE file for details.