@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.
Files changed (90) hide show
  1. package/.claude-plugin/marketplace.json +3 -3
  2. package/CHANGELOG.md +10 -0
  3. package/COMMERCIAL-LICENSE.md +13 -0
  4. package/Dockerfile +13 -0
  5. package/LICENSE +648 -40
  6. package/README.md +31 -2
  7. package/TRADEMARKS.md +18 -0
  8. package/docs/assets/screenshots/license/license-dashboard.png +3 -0
  9. package/docs/assets/screenshots/license/license-plugin.png +3 -0
  10. package/docs/compatibility.md +1 -1
  11. package/docs/en/installation/README.md +25 -2
  12. package/docs/en/installation/ai-apps/cursor.md +77 -0
  13. package/docs/en/installation/roblox-explorer.md +5 -5
  14. package/docs/en/installation/roblox-plugin.md +1 -0
  15. package/docs/en/pro-upgrade.md +36 -12
  16. package/docs/es/README.md +29 -10
  17. package/docs/es/installation/README.md +25 -2
  18. package/docs/es/installation/ai-apps/cursor.md +77 -0
  19. package/docs/es/installation/roblox-plugin.md +1 -0
  20. package/docs/es/pro-upgrade.md +37 -13
  21. package/docs/id/README.md +29 -10
  22. package/docs/id/installation/README.md +25 -2
  23. package/docs/id/installation/ai-apps/cursor.md +77 -0
  24. package/docs/id/installation/roblox-plugin.md +1 -0
  25. package/docs/id/pro-upgrade.md +36 -12
  26. package/docs/ja/README.md +29 -10
  27. package/docs/ja/installation/README.md +25 -2
  28. package/docs/ja/installation/ai-apps/cursor.md +77 -0
  29. package/docs/ja/installation/roblox-plugin.md +1 -0
  30. package/docs/ja/pro-upgrade.md +35 -11
  31. package/docs/ko/README.md +28 -9
  32. package/docs/ko/installation/README.md +25 -2
  33. package/docs/ko/installation/ai-apps/cursor.md +77 -0
  34. package/docs/ko/installation/roblox-explorer.md +5 -5
  35. package/docs/ko/installation/roblox-plugin.md +1 -0
  36. package/docs/ko/pro-upgrade.md +35 -11
  37. package/docs/pt-br/README.md +29 -10
  38. package/docs/pt-br/installation/README.md +25 -2
  39. package/docs/pt-br/installation/ai-apps/cursor.md +77 -0
  40. package/docs/pt-br/installation/roblox-plugin.md +1 -0
  41. package/docs/pt-br/pro-upgrade.md +37 -13
  42. package/glama.json +7 -0
  43. package/install.ps1 +277 -0
  44. package/install.sh +307 -0
  45. package/llms-full.txt +92 -7
  46. package/llms.txt +13 -1
  47. package/package.json +14 -3
  48. package/plugins/weppy-roblox-mcp/.claude-plugin/plugin.json +2 -2
  49. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ChangelogDetailPage-Ss9rBuou.js → ChangelogDetailPage-IgHLnaEX.js} +1 -1
  50. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ChangelogPage-Br-A5H5t.css +1 -0
  51. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ChangelogPage-Dao4jPQA.js +1 -0
  52. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ConfirmModal-CvXLNYq0.js +1 -0
  53. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ConfirmModal-tvPLhSO9.css +1 -0
  54. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ConnectionPage-Bl7tLgL2.js +1 -0
  55. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ConnectionPage-CN3LYLAT.css +1 -0
  56. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/InfoLabel-vz7vtbbV.js +1 -0
  57. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{OverviewPage-BcSHb-KS.js → OverviewPage-BDDctbAl.js} +1 -1
  58. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/PlaytestPage-C0iCoAQp.js +1 -0
  59. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/PlaytestPage-LnuHE5FL.css +1 -0
  60. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{PropertyDiff-BGBA0lal.js → PropertyDiff-CbDafceC.js} +1 -1
  61. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SettingsPage-CJs9ctOf.js +1 -0
  62. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SettingsPage-DP9OFhNb.css +1 -0
  63. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{StatusBadge-C_KxiYEt.js → StatusBadge-BMTgkxDJ.js} +1 -1
  64. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SyncPage-Bf1SdHGg.css +1 -0
  65. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SyncPage-BfXIBNVS.js +4 -0
  66. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{TierPromoPanel-B2hY_Iul.js → TierPromoPanel-CUrTMsXB.js} +1 -1
  67. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/TierPromoProgress-DBA-FZGE.js +1 -0
  68. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ToolsPage-BZZZ3FXe.css +1 -0
  69. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ToolsPage-O4dXhEU-.js +1 -0
  70. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/index-CkXvRg-O.js +69 -0
  71. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{tier-promo-config-BFJCz95t.js → tier-promo-config-B9lIKWCQ.js} +1 -1
  72. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{useLiveUptime-Gqoo4lJE.js → useLiveUptime-DXXyWm6j.js} +1 -1
  73. package/plugins/weppy-roblox-mcp/dashboard/dist/index.html +1 -1
  74. package/plugins/weppy-roblox-mcp/dist/index.js +58 -57
  75. package/plugins/weppy-roblox-mcp/roblox-plugin/WeppyRobloxMCP.rbxm +3 -0
  76. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ChangelogPage-ByQDwNhh.css +0 -1
  77. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ChangelogPage-D_OScUeF.js +0 -1
  78. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ConnectionPage-C3QU6eRJ.js +0 -1
  79. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ConnectionPage-CkQVyTc5.css +0 -1
  80. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/InfoLabel-Cvotfyns.js +0 -1
  81. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/PlaytestPage-CqIxk3qY.js +0 -1
  82. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/PlaytestPage-emQ5xjZz.css +0 -1
  83. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SettingsPage-D-SyrBho.js +0 -1
  84. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SettingsPage-NF_CPSvZ.css +0 -1
  85. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SyncPage-BNHvpQxD.css +0 -1
  86. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SyncPage-DeQjKxmi.js +0 -4
  87. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/TierPromoProgress-B9L7tJGd.js +0 -1
  88. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ToolsPage-CzFt06tW.js +0 -1
  89. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ToolsPage-cVoMPYAn.css +0 -1
  90. 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
- ## 1단계: Roblox Studio 플러그인 설치
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
- ## 2단계: AI 앱에 MCP 서버 등록
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. VSIX 다운로드
14
+ ### 1. 릴리스 ZIP 다운로드
15
15
 
16
- [Releases](https://github.com/hope1026/weppy-roblox-mcp/releases) 페이지에서 최신 `weppy-roblox-explorer-*.vsix` 파일을 다운로드합니다.
16
+ [Releases](https://github.com/hope1026/weppy-roblox-mcp/releases) 페이지에서 최신 `weppy-roblox-explorer-v*.zip` 파일을 다운로드합니다.
17
17
 
18
- > VSIX 파일은 플러그인 ZIP과 함께 릴리스 asset으로 첨부되어 있습니다.
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
  ![Install from VSIX](../../assets/screenshots/roblox-explorer/install-from-vsix.png)
27
27
 
28
- 4. 다운로드한 `.vsix` 파일을 선택합니다
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) |
@@ -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
+ ![플러그인 라이선스 활성화 화면](../assets/screenshots/license/license-plugin.png)
52
+
53
+ ### 대시보드에서 활성화
30
54
 
31
- ### 2단계: GitHub Releases에서 다운로드
55
+ 1. MCP 서버를 실행한 뒤 대시보드의 **Settings > License** 섹션을 엽니다.
56
+ 2. Provider가 `gumroad`로 선택되어 있는지 확인합니다.
57
+ 3. `License Key` 입력창에 구매한 키를 붙여넣습니다.
58
+ 4. **Activate License** 버튼을 눌러 라이선스를 활성화합니다.
59
+ 5. 필요하면 **Refresh License**로 최신 상태를 다시 조회합니다.
32
60
 
33
- 1. [GitHub Releases](https://github.com/hope1026/weppy-roblox-mcp/releases/latest) 열기
34
- 2. `weppy-roblox-mcp-v{version}.zip` 다운로드
35
- 3. 압축 해제 후 `roblox-plugin/WeppyRobloxMCP.rbxm`를 Roblox Plugins 폴더에 복사
61
+ ![대시보드 라이선스 활성화 화면](../assets/screenshots/license/license-dashboard.png)
36
62
 
37
- ### 3단계: 확인
63
+ ### 활성화 확인
38
64
 
39
- 1. Roblox Studio에서 W-MCP 열기
40
- 2. Pro 배지가 표시되는지 확인
41
- 3. Pro action(예: `manage_sync`, 대량 작업) 실행 확인
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
  | 플레이테스트 제어 (실행/정지/일시정지/재개) | ❌ | ✅ |
@@ -8,10 +8,28 @@
8
8
 
9
9
  [![Demo — IA criando um jogo Roblox em tempo real](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
10
10
 
11
- ## Instalacao rapida (5 minutos)
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](../en/installation/roblox-plugin.md)
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](../en/installation/ai-apps/claude-code.md) |
25
- | Claude Desktop | [Configuracao](../en/installation/ai-apps/claude-app.md) |
26
- | Codex CLI | [Configuracao](../en/installation/ai-apps/codex-cli.md) |
27
- | Codex Desktop | [Configuracao](../en/installation/ai-apps/codex-app.md) |
28
- | Gemini CLI | [Configuracao](../en/installation/ai-apps/gemini-cli.md) |
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](../en/installation/README.md)
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)](../en/installation/roblox-explorer.md)
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](../en/pro-upgrade.md)
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
- ## Passo 1: Instalar plugin do Roblox Studio
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
- ## Passo 2: Registrar servidor MCP no app de IA
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
- ## Assinatura e download
32
+ ## Comprar e ativar
25
33
 
26
- ### Passo 1: Assinar no Gumroad
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 licenca Pro por assinatura
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
+ ![Tela de ativação de licença no plugin](../assets/screenshots/license/license-plugin.png)
52
+
53
+ ### Ativar no dashboard
30
54
 
31
- ### Passo 2: Baixar no GitHub Releases
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
- 1. Abra [GitHub Releases](https://github.com/hope1026/weppy-roblox-mcp/releases/latest)
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
+ ![Tela de ativação de licença no dashboard](../assets/screenshots/license/license-dashboard.png)
36
62
 
37
- ### Passo 3: Verificar
63
+ ### Depois da ativação
38
64
 
39
- 1. Abra o W-MCP no Roblox Studio
40
- 2. Confirme que o selo Pro aparece
41
- 3. Execute uma acao Pro (por exemplo: `manage_sync` ou operacoes em massa)
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) | ❌ | ✅ |
package/glama.json ADDED
@@ -0,0 +1,7 @@
1
+ {
2
+ "$schema": "https://glama.ai/mcp/schemas/server.json",
3
+ "maintainers": [
4
+ "hope1026"
5
+ ]
6
+ }
7
+