Getting Started RU

🌐 English · Русский

← Главная · Управление →

Начало работы

Требования

• .NET 10 SDK.
• Windows. Ввод с клавиатуры использует Win32 API, а поддержка мыши в мастере — Win32 console API, поэтому приложение сейчас работает только под Windows.
• Терминал с поддержкой 24-битного ANSI-цвета для наилучшего вывода (рекомендуется Windows Terminal).
• (Опционально) NVIDIA GPU с CUDA — или любое OpenCL-устройство — для GPU-рендерера. Без него миры, запросившие GPU, прозрачно откатываются на CPU.

Сборка и запуск

dotnet build -c Release

Установите SampleGame как стартовый проект в Visual Studio или запустите его напрямую:

dotnet run --project SampleGame -c Release

Заметка для контрибьюторов: для чистой/проверочной сборки используется dotnet build -c Release --no-incremental (обычная инкрементальная сборка может ложно показать «0 warnings»). См. Самотесты для headless-команд.

Мастер настройки

Перед циклом рендеринга запускается брендированный мастер настройки. Он рисуется собственным консольным UI движка (без внешнего UI-тулкита) и управляется клавиатурой и мышью; он перестраивается при изменении размера терминала. Проводит по шагам, по порядку:

1. Никнейм — выбери ранее использованный никнейм или введи новый. Он запоминается локально в SampleGame/users.json (в .gitignore) и не ограничивает и не изолирует контент — миры, модели и текстуры остаются общими локальными файлами. Твой никнейм помечает строки чата и передаётся другим пирам.
2. Режим сессии — локальная одиночная или онлайн.
3. Сетевая роль (только онлайн) — поднять Server или подключиться как Client.
4. Мир — Создать новый мир или Загрузить сохранённый (worlds/*.json).
   • Создание позволяет задать:
     • имя мира;
     • переключатели: Shadows (тени), BVH acceleration, Extra fixed light (доп. свет), Disable camera light (отключить свет камеры), Include platform (платформа);
     • Renderer — CPU или GPU (NVIDIA);
     • форму платформы — Square / Rectangle / Circle — и её размер / ширину / глубину;
     • переключатели физики — Gravity (+ сила) + Bounce (упругость 0–1) и Collision.
5. Сеть (только онлайн) — порт прослушивания (сервер) или IP + порт сервера (клиент).

Клиент, подключившийся к серверу, скачивает мир хоста автоматически. Подробнее — Мультиплеер.

Зум и изменение размера

Мастер перестраивается при изменении размера окна или при клавиатурном зуме шрифта (Ctrl+= / Ctrl+-).

Зум по Ctrl+колёсику не меняет размер мастера (он перехватывает колёсико для кликов) — но внутриигровое 3D по-прежнему реагирует на Ctrl+scroll, как и стартовый сплэш. Весь внутренний HUD адаптируется вживую к растяжению окна или зуму шрифта.

Дальше

• Изучите Управление (движение, редактор, режимы HUD, чат).
• Соберите сцену: см. Формат мира и добавьте свои Текстуры.
• Идите в Мультиплеер или включите GPU-рендерер.