Ultimate Odycer

문서와 첫 플레이 테스트

서버를 구성하고 클라이언트를 연결해 첫 온라인 월드를 테스트하세요.

FAQ 읽기

  1. 평가용 인스턴스 설치

    릴리스 노트를 읽고 SHA-256을 확인한 뒤 버전별 안내를 따르세요. PostgreSQL, 마이그레이션, TLS를 설정하고 PostgreSQL과 WebAdmin은 비공개 네트워크 또는 인터페이스에 둡니다.

    서버 다운로드VPS 안내서(프랑스어)
  2. 첫 클라이언트 연결

    호환되는 Godot/C# 프로젝트에 Login과 Game 주소를 설정합니다. 테스트 계정 두 개를 만들고 같은 월드에 접속할 수 있는지 확인하세요.

    기술 문서(영어)
  3. AI의 도움으로 첫 플레이 흐름 만들기

    Codex 또는 Claude Code에 검토할 수 있는 변경을 한 번에 하나씩 요청하세요. 작은 지도, NPC, 퀘스트, 보상으로 시작합니다. 사용 가능한 제작 도구에서 버전을 기록한 결과물을 가져와 Godot와 서버에서 확인하세요.

    Codex 제작 도구
  4. 스테이징 배포 준비

    다시 접속하고 서버를 재시작해도 캐릭터와 보상이 유지되는지 확인하세요. 격리된 환경에 백업을 복원하고 로그를 확인하며 부하를 측정합니다. 스테이징 기준을 충족한 빌드를 운영 환경에 배포하세요.

VPS에 서버 설치하기

Linux x86-64 VPS에 PostgreSQL과 TLS를 갖춘 평가 환경을 구성합니다. 호환 클라이언트는 별도로 준비하세요. 명령어는 Debian 또는 Ubuntu 예시이며 선택한 패키지의 요구 사항을 확인해야 합니다.

  1. VPS와 비공개 네트워크 준비

    sudo 권한이 있는 일반 SSH 계정을 사용하세요. x86_64와 glibc를 확인하고 PostgreSQL과 필요한 라이브러리를 설치합니다. PostgreSQL, API, WebAdmin은 로컬에 유지합니다. 두 테스트 기기에서 접근할 수 있는 사설망이나 VPN을 준비하세요.

    uname -m
    getconf GNU_LIBC_VERSION
    sudo apt update
    sudo apt install postgresql libpq5 openssl ca-certificates
    pg_isready
  2. 다운로드, 검증, 압축 풀기

    릴리스 페이지에서 Linux x86-64 아카이브와 .sha256 파일을 받으세요. 예시 파일명을 실제 이름으로 바꾸고 공식 페이지의 체크섬도 비교하세요. 다르면 중단하세요. 압축을 푼 폴더에 들어가 누락된 라이브러리가 있는지 확인합니다.

    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
    서버 다운로드
  3. 전용 데이터베이스 생성

    평가용 PostgreSQL에 전용 역할과 데이터베이스를 만듭니다. 메시지가 표시되면 고유한 비밀번호를 설정합니다. 마지막 명령으로 로컬 TCP 로그인을 확인합니다.

    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. 서버와 TLS 설정

    config.example.json을 config.json으로 복사하고 접근을 제한합니다. server의 db_host, db_port, db_name, db_user, db_password를 설정합니다. network.enable_tls는 true로 두고 network.tls_cert_path와 tls_key_path에 인증서와 키를 둡니다. 클라이언트가 인증서를 신뢰해야 하며 접속 이름이나 IP가 일치해야 합니다. Game과 Login에서 동일한 JWT_SECRET을 사용합니다. 실행 계정으로 압축을 풀거나 필요한 파일에 접근할 권한을 부여하세요. 별도로 시작하는 서비스에는 TLS 절대 경로를 쓰고 두 프로세스가 인증서와 키를 읽을 수 있는지 확인하세요.

    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. Game을 먼저 시작하고 마이그레이션 후 Login 실행

    압축을 푼 폴더에서 두 SSH 세션을 열고 같은 환경 파일을 표시하지 않고 불러옵니다. 빈 데이터베이스에서는 Game만 시작합니다. PostgreSQL 마이그레이션이 끝나고 Game과 WebAdmin이 수신 대기하는지 확인한 뒤 두 번째 세션에서 Login을 시작하세요. 동시에 시작하면 릴레이션 중복 오류가 발생하고 SQLite로 대체될 수 있습니다. 로그에 대체가 표시되면 PostgreSQL부터 수정하세요.

    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. WebAdmin 열기 및 테스트 클라이언트 허용

    마이그레이션 후 bootstrap-admin을 실행하고 SSH 터널을 통한 첫 로그인에서 임시 비밀번호를 바꿉니다. server.login_ip와 server.server_ip를 테스트 기기에서 접근할 수 있는 사설 IP로 설정하고 재시작한 뒤 TCP 2106과 7777을 테스트 망에만 허용합니다. Login이 알려 주는 Game 주소가 연결 가능하고 TLS 인증서에 포함되는지 확인하세요. 5432, 8080, 8082는 공개하지 않습니다. 부트스트랩은 Game과 동일한 시스템 계정, 작업 폴더, PostgreSQL 설정으로 실행하세요. 사용자를 바꿀 때는 서비스 계정의 홈 디렉터리를 사용합니다.

    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. 결과 기록과 백업

    테스트 기기에서 Login과 월드 입장을 확인합니다. 입장이 실패하면 Game 주소, 방화벽, 인증서 신뢰 여부부터 확인합니다. 데이터베이스, 설정, 릴리스를 백업하고 공개 전에 격리된 인스턴스로 복원하세요.

    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

Codex 또는 Claude Code로 첫 플레이 가능한 MMORPG 만들기

목표는 같은 월드에 접속한 두 플레이어, 퀘스트 한 개, 재시작 후에도 남는 보상입니다. 서버와 호환되는 Godot 프로젝트가 필요합니다. 클라이언트는 서버 패키지와 별도로 준비합니다.

  1. Godot 프로젝트 준비

    Godot 4 .NET과 프로젝트가 요구하는 .NET SDK로 호환 클라이언트를 엽니다. 서버, 클라이언트, 프로토콜 버전을 기록하고 Git의 별도 브랜치, 테스트 인스턴스, 테스트 계정을 사용합니다.

    Godot .NET / C#
  2. 도우미에게 첫 작업 맡기기

    Codex 또는 Claude Code에서 프로젝트 폴더를 엽니다. 일치하는 네트워크 명세, 비밀이 없는 설정, 기대 결과를 전달합니다. 검증 가능한 변경을 하나씩 요청하고 차이를 검토합니다. 예를 들어 Login과 Game 설정을 찾고 접속에 필요한 최소 변경과 확인 방법을 제안해 달라고 하세요.

    CodexClaude Code
  3. 클라이언트 한 개 먼저 연결

    프로젝트 설정 방식으로 Login 주소를 넣고 반환되는 Game 주소를 확인합니다. 해당 버전이 지원하는 방식으로 계정 두 개를 만듭니다. 첫 계정에서 캐릭터를 만들거나 선택한 뒤 테스트 구역에 입장합니다. 버전, 인증서, 연결 오류부터 해결하세요. 클라이언트와 서버가 사용하는 에셋 레지스트리도 확인하세요. dev-20261106.2 서버 아카이브에는 asset_registry.json이 없습니다. 클라이언트가 해시를 요구하면 프로젝트와 함께 제공된 레지스트리를 쓰거나 프로젝트 도구로 서버 템플릿과 클라이언트 에셋에서 생성합니다. 테스트 인스턴스에 넣고 Game을 재시작한 뒤 클라이언트에 같은 해시를 설정합니다.

  4. 게임 플레이 흐름 만들기

    작은 지도, 시작 지점, NPC, 퀘스트를 만듭니다. NPC와 대화하고 아이템을 수집한 뒤 돌아와 보상을 받는 흐름입니다. 지원 형식으로 제작 도구의 결과물을 가져와 Godot와 서버에서 확인합니다. 목표, 인벤토리, 보상에 기존 서버 처리 경로를 재사용하세요.

    Codex 제작 도구
  5. Godot 클라이언트 두 개 실행

    Godot의 Debug → Customize Run Instances에서 두 개를 선택하거나 별도 기기에서 데스크톱 빌드를 실행합니다. 계정이 저장되는 경우 별도 프로필이나 사용자 폴더를 사용합니다. 계정 A와 B를 같은 서버와 구역에 접속시킵니다. 그래픽 테스트에는 리소스가 포함되어 있고 테스트 기기의 운영 체제와 그래픽 드라이버를 지원하는 전체 C# 빌드를 사용하세요. 소스 프로젝트를 실행할 때는 프로젝트가 지정한 Godot .NET과 .NET SDK 버전을 사용하세요. Windows용으로 내보낸 빌드는 Windows 데스크톱에서 실행하여 Linux VPS의 서버에 연결할 수 있습니다. VPS의 그래픽 드라이버와 호환되는 Linux 빌드는 가상 X11 디스플레이를 사용할 수 있습니다. 빌드와 함께 제공된 매니페스트를 보관하고 파일 무결성을 검사한 뒤 해당 해시를 Game 레지스트리에 등록하세요. 소스 프로젝트에서 실행한 클라이언트가 파일 목록이 바뀌었다고 표시하면 프로젝트 도구로 매니페스트를 다시 생성하고 테스트 서버 레지스트리를 갱신하세요. 실행 계정에는 파일 읽기와 자체 프로필 쓰기 권한이 필요합니다. 재시작 전후에 각 창을 캡처하세요.

    Godot · Customize Run Instances
  6. 멀티플레이와 데이터 유지 검증

    두 캐릭터가 서로 보이고 B에게 A의 움직임이 보이는지 확인합니다. A가 퀘스트를 완료하면 A만 보상을 한 번 받아야 합니다. A를 재접속시킨 뒤 테스트 서버를 정상적으로 재시작하고 캐릭터, 인벤토리, 보상을 확인합니다.

  7. 결과 기록과 오류 조사

    버전, 테스트 계정, 단계, 기대값, 실제 결과를 비밀 없이 기록합니다. 서로 보이지 않으면 구역, 인스턴스, 버전을 비교합니다. 보상이 사라지면 서버 저장부터 확인합니다. 모든 검증을 통과하면 플레이 가능한 멀티플레이 프로토타입이 완성됩니다. VPS에서 Game과 Login을 재시작한 후 퀘스트와 보상 상태는 두 테스트 클라이언트로 검증했습니다. Ultody2 Windows 전체 내보내기 빌드의 두 창에서 고블린 처치를 완료했고, 재시작 후 데이터베이스에 퀘스트 진행도와 두 캐릭터의 인벤토리가 유지됨을 확인했습니다. 이 빌드에서 전리품 획득과 퀘스트 보상 지급은 아직 검증해야 합니다. 퀘스트를 시작하기 전에 목표에 포함된 시체에서 전리품 획득 등 필요한 모든 동작을 내보내기 빌드의 화면에서 수행할 수 있는지 확인하세요. Game과 Login을 재시작한 뒤 두 계정으로 다시 접속해 각 캐릭터의 퀘스트 기록과 인벤토리를 비교하세요.