mcpField
R
roblox-studio-hub

roblox-studio-hub

github.com/white-dragon-tools开发057 次安装37 周前更新
代码仓库

关于 roblox-studio-hub

用于通过 Roblox Studio Hub 管理 Roblox Studio 实例并运行 Lua 代码的技能。它支持同时连接多个 Studio、提供多种执行模式，并可通过命令行或 HTTP API 管理。

主要功能

  1. 01管理多个 Studio 实例
  2. 02以 eval、run 或 play 模式执行 Lua
  3. 03列出 Studio 并查看日志
  4. 04管理 Hub 系统服务
  5. 05通过 HTTP API 执行操作

适用场景

  1. 01在已连接的 Studio 中运行 Lua 脚本
  2. 02测试服务器逻辑或完整 Play 模式
  3. 03查看 Studio 状态与日志

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/white-dragon-tools/roblox-studio-hub --skill roblox-studio-hub

安装后在 Claude Code 中输入/roblox-studio-hub确认已加载。

附带文件references/api-reference.mdreferences/lua-patterns.md

详细介绍

Roblox Studio Hub

用于管理多个 Roblox Studio 实例，并通过 CLI 和 HTTP API 远程执行 Lua 代码的工具。

概述

Roblox Studio Hub 提供：

  • 多 Studio 管理 - 同时连接和管理多个 Roblox Studio 实例
  • 远程代码执行 - 通过三种模式（eval、run、play）在 Studio 中执行 Lua 代码
  • CLI 接口 - 功能齐全的命令行界面，支持所有操作
  • 系统服务 - 作为后台服务运行，并在启动时自动启动

架构

┌─────────────────┐     HTTP Long Polling     ┌─────────────────┐
│  Roblox Studio  │ ◄──────────────────────► │   Studio Hub    │
│    (Plugin)     │                           │    (Server)     │
└─────────────────┘                           └────────┬────────┘
                                                       │
                                              ┌────────▼────────┐
                                              │    CLI / API    │
                                              │  localhost:35888│
                                              └─────────────────┘

快速开始

1. 安装 Hub 服务端

必须保证当前运行在 管理员 权限中, 否则提醒用户并中断本次会话.

# Configure GitHub npm registry
npm config set @white-dragon-tools:registry https://npm.pkg.github.com

# Install globally
npm install -g @white-dragon-tools/roblox-studio-hub
2. 注册为系统服务（推荐）
# Register as system service (auto-start on boot)
# Windows: Run as Administrator
# Mac/Linux: Use sudo
roblox-studio-hub install

# Check service status
roblox-studio-hub status
3. 安装 Studio 插件
roblox-studio-hub install-plugin
4. 验证设置
roblox-studio-hub status

CLI 命令参考

所有命令均支持 -h 或 --help，可查看详细帮助。

服务管理
命令描述
roblox-studio-hub serve在前台运行服务端（用于调试）
roblox-studio-hub install注册为系统服务（自动启动）
roblox-studio-hub uninstall卸载系统服务
roblox-studio-hub start启动系统服务
roblox-studio-hub stop停止系统服务
roblox-studio-hub status检查 Hub 服务状态
roblox-studio-hub update更新到最新版本（自动处理服务重启）
Studio 管理
命令描述
roblox-studio-hub list列出所有已连接的 Studio
roblox-studio-hub info <studioId>显示 Studio 详情
roblox-studio-hub logs <studioId> [-n limit]查看 Studio 日志
代码执行
# Basic usage
roblox-studio-hub exec <studioId> <file> [-m mode]

# Examples
roblox-studio-hub exec place:123456 script.lua           # Execute with eval mode
roblox-studio-hub exec local:MyGame test.lua -m run      # Server-side test
roblox-studio-hub exec path:D:/Projects/MyGame test.lua --mode play  # Full play mode
插件管理
roblox-studio-hub install-plugin    # Install Studio plugin
更新 Hub
roblox-studio-hub update

更新命令会自动：

  1. 停止正在运行的服务
  2. 执行 npm update
  3. 重启服务

执行模式

模式描述使用场景
eval通过 loadstring 直接执行（默认）快速脚本、简单测试
run通过 StudioTestService 进行服务端测试服务端逻辑测试
play完整的 Play 模式（服务端 + 客户端）完整的游戏测试

Studio ID 格式

  • 云端 place：place:{placeId}（例如：place:123456）
  • 本地文件：local:{placeName}（例如：local:MyGame）
  • 自定义路径：path:{localPath}（例如：path:D:/Projects/MyGame）

常见工作流

检查已连接的 Studio
# List all connected Studios
roblox-studio-hub list

# Get details of a specific Studio
roblox-studio-hub info place:123456
执行 Lua 脚本
# Create a test script
echo "print('Hello from Hub!'); return 42" > test.lua

# Execute on a connected Studio
roblox-studio-hub exec place:123456 test.lua
查看 Studio 日志
# View last 100 logs (default)
roblox-studio-hub logs place:123456

# View last 50 logs
roblox-studio-hub logs local:MyGame -n 50
将 Hub 更新到最新版本
# Update with automatic service handling
roblox-studio-hub update

# Update plugin if needed
roblox-studio-hub install-plugin

API 参考（用于程序化访问）

检查 Hub 状态
GET /api/status
列出已连接的 Studio
GET /api/studios
获取 Studio 详情
GET /api/studios/:id
获取 Studio 日志
GET /api/studios/:id/logs?limit=100
执行代码
POST /api/execute
Content-Type: application/json

{
  "studioId": "place:123456",
  "code": "print('Hello'); return 42",
  "mode": "eval",
  "timeout": 30
}

配置

环境变量
变量默认值描述
STUDIO_HUB_PORT35888服务端端口

故障排除

问题解决方案
Studio 无法连接在 Studio 设置 → 安全中启用 HTTP 请求
连接超时检查防火墙，并确认端口 35888 已开放
代码执行失败检查 Lua 语法，并查看响应中的错误
Studio 断开连接Hub 会在 35s 未收到心跳后移除不活跃的 Studio
服务无法启动使用管理员/sudo 权限运行 roblox-studio-hub install
更新失败使用管理员/sudo 权限运行

其他资源

参考文件

如需详细的 API 文档和模式，请参阅：

  • references/api-reference.md - 完整的 API 规范
  • references/lua-patterns.md - 用于测试的常见 Lua 代码模式

评论

支持 Markdown