@weppy/roblox-mcp 2.4.0 → 2.5.0
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 +2 -2
- package/.github/workflows/install-test.yml +2 -21
- package/CHANGELOG.md +30 -5
- package/COMMERCIAL-LICENSE.md +1 -1
- package/README.md +11 -11
- package/TRADEMARKS.md +1 -1
- package/docs/en/dashboard/changelog.md +1 -1
- package/docs/en/dashboard/connection.md +1 -1
- package/docs/en/dashboard/overview.md +1 -1
- package/docs/en/dashboard/playtest.md +1 -1
- package/docs/en/dashboard/settings.md +1 -1
- package/docs/en/dashboard/sync.md +1 -1
- package/docs/en/dashboard/tools.md +1 -1
- package/docs/en/installation/README.md +4 -4
- package/docs/en/installation/ai-apps/antigravity.md +1 -1
- package/docs/en/installation/ai-apps/claude-app.md +1 -1
- package/docs/en/installation/ai-apps/claude-code.md +1 -1
- package/docs/en/installation/ai-apps/codex-app.md +1 -1
- package/docs/en/installation/ai-apps/codex-cli.md +1 -1
- package/docs/en/installation/ai-apps/cursor.md +1 -1
- package/docs/en/installation/ai-apps/gemini-cli.md +1 -1
- package/docs/en/installation/roblox-explorer.md +12 -12
- package/docs/en/installation/roblox-plugin.md +5 -5
- package/docs/en/pro-upgrade.md +3 -3
- package/docs/en/sync/luau-lsp.md +13 -13
- package/docs/en/sync/overview.md +8 -8
- package/docs/en/tools/overview.md +1 -1
- package/docs/en/tools/playtest.md +2 -2
- package/docs/es/README.md +10 -10
- package/docs/es/dashboard/changelog.md +1 -1
- package/docs/es/dashboard/connection.md +1 -1
- package/docs/es/dashboard/overview.md +1 -1
- package/docs/es/dashboard/playtest.md +1 -1
- package/docs/es/dashboard/settings.md +1 -1
- package/docs/es/dashboard/sync.md +1 -1
- package/docs/es/dashboard/tools.md +1 -1
- package/docs/es/installation/README.md +3 -3
- package/docs/es/installation/ai-apps/antigravity.md +1 -1
- package/docs/es/installation/ai-apps/claude-app.md +1 -1
- package/docs/es/installation/ai-apps/claude-code.md +1 -1
- package/docs/es/installation/ai-apps/codex-app.md +1 -1
- package/docs/es/installation/ai-apps/codex-cli.md +1 -1
- package/docs/es/installation/ai-apps/cursor.md +1 -1
- package/docs/es/installation/ai-apps/gemini-cli.md +1 -1
- package/docs/es/installation/roblox-explorer.md +11 -11
- package/docs/es/installation/roblox-plugin.md +3 -3
- package/docs/es/pro-upgrade.md +1 -1
- package/docs/es/sync/luau-lsp.md +13 -13
- package/docs/es/sync/overview.md +8 -8
- package/docs/es/tools/overview.md +1 -1
- package/docs/es/tools/playtest.md +2 -2
- package/docs/id/README.md +10 -10
- package/docs/id/dashboard/changelog.md +1 -1
- package/docs/id/dashboard/connection.md +1 -1
- package/docs/id/dashboard/overview.md +1 -1
- package/docs/id/dashboard/playtest.md +1 -1
- package/docs/id/dashboard/settings.md +1 -1
- package/docs/id/dashboard/sync.md +1 -1
- package/docs/id/dashboard/tools.md +1 -1
- package/docs/id/installation/README.md +4 -4
- package/docs/id/installation/ai-apps/antigravity.md +1 -1
- package/docs/id/installation/ai-apps/claude-app.md +1 -1
- package/docs/id/installation/ai-apps/claude-code.md +1 -1
- package/docs/id/installation/ai-apps/codex-app.md +1 -1
- package/docs/id/installation/ai-apps/codex-cli.md +1 -1
- package/docs/id/installation/ai-apps/cursor.md +1 -1
- package/docs/id/installation/ai-apps/gemini-cli.md +1 -1
- package/docs/id/installation/roblox-explorer.md +11 -11
- package/docs/id/installation/roblox-plugin.md +3 -3
- package/docs/id/pro-upgrade.md +1 -1
- package/docs/id/sync/luau-lsp.md +13 -13
- package/docs/id/sync/overview.md +8 -8
- package/docs/id/tools/overview.md +1 -1
- package/docs/id/tools/playtest.md +2 -2
- package/docs/installer/assets/index-Bz0amd7x.js +2 -2
- package/docs/installer/index.html +1 -1
- package/docs/installer/manifest.webmanifest +3 -3
- package/docs/ja/README.md +10 -10
- package/docs/ja/installation/README.md +4 -4
- package/docs/ja/installation/ai-apps/antigravity.md +1 -1
- package/docs/ja/installation/ai-apps/claude-app.md +1 -1
- package/docs/ja/installation/ai-apps/claude-code.md +1 -1
- package/docs/ja/installation/ai-apps/codex-app.md +1 -1
- package/docs/ja/installation/ai-apps/codex-cli.md +1 -1
- package/docs/ja/installation/ai-apps/cursor.md +1 -1
- package/docs/ja/installation/ai-apps/gemini-cli.md +1 -1
- package/docs/ja/installation/roblox-explorer.md +11 -11
- package/docs/ja/installation/roblox-plugin.md +3 -3
- package/docs/ja/pro-upgrade.md +1 -1
- package/docs/ja/sync/luau-lsp.md +13 -13
- package/docs/ja/sync/overview.md +8 -8
- package/docs/ja/tools/overview.md +1 -1
- package/docs/ja/tools/playtest.md +2 -2
- package/docs/ko/README.md +10 -10
- package/docs/ko/installation/README.md +4 -4
- package/docs/ko/installation/ai-apps/antigravity.md +1 -1
- package/docs/ko/installation/ai-apps/claude-app.md +1 -1
- package/docs/ko/installation/ai-apps/claude-code.md +1 -1
- package/docs/ko/installation/ai-apps/codex-app.md +1 -1
- package/docs/ko/installation/ai-apps/codex-cli.md +1 -1
- package/docs/ko/installation/ai-apps/cursor.md +1 -1
- package/docs/ko/installation/ai-apps/gemini-cli.md +1 -1
- package/docs/ko/installation/roblox-explorer.md +12 -12
- package/docs/ko/installation/roblox-plugin.md +5 -5
- package/docs/ko/pro-upgrade.md +1 -1
- package/docs/ko/sync/luau-lsp.md +13 -13
- package/docs/ko/sync/overview.md +8 -8
- package/docs/ko/tools/overview.md +1 -1
- package/docs/ko/tools/playtest.md +2 -2
- package/docs/pt-br/README.md +11 -11
- package/docs/pt-br/dashboard/changelog.md +1 -1
- package/docs/pt-br/dashboard/connection.md +1 -1
- package/docs/pt-br/dashboard/overview.md +1 -1
- package/docs/pt-br/dashboard/playtest.md +1 -1
- package/docs/pt-br/dashboard/settings.md +1 -1
- package/docs/pt-br/dashboard/sync.md +1 -1
- package/docs/pt-br/dashboard/tools.md +1 -1
- package/docs/pt-br/installation/README.md +4 -4
- package/docs/pt-br/installation/ai-apps/antigravity.md +1 -1
- package/docs/pt-br/installation/ai-apps/claude-app.md +1 -1
- package/docs/pt-br/installation/ai-apps/claude-code.md +1 -1
- package/docs/pt-br/installation/ai-apps/codex-app.md +1 -1
- package/docs/pt-br/installation/ai-apps/codex-cli.md +1 -1
- package/docs/pt-br/installation/ai-apps/cursor.md +1 -1
- package/docs/pt-br/installation/ai-apps/gemini-cli.md +1 -1
- package/docs/pt-br/installation/roblox-explorer.md +11 -11
- package/docs/pt-br/installation/roblox-plugin.md +3 -3
- package/docs/pt-br/pro-upgrade.md +1 -1
- package/docs/pt-br/sync/luau-lsp.md +13 -13
- package/docs/pt-br/sync/overview.md +8 -8
- package/docs/pt-br/tools/overview.md +1 -1
- package/docs/pt-br/tools/playtest.md +2 -2
- package/docs/troubleshooting.md +1 -1
- package/install.ps1 +8 -8
- package/install.sh +11 -11
- package/llms-full.txt +8 -8
- package/llms.txt +4 -4
- package/package.json +1 -1
- package/plugins/weppy-roblox-mcp/.claude-plugin/plugin.json +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ChangelogDetailPage-CDMDeGei.js → ChangelogDetailPage-DRfFUIvC.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ChangelogPage-Uhx5ND-w.js → ChangelogPage-Dgl8dBt6.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ConfirmModal-BHlbjwL7.js → ConfirmModal-DfdyAPrJ.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ConnectionPage-VXh4Hc9N.js → ConnectionPage-LSvSX1_u.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{InfoLabel-CGOLGj5z.js → InfoLabel-DrK7vhO-.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{OverviewPage-CWnqw6VH.js → OverviewPage-CXsGuoPu.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{PlaytestPage-62dIQkgo.js → PlaytestPage-CgkzRAqQ.js} +2 -2
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{PropertyDiff-DnLJY3ZB.js → PropertyDiff-Dy3MffNh.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SettingsPage-D2ZBQ2KF.js +1 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{StatusBadge-6VL6HJhv.js → StatusBadge-hJyzgRAl.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SyncPage-eX2Rh-Ct.js +4 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{TierComparison-7eRDwSAZ.js → TierComparison-BwKqP_4s.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{TierPromoProgress-DFG_858F.js → TierPromoProgress-CLAr1gQq.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ToolsPage-54vIMfZg.css +1 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ToolsPage-CqzfCxxH.js +1 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{WhatsNewPage-WPfXt13q.js → WhatsNewPage-23o8LmsR.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/index-BfvSPSNj.js +207 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{useLiveUptime-BT-AiWEA.js → useLiveUptime-BeRNzFBh.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/index.html +3 -3
- package/plugins/weppy-roblox-mcp/dist/index.js +82 -82
- package/plugins/weppy-roblox-mcp/roblox-plugin/WeppyRobloxMCP.rbxm +0 -0
- package/.github/workflows/deploy-docs.yml +0 -41
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SettingsPage-Bjr3d4mM.js +0 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SyncPage-jdplS80I.js +0 -4
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ToolsPage-B8iwhAW0.css +0 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ToolsPage-Cc6Vl-VU.js +0 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/index-BhDELp5r.js +0 -143
- /package/docs/installer/{wrox-icon.png → weppy-icon.png} +0 -0
- /package/plugins/weppy-roblox-mcp/dashboard/dist/{wrox-icon.png → weppy-icon.png} +0 -0
|
@@ -1,23 +1,23 @@
|
|
|
1
|
-
#
|
|
1
|
+
# WEPPY Roblox Explorer (VSCode · Antigravity 확장)
|
|
2
2
|
|
|
3
3
|
> **선택 사항** — Explorer는 필수가 아닙니다. MCP와 플러그인만으로도 모든 핵심 기능을 사용할 수 있습니다. 프로젝트 구조를 에디터에서 탐색하고 싶을 때 설치하세요.
|
|
4
4
|
|
|
5
5
|
Roblox Studio의 Explorer와 동일한 인스턴스 트리를 에디터에서 볼 수 있는 확장입니다. 동기화된 인스턴스를 탐색하고, 스크립트를 바로 열고, Sync 상태를 에디터 안에서 확인할 수 있습니다.
|
|
6
|
-
이 확장은
|
|
6
|
+
이 확장은 WEPPY용 companion 확장이며, 단독 Roblox 연동 도구는 아닙니다.
|
|
7
7
|
|
|
8
|
-

|
|
9
9
|
|
|
10
10
|
## 요구 사항
|
|
11
11
|
|
|
12
12
|
- VSCode 1.85+ 또는 Antigravity
|
|
13
13
|
- [Roblox MCP](../../../README.md) 설치 및 Sync 활성화 (Basic 또는 Pro)
|
|
14
|
-
- 프로젝트 루트 아래에 Sync가 생성한 `
|
|
14
|
+
- 프로젝트 루트 아래에 Sync가 생성한 `weppy-project-sync/place_*/.sync-meta.json` 존재
|
|
15
15
|
|
|
16
16
|
## 설치 방법
|
|
17
17
|
|
|
18
18
|
### VSCode
|
|
19
19
|
|
|
20
|
-
VSCode Extensions 사이드바(`Ctrl+Shift+X` / `Cmd+Shift+X`)에서 **
|
|
20
|
+
VSCode Extensions 사이드바(`Ctrl+Shift+X` / `Cmd+Shift+X`)에서 **WEPPY Roblox Explorer**를 검색하고 **Install**을 클릭합니다.
|
|
21
21
|
|
|
22
22
|
또는 아래 마켓플레이스에서 바로 설치할 수 있습니다.
|
|
23
23
|
|
|
@@ -26,7 +26,7 @@ VSCode Extensions 사이드바(`Ctrl+Shift+X` / `Cmd+Shift+X`)에서 **WROX Robl
|
|
|
26
26
|
|
|
27
27
|
### Antigravity
|
|
28
28
|
|
|
29
|
-
Antigravity는 VSCode 기반이므로 동일한 확장을 사용합니다. Antigravity의 Extensions 탭에서 **
|
|
29
|
+
Antigravity는 VSCode 기반이므로 동일한 확장을 사용합니다. Antigravity의 Extensions 탭에서 **WEPPY Roblox Explorer**를 검색하고 **Install**을 클릭합니다.
|
|
30
30
|
|
|
31
31
|
---
|
|
32
32
|
|
|
@@ -47,7 +47,7 @@ Antigravity는 VSCode 기반이므로 동일한 확장을 사용합니다. Antig
|
|
|
47
47
|
|
|
48
48
|
| 설정 | 기본값 | 설명 |
|
|
49
49
|
|------|--------|------|
|
|
50
|
-
| `robloxExplorer.syncRoot` | `""` | `
|
|
50
|
+
| `robloxExplorer.syncRoot` | `""` | `weppy-project-sync` 루트 절대 경로. 비워두면 자동 탐색합니다. WEPPY는 `{projectRoot}/weppy-project-sync` 를 사용합니다. |
|
|
51
51
|
| `robloxExplorer.hidePropsFiles` | `false` | 기본 VSCode 탐색기에서 동기화 파일(`.props.json`, `_tree.json`, `.value.json`)을 숨깁니다. |
|
|
52
52
|
| `robloxExplorer.autoRefresh` | `true` | Sync 파일 변경 시 트리를 자동으로 새로고침합니다. |
|
|
53
53
|
| `robloxExplorer.showSyncStatus` | `true` | 트리 항목에 Sync 상태 장식을 표시합니다. |
|
|
@@ -56,11 +56,11 @@ Antigravity는 VSCode 기반이므로 동일한 확장을 사용합니다. Antig
|
|
|
56
56
|
|
|
57
57
|
| 명령어 | 설명 |
|
|
58
58
|
|--------|------|
|
|
59
|
-
| `
|
|
60
|
-
| `
|
|
61
|
-
| `
|
|
62
|
-
| `
|
|
63
|
-
| `
|
|
59
|
+
| `WEPPY Explorer: Refresh` | 인스턴스 트리 수동 새로고침 |
|
|
60
|
+
| `WEPPY Explorer: Search Instances` | 모든 서비스에서 인스턴스 검색 |
|
|
61
|
+
| `WEPPY Explorer: Open Backing File` | 선택한 인스턴스의 파일 열기 |
|
|
62
|
+
| `WEPPY Explorer: Copy Instance Path` | 전체 인스턴스 경로 복사 (예: `game.Workspace.Part`) |
|
|
63
|
+
| `WEPPY Explorer: Reveal in Explorer` | 기본 VSCode 탐색기에서 파일 표시 |
|
|
64
64
|
|
|
65
65
|
## 관련 문서
|
|
66
66
|
|
|
@@ -9,14 +9,14 @@ MCP 서버 설치가 완료되었다면 플러그인은 **자동으로 설치**
|
|
|
9
9
|
### 동작 방식
|
|
10
10
|
|
|
11
11
|
1. MCP 서버가 처음 실행될 때 플러그인 파일(`WeppyRobloxMCP.rbxm`)을 Roblox Studio의 Plugins 폴더에 자동 배치합니다.
|
|
12
|
-
2. Roblox Studio를 시작하면 Plugins 탭에 **
|
|
12
|
+
2. Roblox Studio를 시작하면 Plugins 탭에 **WEPPY** 버튼이 나타납니다.
|
|
13
13
|
|
|
14
14
|
### 연결하기
|
|
15
15
|
|
|
16
16
|
1. **Roblox Studio**에서 아무 프로젝트를 엽니다
|
|
17
|
-
2. 상단 **Plugins** 탭 → **
|
|
17
|
+
2. 상단 **Plugins** 탭 → **WEPPY** 클릭
|
|
18
18
|
|
|
19
|
-

|
|
20
20
|
|
|
21
21
|
3. 플러그인 창에서 **Connect** 버튼 클릭
|
|
22
22
|
4. **"Connected"** 상태가 표시되면 연결 완료
|
|
@@ -50,9 +50,9 @@ MCP 서버 설치가 완료되었다면 플러그인은 **자동으로 설치**
|
|
|
50
50
|
|
|
51
51
|
### 3. 설치 확인
|
|
52
52
|
|
|
53
|
-
재시작 후 Plugins 탭에 **
|
|
53
|
+
재시작 후 Plugins 탭에 **WEPPY** 버튼이 나타납니다.
|
|
54
54
|
|
|
55
|
-

|
|
56
56
|
|
|
57
57
|
### 4. 연결하기
|
|
58
58
|
|
package/docs/ko/pro-upgrade.md
CHANGED
|
@@ -48,7 +48,7 @@ Pro는 핵심 워크플로를 넘어 더 많은 기능을 사용할 수 있습
|
|
|
48
48
|
|
|
49
49
|
### 플러그인에서 활성화
|
|
50
50
|
|
|
51
|
-
1. Roblox Studio에서 **
|
|
51
|
+
1. Roblox Studio에서 **WEPPY** 플러그인을 열고 MCP 서버에 연결합니다.
|
|
52
52
|
2. 플러그인의 **Settings > License** 섹션을 엽니다.
|
|
53
53
|
3. `License key` 입력창에 구매한 키를 붙여넣습니다.
|
|
54
54
|
4. **Activate** 버튼을 눌러 라이선스를 활성화합니다.
|
package/docs/ko/sync/luau-lsp.md
CHANGED
|
@@ -1,19 +1,19 @@
|
|
|
1
|
-
#
|
|
1
|
+
# WEPPY Sync에서 `luau-lsp` 사용하기
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
WEPPY Sync는 `luau-lsp`가 필요한 sourcemap 파일을 자동으로 생성할 수 있으므로, 별도의 Rojo 프로젝트를 따로 구성하지 않아도 Roblox 인식 편집기 기능을 사용할 수 있습니다.
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## WEPPY가 생성하는 파일
|
|
6
6
|
|
|
7
|
-
Full Sync가 끝나면
|
|
7
|
+
Full Sync가 끝나면 WEPPY는 다음 파일을 생성합니다.
|
|
8
8
|
|
|
9
|
-
- Place sourcemap: `
|
|
10
|
-
- 루트 대표 파일: `
|
|
9
|
+
- Place sourcemap: `weppy-project-sync/place_<id>/sourcemap.json`
|
|
10
|
+
- 루트 대표 파일: `weppy-project-sync/sourcemap.json`
|
|
11
11
|
|
|
12
|
-
대부분의 사용자에게 권장되는 경로는 `
|
|
12
|
+
대부분의 사용자에게 권장되는 경로는 `weppy-project-sync/sourcemap.json`입니다.
|
|
13
13
|
|
|
14
14
|
## 어떤 점이 좋아지나
|
|
15
15
|
|
|
16
|
-
`luau-lsp`가
|
|
16
|
+
`luau-lsp`가 WEPPY sourcemap을 읽으면 다음이 개선됩니다.
|
|
17
17
|
|
|
18
18
|
- `game.*` 자동완성
|
|
19
19
|
- 동기화된 스크립트 기준 탐색
|
|
@@ -21,8 +21,8 @@ Full Sync가 끝나면 WROX는 다음 파일을 생성합니다.
|
|
|
21
21
|
|
|
22
22
|
## 권장 설정 방법
|
|
23
23
|
|
|
24
|
-
1.
|
|
25
|
-
2. 에디터의 `luau-lsp` sourcemap 설정이 `
|
|
24
|
+
1. WEPPY가 `weppy-project-sync/sourcemap.json`을 만들도록 Full Sync를 한 번 실행합니다.
|
|
25
|
+
2. 에디터의 `luau-lsp` sourcemap 설정이 `weppy-project-sync/sourcemap.json`을 가리키게 합니다.
|
|
26
26
|
3. 사용하는 클라이언트에서 자동 Rojo 생성을 끌 수 있다면 `luau-lsp.sourcemap.autogenerate`를 `false`로 설정합니다.
|
|
27
27
|
|
|
28
28
|
VSCode 설정 예시:
|
|
@@ -31,11 +31,11 @@ VSCode 설정 예시:
|
|
|
31
31
|
{
|
|
32
32
|
"luau-lsp.sourcemap.enabled": true,
|
|
33
33
|
"luau-lsp.sourcemap.autogenerate": false,
|
|
34
|
-
"luau-lsp.sourcemap.sourcemapFile": "
|
|
34
|
+
"luau-lsp.sourcemap.sourcemapFile": "weppy-project-sync/sourcemap.json"
|
|
35
35
|
}
|
|
36
36
|
```
|
|
37
37
|
|
|
38
38
|
## Multi-place 참고
|
|
39
39
|
|
|
40
|
-
`
|
|
41
|
-
특정 place를 고정해서 쓰고 싶다면 `luau-lsp`가 해당 place의 `
|
|
40
|
+
`weppy-project-sync/sourcemap.json`은 프로젝트의 현재 대표 place를 따라갑니다.
|
|
41
|
+
특정 place를 고정해서 쓰고 싶다면 `luau-lsp`가 해당 place의 `weppy-project-sync/place_<id>/sourcemap.json`을 직접 보도록 설정하면 됩니다.
|
package/docs/ko/sync/overview.md
CHANGED
|
@@ -18,16 +18,16 @@ Sync가 없으면 AI는 대화에 붙여 넣은 코드 일부만 보고 판단
|
|
|
18
18
|
2. Incremental Sync: 변경 감시로 이후 변경분만 반영
|
|
19
19
|
3. History/Status 추적: 어떤 변경이 언제 어떤 방향으로 반영됐는지 확인
|
|
20
20
|
|
|
21
|
-
Sync 데이터는 `{projectRoot}/
|
|
22
|
-
|
|
23
|
-
`luau-lsp` 같은 에디터 연동에는 루트 경로 사용을 권장합니다. 설정 방법은 [
|
|
21
|
+
Sync 데이터는 `{projectRoot}/weppy-project-sync/place_{placeId}/explorer` 아래에 생성됩니다.
|
|
22
|
+
WEPPY는 여기에 더해 place별 sourcemap을 `{projectRoot}/weppy-project-sync/place_{placeId}/sourcemap.json`에 기록하고, 권장 루트 대표 파일을 `{projectRoot}/weppy-project-sync/sourcemap.json`에 유지합니다.
|
|
23
|
+
`luau-lsp` 같은 에디터 연동에는 루트 경로 사용을 권장합니다. 설정 방법은 [WEPPY Sync에서 `luau-lsp` 사용하기](./luau-lsp.md)에서 확인할 수 있습니다.
|
|
24
24
|
|
|
25
25
|
### VSCode에서 Sync 데이터 탐색
|
|
26
26
|
|
|
27
|
-
[
|
|
27
|
+
[WEPPY Roblox Explorer](../installation/roblox-explorer.md) 확장을 설치하면, 동기화된 인스턴스 트리를 Roblox Studio와 동일한 형태로 VSCode에서 탐색할 수 있습니다.
|
|
28
28
|
Explorer는 여기서 생성된 sync 파일을 읽고, 로컬 MCP 서버가 실행 중이면 추가로 실시간 sync 상태와 direction 정보를 표시할 수 있습니다.
|
|
29
29
|
|
|
30
|
-

|
|
31
31
|
|
|
32
32
|
- 서비스/인스턴스 트리를 Roblox 클래스 아이콘과 함께 표시
|
|
33
33
|
- 스크립트 파일을 클릭하면 바로 편집 가능
|
|
@@ -40,7 +40,7 @@ Explorer는 여기서 생성된 sync 파일을 읽고, 로컬 MCP 서버가 실
|
|
|
40
40
|
| 동기화 방향 | Studio -> Local | 양방향 |
|
|
41
41
|
| 타입별 Direction | 미지원 | 지원 (Scripts / Values / Containers / Data / Services) |
|
|
42
42
|
| 타입별 Apply Mode | 미지원 | 지원 (Auto / Manual) |
|
|
43
|
-
| 상태/기록 조회 API | 미지원 | 지원 (`
|
|
43
|
+
| 상태/기록 조회 API | 미지원 | 지원 (`status_current_place`, `history`, `progress`) |
|
|
44
44
|
| `manage_sync` 도구 사용 | 미지원 | 지원 |
|
|
45
45
|
| 멀티 Place Sync | 미지원 | 지원 (최대 3개 Place) |
|
|
46
46
|
|
|
@@ -87,7 +87,7 @@ Pro에서는 타입별로 Direction/Apply Mode를 다르게 설정해 워크플
|
|
|
87
87
|
|
|
88
88
|
| 액션 | 설명 | 주요 인자 |
|
|
89
89
|
|------|------|-----------|
|
|
90
|
-
| `
|
|
90
|
+
| `status_current_place` | 현재 연결된 Place의 동기화 상태 확인 | `-` |
|
|
91
91
|
| `history` | 변경 기록 조회 | `placeId`, `query.limit`, `query.offset` |
|
|
92
92
|
| `directions` | 타입별 Direction 조회 | `placeId` |
|
|
93
93
|
| `read_file` | 동기화된 파일 읽기 | `placeId`, `instancePath` |
|
|
@@ -148,6 +148,6 @@ explorer/
|
|
|
148
148
|
|
|
149
149
|
## 함께 보면 좋은 문서
|
|
150
150
|
|
|
151
|
-
- [
|
|
151
|
+
- [WEPPY Sync에서 `luau-lsp` 사용하기](./luau-lsp.md)
|
|
152
152
|
- [Tool 지원 범위 (Tools Overview)](../tools/overview.md)
|
|
153
153
|
- [Pro 업그레이드 가이드](https://weppyai.com/ko/plans)
|
|
@@ -227,7 +227,7 @@ Sync 정책:
|
|
|
227
227
|
|
|
228
228
|
| 액션 | 설명 | 티어 |
|
|
229
229
|
|------|------|------|
|
|
230
|
-
| `
|
|
230
|
+
| `status_current_place` | 현재 연결된 Place의 동기화 상태 가져오기 | Pro |
|
|
231
231
|
| `history` | 변경 기록 가져오기 | Pro |
|
|
232
232
|
| `directions` | 타입별 동기화 방향 가져오기 | Pro |
|
|
233
233
|
| `read_file` | 동기화된 파일 읽기 | Pro |
|
|
@@ -81,10 +81,10 @@ Edit ──play──→ Running ──stop──→ Edit
|
|
|
81
81
|
- 마지막 로그 수집
|
|
82
82
|
|
|
83
83
|
### 5. 리포트 생성
|
|
84
|
-
리포트와 로그는 로컬 `{projectRoot}/
|
|
84
|
+
리포트와 로그는 로컬 `{projectRoot}/weppy-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/` 아래에 저장됩니다.
|
|
85
85
|
|
|
86
86
|
```
|
|
87
|
-
{projectRoot}/
|
|
87
|
+
{projectRoot}/weppy-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/
|
|
88
88
|
├── test-report.md # 결과 요약 (상태, 시간, 시그널)
|
|
89
89
|
└── test-log.txt # 전체 로그 (타임스탬프, 시퀀스, 레벨)
|
|
90
90
|
```
|
package/docs/pt-br/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Roblox MCP — Servidor MCP para Roblox Studio | Desenvolvimento de jogos com IA usando Claude, Codex, Cursor e Gemini
|
|
2
2
|
|
|
3
|
-
> **
|
|
3
|
+
> **WEPPY** e um servidor MCP que permite agentes de codificacao IA controlarem uma sessao ao vivo do Roblox Studio — crie e edite scripts, instancias, terrain, iluminacao, assets, audio e animacoes com linguagem natural.
|
|
4
4
|
|
|
5
5
|
**Ferramentas consolidadas baseadas em ações · Sync bidirecional · Playtest automatizado · Suporte multi-place**
|
|
6
6
|
|
|
@@ -8,11 +8,11 @@
|
|
|
8
8
|
|
|
9
9
|
[](https://youtu.be/puQB4u1VlMw)
|
|
10
10
|
|
|
11
|
-
## Por que
|
|
11
|
+
## Por que WEPPY (Weppy Roblox MCP)?
|
|
12
12
|
|
|
13
13
|
Agentes de codificação IA como Claude, Codex e Gemini são poderosos — mas não conseguem ver nem modificar nada dentro do Roblox Studio. O DataModel, scripts, terrain e iluminação são todos invisíveis para ferramentas externas. Sem uma ponte, a IA só pode gerar trechos de código que você precisa colar manualmente.
|
|
14
14
|
|
|
15
|
-
**
|
|
15
|
+
**WEPPY** é uma ponte entre agentes de IA e o Roblox Studio. A IA cria e modifica diretamente instâncias, scripts, propriedades, terrain e mais dentro do Studio, e as alterações são refletidas imediatamente no Studio e no dashboard para que você possa **ver exatamente o que mudou**.
|
|
16
16
|
|
|
17
17
|
Sem necessidade de copiar e colar código. A IA trabalha e você confere os resultados.
|
|
18
18
|
|
|
@@ -104,9 +104,9 @@ A IA pode controlar diretamente o playtest do Studio. Ela pode iniciar e parar P
|
|
|
104
104
|
- "Escreva e execute um teste para confirmar que o SpawnLocation esta acima do chao."
|
|
105
105
|
- "Valide com playtest se o script que acabei de alterar roda sem erros."
|
|
106
106
|
|
|
107
|
-

|
|
108
108
|
|
|
109
|
-
### 4)
|
|
109
|
+
### 4) WEPPY Dashboard: monitore as operacoes da IA em tempo real
|
|
110
110
|
|
|
111
111
|
No dashboard web fornecido pelo servidor MCP, acompanhe em tempo real o status de conexao, historico de execucao de ferramentas, status de sincronizacao e historico de alteracoes do jogo.
|
|
112
112
|
|
|
@@ -114,19 +114,19 @@ No dashboard web fornecido pelo servidor MCP, acompanhe em tempo real o status d
|
|
|
114
114
|
- Compare todas as alteracoes feitas pela IA com Before & After no Changelog
|
|
115
115
|
- Analise o fluxo de trabalho com historico e estatisticas de execucao de ferramentas
|
|
116
116
|
|
|
117
|
-

|
|
118
118
|
|
|
119
|
-
### 5)
|
|
119
|
+
### 5) WEPPY Roblox Explorer: navegue a hierarquia do Studio no VSCode
|
|
120
120
|
|
|
121
121
|
Visualize a arvore completa de instancias do seu lugar no Roblox Studio diretamente dentro do VSCode. Navegue pelos servicos, abra scripts e arquivos de propriedades sincronizados, e acompanhe o status de sincronizacao — tudo sem trocar para o Studio.
|
|
122
|
-
|
|
122
|
+
WEPPY Roblox Explorer e uma extensao complementar do VSCode para os dados de sync gerados pelo WEPPY. A navegacao basica da arvore funciona a partir dos arquivos sincronizados em disco, e os indicadores ao vivo de status sync ou direction ficam mais completos quando o servidor MCP local esta em execucao.
|
|
123
123
|
Instale pela [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer) ou pela [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer).
|
|
124
124
|
|
|
125
125
|
- Icones de classe iguais ao Studio para reconhecimento imediato
|
|
126
126
|
- Clique para abrir scripts e arquivos de propriedades sincronizados
|
|
127
127
|
- Suporte multiplace com indicadores de status de sincronizacao
|
|
128
128
|
|
|
129
|
-

|
|
130
130
|
|
|
131
131
|
## Valor imediato para o usuario
|
|
132
132
|
|
|
@@ -148,8 +148,8 @@ Instale pela [VS Code Marketplace](https://marketplace.visualstudio.com/items?it
|
|
|
148
148
|
- [Guia de instalacao](installation/README.md)
|
|
149
149
|
- [Lista completa de tools](tools/overview.md)
|
|
150
150
|
- [Guia detalhado de Sync](sync/overview.md)
|
|
151
|
-
- [Guia do
|
|
152
|
-
- [
|
|
151
|
+
- [Guia do WEPPY Dashboard](dashboard/overview.md)
|
|
152
|
+
- [WEPPY Roblox Explorer (Extensao VSCode)](installation/roblox-explorer.md)
|
|
153
153
|
- [Compatibilidade](../compatibility.md)
|
|
154
154
|
- [Solucao de problemas](../troubleshooting.md)
|
|
155
155
|
|
|
@@ -106,7 +106,7 @@ Filtre a categoria Instance na timeline e rastreie as alteracoes do tipo delete
|
|
|
106
106
|
|
|
107
107
|
## Documentos relacionados
|
|
108
108
|
|
|
109
|
-
- [
|
|
109
|
+
- [WEPPY Dashboard Overview](overview.md)
|
|
110
110
|
- [Connection](connection.md)
|
|
111
111
|
- [Sync](sync.md)
|
|
112
112
|
- [Playtest](playtest.md)
|
|
@@ -69,7 +69,7 @@ Confira o nome, PID e diretorio de trabalho do agente conectado na tabela AI Age
|
|
|
69
69
|
|
|
70
70
|
## Documentos relacionados
|
|
71
71
|
|
|
72
|
-
- [
|
|
72
|
+
- [WEPPY Dashboard Overview](overview.md)
|
|
73
73
|
- [Changelog](changelog.md)
|
|
74
74
|
- [Sync](sync.md)
|
|
75
75
|
- [Playtest](playtest.md)
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
> Monitore e gerencie em tempo real o status, conexoes, sincronizacao, historico de execucao de ferramentas e historico de alteracoes do jogo do servidor MCP diretamente no navegador.
|
|
4
4
|
|
|
5
|
-

|
|
6
6
|
|
|
7
7
|
## O que e o Dashboard?
|
|
8
8
|
|
|
@@ -52,7 +52,7 @@ Verifique o timestamp e o Status no Test History para acompanhar a tendencia dos
|
|
|
52
52
|
|
|
53
53
|
## Documentos relacionados
|
|
54
54
|
|
|
55
|
-
- [
|
|
55
|
+
- [WEPPY Dashboard Overview](overview.md)
|
|
56
56
|
- [Changelog](changelog.md)
|
|
57
57
|
- [Connection](connection.md)
|
|
58
58
|
- [Sync](sync.md)
|
|
@@ -52,7 +52,7 @@ Altere o idioma da interface do Dashboard. Suporta 6 idiomas + Auto (deteccao au
|
|
|
52
52
|
|
|
53
53
|
## Documentos relacionados
|
|
54
54
|
|
|
55
|
-
- [
|
|
55
|
+
- [WEPPY Dashboard Overview](overview.md)
|
|
56
56
|
- [Changelog](changelog.md)
|
|
57
57
|
- [Connection](connection.md)
|
|
58
58
|
- [Sync](sync.md)
|
|
@@ -59,7 +59,7 @@ Verifique a Direction do tipo Scripts na tabela Sync Directions.
|
|
|
59
59
|
|
|
60
60
|
## Documentos relacionados
|
|
61
61
|
|
|
62
|
-
- [
|
|
62
|
+
- [WEPPY Dashboard Overview](overview.md)
|
|
63
63
|
- [Changelog](changelog.md)
|
|
64
64
|
- [Connection](connection.md)
|
|
65
65
|
- [Playtest](playtest.md)
|
|
@@ -60,7 +60,7 @@ Encontre o item com Status Error na aba History para verificar as informacoes de
|
|
|
60
60
|
|
|
61
61
|
## Documentos relacionados
|
|
62
62
|
|
|
63
|
-
- [
|
|
63
|
+
- [WEPPY Dashboard Overview](overview.md)
|
|
64
64
|
- [Changelog](changelog.md)
|
|
65
65
|
- [Connection](connection.md)
|
|
66
66
|
- [Sync](sync.md)
|
|
@@ -68,12 +68,12 @@ Registre o servidor MCP no seu app de IA. Funciona com qualquer app que suporte
|
|
|
68
68
|
|
|
69
69
|
---
|
|
70
70
|
|
|
71
|
-
## Opcional: Instalar
|
|
71
|
+
## Opcional: Instalar WEPPY Roblox Explorer (Extensão VSCode)
|
|
72
72
|
|
|
73
73
|
Navegue pelas árvores de instâncias sincronizadas dentro do VSCode com ícones de classes Roblox.
|
|
74
|
-
Esta extensao opcional exige que a instalacao do Roblox MCP acima ja esteja concluida, porque o Explorer le os dados de Sync em `
|
|
74
|
+
Esta extensao opcional exige que a instalacao do Roblox MCP acima ja esteja concluida, porque o Explorer le os dados de Sync em `weppy-project-sync` dentro da raiz do projeto.
|
|
75
75
|
|
|
76
|
-
👉 [Guia de instalação do
|
|
76
|
+
👉 [Guia de instalação do WEPPY Roblox Explorer](https://weppyai.com/en/install#explorer)
|
|
77
77
|
|
|
78
78
|
Instalação direta:
|
|
79
79
|
- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
|
|
@@ -83,7 +83,7 @@ Instalação direta:
|
|
|
83
83
|
|
|
84
84
|
## Depois da instalação
|
|
85
85
|
|
|
86
|
-
1. Abra o **Roblox Studio** e na aba Plugins clique em **
|
|
86
|
+
1. Abra o **Roblox Studio** e na aba Plugins clique em **WEPPY** → **Connect**
|
|
87
87
|
2. No **app de IA** teste assim:
|
|
88
88
|
|
|
89
89
|
```
|
|
@@ -61,7 +61,7 @@ Recomendamos manter o padrão (HTTP `127.0.0.1:3002`). Se necessário, você pod
|
|
|
61
61
|
|
|
62
62
|
## Teste de conexão
|
|
63
63
|
|
|
64
|
-
1. Abra o **Roblox Studio** → aba Plugins → **
|
|
64
|
+
1. Abra o **Roblox Studio** → aba Plugins → **WEPPY** → **Connect**
|
|
65
65
|
2. No **Antigravity**, digite:
|
|
66
66
|
```
|
|
67
67
|
Diga-me o que está selecionado atualmente no Roblox Studio
|
|
@@ -46,7 +46,7 @@ Como usar o Roblox MCP no [Claude Desktop App](https://claude.ai/download).
|
|
|
46
46
|
|
|
47
47
|
## Teste de Conexao
|
|
48
48
|
|
|
49
|
-
1. Inicie o **Roblox Studio** → Aba Plugins → **
|
|
49
|
+
1. Inicie o **Roblox Studio** → Aba Plugins → **WEPPY** → **Connect**
|
|
50
50
|
2. Inicie uma nova conversa no **Claude Desktop** e teste:
|
|
51
51
|
```
|
|
52
52
|
Crie uma parte azul no Roblox Studio
|
|
@@ -64,7 +64,7 @@ O Claude Code gerencia o servidor MCP automaticamente:
|
|
|
64
64
|
|
|
65
65
|
## Teste de Conexao
|
|
66
66
|
|
|
67
|
-
1. Inicie o **Roblox Studio** → Aba Plugins → **
|
|
67
|
+
1. Inicie o **Roblox Studio** → Aba Plugins → **WEPPY** → **Connect**
|
|
68
68
|
2. Teste no **Claude Code**:
|
|
69
69
|
```
|
|
70
70
|
Crie uma parte azul no Roblox Studio
|
|
@@ -30,7 +30,7 @@ Command: npx -y @weppy/roblox-mcp
|
|
|
30
30
|
|
|
31
31
|
## Teste de Conexao
|
|
32
32
|
|
|
33
|
-
1. Inicie o **Roblox Studio** → Aba Plugins → **
|
|
33
|
+
1. Inicie o **Roblox Studio** → Aba Plugins → **WEPPY** → **Connect**
|
|
34
34
|
2. Inicie uma nova conversa no **Codex App** e teste:
|
|
35
35
|
```
|
|
36
36
|
Diga-me o que esta selecionado atualmente no Roblox Studio
|
|
@@ -40,7 +40,7 @@ args = ["-y", "@weppy/roblox-mcp"]
|
|
|
40
40
|
|
|
41
41
|
## Teste de Conexao
|
|
42
42
|
|
|
43
|
-
1. Inicie o **Roblox Studio** → Aba Plugins → **
|
|
43
|
+
1. Inicie o **Roblox Studio** → Aba Plugins → **WEPPY** → **Connect**
|
|
44
44
|
2. Inicie o **Codex CLI** e digite:
|
|
45
45
|
```
|
|
46
46
|
Diga-me o que esta selecionado atualmente no Roblox Studio
|
|
@@ -45,7 +45,7 @@ Depois de editar a configuração, recarregue a janela do Cursor ou reinicie o a
|
|
|
45
45
|
|
|
46
46
|
## Teste de conexão
|
|
47
47
|
|
|
48
|
-
1. Abra o **Roblox Studio** → aba Plugins → **
|
|
48
|
+
1. Abra o **Roblox Studio** → aba Plugins → **WEPPY** → **Connect**
|
|
49
49
|
2. No **Cursor**, digite:
|
|
50
50
|
```
|
|
51
51
|
Tell me what's currently selected in Roblox Studio
|
|
@@ -81,7 +81,7 @@ gemini mcp add weppy-roblox-mcp npx --trust -e HTTP_PORT=3002 -- -y @weppy/roblo
|
|
|
81
81
|
|
|
82
82
|
## Teste de conexão
|
|
83
83
|
|
|
84
|
-
1. Abra o **Roblox Studio** → aba Plugins → **
|
|
84
|
+
1. Abra o **Roblox Studio** → aba Plugins → **WEPPY** → **Connect**
|
|
85
85
|
2. Execute o **Gemini CLI** e digite:
|
|
86
86
|
```
|
|
87
87
|
Me diga o que está selecionado atualmente no Roblox Studio
|
|
@@ -1,19 +1,19 @@
|
|
|
1
|
-
#
|
|
1
|
+
# WEPPY Roblox Explorer (Extensão VSCode)
|
|
2
2
|
|
|
3
3
|
Visualização em árvore de instâncias similar ao Explorer do Roblox Studio, dentro do VSCode. Navegue por instâncias sincronizadas, abra scripts diretamente e acompanhe o status de sincronização sem sair do editor.
|
|
4
|
-
Esta é uma extensao complementar do
|
|
4
|
+
Esta é uma extensao complementar do WEPPY, e não uma integração Roblox independente.
|
|
5
5
|
|
|
6
|
-

|
|
7
7
|
|
|
8
8
|
## Requisitos
|
|
9
9
|
|
|
10
10
|
- VSCode 1.85+
|
|
11
11
|
- [Roblox MCP](../../../README.md) instalado com Sync habilitado (Basic ou Pro)
|
|
12
|
-
- O Sync ja gerou `
|
|
12
|
+
- O Sync ja gerou `weppy-project-sync/place_*/.sync-meta.json` na raiz do projeto
|
|
13
13
|
|
|
14
14
|
## Instalação
|
|
15
15
|
|
|
16
|
-
Pesquise **
|
|
16
|
+
Pesquise **WEPPY Roblox Explorer** na barra lateral de Extensões do VSCode (`Ctrl+Shift+X` / `Cmd+Shift+X`) e clique em **Install**.
|
|
17
17
|
|
|
18
18
|
Ou instale diretamente por um destes marketplaces:
|
|
19
19
|
|
|
@@ -37,7 +37,7 @@ A navegação basica da arvore funciona a partir dos arquivos sincronizados em d
|
|
|
37
37
|
|
|
38
38
|
| Configuração | Padrão | Descrição |
|
|
39
39
|
|--------------|--------|-----------|
|
|
40
|
-
| `robloxExplorer.syncRoot` | `""` | Caminho absoluto para a raiz do `
|
|
40
|
+
| `robloxExplorer.syncRoot` | `""` | Caminho absoluto para a raiz do `weppy-project-sync`. Se estiver vazio, e detectado automaticamente. O WEPPY usa `{projectRoot}/weppy-project-sync`. |
|
|
41
41
|
| `robloxExplorer.hidePropsFiles` | `false` | Oculta arquivos de Sync (`.props.json`, `_tree.json`, `.value.json`) no explorador padrão do VSCode. |
|
|
42
42
|
| `robloxExplorer.autoRefresh` | `true` | Atualiza automaticamente a árvore quando os arquivos Sync mudam. |
|
|
43
43
|
| `robloxExplorer.showSyncStatus` | `true` | Exibe decorações de status Sync nos itens da árvore. |
|
|
@@ -46,11 +46,11 @@ A navegação basica da arvore funciona a partir dos arquivos sincronizados em d
|
|
|
46
46
|
|
|
47
47
|
| Comando | Descrição |
|
|
48
48
|
|---------|-----------|
|
|
49
|
-
| `
|
|
50
|
-
| `
|
|
51
|
-
| `
|
|
52
|
-
| `
|
|
53
|
-
| `
|
|
49
|
+
| `WEPPY Explorer: Refresh` | Atualizar manualmente a árvore de instâncias |
|
|
50
|
+
| `WEPPY Explorer: Search Instances` | Pesquisar instâncias em todos os serviços |
|
|
51
|
+
| `WEPPY Explorer: Open Backing File` | Abrir o arquivo de suporte de uma instância selecionada |
|
|
52
|
+
| `WEPPY Explorer: Copy Instance Path` | Copiar o caminho completo da instância (ex. `game.Workspace.Part`) |
|
|
53
|
+
| `WEPPY Explorer: Reveal in Explorer` | Mostrar o arquivo no explorador padrão do VSCode |
|
|
54
54
|
|
|
55
55
|
## Relacionado
|
|
56
56
|
|
|
@@ -25,9 +25,9 @@ Nota:
|
|
|
25
25
|
|
|
26
26
|
## 3. Verificar a Instalacao
|
|
27
27
|
|
|
28
|
-
Apos reiniciar, o botao **
|
|
28
|
+
Apos reiniciar, o botao **WEPPY** aparecera na aba Plugins.
|
|
29
29
|
|
|
30
|
-

|
|
31
31
|
|
|
32
32
|
## 4. Conectar ao Agente de IA
|
|
33
33
|
|
|
@@ -48,7 +48,7 @@ O servidor MCP deve estar instalado. Complete primeiro o guia do seu app de IA:
|
|
|
48
48
|
### Conectar
|
|
49
49
|
|
|
50
50
|
1. Abra qualquer projeto no **Roblox Studio**
|
|
51
|
-
2. Aba **Plugins** -> **
|
|
51
|
+
2. Aba **Plugins** -> **WEPPY**
|
|
52
52
|
3. Clique em **Connect**
|
|
53
53
|
4. Quando aparecer **"Connected"**, esta pronto
|
|
54
54
|
|
|
@@ -48,7 +48,7 @@ Você só precisa ativar a licença uma vez, no plugin ou no dashboard. As duas
|
|
|
48
48
|
|
|
49
49
|
### Ativar no plugin
|
|
50
50
|
|
|
51
|
-
1. Abra o **
|
|
51
|
+
1. Abra o **WEPPY** no Roblox Studio e conecte ao servidor MCP.
|
|
52
52
|
2. Abra a seção **Settings > License** no plugin.
|
|
53
53
|
3. Cole a chave comprada no campo `License key`.
|
|
54
54
|
4. Clique em **Activate** para ativar a licença.
|
|
@@ -1,19 +1,19 @@
|
|
|
1
|
-
# Usar `luau-lsp` com
|
|
1
|
+
# Usar `luau-lsp` com WEPPY Sync
|
|
2
2
|
|
|
3
|
-
O
|
|
3
|
+
O WEPPY Sync pode gerar automaticamente os arquivos sourcemap que o `luau-lsp` precisa, para que voce habilite recursos de editor com contexto de Roblox sem montar um projeto Rojo separado.
|
|
4
4
|
|
|
5
|
-
## O que o
|
|
5
|
+
## O que o WEPPY grava
|
|
6
6
|
|
|
7
|
-
Depois que o Full Sync termina, o
|
|
7
|
+
Depois que o Full Sync termina, o WEPPY grava:
|
|
8
8
|
|
|
9
|
-
- Place sourcemap: `
|
|
10
|
-
- Arquivo representativo da raiz: `
|
|
9
|
+
- Place sourcemap: `weppy-project-sync/place_<id>/sourcemap.json`
|
|
10
|
+
- Arquivo representativo da raiz: `weppy-project-sync/sourcemap.json`
|
|
11
11
|
|
|
12
|
-
Para a maioria dos usuarios, o caminho recomendado e `
|
|
12
|
+
Para a maioria dos usuarios, o caminho recomendado e `weppy-project-sync/sourcemap.json`.
|
|
13
13
|
|
|
14
14
|
## O que melhora
|
|
15
15
|
|
|
16
|
-
Quando o `luau-lsp` usa o sourcemap do
|
|
16
|
+
Quando o `luau-lsp` usa o sourcemap do WEPPY, melhora:
|
|
17
17
|
|
|
18
18
|
- Autocomplete de `game.*`
|
|
19
19
|
- Navegacao entre scripts sincronizados
|
|
@@ -21,8 +21,8 @@ Quando o `luau-lsp` usa o sourcemap do WROX, melhora:
|
|
|
21
21
|
|
|
22
22
|
## Configuracao recomendada
|
|
23
23
|
|
|
24
|
-
1. Execute o Full Sync uma vez para que o
|
|
25
|
-
2. Aponte a configuracao de sourcemap do `luau-lsp` no seu editor para `
|
|
24
|
+
1. Execute o Full Sync uma vez para que o WEPPY crie `weppy-project-sync/sourcemap.json`.
|
|
25
|
+
2. Aponte a configuracao de sourcemap do `luau-lsp` no seu editor para `weppy-project-sync/sourcemap.json`.
|
|
26
26
|
3. Se o seu cliente puder desativar a geracao automatica com Rojo, defina `luau-lsp.sourcemap.autogenerate` como `false`.
|
|
27
27
|
|
|
28
28
|
Exemplo de configuracao no VSCode:
|
|
@@ -31,11 +31,11 @@ Exemplo de configuracao no VSCode:
|
|
|
31
31
|
{
|
|
32
32
|
"luau-lsp.sourcemap.enabled": true,
|
|
33
33
|
"luau-lsp.sourcemap.autogenerate": false,
|
|
34
|
-
"luau-lsp.sourcemap.sourcemapFile": "
|
|
34
|
+
"luau-lsp.sourcemap.sourcemapFile": "weppy-project-sync/sourcemap.json"
|
|
35
35
|
}
|
|
36
36
|
```
|
|
37
37
|
|
|
38
38
|
## Observacao sobre Multi-place
|
|
39
39
|
|
|
40
|
-
`
|
|
41
|
-
Se voce precisar fixar um place especifico, aponte o `luau-lsp` diretamente para `
|
|
40
|
+
`weppy-project-sync/sourcemap.json` acompanha o place representativo atual do projeto.
|
|
41
|
+
Se voce precisar fixar um place especifico, aponte o `luau-lsp` diretamente para `weppy-project-sync/place_<id>/sourcemap.json`.
|