studio/rbxl-importer/README.md

rbxl-importer

Конвертер Roblox .rbxl карт в проекты Rublox. Состоит из:

• Python-парсер Roblox Binary Level формата (v0+)
• Asset downloader с дедупликацией (Marfusha proxy + .ROBLOSECURITY cookie)
• Mesh→GLB конвертер (Roblox .mesh v1-v5)
• Roblox-LUA runtime (wasmoon, реализован в репо rublox/player)
• Flask API + React UI модалка в rublox/studio

Архитектура

[Студия]                                 [VM 130 rbxl-importer S1]
  user drops .rbxl              ┌─────────────────────────────┐
        ↓                       │ Flask  (port 8690)          │
  POST /api-rbxl/...   ─────────┤  ├ analyze: parser + report│
        ↓                       │  └ create: parser + конверт│
  redirect /edit/<id>           │     + asset_downloader     │
                                │     + mesh→glb              │
                                │                             │
                                │ Redis (preview cache)       │
                                │ nginx (assets.rublox.pro)   │
                                │ /opt/roblox-assets/         │
                                └─────────────────────────────┘
                                              ↓
                                  [Marfusha proxy 85.192.61.244:39237]
                                              ↓
                                  Roblox CDN (assetdelivery.roblox.com)
                                              ↓
                                  Ассеты ← .ROBLOSECURITY cookie auth

Структура

rbxl-importer/
  src/
    rbxl_binreader.py    — низкоуровневое чтение (deinterleave, zigzag, roblox float)
    rbxl_types.py        — декодеры 28+ PROP типов (Vector3, CFrame, Color3, ...)
    rbxl_parser.py       — парсер chunks → RobloxModel
    converter.py         — RobloxModel → Rublox project_data
    asset_downloader.py  — скачка с Roblox CDN, дедуп через roblox_assets
    asset_proxy.py       — режимы proxy: disabled/direct/http_proxy/cloudflare_worker
    mesh_converter.py    — Roblox .mesh v1-v5 → GLB
    app.py               — Flask endpoints
  sql/
    001_roblox_assets.sql — таблицы roblox_assets, roblox_asset_usage, roblox_imports
  reference_files/        — тестовые .rbxl
  tests/                  — unit-тесты

Поток импорта

1. Юзер (МИН) загружает .rbxl через модалку в студии.
2. POST /import/rbxl/analyze → парсер, отчёт, preview_hash в Redis.
3. Юзер видит: число объектов, скриптов, ассетов, классов.
4. POST /import/rbxl/create с title:
   • Парсим → конвертим RobloxModel → project_data.
   • Скачиваем все rbxassetid:// ассеты (mesh/texture/sound).
   • Mesh → GLB через mesh_converter.
   • INSERT в kubikon3d_projects (status=draft, is_test=true).
5. Редирект на /edit/<project_id> — открывается в студии.
6. Если есть Lua-скрипты (kind: 'roblox-lua') — плеер запускает их через RobloxLuaSandbox (wasmoon).

Запуск (на VM 130)

systemctl start rbxl-importer
systemctl status rbxl-importer
# логи:
journalctl -u rbxl-importer -f

ENV

Переменная	Значение
PG_DSN	DSN Postgres storys_db (через autossh туннель S1→S2)
REDIS_URL	redis://127.0.0.1:6379/0 (локальный Docker)
STORAGE_ROOT	/opt/roblox-assets
PUBLIC_ASSET_BASE	https://assets.rublox.pro/roblox
ROBLOX_PROXY_MODE	http_proxy
ROBLOX_HTTP_PROXY	Marfusha xray HTTP proxy
ROBLOX_SECURITY_COOKIE	.ROBLOSECURITY от Roblox-аккаунта МИНа

Тестовый импорт

# analyze (file=Easy Obby)
curl -X POST -H "X-Auth-Override: 1" \
    -F "file=@reference_files/easy_obby.rbxl" \
    http://localhost:8690/import/rbxl/analyze

# create
curl -X POST -H "X-Auth-Override: 1" -H "Content-Type: application/json" \
    -d '{"preview_hash":"<from_analyze>", "title":"Easy Obby"}' \
    http://localhost:8690/import/rbxl/create

Ограничения / TODO

• Roblox auth обязателен для большинства ассетов (с 2024 года). Используется .ROBLOSECURITY cookie аккаунта МИНа.
• GUI (ScreenGui, Frame, TextLabel) пока пропускается в конвертере (skipped).
• Animation/KeyframeSequence требуют отдельной обработки.
• CSG: parsing есть, но конверт в GLB не реализован — пока деградация в bbox cube.
• Terrain (voxel) — конвертация в robloxTerrain поле пока заглушка.

Авторские права

Эта тест-фича для МИНа только. Юзер подтверждает право использовать содержимое карты при загрузке. Не открывать для публичных пользователей без юр-проверки.