SmashKarts Clone

Браузерная 3D мультиплеер-гонка с оружием для компании друзей. Клон SmashKarts.io.

Требования

• Godot 4.6 — Godot_v4.6.1-stable_win64.exe
• Python 3 — для локального HTTP-сервера HTML5-билда

Запуск в редакторе (разработка)

1. Открыть проект в Godot 4.6
2. Запустить сцену scenes/lobby.tscn
3. Хост: ввести имя → нажать Host Game
4. Клиент: второе окно Godot (или браузер с HTML5-билдом) → ввести имя → IP 127.0.0.1 → Join

Запуск HTML5-билда (браузер)

HTML5-билд требует заголовков Cross-Origin-Isolation — обычный file:// или стандартный HTTP-сервер не подойдут.

python build/serve.py

Открыть в браузере: http://localhost:8060/index.html

Браузерный клиент может только подключаться (Join). Хост запускается только из desktop-билда.

Управление

Клавиша	Действие
W / S	Газ / Тормоз
A / D	Поворот
Space или ЛКМ	Выстрел (если есть оружие)

Авто-подключение (URL-параметры)

Браузерный билд поддерживает авто-джоин без лобби:

http://localhost:8060/index.html?join=127.0.0.1&name=Player1

Структура проекта

scenes/       — сцены Godot (.tscn)
scripts/      — GDScript (.gd)
Maps/         — карты
assets/       — 3D-модели, текстуры
resources/    — Resource-файлы (.tres)
build/        — HTML5-экспорт + serve.py
design/gdd/   — Game Design Documents

Стек

• Движок: Godot 4.6, GDScript
• Мультиплеер: WebSocketMultiplayerPeer (server-authoritative)
• Клиент: HTML5 export (браузер)
• Сервер: Godot headless на VPS (Linux), nginx + wss://

Деплой на сервер

• Godot headless запускается на VPS
• nginx раздаёт HTML5-билд по HTTPS
• Game server: WebSocket на порту 4444 (wss://)