К основному содержанию
скилл CX Codex

roblox-rojo — скилл для Claude Code: что делает и как установить

Скилл roblox-rojo настраивает проекты Rojo 7 для синхронизации файлов с диска в Roblox Studio, генерации сборок и карт исходников.

MIT 519 установок ★ 36 обновлён 2026-10-22

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add nonlooped/roblox-suite --skill roblox-rojo -a claude-code
Открыть на GitHub

Что делает roblox-rojo

Ассистент помогает развернуть проект Rojo 7 и связать файловую структуру с деревом объектов в Roblox. Скилл объясняет правила сопоставления скриптов .lua и .luau, настраивает конфигурацию default.project.json и подсказывает команды сборки плейсов через rojo build.

По умолчанию сессия живой синхронизации через rojo serve слушает порт 34872 и передаёт изменения в одну сторону — от файлов к Studio. Перенос готовых плейсов обратно в файлы на диске выполняется через команду rojo syncback.

Для объектов Terrain или геометрии CSG живой синхронизации недостаточно: такие свойства требуют полной пересборки плейса через rojo build.

Какие задачи решает

  • настроить структуру инстансов в файле default.project.json
  • выгрузить плейс из Studio на диск с помощью rojo syncback
  • собрать файл плейса или модели через команду rojo build
  • сгенерировать карту sourcemap.json для анализатора кода в редакторе

Примеры запросов агенту

  • Сформируй файл конфигурации default.project.json для структуры каталогов в проекте.
  • Покажи команду для rojo syncback, чтобы выгрузить плейс place.rbxl в файлы на диске.
  • Как запустить генерацию sourcemap.json в фоновом режиме?

Как установить roblox-rojo

1Через Skills CLI (Vercel)

npx skills add nonlooped/roblox-suite --skill roblox-rojo -a claude-code

2Вручную: положить файлы

~/.claude/skills/roblox-rojo/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/roblox-rojo/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о roblox-rojo

Как установить roblox-rojo в Claude Code?

Выполните команду npx skills add nonlooped/roblox-suite --skill roblox-rojo -a claude-code. Конфигурация запишется в файл ~/.claude/skills/roblox-rojo/SKILL.md.

Что делает скилл roblox-rojo?

Он помогает настроить проект Rojo 7: сформировать дерево объектов, запустить сервер синхронизации и собрать файлы плейсов.

Почему часть свойств не передаётся через живую синхронизацию?

Ограничения API плагина в Studio не позволяют передавать бинарные данные вроде ландшафта Terrain или параметры MeshPart.MeshId. Для их обновления нужно заново скомпилировать плейс командой rojo build.

Исходный текст

SKILL.md · MIT
---
name: roblox-rojo
description: "Set up or troubleshoot Rojo projects. Use for CLI and plugin installation, project files, live sync, builds, uploads, sourcemaps, and exporting existing places with syncback."
last_reviewed: 2026-07-09
---

# roblox-rojo

**Official sources:**
- https://rojo.space/docs/v7/ (docs index; current major is v7)
- https://rojo.space/docs/v7/getting-started/installation/
- https://rojo.space/docs/v7/getting-started/new-game/
- https://rojo.space/docs/v7/getting-started/existing-game/
- https://rojo.space/docs/v7/project-format/
- https://rojo.space/docs/v7/properties/
- https://rojo.space/docs/v7/sync-details/
- https://rojo.space/docs/v7/upgrade/
- https://github.com/rojo-rbx/rojo/releases (latest CLI/plugin releases; verify version before recommending install pins)
- https://github.com/rojo-rbx/rojo (source of truth for CLI flags and changelog when docs lag)

Rojo maps a filesystem project to Roblox instances so you can edit with external tools (VS Code, Git, linters, formatters) and live-sync or build into Studio/place files. This skill covers **Rojo 7** as documented at rojo.space and implemented in the current `rojo-rbx/rojo` release line.

## Mental model

| Piece | Role |
| --- | --- |
| **Rojo CLI** | Reads the project file + filesystem; serves live sync, builds place/model files, uploads, sourcemaps, syncback. |
| **Studio plugin** | Connects to the local serve session and applies patches into the open place. |
| **Project file** | `*.project.json` / `*.project.jsonc` describing the instance tree and options. |
| **Filesystem tree** | Scripts, models, JSON/TOML/YAML/CSV/text under `$path` nodes become Instances. |

Rojo is **filesystem → Studio** for live sync (one primary direction). Optional **two-way sync** in the plugin is experimental and incomplete. Do not design production workflows around it. For place → files, use **`rojo syncback`** (Rojo 7.7+) or external porting tools.

## Quick start

1. Install the **CLI** (Rokit recommended for projects; GitHub binaries or `cargo install rojo --version ^7` also supported).
2. Install the **Studio plugin** with `rojo plugin install` (or GitHub `rbxm` / Roblox.com plugin for the matching major).
3. `rojo init my-game` (or open folder + VS Code "Rojo: Open Menu").
4. `rojo serve` in the project folder.
5. In Studio: open the Rojo plugin panel → **Connect**.
6. Edit files on disk; watch them sync. Use `rojo build -o build.rbxlx` for a one-shot place file.

Full install matrix and CLI flags: [references/installation-and-cli.md](references/installation-and-cli.md).

## Script file → Instance mapping (defaults)

Both `.lua` and `.luau` are supported. Default rules (from Rojo source / sync docs):

| File pattern | Instance (when `emitLegacyScripts` is **true**, the default) | Instance (when `emitLegacyScripts` is **false**) |
| --- | --- | --- |
| `*.server.lua(u)` | `Script` (legacy RunContext) | `Script` with `RunContext = Server` |
| `*.client.lua(u)` | `LocalScript` | `Script` with `RunContext = Client` |
| `*.plugin.lua(u)` | `Script` with `RunContext = Plugin` | same |
| other `*.lua(u)` | `ModuleScript` | same |

**Init usurpers** (replace the parent folder with a script): `init.server.lua(u)`, `init.client.lua(u)`, `init.plugin.lua(u)`, `init.lua(u)`. Only one init script type per folder. A directory with `default.project.json` / `default.project.jsonc` is treated as a nested project instead of a plain folder.

Other defaults: `.rbxm`/`.rbxmx` models, `.model.json(c)`, plain `.json(c)` → ModuleScript returning a table, `.toml` / `.yml`/`.yaml` similarly, `.csv` → `LocalizationTable`, `.txt` → `StringValue`.

Details, meta files, limitations: [references/sync-details.md](references/sync-details.md).

## Project file essentials

Minimal place-shaped tree (services inferred without `$className` for known services):

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

Important top-level fields (docs + current CLI):

| Field | Purpose |
| --- | --- |
| `name` | Project/instance name (optional for `default.project.json`; folder name used). |
| `tree` | Root instance description (required). |
| `servePort` | Default port for `rojo serve` (default **34872**). |
| `serveAddress` | Default bind address when CLI `--address` omitted. |
| `servePlaceIds` / `blockedPlaceIds` | Allow/deny live-sync targets by place ID. |
| `placeId` / `gameId` | Set Studio place/universe IDs on connect. |
| `serveAllowedHosts` | Extra Host/Origin values for serve (hostname access); CLI `--allowed-hosts` overrides. |
| `globIgnorePaths` | Globs to ignore (gitignore-style negation supported in recent releases). |
| `emitLegacyScripts` | Default **true** = Script/LocalScript; **false** = RunContext Scripts for server/client files. |
| `syncRules` | Custom file→middleware patterns. |
| `syncbackRules` | Controls `rojo syncback` behavior. |

Instance nodes use `$className`, `$path`, `$properties`, `$attributes`, `$ignoreUnknownInstances`, plus child keys. Prefer **implicit** property syntax. Full format: [references/project-format.md](references/project-format.md).

## Daily commands

```bash
# New project (place | model | plugin)
rojo init my-game
rojo init --kind model
rojo init --kind plugin --skip-git

# Live sync (default localhost:34872)
rojo serve
rojo serve --port 34872 --address 127.0.0.1

# Build place/model
rojo build -o build.rbxlx
rojo build -o build.rbxl
rojo build --plugin MyPlugin.rbxm
rojo build -o out.rbxlx --watch

# Sourcemap for editor tooling
rojo sourcemap --output sourcemap.json
rojo sourcemap --watch --absolute

# Upload (prefer dedicated deploy account; never commit cookies/keys)
rojo upload --asset_id PLACE_ID --cookie "..."
rojo upload --asset_id PLACE_ID --api_key "..." --universe_id UNIVERSE_ID

# Place file → filesystem into an existing project tree
rojo syncback . --input place.rbxl
rojo syncback . --input place.rbxlx --dry-run --list

# Plugin management / docs / format
rojo plugin install
rojo plugin uninstall
rojo doc
rojo fmt-project
```

## Live-sync limitations

Not all property types apply in real time (Studio plugin API limits). Common cases that may need a full **build + open** instead of live sync:

- Binary data (Terrain, CSG)
- `MeshPart.MeshId`
- `HttpService.HttpEnabled`

Property type coverage for build vs live sync is documented on the Properties page and rbx-dom's coverage chart. When live sync fails for a class/property, rebuild with `rojo build` and open the place.

`rojo serve` binds to loopback by default. Binding to a network-reachable address exposes the session: recent Rojo versions validate Host/Origin, gate some APIs to local clients, and warn on non-local binds. Prefer localhost; if you must expose, use `serveAllowedHosts` / `--allowed-hosts` deliberately.

## Porting existing games

1. Refactor Studio code into fewer service-rooted locations (`ReplicatedStorage`, `ServerScriptService`, `StarterPlayer`, tags via `CollectionService`) before porting.
2. Prefer **`rojo syncback`** with a project that already lists the services/paths you want filled (`rojo syncback path/to/project --input place.rbxl`). Only descendants of nodes present in the project tree are written.
3. Alternatives called out in official docs: [rbxlx-to-rojo](https://github.com/rojo-rbx/rbxlx-to-rojo), [Lune](https://github.com/lune-org/lune) for custom pipelines.
4. Leaving Rojo is always possible: Rojo builds normal place/model files; you can stop using the filesystem tree and edit in Studio only.

Workflows and syncback rules: [references/workflows-and-syncback.md](references/workflows-and-syncback.md).

## Agent checklist

- **Do** pin CLI + plugin to the **same major** (Rojo 7 plugin with Rojo 7 CLI).
- **Do** run `rojo plugin install` after upgrading the CLI.
- **Do** put shared modules under `ReplicatedStorage` paths and server authority under `ServerScriptService`.
- **Do** use `.luau` (Rojo's `init` templates use `.luau` since 7.4).
- **Do** set `emitLegacyScripts: false` only when the team understands modern `RunContext` scripts (and that client files become `Script`+Client, not `LocalScript`).
- **Do not** invent CLI flags or project keys. If unsure, run `rojo --help` / `rojo <cmd> --help` or re-check docs/changelog.
- **Do not** commit `.ROBLOSECURITY` cookies or Open Cloud API keys used with `rojo upload`.
- **Do not** treat experimental two-way sync as reliable source control.
- **Do not** confuse Rojo with Roblox **Script Sync** or **Studio MCP**. Different tools; they can coexist (see roblox-mcp).

## Verification

- [ ] `rojo --version` reports a 7.x release matching the intended pin.
- [ ] Studio shows the Rojo 7 plugin; connect succeeds against `rojo serve`.
- [ ] Editing a `.server.luau` under a mapped `$path` updates the correct service in Studio.
- [ ] `rojo build -o build.rbxlx` opens cleanly in Studio.
- [ ] `sourcemap.json` is gitignored if generated (Rojo's default gitignore template includes it in recent releases).

## How to proceed

1. Confirm install path: [references/installation-and-cli.md](references/installation-and-cli.md).
2. Shape the tree: [references/project-format.md](references/project-format.md).
3. Name files correctly: [references/sync-details.md](references/sync-details.md).
4. For teams / porting / deploy: [references/workflows-and-syncback.md](references/workflows-and-syncback.md).

<!-- catalog:references:start -->
## Reference index

- [installation-and-cli.md](references/installation-and-cli.md): Install Rojo or choose CLI commands and flags.
- [project-format.md](references/project-format.md): Write project trees, properties, paths, or nested projects.
- [sync-details.md](references/sync-details.md): Map files to instances or diagnose changes that live sync cannot apply.
- [workflows-and-syncback.md](references/workflows-and-syncback.md): Port an existing place, export Studio changes, or build in CI.
<!-- catalog:references:end -->

© nonlooped · MIT · nonlooped/roblox-suite

Похожие скиллы

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
rojo-pro dig1t Скилл rojo-pro для работы с Rojo в проектах Roblox: конфиг project.json, синхронизация со Studio, сборка .rbxl и sourcemap для проверки типов. CX Codex +1 264установок scenario-roblox-tooling scenario-labs Скилл scenario-roblox-tooling для Claude Code помогает настраивать пайплайны Roblox, синхронизировать код и запускать тесты вне Studio. CX Codex +1 350установок roblox-studio-workflow gamedev-skills Скилл roblox-studio-workflow для Claude Code и Codex выстраивает безопасный процесс правок в проектах Roblox и Rojo. Запускается при редактировании плейсов .rbxl, работе через Studio MCP и проверке изменений. CX Codex +1 9 300установок scenario-roblox-expert scenario-labs Скилл scenario-roblox-expert для Claude Code помогает создавать, исправлять и проверять проекты в Roblox Studio. Он подключается к задачам с Luau, Rojo, игровыми тестами и управлением Studio через MCP. CX Codex +1 411установок roblox-physics gamedev-skills Скилл roblox-physics для Claude Code настраивает физику и пространственные запросы в Roblox, включая сборки, ограничения и владение сетью. CX Codex +1 9 100установок roblox-datastores sentinelcore Скилл roblox-datastores для Claude Code с референсом по DataStoreService в Roblox. Включается, когда в скрипте нужно сохранить статистику игрока, инвентарь или собрать таблицу лидеров. CX Codex +1 680установок

Из того же набора16

Весь набор →
roblox-gamepasses Скилл roblox-gamepasses помогает агенту собрать монетизацию в Roblox: пассы, developer products, подписки и переводы Robux — с выдачей бонусов только на сервере. CX Codex +1 547установок roblox-core Скилл roblox-core для Claude Code помогает выбирать сервисы Roblox, места для скриптов и контексты выполнения. Он подключается к вопросам о типах Luau, сериализации, загрузке модулей и обмене данными между клиентом и сервером. CX Codex +1 546установок roblox-datastores Скилл roblox-datastores помогает реализовать и отладить сохранение данных игроков в Roblox: профили, OrderedDataStore для лидербордов, миграции и выбор между DataStore и MemoryStore. CX Codex +1 544установок roblox-audio Скилл roblox-audio помогает собирать и отлаживать аудиосистемы Roblox: от позиционного звука до преобразования речи. Пригодится при настройке аудиографа или миграции со старого Sound. CX Codex +1 522установок roblox-physics Скилл roblox-physics помогает собирать и отлаживать физику в Roblox: механизмы, транспорт, констрейнты и сетевое владение. CX Codex +1 521установок roblox-teleport Скилл roblox-teleport переносит игроков Roblox между местами, серверами и зарезервированными серверами через TeleportAsync. Подскажет, как передать данные, обработать ошибки и настроить лобби. CX Codex +1 519установок roblox-npcs Скилл roblox-npcs для Claude Code создаёт и отлаживает навигацию NPC в Roblox через PathfindingService. Настраивает патрулирование, преследование и обход препятствий. CX Codex +1 518установок roblox-open-cloud Справочник по REST API Roblox Open Cloud для внешней автоматизации, CI/CD и работы с Data Stores без запуска игры. CX Codex +1 497установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой