Ultimate Odycer

Documentación y primera prueba de juego

Configura una instancia, conecta un cliente y prueba tu primer mundo en línea.

Leer las preguntas frecuentes

  1. Instalar una instancia de evaluación

    Lee las notas, verifica el SHA-256 y sigue la guía de la versión. Configura PostgreSQL, las migraciones y TLS. Mantén PostgreSQL y WebAdmin en una red o interfaz privada.

    Descargar el servidorGuía de VPS (en francés)
  2. Conectar los primeros clientes

    Usa un proyecto Godot/C# compatible. Configura los puntos de acceso a Login y Game. Crea dos cuentas de prueba y verifica que ambas entran en el mismo mundo.

    Documentación técnica (en inglés)
  3. Crear un primer ciclo jugable con IA

    Pide a Codex o Claude Code un cambio revisable cada vez. Empieza con un mapa pequeño, un PNJ, una misión y una recompensa. Importa las exportaciones versionadas de los talleres disponibles y prueba el resultado en Godot y en el servidor.

    Talleres de Codex
  4. Preparar la preproducción

    Comprueba personaje y recompensa al reconectar y reiniciar. Restaura una copia de seguridad en aislamiento, revisa registros y mide la carga. Conserva esa versión cuando supere las pruebas de preproducción.

Instalar el servidor en un VPS

Evaluación en un VPS Linux x86-64 con PostgreSQL y TLS. Consigue por separado un cliente compatible. Las órdenes ilustran un primer arranque en Debian o Ubuntu. Revisa los requisitos del paquete elegido.

  1. Preparar el VPS y la red privada

    Usa una cuenta SSH sin privilegios de root y con sudo. Comprueba x86_64 y glibc e instala PostgreSQL y las dependencias. Mantén PostgreSQL, la API y WebAdmin en local. Prepara una red privada o VPN accesible desde los dos equipos de prueba.

    uname -m
    getconf GNU_LIBC_VERSION
    sudo apt update
    sudo apt install postgresql libpq5 openssl ca-certificates
    pg_isready
  2. Descargar, verificar y extraer

    Descarga el paquete Linux x86-64 y su archivo .sha256 desde Versiones. Sustituye el nombre de ejemplo por el real. Compara también la suma con la página oficial y detente si difiere. Entra en la carpeta extraída y busca bibliotecas que falten.

    archive=ultimate-odycer-server-dev-20261106.2-linux-x86_64.tar.gz
    sha256sum -c "$archive.sha256" && tar -xzf "$archive" &&
      cd "${archive%.tar.gz}" && ldd ./bin/mmorpg-server && ldd ./bin/login-server
    Descargar el servidor
  3. Crear una base de datos dedicada

    Crea un rol y su base en PostgreSQL de evaluación. Usa una contraseña exclusiva cuando se te pida. La última orden verifica el acceso TCP local.

    sudo -u postgres createuser --pwprompt odycer_test
    sudo -u postgres createdb --owner=odycer_test ultimate_odycer_test
    psql -h 127.0.0.1 -U odycer_test -d ultimate_odycer_test -c "SELECT current_user;"
  4. Configurar el servidor y TLS

    Copia config.example.json como config.json y protege el archivo. Ajusta db_host, db_port, db_name, db_user y db_password en server. Mantén network.enable_tls en true. Coloca el certificado y la clave en network.tls_cert_path y tls_key_path. Los clientes deben confiar en el certificado y este debe coincidir con el nombre o IP usado. Comparte JWT_SECRET entre Game y Login. Extrae el paquete con la cuenta que ejecutará los binarios o dale acceso a los archivos necesarios. Utiliza rutas TLS absolutas para servicios iniciados por separado y comprueba que ambos puedan leer el certificado y la clave.

    cp -n config.example.json config.json
    chmod 600 config.json
    (umask 077; set -C; printf "JWT_SECRET=%s
    " "$(openssl rand -hex 32)" > .odycer-runtime.env)
  5. Iniciar Game y después Login, una vez terminadas las migraciones

    Abre dos sesiones SSH en la carpeta extraída. Carga el mismo archivo de entorno en ambas sin mostrarlo. Con una base vacía inicia solo Game. Espera a que terminen las migraciones PostgreSQL y a que Game y WebAdmin escuchen. Inicia Login en la segunda sesión. Arrancar ambos a la vez puede causar un error de relación duplicada y activar SQLite como alternativa. Si los registros lo indican, corrige PostgreSQL antes de continuar.

    Game

    set -a; . ./.odycer-runtime.env; set +a
    ./bin/mmorpg-server
    ss -ltn

    Login

    set -a; . ./.odycer-runtime.env; set +a
    ./bin/login-server
  6. Abrir WebAdmin y autorizar los clientes de prueba

    Tras las migraciones, ejecuta bootstrap-admin y cambia la contraseña temporal en el primer acceso mediante el túnel SSH. Para probar a distancia asigna a server.login_ip y server.server_ip una IP privada accesible, reinicia y permite solo la red de prueba en TCP 2106 y 7777. Login anuncia la dirección de Game. Comprueba su alcance y el certificado TLS. Mantén 5432, 8080 y 8082 fuera de la red pública. Ejecuta el bootstrap con la misma cuenta del sistema, carpeta de trabajo y configuración de PostgreSQL que Game. Si cambias de usuario, usa el directorio personal de la cuenta de servicio.

    VPS

    set -a; . ./.odycer-runtime.env; set +a
    ./bin/bootstrap-admin

    SSH → WebAdmin

    ssh -N -L 8082:127.0.0.1:8082 operator@vps.example.com
    # http://127.0.0.1:8082/
  7. Registrar el resultado y crear una copia

    Desde un puesto de prueba verifica Login y la entrada en Game. Si falla la entrada al mundo, comprueba la dirección anunciada, el cortafuegos y la confianza TLS. Guarda base, configuración y versión. Restaura la copia en una instancia aislada antes de abrir al público.

    umask 077
    pg_dump -h 127.0.0.1 -U odycer_test -Fc -f odycer-test.dump ultimate_odycer_test
    pg_restore --list odycer-test.dump

Crear un primer MMORPG jugable con Codex o Claude Code

Objetivo del prototipo: dos jugadores en el mismo mundo, una misión y una recompensa persistente. Consigue un proyecto Godot compatible con el servidor. El paquete del servidor se distribuye por separado.

  1. Preparar el proyecto Godot

    Abre el cliente en Godot 4 .NET con el SDK .NET que requiera el proyecto. Anota las versiones de servidor, cliente y protocolo. Usa Git, una rama específica, una instancia y cuentas de prueba.

    Godot .NET / C#
  2. Dar la primera tarea al asistente

    Abre la carpeta con Codex o Claude Code. Facilita el contrato de red, la configuración sin secretos y el resultado esperado. Pide un cambio verificable cada vez y revisa las diferencias. Ejemplo: « Localiza la configuración de Login y Game, propón el cambio mínimo para conectar el cliente de prueba y explica cómo probarlo ».

    CodexClaude Code
  3. Conectar primero un cliente

    Configura la dirección de Login mediante el mecanismo del proyecto y verifica la de Game. Crea dos cuentas con el flujo compatible con tu versión. Con la primera, crea o selecciona un personaje y entra en la zona de prueba. Resuelve primero errores de versión, certificado o conexión. Comprueba el registro de recursos que esperan el cliente y el servidor. El paquete dev-20261106.2 no incluye asset_registry.json. Si el cliente requiere una huella, usa el registro que acompaña a su proyecto o genéralo a partir de las plantillas del servidor y los recursos del cliente con la herramienta del proyecto. Cárgalo en la instancia de prueba y reinicia Game antes de configurar la misma huella en el cliente.

  4. Crear un ciclo de juego

    Crea un mapa pequeño, un punto de aparición, un PNJ y una misión simple. Habla con el PNJ, recoge un objeto y regresa para cobrar la recompensa. Importa las exportaciones en formatos compatibles y prueba en Godot y en el servidor. Pide reutilizar las rutas de objetivos, inventario y recompensas del servidor.

    Talleres de Codex
  5. Arrancar dos clientes Godot

    En Godot usa Debug → Customize Run Instances y elige dos instancias o abre dos compilaciones de escritorio en equipos separados. Usa perfiles o directorios de usuario distintos si el cliente recuerda la cuenta. Conecta A y B al mismo servidor y zona. Para la prueba gráfica, elige una compilación completa de C# con sus recursos y compatible con el sistema operativo y el controlador gráfico de los equipos de prueba. Si ejecutas el proyecto fuente, usa las versiones de Godot .NET y del SDK de .NET que indique. Una exportación para Windows se ejecuta en un equipo Windows con escritorio y puede conectarse al servidor en un VPS Linux. Una pantalla virtual X11 es una opción para una compilación Linux compatible con el controlador del VPS. Conserva el manifiesto incluido en la compilación, verifica sus archivos y autoriza su huella en el registro de Game. Si el cliente fuente indica que el inventario ha cambiado, regenera el manifiesto con la herramienta del proyecto y actualiza el registro del servidor de pruebas. La cuenta de ejecución debe poder leer los archivos y escribir en su perfil. Captura cada ventana antes y después del reinicio.

    Godot · Customize Run Instances
  6. Verificar el multijugador y la persistencia

    Confirma que ambos personajes se ven y que B ve moverse a A. Completa la misión con A. Comprueba que A recibe una sola recompensa y B ninguna. Reconecta A y reinicia el servidor de prueba de forma controlada. Comprueba personaje, inventario y recompensa.

  7. Registrar resultados y resolver fallos

    Anota versiones, cuentas de prueba, pasos y resultados esperados y observados sin conservar secretos. Si los clientes no se ven, compara zona, instancia y versión. Si falta la recompensa tras el reinicio, comprueba el guardado del servidor. Al superar las pruebas tendrás un prototipo multijugador jugable. El escenario de misión y recompensa tras reiniciar Game y Login en el VPS se verificó con dos clientes de prueba. Con dos ventanas de la exportación completa de Ultody2 para Windows se verificó la eliminación del goblin y la conservación del progreso y de ambos inventarios en la base de datos tras el reinicio. Aún queda por verificar la recogida del trofeo y la concesión de la recompensa en esta exportación. Antes de jugar la misión, comprueba que su interfaz permite todas las acciones necesarias, incluido saquear un cadáver si el objetivo lo exige. Tras reiniciar Game y Login, vuelve a conectar ambas cuentas y compara el diario de misiones y el inventario de cada personaje.