Ultimate Odycer

Документация и первый игровой тест

Настройте сервер, подключите клиент и испытайте свой первый сетевой мир.

Читать FAQ

  1. Установите тестовый экземпляр

    Прочитайте примечания к выпуску, сверьте SHA-256 архива и следуйте руководству к версии. Настройте PostgreSQL и TLS, выполните миграции. Оставьте PostgreSQL и WebAdmin в закрытой сети или на закрытом интерфейсе.

    Скачать серверРуководство по VPS (на французском)
  2. Подключите первые клиенты

    Возьмите совместимый проект Godot/C#. Укажите адреса Login и Game. Создайте две тестовые учётные записи и убедитесь, что оба клиента попадают в один мир.

    Техническая документация (на английском)
  3. Создайте первый игровой цикл с помощью ИИ

    Поручайте Codex или Claude Code по одному изменению, которое можно проверить. Начните с небольшой карты, NPC, задания и награды. Импортируйте версионированные результаты доступных инструментов и проверьте их в Godot и на сервере.

    Инструменты Codex
  4. Подготовьте тестовый стенд

    Проверьте сохранность персонажа и награды после переподключения и перезапуска. Восстановите резервную копию изолированно, изучите журналы и измерьте нагрузку. Выпускайте ту же сборку после прохождения проверок.

Установка сервера на VPS

Тестовая установка на Linux x86-64 с PostgreSQL и TLS. Совместимый клиент подготовьте отдельно. Команды рассчитаны на Debian или Ubuntu. Сверьте требования выбранного архива.

  1. Подготовьте VPS и частную сеть

    Войдите по SSH под обычной учётной записью с sudo. Проверьте 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 подключения должны ему соответствовать. Используйте одинаковый JWT_SECRET в Game и Login. Распакуйте архив от имени пользователя службы или дайте ему доступ к нужным файлам. Используйте абсолютные пути 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-туннель. Укажите доступный клиентам частный IP в server.login_ip и server.server_ip, перезапустите службы и разрешите TCP 2106 и 7777 только тестовой сети. Login сообщает клиенту адрес Game. Проверьте маршрутизацию и соответствие TLS. Оставьте 5432, 8080 и 8082 вне публичной сети. Запускайте bootstrap с той же системной учётной записью, рабочим каталогом и настройками PostgreSQL, что и Game. При смене пользователя используйте домашний каталог служебной учётной записи.

    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

Создание первого игрового MMORPG-прототипа с Codex или Claude Code

Цель: два игрока в одном мире, одно задание и сохраняющаяся награда. Подготовьте совместимый проект клиента 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 и может подключаться к серверу на VPS с Linux. Для сборки Linux, совместимой с драйвером VPS, можно использовать виртуальный дисплей X11. Сохраните манифест из комплекта сборки, проверьте целостность её файлов и разрешите её хеш в реестре Game. Если клиент из исходного проекта сообщает об изменении списка файлов, пересоздайте манифест инструментом проекта и обновите реестр тестового сервера. Учётной записи нужны права на чтение файлов и запись в свой профиль. Сделайте снимки каждого окна до и после перезапуска.

    Godot · Customize Run Instances
  6. Проверьте мультиплеер и сохранение

    Убедитесь, что персонажи видят друг друга и что B видит движение A. Выполните задание за A. Награда должна поступить только A и только один раз. Переподключите A, затем штатно перезапустите тестовый сервер и проверьте персонажа, инвентарь и награду.

  7. Запишите результаты и разберите ошибки

    Отметьте версии, тестовые учётные записи, шаги, ожидания и наблюдения без секретов. Если персонажи не видны, сравните зону, экземпляр и версию. Если пропала награда, проверьте сохранение на сервере. После прохождения проверок прототип готов к игровому тесту. Сценарий задания и сохранения награды после перезапуска Game и Login на VPS проверен с двумя тестовыми клиентами. В двух окнах полного экспорта Ultody2 для Windows проверено убийство гоблина, а после перезапуска подтверждено сохранение прогресса и обоих инвентарей в базе данных. Сбор трофея и начисление награды в этом экспорте ещё предстоит проверить. Перед началом задания убедитесь, что в интерфейсе доступны все необходимые действия, в том числе сбор добычи с тела, если этого требует цель. После перезапуска Game и Login снова подключите обе учётные записи и сравните журнал заданий и инвентарь каждого персонажа.