Developers

Everything is scriptable.
Everything is integrable.

uVersion exposes a full CLI, a documented REST API, and native plugins for the IDEs used in game development. If you script your pipeline, we plug in.

CLI `uversion`

The uversion.exe binary (~6 MB) covers every VCS operation and provides --json output to parse from any script.

Credentials are shared with the desktop client through the system keyring, no double login. CDC chunking, zstd compression and .uversionignore tracking are identical to the desktop client.

Full CLI reference →

# Login + clone + checkin

$ uversion login https://team.uversion.io --username alex.dev

✓ Authenticated as alex.dev

$ uversion clone hero-rpg ./HeroRPG

Cloning to ./HeroRPG ...

✓ 8,432 files in 47s

$ uversion checkout Content/Characters/Hero.uasset

✓ Lock acquired

$ uversion checkin -m "Hero pose pass"

✓ Committed as 7f3a9b1

Editor plugins

Native integration into the IDEs used for Unreal development.

Plugin Unreal Engine

Available

Source Control Provider built into the editor. UE 5.6 and later. Shipped as a precompiled binary: the desktop client installs it into the project for you and flags updates, per Unreal version and per platform. No ZIP to extract.

Checkout / Checkin / Revert from the Content Browser
Built-in visual Blueprint diff
Pre-checkin validation with 10 built-in rules
Auto-checkout on modification
Auto-login via Windows Credential Manager
Reconcile at startup (Content/ + Plugins/*/Content/)

Documentation →

Plugin Rider

Available

VCS integration for JetBrains Rider, the go-to IDE for Unreal game development.

Refresh / Update / Checkin / Revert via the VCS menu
Delegates to the uversion CLI under the hood
Filters on source extensions (.cpp, .h, .cs, .uproject)
Auth shared with the desktop client

Plugin Visual Studio

Coming soon

VCS integration in Visual Studio 2022+ for C++ developers who stay on Microsoft's IDE. Same features as the Rider plugin, exposed in the Team Explorer menu.

Extension VS Code

Coming soon

VS Code extension for scripting, config editing, and writing project documentation without leaving the editor. Status icons in the explorer, checkout / checkin via the command palette.

API REST

The uVersion server exposes a JSON HTTP API authenticated with JWT. Every client operation (auth, repos, files, locks, comments, builds) is available over REST.

POST /api/auth/login: get a 30-day JWT
POST /api/auth/refresh: refresh without re-entering the password
GET /api/repositories: list accessible repos
POST /api/files/{repo_id}/upload-chunks: chunked binary upload
POST /api/locks/{repo_id}/acquire: lock files
POST /api/builds/{repo_id}/upload: publish a playtest build

Full API reference →

# Get the list of repos

curl -X GET https://team.uversion.io/api/repositories \
  -H "Authorization: Bearer $UV_TOKEN"

# Response

{
  "success": true,
  "data": [
    {
      "id": 12,
      "name": "hero-rpg",
      "owner": "acme",
      "current_revision": "7f3a9b1...",
      "file_count": 8432,
      "size_bytes": 14211938405
    }
  ]
}

CI/CD

The uversion CLI is built for automated pipelines. --json mode, standard return codes, long-lived JWT (30 days) renewable without re-entering the password.

# .github/workflows/build.yml

name: Nightly build
on:
  schedule: [{ cron: '0 2 * * *' }]
jobs:
  build:
    runs-on: [self-hosted, unreal]
    steps:
      - name: Login + sync from uVersion
        env:
          UV_SERVER: ${{ secrets.UV_SERVER }}
          UV_USER: ${{ secrets.UV_USER }}
          UV_PASSWORD: ${{ secrets.UV_PASSWORD }}
        run: |
          uversion login "$UV_SERVER" --username "$UV_USER" --password "$UV_PASSWORD" --json
          uversion clone hero-rpg ./project --json
          uversion sync --json
      - name: Build packaged client
        run: |
          ./project/Engine/Build/BatchFiles/RunUAT.bat \
            BuildCookRun -project=./project/HeroRPG.uproject \
            -clientconfig=Development -platform=Win64

Reliable and fast

Native server binary, lightweight desktop client (a few MB, instant launch), massively parallel upload and download for large files. JWT authentication, passwords hashed to modern standards, full audit of sensitive actions. Server on your own infrastructure with self-signed TLS: the client pins the fingerprint on first contact (TOFU), uversion trust to script trust in CI.

Dive into the docs.

Read the wiki CLI reference

Everything is scriptable.Everything is integrable.

CLI uversion