smokestack-games/rbxsync

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

37 stars 4 forks 质量 58 趋势 16NOASSERTION

Repository Install

通过MCP集成，在Studio和VS Code之间同步Roblox游戏

概览

Roblox Studio 与文件系统之间的双向同步。完整的属性保护、git 集成以及原生 MCP 支持，支持人工智能辅助开发。 - ：所有人都从 git 同步。不再有“哪个版本是最新的？”- ：用 .rbxjson 格式序列化所有实例属性并带有显式类型注释 - ：在 Studio 或 VS Code 编辑 - 自动双向同步 - ：内置 MCP 服务器允许 AI 代理提取、同步、测试和调试 - ：几秒钟内将任何现有游戏解压成文件 RbxSync 是 Roblox 的同步工具，原生支持 MCP（模型上下文协议）。像 Claude 和 Cursor 这样的 AI 助手可以： - 自动从Studio到文件——同步变化瞬间变化——并在测试（移动、交互、装备工具）期间实时查看控制台输出——基于运行时输出自主切换 Rojo、Argon 和 Pesto 不支持 MCP。请参见 MCP 集成以建立 AI 辅助开发。

概述（AI 翻译）

Roblox Studio 与文件系统之间的双向同步。完整的属性保护、git 集成以及原生 MCP 支持，支持人工智能辅助开发。

主要特色

唯一真相来源：所有人都从git同步。不再有“哪个版本是最新的？”的问题。
完整属性保留：使用.rbxjson格式并带有显式类型注释的序列化所有实例属性
真正的双向同步：在Studio或VS Code中编辑——双向自动同步
AI 原生架构：内置 MCP 服务器支持人工智能代理提取、同步、测试和调试
一键解压：几秒钟内将任何现有游戏解压为文件

人工智能驱动开发

RbxSync 是唯一** Roblox 同步工具，原生支持 MCP（模型上下文协议）。像 Claude 和 Cursor 这样的 AI 助手可以：

**自动将Studio中的游戏提取到文件中
编辑代码并同步即时更改
运行游戏测试并实时查看控制台输出
**在测试中控制角色（移动、互动、装备工具）
**基于运行时输出自主调试错误

Rojo、Argon 和 Pesto 不支持 MCP。请参见 MCP 集成以建立 AI 辅助开发。

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

RbxSync

Bidirectional sync between Roblox Studio and filesystem. Full property preservation, git integration, and native MCP support for AI-assisted development.

Key Features

One Source of Truth: Everyone syncs from git. No more “which version is latest?”
Full Property Preservation: Serializes all instance properties using .rbxjson format with explicit type annotations
True Two-Way Sync: Edit in Studio or VS Code—changes sync automatically in both directions
AI-Native Architecture: Built-in MCP server lets AI agents extract, sync, test, and debug
One-Click Extraction: Extract any existing game to files in seconds

AI-Powered Development

RbxSync is the only Roblox sync tool with native MCP (Model Context Protocol) support. AI assistants like Claude and Cursor can:

Extract games from Studio to files automatically
Edit code and sync changes instantly
Run playtests and see console output in real-time
Control characters during tests (move, interact, equip tools)
Debug errors autonomously based on runtime output

Rojo, Argon, and Pesto do not support MCP. See MCP Integration to set up AI-assisted development.

Feature Comparison

Feature	RbxSync	Rojo	Argon	Pesto
Native MCP/AI integration	✅	❌	❌	◐ Sourcemaps
Automatic two-way sync	✅	⚙️ Syncback	✅	⚙️ Pro ($6.99)
One-click game extraction	✅	⚙️ Manual setup	❌	✅
Full property serialization	✅ JSON	◐ XML/Binary	◐ XML	✅
E2E testing from CLI	✅	❌	❌	❌
Console streaming	✅	❌	❌	❌
Build to .rbxl/.rbxm	✅	✅	✅	❌
Build --watch mode	✅	✅	✅	❌
Multi-IDE (OpenVSX)	✅	✅	✅	✅

Legend: ✅ Native support | ⚙️ Requires setup/plugins | ◐ Partial | ❌ Not available

Installation

You need three components: the CLI (runs the sync server), the Studio Plugin, and optionally the VS Code Extension.

1. Install CLI (Required)

The CLI runs the sync server that connects Studio and VS Code.

macOS (one command):

curl -fsSL https://raw.githubusercontent.com/Smokestack-Games/rbxsync/master/scripts/install.sh | sh

Windows (PowerShell):

irm https://raw.githubusercontent.com/Smokestack-Games/rbxsync/master/scripts/install.ps1 | iex

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "rbxsync": {
      "command": "/path/to/rbxsync-mcp"
    }
  }
}