Desenvolvedores

Tudo é scriptável.
Tudo é integrável.

O uVersion oferece um CLI completo, uma API REST documentada e plugins nativos para as IDEs usadas no desenvolvimento de jogos. Se você programa seu pipeline, a gente se integra.

CLI `uversion`

O binário uversion.exe (~6 MB) cobre todas as operações de VCS e expõe uma saída --json para parsear a partir de qualquer script.

As credenciais são compartilhadas com o cliente desktop pelo keyring do sistema, sem login duplicado. O chunking CDC, a compressão zstd e o rastreamento de .uversionignore são idênticos aos do cliente desktop.

Referência completa do CLI →

# 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

Plugins de editor

Integração nativa nas IDEs usadas para o desenvolvimento na Unreal.

Plugin Unreal Engine

Disponível

Source Control Provider integrado ao editor. UE 5.6 e superior. Distribuído como binário pré-compilado: o cliente desktop o instala para você no projeto e avisa sobre as atualizações, por versão da Unreal e por plataforma. Sem ZIP para extrair.

Checkout / Checkin / Revert a partir do Content Browser
Diff visual de Blueprint integrado
Validação antes do checkin com 10 regras integradas
Auto-checkout ao modificar
Auto-login via Windows Credential Manager
Reconcile na inicialização (Content/ + Plugins/*/Content/)

Documentação →

Plugin Rider

Disponível

Integração VCS para o JetBrains Rider, a IDE de referência do desenvolvimento de jogos na Unreal.

Refresh / Update / Checkin / Revert pelo menu VCS
Delega ao CLI uversion por baixo dos panos
Filtra por extensões de código (.cpp, .h, .cs, .uproject)
Autenticação compartilhada com o cliente desktop

Plugin Visual Studio

Coming soon

Integração VCS no Visual Studio 2022+ para os desenvolvedores C++ que permanecem na IDE da Microsoft. As mesmas funções do plugin do Rider, expostas no menu Team Explorer.

Extension VS Code

Coming soon

Extensão do VS Code para scripting, edição de config e escrita de documentação do projeto sem sair do editor. Ícones de status no explorador, checkout / checkin pela paleta de comandos.

API REST

O servidor uVersion expõe uma API HTTP JSON autenticada por JWT. Todas as operações do cliente (auth, repos, files, locks, comments, builds) estão disponíveis via REST.

POST /api/auth/login: obtém um JWT de 30 dias
POST /api/auth/refresh: renova sem digitar a senha de novo
GET /api/repositories: lista os repos acessíveis
POST /api/files/{repo_id}/upload-chunks: upload binário em chunks
POST /api/locks/{repo_id}/acquire: bloquear arquivos
POST /api/builds/{repo_id}/upload: publicar uma build de playtest

Referência completa da API →

# Obter a lista de repos

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

# Resposta

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

CI/CD

O CLI uversion foi feito para pipelines automatizados. Modo --json, códigos de retorno padrão, JWT de longa duração (30 dias) renovável sem digitar a senha de novo.

# .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

Confiável e rápido

Binário de servidor nativo, cliente desktop leve (poucos MB, abertura instantânea), upload e download massivamente paralelizados para arquivos grandes. Autenticação JWT, senhas com hash conforme os padrões, auditoria completa das ações sensíveis. Servidor na sua própria infraestrutura com TLS autoassinado: o cliente fixa a impressão digital no primeiro contato (TOFU), uversion trust para automatizar a confiança na CI.

Mergulhe na documentação.

Ler o wiki Referência do CLI

Tudo é scriptável.Tudo é integrável.

CLI uversion