用途:Rojo 将文件系统项目映射为 Roblox 实例,让开发者用外部工具(VS Code、Git、linter、formatter)编辑代码,并通过实时同步或构建写入 Studio/place 文件。本技能覆盖 Rojo 7。
主要能力:Rojo CLI 读取项目文件与文件系统,提供实时同步、构建 place/model 文件、上传、sourcemap、syncback;Studio 插件连接本地 serve 会话并应用补丁;项目文件(*.project.json / *.project.jsonc)描述实例树与选项;文件系统树中的脚本、模型、JSON/TOML/YAML/CSV/文本在 $path 节点下变为实例。
使用方式:安装 CLI(推荐 Rokit,也支持 GitHub 二进制或 cargo install rojo --version ^7);用 rojo plugin install 安装 Studio 插件;rojo init my-game 初始化;在项目文件夹运行 rojo serve;在 Studio 打开 Rojo 插件面板并 Connect;编辑磁盘文件即可同步;用 rojo build -o build.rbxlx 生成一次性 place 文件。常用命令还包括 rojo sourcemap --output sourcemap.json、rojo upload --asset_id PLACE_ID --cookie "..."、rojo syncback . --input place.rbxl。
适用场景:新项目搭建、现有游戏移植、团队协作与 CI 构建、编辑器工具链集成。
限制:实时同步为文件系统到 Studio 单向,插件双向同步为实验性且不完整,不应作为生产工作流;部分属性类型(如 Terrain、CSG 二进制数据、MeshPart.MeshId、HttpService.HttpEnabled)无法实时应用,需重新构建并打开 place;rojo serve 默认绑定回环地址,暴露到网络需谨慎使用 serveAllowedHosts / --allowed-hosts;CLI 与插件应固定同一主版本,升级 CLI 后需重新运行 rojo plugin install;不要提交 .ROBLOSECURITY cookie 或 Open Cloud API key。