@weppy/roblox-mcp 2.0.1 → 2.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +3 -3
- package/CHANGELOG.md +10 -0
- package/COMMERCIAL-LICENSE.md +13 -0
- package/Dockerfile +13 -0
- package/LICENSE +648 -40
- package/README.md +31 -2
- package/TRADEMARKS.md +18 -0
- package/docs/assets/screenshots/license/license-dashboard.png +3 -0
- package/docs/assets/screenshots/license/license-plugin.png +3 -0
- package/docs/compatibility.md +1 -1
- package/docs/en/installation/README.md +25 -2
- package/docs/en/installation/ai-apps/cursor.md +77 -0
- package/docs/en/installation/roblox-explorer.md +5 -5
- package/docs/en/installation/roblox-plugin.md +1 -0
- package/docs/en/pro-upgrade.md +36 -12
- package/docs/es/README.md +29 -10
- package/docs/es/installation/README.md +25 -2
- package/docs/es/installation/ai-apps/cursor.md +77 -0
- package/docs/es/installation/roblox-plugin.md +1 -0
- package/docs/es/pro-upgrade.md +37 -13
- package/docs/id/README.md +29 -10
- package/docs/id/installation/README.md +25 -2
- package/docs/id/installation/ai-apps/cursor.md +77 -0
- package/docs/id/installation/roblox-plugin.md +1 -0
- package/docs/id/pro-upgrade.md +36 -12
- package/docs/ja/README.md +29 -10
- package/docs/ja/installation/README.md +25 -2
- package/docs/ja/installation/ai-apps/cursor.md +77 -0
- package/docs/ja/installation/roblox-plugin.md +1 -0
- package/docs/ja/pro-upgrade.md +35 -11
- package/docs/ko/README.md +28 -9
- package/docs/ko/installation/README.md +25 -2
- package/docs/ko/installation/ai-apps/cursor.md +77 -0
- package/docs/ko/installation/roblox-explorer.md +5 -5
- package/docs/ko/installation/roblox-plugin.md +1 -0
- package/docs/ko/pro-upgrade.md +35 -11
- package/docs/pt-br/README.md +29 -10
- package/docs/pt-br/installation/README.md +25 -2
- package/docs/pt-br/installation/ai-apps/cursor.md +77 -0
- package/docs/pt-br/installation/roblox-plugin.md +1 -0
- package/docs/pt-br/pro-upgrade.md +37 -13
- package/glama.json +7 -0
- package/install.ps1 +277 -0
- package/install.sh +307 -0
- package/llms-full.txt +92 -7
- package/llms.txt +13 -1
- package/package.json +14 -3
- package/plugins/weppy-roblox-mcp/.claude-plugin/plugin.json +2 -2
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ChangelogDetailPage-Ss9rBuou.js → ChangelogDetailPage-IgHLnaEX.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ChangelogPage-Br-A5H5t.css +1 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ChangelogPage-Dao4jPQA.js +1 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ConfirmModal-CvXLNYq0.js +1 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ConfirmModal-tvPLhSO9.css +1 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ConnectionPage-Bl7tLgL2.js +1 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ConnectionPage-CN3LYLAT.css +1 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/InfoLabel-vz7vtbbV.js +1 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{OverviewPage-BcSHb-KS.js → OverviewPage-BDDctbAl.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/PlaytestPage-C0iCoAQp.js +1 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/PlaytestPage-LnuHE5FL.css +1 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{PropertyDiff-BGBA0lal.js → PropertyDiff-CbDafceC.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SettingsPage-CJs9ctOf.js +1 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SettingsPage-DP9OFhNb.css +1 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{StatusBadge-C_KxiYEt.js → StatusBadge-BMTgkxDJ.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SyncPage-Bf1SdHGg.css +1 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SyncPage-BfXIBNVS.js +4 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{TierPromoPanel-B2hY_Iul.js → TierPromoPanel-CUrTMsXB.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/TierPromoProgress-DBA-FZGE.js +1 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ToolsPage-BZZZ3FXe.css +1 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ToolsPage-O4dXhEU-.js +1 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/index-CkXvRg-O.js +69 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{tier-promo-config-BFJCz95t.js → tier-promo-config-B9lIKWCQ.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{useLiveUptime-Gqoo4lJE.js → useLiveUptime-DXXyWm6j.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/index.html +1 -1
- package/plugins/weppy-roblox-mcp/dist/index.js +58 -57
- package/plugins/weppy-roblox-mcp/roblox-plugin/WeppyRobloxMCP.rbxm +3 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ChangelogPage-ByQDwNhh.css +0 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ChangelogPage-D_OScUeF.js +0 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ConnectionPage-C3QU6eRJ.js +0 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ConnectionPage-CkQVyTc5.css +0 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/InfoLabel-Cvotfyns.js +0 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/PlaytestPage-CqIxk3qY.js +0 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/PlaytestPage-emQ5xjZz.css +0 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SettingsPage-D-SyrBho.js +0 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SettingsPage-NF_CPSvZ.css +0 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SyncPage-BNHvpQxD.css +0 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SyncPage-DeQjKxmi.js +0 -4
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/TierPromoProgress-B9L7tJGd.js +0 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ToolsPage-CzFt06tW.js +0 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ToolsPage-cVoMPYAn.css +0 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/index-mMUjBHCe.js +0 -69
|
@@ -14,7 +14,29 @@ AI 앱이 "파란 파트를 만들어줘"라고 하면, MCP 서버가 이 요청
|
|
|
14
14
|
|
|
15
15
|
---
|
|
16
16
|
|
|
17
|
-
##
|
|
17
|
+
## 원라인 설치 (권장)
|
|
18
|
+
|
|
19
|
+
MCP 서버, Roblox Studio 플러그인, AI 앱 등록을 한 번에 진행합니다:
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
# macOS / Linux
|
|
23
|
+
curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
|
|
24
|
+
|
|
25
|
+
# Windows (PowerShell)
|
|
26
|
+
irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
Roblox Studio를 재시작하면 완료입니다!
|
|
30
|
+
|
|
31
|
+
Windows에서 PowerShell 실행이 차단되면 아래 수동 설치로 진행하세요. ZIP 패키지를 사용하는 경우 `setup-plugin.bat`, `setup-mcp.bat`를 실행할 수 있습니다.
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## 수동 설치
|
|
36
|
+
|
|
37
|
+
원라인 설치가 동작하지 않거나 환경상 자동 설치를 사용할 수 없는 경우에 진행하는 대안 설치 방법입니다.
|
|
38
|
+
|
|
39
|
+
### 1단계: Roblox Studio 플러그인 설치
|
|
18
40
|
|
|
19
41
|
GitHub에서 플러그인 파일을 다운로드한 뒤, Roblox Studio의 Plugins 폴더에 넣으면 됩니다.
|
|
20
42
|
|
|
@@ -22,7 +44,7 @@ GitHub에서 플러그인 파일을 다운로드한 뒤, Roblox Studio의 Plugin
|
|
|
22
44
|
|
|
23
45
|
---
|
|
24
46
|
|
|
25
|
-
|
|
47
|
+
### 2단계: AI 앱에 MCP 서버 등록
|
|
26
48
|
|
|
27
49
|
사용하는 AI 앱에 MCP 서버를 등록합니다. MCP를 지원하는 모든 AI 앱에서 사용할 수 있어요.
|
|
28
50
|
|
|
@@ -30,6 +52,7 @@ GitHub에서 플러그인 파일을 다운로드한 뒤, Roblox Studio의 Plugin
|
|
|
30
52
|
|-------|-------------|
|
|
31
53
|
| Claude Code | [설정 방법](ai-apps/claude-code.md) |
|
|
32
54
|
| Claude Desktop | [설정 방법](ai-apps/claude-app.md) |
|
|
55
|
+
| Cursor | [설정 방법](ai-apps/cursor.md) |
|
|
33
56
|
| Codex CLI | [설정 방법](ai-apps/codex-cli.md) |
|
|
34
57
|
| Codex Desktop | [설정 방법](ai-apps/codex-app.md) |
|
|
35
58
|
| Gemini CLI | [설정 방법](ai-apps/gemini-cli.md) |
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
# Cursor 설정
|
|
2
|
+
|
|
3
|
+
[Cursor](https://cursor.com/)에서 Roblox MCP를 사용하는 방법입니다.
|
|
4
|
+
|
|
5
|
+
## 사전 요구사항
|
|
6
|
+
|
|
7
|
+
- **Cursor** 설치됨
|
|
8
|
+
- **Node.js** (v18.0.0 이상)
|
|
9
|
+
- **Roblox Studio 플러그인** 설치 완료
|
|
10
|
+
|
|
11
|
+
## MCP 서버 등록
|
|
12
|
+
|
|
13
|
+
### 방법 1: 프로젝트 설정
|
|
14
|
+
|
|
15
|
+
프로젝트의 `.cursor/mcp.json` 파일에 아래 내용을 추가하세요:
|
|
16
|
+
|
|
17
|
+
```json
|
|
18
|
+
{
|
|
19
|
+
"mcpServers": {
|
|
20
|
+
"weppy-roblox-mcp": {
|
|
21
|
+
"command": "npx",
|
|
22
|
+
"args": ["-y", "@weppy/roblox-mcp"]
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
### 방법 2: 글로벌 설정
|
|
29
|
+
|
|
30
|
+
전역 Cursor MCP 설정 파일에 같은 내용을 추가하세요.
|
|
31
|
+
|
|
32
|
+
**설정 파일 위치:**
|
|
33
|
+
|
|
34
|
+
| 범위 | 경로 |
|
|
35
|
+
|------|------|
|
|
36
|
+
| 프로젝트 | `<프로젝트>/.cursor/mcp.json` |
|
|
37
|
+
| 글로벌 (macOS/Linux) | `~/.cursor/mcp.json` |
|
|
38
|
+
| 글로벌 (Windows) | `%USERPROFILE%\\.cursor\\mcp.json` |
|
|
39
|
+
|
|
40
|
+
> 파일이 이미 있으면 기존 `mcpServers` 객체 안에 `weppy-roblox-mcp` 항목만 병합하세요.
|
|
41
|
+
|
|
42
|
+
### 적용
|
|
43
|
+
|
|
44
|
+
설정을 수정한 뒤 Cursor 창을 다시 로드하거나 앱을 재시작하세요.
|
|
45
|
+
|
|
46
|
+
## 연결 테스트
|
|
47
|
+
|
|
48
|
+
1. **Roblox Studio** 실행 → Plugins 탭 → **W-MCP** → **Connect**
|
|
49
|
+
2. **Cursor**에서 다음을 입력:
|
|
50
|
+
```
|
|
51
|
+
Roblox Studio에서 현재 선택된 것을 알려줘
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
## 문제 해결
|
|
55
|
+
|
|
56
|
+
### MCP 서버가 보이지 않을 때
|
|
57
|
+
|
|
58
|
+
- 설정 파일 경로가 올바른지 확인
|
|
59
|
+
- JSON 문법이 유효한지 확인
|
|
60
|
+
- 설정 변경 후 Cursor를 다시 로드했는지 확인
|
|
61
|
+
|
|
62
|
+
### 서버가 시작되지 않을 때
|
|
63
|
+
|
|
64
|
+
MCP 서버를 직접 실행하여 오류를 확인하세요:
|
|
65
|
+
|
|
66
|
+
```bash
|
|
67
|
+
npx -y @weppy/roblox-mcp
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
### 연결 실패
|
|
71
|
+
|
|
72
|
+
- Roblox Studio 플러그인이 **Connected** 상태인지 확인
|
|
73
|
+
- 포트 3002가 방화벽에 의해 차단되지 않았는지 확인
|
|
74
|
+
|
|
75
|
+
## 참고 자료
|
|
76
|
+
|
|
77
|
+
- [Cursor MCP 문서](https://docs.cursor.com/context/model-context-protocol)
|
|
@@ -11,11 +11,11 @@ Roblox Studio의 Explorer와 동일한 인스턴스 트리를 VSCode에서 볼
|
|
|
11
11
|
|
|
12
12
|
## 설치 방법
|
|
13
13
|
|
|
14
|
-
### 1.
|
|
14
|
+
### 1. 릴리스 ZIP 다운로드
|
|
15
15
|
|
|
16
|
-
[Releases](https://github.com/hope1026/weppy-roblox-mcp/releases) 페이지에서 최신 `weppy-roblox-explorer
|
|
16
|
+
[Releases](https://github.com/hope1026/weppy-roblox-mcp/releases) 페이지에서 최신 `weppy-roblox-explorer-v*.zip` 파일을 다운로드합니다.
|
|
17
17
|
|
|
18
|
-
>
|
|
18
|
+
> ZIP 패키지 안에 VSCode에 설치할 `weppy-roblox-explorer-*.vsix` 파일이 들어 있습니다.
|
|
19
19
|
|
|
20
20
|
### 2. VSCode에서 설치
|
|
21
21
|
|
|
@@ -25,7 +25,7 @@ Roblox Studio의 Explorer와 동일한 인스턴스 트리를 VSCode에서 볼
|
|
|
25
25
|
|
|
26
26
|

|
|
27
27
|
|
|
28
|
-
4.
|
|
28
|
+
4. ZIP을 압축 해제한 뒤 포함된 `.vsix` 파일을 선택합니다
|
|
29
29
|
5. 안내에 따라 VSCode를 리로드합니다
|
|
30
30
|
|
|
31
31
|
## 기능
|
|
@@ -60,7 +60,7 @@ Roblox Studio의 Explorer와 동일한 인스턴스 트리를 VSCode에서 볼
|
|
|
60
60
|
|
|
61
61
|
## 업데이트
|
|
62
62
|
|
|
63
|
-
[Releases](https://github.com/hope1026/weppy-roblox-mcp/releases)에서 최신 `.vsix`를
|
|
63
|
+
[Releases](https://github.com/hope1026/weppy-roblox-mcp/releases)에서 최신 `weppy-roblox-explorer-v*.zip`를 다운로드하고 `.vsix`를 압축 해제한 뒤 동일한 설치 과정을 반복하면 됩니다. 기존 버전이 자동으로 교체됩니다.
|
|
64
64
|
|
|
65
65
|
## 관련 문서
|
|
66
66
|
|
|
@@ -39,6 +39,7 @@ MCP 서버가 설치되어 있어야 합니다. 사용하는 AI 앱에 맞는
|
|
|
39
39
|
|-------|-------------|
|
|
40
40
|
| Claude Code | [설정 방법](ai-apps/claude-code.md) |
|
|
41
41
|
| Claude Desktop | [설정 방법](ai-apps/claude-app.md) |
|
|
42
|
+
| Cursor | [설정 방법](ai-apps/cursor.md) |
|
|
42
43
|
| Codex CLI | [설정 방법](ai-apps/codex-cli.md) |
|
|
43
44
|
| Codex Desktop | [설정 방법](ai-apps/codex-app.md) |
|
|
44
45
|
| Gemini CLI | [설정 방법](ai-apps/gemini-cli.md) |
|
package/docs/ko/pro-upgrade.md
CHANGED
|
@@ -17,28 +17,54 @@ Pro Sync는 단방향 내보내기를 넘어섭니다. 로컬에서 스크립트
|
|
|
17
17
|
|
|
18
18
|
대량 및 고급 작업으로 반복 호출을 줄여 프롬프트 한 번에 더 많은 작업을 처리합니다.
|
|
19
19
|
|
|
20
|
+
### AI가 플레이테스트를 직접 제어
|
|
21
|
+
|
|
22
|
+
Studio 플레이테스트를 AI가 실행하고 검증합니다. F5(Play)/F8(Run) 시작/정지는 물론, 테스트 스크립트를 주입하고 로그를 수집해 리포트까지 자동 생성합니다.
|
|
23
|
+
|
|
24
|
+
- "Run 모드로 플레이테스트 시작하고, NPC가 목표 지점까지 이동하는지 확인해줘."
|
|
25
|
+
- "SpawnLocation이 지면 위에 있는지 테스트 스크립트를 작성해서 자동 실행해줘."
|
|
26
|
+
- "방금 수정한 스크립트가 에러 없이 동작하는지 플레이테스트로 검증해줘."
|
|
27
|
+
|
|
20
28
|
### 더 넓은 고급 기능
|
|
21
29
|
|
|
22
30
|
지형 생성, 에셋 검색, 공간 분석, 애니메이션, 오디오, 대규모 자동화.
|
|
23
31
|
|
|
24
|
-
##
|
|
32
|
+
## 구매 후 활성화
|
|
25
33
|
|
|
26
34
|
### 1단계: Gumroad에서 Pro 구독 라이선스 구매
|
|
27
35
|
|
|
28
36
|
1. [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/faccjs?utm_source=github&utm_medium=repo&utm_campaign=pro_upgrade_md) 접속
|
|
29
37
|
2. Pro 구독 라이선스 구매 완료
|
|
38
|
+
3. 결제 완료 후 받은 라이선스 키를 복사
|
|
39
|
+
|
|
40
|
+
라이선스는 **플러그인 또는 대시보드 중 한 곳에서만 한 번 활성화하면 충분합니다.** 두 화면은 같은 MCP 로컬 라이선스 상태를 공유하므로, 한쪽에서 활성화하면 다른 쪽에도 같은 상태가 반영됩니다.
|
|
41
|
+
|
|
42
|
+
### 플러그인에서 활성화
|
|
43
|
+
|
|
44
|
+
1. Roblox Studio에서 **W-MCP** 플러그인을 열고 MCP 서버에 연결합니다.
|
|
45
|
+
2. 플러그인의 **Settings > License** 섹션을 엽니다.
|
|
46
|
+
3. `License key` 입력창에 구매한 키를 붙여넣습니다.
|
|
47
|
+
4. **Activate** 버튼을 눌러 라이선스를 활성화합니다.
|
|
48
|
+
5. 상태가 바로 갱신되지 않으면 **Refresh** 버튼으로 다시 확인합니다.
|
|
49
|
+
6. 활성화가 완료되면 Basic 대신 Pro 상태로 표시되고 Pro 기능을 사용할 수 있습니다.
|
|
50
|
+
|
|
51
|
+

|
|
52
|
+
|
|
53
|
+
### 대시보드에서 활성화
|
|
30
54
|
|
|
31
|
-
|
|
55
|
+
1. MCP 서버를 실행한 뒤 대시보드의 **Settings > License** 섹션을 엽니다.
|
|
56
|
+
2. Provider가 `gumroad`로 선택되어 있는지 확인합니다.
|
|
57
|
+
3. `License Key` 입력창에 구매한 키를 붙여넣습니다.
|
|
58
|
+
4. **Activate License** 버튼을 눌러 라이선스를 활성화합니다.
|
|
59
|
+
5. 필요하면 **Refresh License**로 최신 상태를 다시 조회합니다.
|
|
32
60
|
|
|
33
|
-
|
|
34
|
-
2. `weppy-roblox-mcp-v{version}.zip` 다운로드
|
|
35
|
-
3. 압축 해제 후 `roblox-plugin/WeppyRobloxMCP.rbxm`를 Roblox Plugins 폴더에 복사
|
|
61
|
+

|
|
36
62
|
|
|
37
|
-
###
|
|
63
|
+
### 활성화 후 확인
|
|
38
64
|
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
65
|
+
- 라이선스 상태가 `active` 또는 `grace`로 표시되면 Pro 기능을 사용할 수 있습니다.
|
|
66
|
+
- 플러그인과 대시보드는 같은 라이선스 상태를 공유하므로, 한쪽에서 활성화한 뒤 다른 쪽에서도 동일한 상태를 확인할 수 있습니다.
|
|
67
|
+
- 라이선스를 다시 확인해야 할 때는 `Refresh` 또는 `Refresh License`를 사용하세요.
|
|
42
68
|
|
|
43
69
|
## 기능 비교
|
|
44
70
|
|
|
@@ -49,8 +75,6 @@ Pro Sync는 단방향 내보내기를 넘어섭니다. 로컬에서 스크립트
|
|
|
49
75
|
| Sync 방향 | Studio → Local (단방향) | 양방향 |
|
|
50
76
|
| 타입별 Sync Direction | ❌ | ✅ Scripts / Values / Containers / Data / Services |
|
|
51
77
|
| 타입별 Apply Mode | ❌ | ✅ Auto / Manual |
|
|
52
|
-
| Full Sync | ❌ | ✅ |
|
|
53
|
-
| Resync / 상태 재구축 | ❌ | ✅ |
|
|
54
78
|
| 변경 기록 | ❌ | ✅ |
|
|
55
79
|
| 멀티 Place Sync | ❌ | ✅ 최대 3개 Place, 각각 독립 저장소 |
|
|
56
80
|
| 플레이테스트 제어 (실행/정지/일시정지/재개) | ❌ | ✅ |
|
package/docs/pt-br/README.md
CHANGED
|
@@ -8,10 +8,28 @@
|
|
|
8
8
|
|
|
9
9
|
[](https://youtu.be/3jrUpBbZPaw)
|
|
10
10
|
|
|
11
|
-
## Instalacao rapida
|
|
11
|
+
## Instalacao rapida
|
|
12
|
+
|
|
13
|
+
**Instalacao em um comando** — Instala o servidor MCP, o plugin do Roblox Studio e registra nos apps de IA em um único passo:
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
# macOS / Linux
|
|
17
|
+
curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
|
|
18
|
+
|
|
19
|
+
# Windows (PowerShell)
|
|
20
|
+
irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Reinicie o Roblox Studio — pronto!
|
|
24
|
+
|
|
25
|
+
Se a execução do PowerShell estiver bloqueada no Windows, siga a instalação manual abaixo. Se estiver usando o pacote ZIP, você também pode usar `setup-plugin.bat` e `setup-mcp.bat`.
|
|
26
|
+
|
|
27
|
+
### Instalacao manual
|
|
28
|
+
|
|
29
|
+
Se a instalação em um comando não funcionar, ou se a instalação automática não puder ser usada no seu ambiente, use a instalação manual abaixo como alternativa.
|
|
12
30
|
|
|
13
31
|
**Passo 1** — Instale o plugin do Roblox Studio (ponte entre Studio e IA):
|
|
14
|
-
[Guia de instalacao do plugin](
|
|
32
|
+
[Guia de instalacao do plugin](installation/roblox-plugin.md)
|
|
15
33
|
|
|
16
34
|
**Passo 2** — Registre o servidor MCP no seu app de IA:
|
|
17
35
|
|
|
@@ -21,11 +39,12 @@ npx -y @weppy/roblox-mcp
|
|
|
21
39
|
|
|
22
40
|
| App de IA | Guia |
|
|
23
41
|
|-----------|------|
|
|
24
|
-
| Claude Code | [Configuracao](
|
|
25
|
-
| Claude Desktop | [Configuracao](
|
|
26
|
-
|
|
|
27
|
-
| Codex
|
|
28
|
-
|
|
|
42
|
+
| Claude Code | [Configuracao](installation/ai-apps/claude-code.md) |
|
|
43
|
+
| Claude Desktop | [Configuracao](installation/ai-apps/claude-app.md) |
|
|
44
|
+
| Cursor | [Configuracao](installation/ai-apps/cursor.md) |
|
|
45
|
+
| Codex CLI | [Configuracao](installation/ai-apps/codex-cli.md) |
|
|
46
|
+
| Codex Desktop | [Configuracao](installation/ai-apps/codex-app.md) |
|
|
47
|
+
| Gemini CLI | [Configuracao](installation/ai-apps/gemini-cli.md) |
|
|
29
48
|
|
|
30
49
|
> Funciona com qualquer cliente MCP compativel. O comando do servidor e `npx -y @weppy/roblox-mcp`.
|
|
31
50
|
|
|
@@ -95,11 +114,11 @@ Visualize a arvore completa de instancias do seu lugar no Roblox Studio diretame
|
|
|
95
114
|
|
|
96
115
|
## Documentacao detalhada
|
|
97
116
|
|
|
98
|
-
- [Guia de instalacao](
|
|
117
|
+
- [Guia de instalacao](installation/README.md)
|
|
99
118
|
- [Lista completa de tools](tools/overview.md)
|
|
100
119
|
- [Guia detalhado de Sync](sync/overview.md)
|
|
101
120
|
- [Guia do Dashboard](dashboard/overview.md)
|
|
102
|
-
- [Roblox Explorer (Extensao VSCode)](
|
|
121
|
+
- [Roblox Explorer (Extensao VSCode)](installation/roblox-explorer.md)
|
|
103
122
|
- [Compatibilidade](../compatibility.md)
|
|
104
123
|
- [Solucao de problemas](../troubleshooting.md)
|
|
105
124
|
|
|
@@ -116,7 +135,7 @@ Visualize a arvore completa de instancias do seu lugar no Roblox Studio diretame
|
|
|
116
135
|
|
|
117
136
|
Sync bidirecional, recursos avancados de criacao e eficiencia de tokens de IA — tudo em uma unica atualizacao.
|
|
118
137
|
|
|
119
|
-
[Guia de upgrade Pro](
|
|
138
|
+
[Guia de upgrade Pro](pro-upgrade.md)
|
|
120
139
|
|
|
121
140
|
---
|
|
122
141
|
|
|
@@ -14,7 +14,29 @@ Quando o app de IA diz "cria uma parte azul", o servidor MCP converte o pedido e
|
|
|
14
14
|
|
|
15
15
|
---
|
|
16
16
|
|
|
17
|
-
##
|
|
17
|
+
## Instalação em um comando (Recomendado)
|
|
18
|
+
|
|
19
|
+
Instala o servidor MCP, o plugin do Roblox Studio e registra nos apps de IA em um único passo:
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
# macOS / Linux
|
|
23
|
+
curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
|
|
24
|
+
|
|
25
|
+
# Windows (PowerShell)
|
|
26
|
+
irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
Reinicie o Roblox Studio — pronto!
|
|
30
|
+
|
|
31
|
+
Se a execução do PowerShell estiver bloqueada no Windows, siga a instalação manual abaixo. Se estiver usando o pacote ZIP, você também pode executar `setup-plugin.bat` e `setup-mcp.bat`.
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## Instalação manual
|
|
36
|
+
|
|
37
|
+
Este é o método alternativo para quando a instalação em um comando não funcionar, ou quando a instalação automática não puder ser usada no seu ambiente.
|
|
38
|
+
|
|
39
|
+
### Passo 1: Instalar plugin do Roblox Studio
|
|
18
40
|
|
|
19
41
|
Baixe o arquivo do plugin no GitHub e coloque na pasta Plugins do Roblox Studio.
|
|
20
42
|
|
|
@@ -22,7 +44,7 @@ Baixe o arquivo do plugin no GitHub e coloque na pasta Plugins do Roblox Studio.
|
|
|
22
44
|
|
|
23
45
|
---
|
|
24
46
|
|
|
25
|
-
|
|
47
|
+
### Passo 2: Registrar servidor MCP no app de IA
|
|
26
48
|
|
|
27
49
|
Registre o servidor MCP no seu app de IA. Funciona com qualquer app que suporte MCP.
|
|
28
50
|
|
|
@@ -30,6 +52,7 @@ Registre o servidor MCP no seu app de IA. Funciona com qualquer app que suporte
|
|
|
30
52
|
|-----------|-------------------|
|
|
31
53
|
| Claude Code | [Como Configurar](ai-apps/claude-code.md) |
|
|
32
54
|
| Claude Desktop | [Como Configurar](ai-apps/claude-app.md) |
|
|
55
|
+
| Cursor | [Como Configurar](ai-apps/cursor.md) |
|
|
33
56
|
| Codex CLI | [Como Configurar](ai-apps/codex-cli.md) |
|
|
34
57
|
| Codex Desktop | [Como Configurar](ai-apps/codex-app.md) |
|
|
35
58
|
| Gemini CLI | [Como Configurar](ai-apps/gemini-cli.md) |
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
# Configuração do Cursor
|
|
2
|
+
|
|
3
|
+
Como usar o Roblox MCP com [Cursor](https://cursor.com/).
|
|
4
|
+
|
|
5
|
+
## Pré-requisitos
|
|
6
|
+
|
|
7
|
+
- **Cursor** instalado
|
|
8
|
+
- **Node.js** (v18.0.0 ou superior)
|
|
9
|
+
- **Plugin do Roblox Studio** instalado
|
|
10
|
+
|
|
11
|
+
## Registrar o servidor MCP
|
|
12
|
+
|
|
13
|
+
### Método 1: Configuração do projeto
|
|
14
|
+
|
|
15
|
+
Adicione o seguinte em `.cursor/mcp.json` dentro do seu projeto:
|
|
16
|
+
|
|
17
|
+
```json
|
|
18
|
+
{
|
|
19
|
+
"mcpServers": {
|
|
20
|
+
"weppy-roblox-mcp": {
|
|
21
|
+
"command": "npx",
|
|
22
|
+
"args": ["-y", "@weppy/roblox-mcp"]
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
### Método 2: Configuração global
|
|
29
|
+
|
|
30
|
+
Adicione o mesmo conteúdo ao arquivo global de configuração do Cursor.
|
|
31
|
+
|
|
32
|
+
**Locais do arquivo de configuração:**
|
|
33
|
+
|
|
34
|
+
| Escopo | Caminho |
|
|
35
|
+
|--------|---------|
|
|
36
|
+
| Projeto | `<projeto>/.cursor/mcp.json` |
|
|
37
|
+
| Global (macOS/Linux) | `~/.cursor/mcp.json` |
|
|
38
|
+
| Global (Windows) | `%USERPROFILE%\\.cursor\\mcp.json` |
|
|
39
|
+
|
|
40
|
+
> Se o arquivo já existir, mescle a entrada `weppy-roblox-mcp` dentro do objeto `mcpServers`.
|
|
41
|
+
|
|
42
|
+
### Aplicar alterações
|
|
43
|
+
|
|
44
|
+
Depois de editar a configuração, recarregue a janela do Cursor ou reinicie o aplicativo.
|
|
45
|
+
|
|
46
|
+
## Teste de conexão
|
|
47
|
+
|
|
48
|
+
1. Abra o **Roblox Studio** → aba Plugins → **W-MCP** → **Connect**
|
|
49
|
+
2. No **Cursor**, digite:
|
|
50
|
+
```
|
|
51
|
+
Tell me what's currently selected in Roblox Studio
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
## Solução de problemas
|
|
55
|
+
|
|
56
|
+
### O servidor MCP não aparece
|
|
57
|
+
|
|
58
|
+
- Verifique se o caminho do arquivo de configuração está correto
|
|
59
|
+
- Confirme que a sintaxe JSON está válida
|
|
60
|
+
- Recarregue o Cursor após editar a configuração
|
|
61
|
+
|
|
62
|
+
### O servidor não inicia
|
|
63
|
+
|
|
64
|
+
Execute o servidor MCP diretamente para verificar erros:
|
|
65
|
+
|
|
66
|
+
```bash
|
|
67
|
+
npx -y @weppy/roblox-mcp
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
### Falha na conexão
|
|
71
|
+
|
|
72
|
+
- Verifique se o plugin do Roblox Studio está no estado **Connected**
|
|
73
|
+
- Confira se a porta 3002 está bloqueada pelo firewall
|
|
74
|
+
|
|
75
|
+
## Referência
|
|
76
|
+
|
|
77
|
+
- [Documentação do Cursor MCP](https://docs.cursor.com/context/model-context-protocol)
|
|
@@ -39,6 +39,7 @@ O servidor MCP deve estar instalado. Complete primeiro o guia do seu app de IA:
|
|
|
39
39
|
|------------------|---------------------|
|
|
40
40
|
| Claude Code | [Como Configurar](ai-apps/claude-code.md) |
|
|
41
41
|
| Claude Desktop | [Como Configurar](ai-apps/claude-app.md) |
|
|
42
|
+
| Cursor | [Como Configurar](ai-apps/cursor.md) |
|
|
42
43
|
| Codex CLI | [Como Configurar](ai-apps/codex-cli.md) |
|
|
43
44
|
| Codex Desktop | [Como Configurar](ai-apps/codex-app.md) |
|
|
44
45
|
| Gemini CLI | [Como Configurar](ai-apps/gemini-cli.md) |
|
|
@@ -17,28 +17,54 @@ O Sync do Pro vai além do simples export. Edite scripts localmente e envie para
|
|
|
17
17
|
|
|
18
18
|
Ações em massa e avançadas reduzem chamadas repetitivas — faça mais por prompt.
|
|
19
19
|
|
|
20
|
+
### IA que controla playtests diretamente
|
|
21
|
+
|
|
22
|
+
A IA pode controlar os playtests do Roblox Studio diretamente. Ela pode iniciar e parar Play (F5) ou Run (F8), injetar scripts de teste, coletar logs e gerar relatórios automaticamente.
|
|
23
|
+
|
|
24
|
+
- "Inicia um playtest no modo Run e verifica se o NPC chega ao alvo."
|
|
25
|
+
- "Escreve um teste que verifica se o SpawnLocation está acima do chão e executa."
|
|
26
|
+
- "Valida que o script que acabei de mudar funciona sem erros no playtest."
|
|
27
|
+
|
|
20
28
|
### Capacidades avançadas mais amplas
|
|
21
29
|
|
|
22
30
|
Geração de terrain, busca de assets, análise espacial, animação, áudio e automação em escala de produção.
|
|
23
31
|
|
|
24
|
-
##
|
|
32
|
+
## Comprar e ativar
|
|
25
33
|
|
|
26
|
-
### Passo 1:
|
|
34
|
+
### Passo 1: Compre uma licença de assinatura Pro no Gumroad
|
|
27
35
|
|
|
28
36
|
1. Acesse [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/faccjs?utm_source=github&utm_medium=repo&utm_campaign=pro_upgrade_md)
|
|
29
|
-
2. Conclua a compra da
|
|
37
|
+
2. Conclua a compra da licença de assinatura Pro
|
|
38
|
+
3. Copie a chave de licença que você recebe após a compra
|
|
39
|
+
|
|
40
|
+
Você só precisa ativar a licença uma vez, no plugin ou no dashboard. As duas superfícies compartilham o mesmo estado local de licença do MCP, então a ativação feita em um lugar aparece no outro.
|
|
41
|
+
|
|
42
|
+
### Ativar no plugin
|
|
43
|
+
|
|
44
|
+
1. Abra o **W-MCP** no Roblox Studio e conecte ao servidor MCP.
|
|
45
|
+
2. Abra a seção **Settings > License** no plugin.
|
|
46
|
+
3. Cole a chave comprada no campo `License key`.
|
|
47
|
+
4. Clique em **Activate** para ativar a licença.
|
|
48
|
+
5. Se o status não atualizar imediatamente, clique em **Refresh**.
|
|
49
|
+
6. Quando a ativação terminar, o status muda de Basic para Pro e os recursos Pro ficam disponíveis.
|
|
50
|
+
|
|
51
|
+

|
|
52
|
+
|
|
53
|
+
### Ativar no dashboard
|
|
30
54
|
|
|
31
|
-
|
|
55
|
+
1. Inicie o servidor MCP e abra **Settings > License** no dashboard.
|
|
56
|
+
2. Confirme que o provider está definido como `gumroad`.
|
|
57
|
+
3. Cole a chave comprada no campo `License Key`.
|
|
58
|
+
4. Clique em **Activate License** para ativar a licença.
|
|
59
|
+
5. Se necessário, use **Refresh License** para buscar o status mais recente.
|
|
32
60
|
|
|
33
|
-
|
|
34
|
-
2. Baixe `weppy-roblox-mcp-v{version}.zip`
|
|
35
|
-
3. Extraia e copie `roblox-plugin/WeppyRobloxMCP.rbxm` para a pasta de Plugins do Roblox
|
|
61
|
+

|
|
36
62
|
|
|
37
|
-
###
|
|
63
|
+
### Depois da ativação
|
|
38
64
|
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
65
|
+
- Se o status da licença aparecer como `active` ou `grace`, os recursos Pro já estão disponíveis.
|
|
66
|
+
- O plugin e o dashboard compartilham o mesmo estado de licença, então a ativação feita em um deles aparece no outro.
|
|
67
|
+
- Use **Refresh** ou **Refresh License** sempre que quiser verificar o status mais recente novamente.
|
|
42
68
|
|
|
43
69
|
## Comparação de Recursos
|
|
44
70
|
|
|
@@ -49,8 +75,6 @@ Geração de terrain, busca de assets, análise espacial, animação, áudio e a
|
|
|
49
75
|
| Direção do Sync | Studio → Local (unidirecional) | Bidirecional |
|
|
50
76
|
| Sync Direction por tipo | ❌ | ✅ Scripts / Values / Containers / Data / Services |
|
|
51
77
|
| Apply Mode por tipo | ❌ | ✅ Auto / Manual |
|
|
52
|
-
| Full Sync | ❌ | ✅ |
|
|
53
|
-
| Resync / Reconstruir estado | ❌ | ✅ |
|
|
54
78
|
| Histórico de mudanças | ❌ | ✅ |
|
|
55
79
|
| Sync multi-place | ❌ | ✅ Até 3 places com armazenamento isolado |
|
|
56
80
|
| Controle de Playtest (Reproduzir/Parar/Pausar/Retomar) | ❌ | ✅ |
|