Добавление проекта Roblox Studio в локальный Git через Rojo

Быстрый старт (автоматический скрипт)

Если не хотите делать всё вручную, скачайте setup-rojo.ps1 с сервера и запустите:

Invoke-WebRequest -Uri "https://roblox.miwatch.de/setup-rojo.ps1" -OutFile "setup-rojo.ps1"
.\setup-rojo.ps1 -ProjectPath "C:\src\LostIsland"

Если появилась ошибка "running scripts is disabled on this system":
PowerShell по умолчанию блокирует запуск скриптов.

Вариант А — обойти политику для одного запуска (рекомендуется):

powershell -ExecutionPolicy Bypass -File ".\setup-rojo.ps1" -ProjectPath "C:\src\LostIsland"

Вариант Б — разрешить скрипты для текущего пользователя (навсегда):

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
.\setup-rojo.ps1 -ProjectPath "C:\src\LostIsland"

Скрипт автоматически скачает Rojo с GitHub, инициализирует проект, Git и создаст .gitignore.
Затем переходите сразу к шагу 5 (плагин в Studio).

---

Установка Rojo (ручная)

Откройте PowerShell и выполните:

winget install aftman
aftman install rojo

Важно: в aftman 0.3.0 флаг --global не используется. Если aftman не найден после установки — перезапустите PowerShell.

Проверка:

rojo --version

Создайте папку проекта на диске

mkdir C:\src\LostIsland
cd C:\src\LostIsland

Инициализация Rojo и Git

Внутри папки проекта:

rojo init        # создаёт default.project.json и src/
git init
git branch -M main

Настройте .gitignore

Создайте файл .gitignore в папке проекта:

# Бинарные файлы Roblox (не версионируем)
*.rbxl
*.rbxlx
*.rbxm
*.rbxmx

# Артефакты сборки Rojo
build.rbxl
build.rbxlx

# Автосохранения и мусор
*.autosave.rbxl
*.tmp
.DS_Store
Thumbs.db
.vscode/

Установите плагин Rojo в Roblox Studio

1. Откройте Roblox Studio.
2. Перейдите в Toolbox → Plugins (или скачайте .rbxmx из релизов Rojo → Plugins → Install from File…).
3. Установите плагин Rojo.

Запустите сервер Rojo

В PowerShell, в папке проекта:

rojo serve

Оставьте окно открытым. Сервер работает на localhost:34872.

Подключите Studio к Rojo и выгрузите скрипты

1. В Roblox Studio нажмите Rojo → Connect (или откройте окно плагина).
2. Укажите адрес: localhost:34872 → Connect.
3. В плагине нажмите "Initial Sync" или "Sync In" (кнопка для загрузки содержимого Studio на диск).
4. Скрипты из открытого place-файла появятся в папке src/ на диске.

Если в src/ пусто: некоторые версии плагина требуют предварительно создать структуру в default.project.json. Попробуйте сохранить скрипты вручную: в Studio ПКМ на Script → Save as… → сохраните в src/ServerScriptService/ (или другой соответствующий сервис).

Проверьте структуру default.project.json

Откройте файл и убедитесь, что пути src/ соответствуют сервисам в Studio. Пример:

{
  "name": "LostIsland",
  "tree": {
    "$className": "DataModel",
    "ServerScriptService": {
      "$className": "ServerScriptService",
      "$path": "src/ServerScriptService"
    },
    "ReplicatedStorage": {
      "$className": "ReplicatedStorage",
      "$path": "src/ReplicatedStorage"
    },
    "StarterPlayer": {
      "$className": "StarterPlayer",
      "StarterPlayerScripts": {
        "$className": "StarterPlayerScripts",
        "$path": "src/StarterPlayerScripts"
      }
    }
  }
}

После правки перезапустите rojo serve и снова синхронизируйте.

Первый коммит в Git

Когда скрипты появились в src/:

git add .
git commit -m "Initial commit: выгружены скрипты из Roblox Studio через Rojo"

(Опционально) Привяжите удалённый репозиторий

Если у вас есть репозиторий на GitHub/GitLab:

git remote add origin <ВАШ_REMOTE_URL>
git push -u origin main