@weppy/roblox-mcp 2.5.0 → 2.6.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 +55 -4
- package/CHANGELOG.md +25 -0
- package/README.md +29 -45
- package/SUPPORT.md +4 -6
- package/docs/assets/screenshots/roblox-explorer/roblox-explorer-property-window.png +0 -0
- package/install.ps1 +22 -9
- package/install.sh +19 -4
- package/llms-full.txt +8 -688
- package/llms.txt +3 -13
- 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-DRfFUIvC.js → ChangelogDetailPage-C-ROvHGr.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ChangelogPage-Dgl8dBt6.js → ChangelogPage-CPm4ft8m.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ConfirmModal-DfdyAPrJ.js → ConfirmModal-BSTYLn14.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ConnectionPage-LSvSX1_u.js → ConnectionPage-BeJEgfmf.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{InfoLabel-DrK7vhO-.js → InfoLabel-BRbbxjjt.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{OverviewPage-CXsGuoPu.js → OverviewPage-BHd6yL_8.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{PlaytestPage-CgkzRAqQ.js → PlaytestPage-BiNJCh4I.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{PropertyDiff-Dy3MffNh.js → PropertyDiff-BKVe7m6g.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SettingsPage-Cg33y021.js +1 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{StatusBadge-hJyzgRAl.js → StatusBadge-A72TDL-q.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{SyncPage-eX2Rh-Ct.js → SyncPage-R4Qs9Xt3.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/TierComparison-CQewH4h_.js +1 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{TierPromoProgress-CLAr1gQq.js → TierPromoProgress-DolZjAqX.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ToolsPage-CqzfCxxH.js → ToolsPage-DRX93nSV.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/WhatsNewPage-uLdiNHd0.js +1 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{index-BfvSPSNj.js → index-oz4Gtzz9.js} +55 -21
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{useLiveUptime-BeRNzFBh.js → useLiveUptime-CRLLCM8t.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/index.html +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/weppy-icon.png +0 -0
- package/plugins/weppy-roblox-mcp/dist/index.js +76 -76
- package/plugins/weppy-roblox-mcp/roblox-plugin/WeppyRobloxMCP.rbxm +0 -0
- package/docs/assets/screenshots/roblox-explorer/install-from-vsix.png +0 -0
- package/docs/compatibility.md +0 -44
- package/docs/en/dashboard/changelog.md +0 -114
- package/docs/en/dashboard/connection.md +0 -77
- package/docs/en/dashboard/overview.md +0 -95
- package/docs/en/dashboard/playtest.md +0 -61
- package/docs/en/dashboard/settings.md +0 -60
- package/docs/en/dashboard/sync.md +0 -68
- package/docs/en/dashboard/tools.md +0 -69
- package/docs/en/installation/README.md +0 -95
- package/docs/en/installation/ai-apps/antigravity.md +0 -89
- package/docs/en/installation/ai-apps/claude-app.md +0 -78
- package/docs/en/installation/ai-apps/claude-code.md +0 -104
- package/docs/en/installation/ai-apps/codex-app.md +0 -56
- package/docs/en/installation/ai-apps/codex-cli.md +0 -67
- package/docs/en/installation/ai-apps/cursor.md +0 -77
- package/docs/en/installation/ai-apps/gemini-cli.md +0 -120
- package/docs/en/installation/roblox-explorer.md +0 -68
- package/docs/en/installation/roblox-plugin.md +0 -96
- package/docs/en/pro-upgrade.md +0 -96
- package/docs/en/sync/luau-lsp.md +0 -41
- package/docs/en/sync/overview.md +0 -153
- package/docs/en/tools/assets-and-effects.md +0 -104
- package/docs/en/tools/instances-and-properties.md +0 -104
- package/docs/en/tools/overview.md +0 -277
- package/docs/en/tools/playtest.md +0 -140
- package/docs/en/tools/scripting.md +0 -66
- package/docs/en/tools/system-and-debugging.md +0 -93
- package/docs/en/tools/world-and-environment.md +0 -102
- package/docs/es/README.md +0 -208
- package/docs/es/dashboard/changelog.md +0 -114
- package/docs/es/dashboard/connection.md +0 -77
- package/docs/es/dashboard/overview.md +0 -95
- package/docs/es/dashboard/playtest.md +0 -61
- package/docs/es/dashboard/settings.md +0 -60
- package/docs/es/dashboard/sync.md +0 -68
- package/docs/es/dashboard/tools.md +0 -69
- package/docs/es/installation/README.md +0 -87
- package/docs/es/installation/ai-apps/antigravity.md +0 -89
- package/docs/es/installation/ai-apps/claude-app.md +0 -78
- package/docs/es/installation/ai-apps/claude-code.md +0 -104
- package/docs/es/installation/ai-apps/codex-app.md +0 -56
- package/docs/es/installation/ai-apps/codex-cli.md +0 -67
- package/docs/es/installation/ai-apps/cursor.md +0 -77
- package/docs/es/installation/ai-apps/gemini-cli.md +0 -120
- package/docs/es/installation/roblox-explorer.md +0 -58
- package/docs/es/installation/roblox-plugin.md +0 -85
- package/docs/es/pro-upgrade.md +0 -96
- package/docs/es/sync/luau-lsp.md +0 -41
- package/docs/es/sync/overview.md +0 -153
- package/docs/es/tools/assets-and-effects.md +0 -104
- package/docs/es/tools/instances-and-properties.md +0 -104
- package/docs/es/tools/overview.md +0 -277
- package/docs/es/tools/playtest.md +0 -140
- package/docs/es/tools/scripting.md +0 -66
- package/docs/es/tools/system-and-debugging.md +0 -93
- package/docs/es/tools/world-and-environment.md +0 -102
- package/docs/id/README.md +0 -208
- package/docs/id/dashboard/changelog.md +0 -114
- package/docs/id/dashboard/connection.md +0 -77
- package/docs/id/dashboard/overview.md +0 -95
- package/docs/id/dashboard/playtest.md +0 -61
- package/docs/id/dashboard/settings.md +0 -60
- package/docs/id/dashboard/sync.md +0 -68
- package/docs/id/dashboard/tools.md +0 -69
- package/docs/id/installation/README.md +0 -93
- package/docs/id/installation/ai-apps/antigravity.md +0 -89
- package/docs/id/installation/ai-apps/claude-app.md +0 -78
- package/docs/id/installation/ai-apps/claude-code.md +0 -104
- package/docs/id/installation/ai-apps/codex-app.md +0 -56
- package/docs/id/installation/ai-apps/codex-cli.md +0 -67
- package/docs/id/installation/ai-apps/cursor.md +0 -77
- package/docs/id/installation/ai-apps/gemini-cli.md +0 -120
- package/docs/id/installation/roblox-explorer.md +0 -58
- package/docs/id/installation/roblox-plugin.md +0 -85
- package/docs/id/pro-upgrade.md +0 -96
- package/docs/id/sync/luau-lsp.md +0 -41
- package/docs/id/sync/overview.md +0 -153
- package/docs/id/tools/assets-and-effects.md +0 -104
- package/docs/id/tools/instances-and-properties.md +0 -104
- package/docs/id/tools/overview.md +0 -277
- package/docs/id/tools/playtest.md +0 -140
- package/docs/id/tools/scripting.md +0 -66
- package/docs/id/tools/system-and-debugging.md +0 -93
- package/docs/id/tools/world-and-environment.md +0 -102
- package/docs/installer/assets/index-Bz0amd7x.js +0 -63
- package/docs/installer/assets/index-ei4lRUa6.css +0 -1
- package/docs/installer/index.html +0 -14
- package/docs/installer/manifest.webmanifest +0 -15
- package/docs/installer/sw.js +0 -7
- package/docs/installer/weppy-icon.png +0 -0
- package/docs/ja/README.md +0 -206
- package/docs/ja/dashboard/changelog.md +0 -114
- package/docs/ja/dashboard/connection.md +0 -77
- package/docs/ja/dashboard/overview.md +0 -95
- package/docs/ja/dashboard/playtest.md +0 -61
- package/docs/ja/dashboard/settings.md +0 -60
- package/docs/ja/dashboard/sync.md +0 -68
- package/docs/ja/dashboard/tools.md +0 -69
- package/docs/ja/installation/README.md +0 -93
- package/docs/ja/installation/ai-apps/antigravity.md +0 -89
- package/docs/ja/installation/ai-apps/claude-app.md +0 -78
- package/docs/ja/installation/ai-apps/claude-code.md +0 -104
- package/docs/ja/installation/ai-apps/codex-app.md +0 -56
- package/docs/ja/installation/ai-apps/codex-cli.md +0 -67
- package/docs/ja/installation/ai-apps/cursor.md +0 -77
- package/docs/ja/installation/ai-apps/gemini-cli.md +0 -120
- package/docs/ja/installation/roblox-explorer.md +0 -58
- package/docs/ja/installation/roblox-plugin.md +0 -85
- package/docs/ja/pro-upgrade.md +0 -96
- package/docs/ja/sync/luau-lsp.md +0 -41
- package/docs/ja/sync/overview.md +0 -153
- package/docs/ja/tools/assets-and-effects.md +0 -104
- package/docs/ja/tools/instances-and-properties.md +0 -104
- package/docs/ja/tools/overview.md +0 -277
- package/docs/ja/tools/playtest.md +0 -140
- package/docs/ja/tools/scripting.md +0 -66
- package/docs/ja/tools/system-and-debugging.md +0 -93
- package/docs/ja/tools/world-and-environment.md +0 -102
- package/docs/ko/README.md +0 -206
- package/docs/ko/dashboard/changelog.md +0 -114
- package/docs/ko/dashboard/connection.md +0 -77
- package/docs/ko/dashboard/overview.md +0 -95
- package/docs/ko/dashboard/playtest.md +0 -61
- package/docs/ko/dashboard/settings.md +0 -60
- package/docs/ko/dashboard/sync.md +0 -68
- package/docs/ko/dashboard/tools.md +0 -69
- package/docs/ko/installation/README.md +0 -95
- package/docs/ko/installation/ai-apps/antigravity.md +0 -88
- package/docs/ko/installation/ai-apps/claude-app.md +0 -78
- package/docs/ko/installation/ai-apps/claude-code.md +0 -104
- package/docs/ko/installation/ai-apps/codex-app.md +0 -56
- package/docs/ko/installation/ai-apps/codex-cli.md +0 -67
- package/docs/ko/installation/ai-apps/cursor.md +0 -77
- package/docs/ko/installation/ai-apps/gemini-cli.md +0 -120
- package/docs/ko/installation/roblox-explorer.md +0 -68
- package/docs/ko/installation/roblox-plugin.md +0 -96
- package/docs/ko/pro-upgrade.md +0 -96
- package/docs/ko/sync/luau-lsp.md +0 -41
- package/docs/ko/sync/overview.md +0 -153
- package/docs/ko/tools/assets-and-effects.md +0 -104
- package/docs/ko/tools/instances-and-properties.md +0 -104
- package/docs/ko/tools/overview.md +0 -277
- package/docs/ko/tools/playtest.md +0 -134
- package/docs/ko/tools/scripting.md +0 -66
- package/docs/ko/tools/system-and-debugging.md +0 -93
- package/docs/ko/tools/world-and-environment.md +0 -102
- package/docs/pt-br/README.md +0 -208
- package/docs/pt-br/dashboard/changelog.md +0 -114
- package/docs/pt-br/dashboard/connection.md +0 -77
- package/docs/pt-br/dashboard/overview.md +0 -95
- package/docs/pt-br/dashboard/playtest.md +0 -61
- package/docs/pt-br/dashboard/settings.md +0 -60
- package/docs/pt-br/dashboard/sync.md +0 -68
- package/docs/pt-br/dashboard/tools.md +0 -69
- package/docs/pt-br/installation/README.md +0 -93
- package/docs/pt-br/installation/ai-apps/antigravity.md +0 -89
- package/docs/pt-br/installation/ai-apps/claude-app.md +0 -78
- package/docs/pt-br/installation/ai-apps/claude-code.md +0 -104
- package/docs/pt-br/installation/ai-apps/codex-app.md +0 -56
- package/docs/pt-br/installation/ai-apps/codex-cli.md +0 -67
- package/docs/pt-br/installation/ai-apps/cursor.md +0 -77
- package/docs/pt-br/installation/ai-apps/gemini-cli.md +0 -120
- package/docs/pt-br/installation/roblox-explorer.md +0 -58
- package/docs/pt-br/installation/roblox-plugin.md +0 -85
- package/docs/pt-br/pro-upgrade.md +0 -96
- package/docs/pt-br/sync/luau-lsp.md +0 -41
- package/docs/pt-br/sync/overview.md +0 -153
- package/docs/pt-br/tools/assets-and-effects.md +0 -104
- package/docs/pt-br/tools/instances-and-properties.md +0 -104
- package/docs/pt-br/tools/overview.md +0 -277
- package/docs/pt-br/tools/playtest.md +0 -140
- package/docs/pt-br/tools/scripting.md +0 -66
- package/docs/pt-br/tools/system-and-debugging.md +0 -93
- package/docs/pt-br/tools/world-and-environment.md +0 -102
- package/docs/troubleshooting.md +0 -47
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SettingsPage-D2ZBQ2KF.js +0 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/TierComparison-BwKqP_4s.js +0 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/WhatsNewPage-23o8LmsR.js +0 -1
package/docs/ko/sync/luau-lsp.md
DELETED
|
@@ -1,41 +0,0 @@
|
|
|
1
|
-
# WEPPY Sync에서 `luau-lsp` 사용하기
|
|
2
|
-
|
|
3
|
-
WEPPY Sync는 `luau-lsp`가 필요한 sourcemap 파일을 자동으로 생성할 수 있으므로, 별도의 Rojo 프로젝트를 따로 구성하지 않아도 Roblox 인식 편집기 기능을 사용할 수 있습니다.
|
|
4
|
-
|
|
5
|
-
## WEPPY가 생성하는 파일
|
|
6
|
-
|
|
7
|
-
Full Sync가 끝나면 WEPPY는 다음 파일을 생성합니다.
|
|
8
|
-
|
|
9
|
-
- Place sourcemap: `weppy-project-sync/place_<id>/sourcemap.json`
|
|
10
|
-
- 루트 대표 파일: `weppy-project-sync/sourcemap.json`
|
|
11
|
-
|
|
12
|
-
대부분의 사용자에게 권장되는 경로는 `weppy-project-sync/sourcemap.json`입니다.
|
|
13
|
-
|
|
14
|
-
## 어떤 점이 좋아지나
|
|
15
|
-
|
|
16
|
-
`luau-lsp`가 WEPPY sourcemap을 읽으면 다음이 개선됩니다.
|
|
17
|
-
|
|
18
|
-
- `game.*` 자동완성
|
|
19
|
-
- 동기화된 스크립트 기준 탐색
|
|
20
|
-
- 동기화된 스크립트 사이의 `require` 해석
|
|
21
|
-
|
|
22
|
-
## 권장 설정 방법
|
|
23
|
-
|
|
24
|
-
1. WEPPY가 `weppy-project-sync/sourcemap.json`을 만들도록 Full Sync를 한 번 실행합니다.
|
|
25
|
-
2. 에디터의 `luau-lsp` sourcemap 설정이 `weppy-project-sync/sourcemap.json`을 가리키게 합니다.
|
|
26
|
-
3. 사용하는 클라이언트에서 자동 Rojo 생성을 끌 수 있다면 `luau-lsp.sourcemap.autogenerate`를 `false`로 설정합니다.
|
|
27
|
-
|
|
28
|
-
VSCode 설정 예시:
|
|
29
|
-
|
|
30
|
-
```json
|
|
31
|
-
{
|
|
32
|
-
"luau-lsp.sourcemap.enabled": true,
|
|
33
|
-
"luau-lsp.sourcemap.autogenerate": false,
|
|
34
|
-
"luau-lsp.sourcemap.sourcemapFile": "weppy-project-sync/sourcemap.json"
|
|
35
|
-
}
|
|
36
|
-
```
|
|
37
|
-
|
|
38
|
-
## Multi-place 참고
|
|
39
|
-
|
|
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
DELETED
|
@@ -1,153 +0,0 @@
|
|
|
1
|
-
# Roblox MCP Sync 상세 가이드
|
|
2
|
-
|
|
3
|
-
Sync는 Roblox Studio 상태와 로컬 파일을 연결해, AI가 프로젝트 전체 문맥을 안정적으로 읽고 수정할 수 있게 만드는 기능입니다.
|
|
4
|
-
|
|
5
|
-
## 왜 Sync가 중요한가
|
|
6
|
-
|
|
7
|
-
Sync가 없으면 AI는 대화에 붙여 넣은 코드 일부만 보고 판단하게 됩니다. Sync를 켜면 프로젝트 전체를 기준으로 작업하므로 다음이 쉬워집니다.
|
|
8
|
-
|
|
9
|
-
- 여러 스크립트에 걸친 리팩터링을 일관되게 적용
|
|
10
|
-
- 변경 이력을 기반으로 위험한 수정만 빠르게 검토
|
|
11
|
-
- Studio와 로컬 중 어느 쪽이 기준인지 방향을 명확히 유지
|
|
12
|
-
|
|
13
|
-
## 기본 동작 방식
|
|
14
|
-
|
|
15
|
-

|
|
16
|
-
|
|
17
|
-
1. Full Sync: Studio 트리와 인스턴스를 로컬 미러로 초기 동기화
|
|
18
|
-
2. Incremental Sync: 변경 감시로 이후 변경분만 반영
|
|
19
|
-
3. History/Status 추적: 어떤 변경이 언제 어떤 방향으로 반영됐는지 확인
|
|
20
|
-
|
|
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
|
-
|
|
25
|
-
### VSCode에서 Sync 데이터 탐색
|
|
26
|
-
|
|
27
|
-
[WEPPY Roblox Explorer](../installation/roblox-explorer.md) 확장을 설치하면, 동기화된 인스턴스 트리를 Roblox Studio와 동일한 형태로 VSCode에서 탐색할 수 있습니다.
|
|
28
|
-
Explorer는 여기서 생성된 sync 파일을 읽고, 로컬 MCP 서버가 실행 중이면 추가로 실시간 sync 상태와 direction 정보를 표시할 수 있습니다.
|
|
29
|
-
|
|
30
|
-

|
|
31
|
-
|
|
32
|
-
- 서비스/인스턴스 트리를 Roblox 클래스 아이콘과 함께 표시
|
|
33
|
-
- 스크립트 파일을 클릭하면 바로 편집 가능
|
|
34
|
-
- Sync 상태 배지로 변경/충돌 확인
|
|
35
|
-
|
|
36
|
-
## Basic vs Pro
|
|
37
|
-
|
|
38
|
-
| 항목 | Basic | Pro |
|
|
39
|
-
|------|------|-----|
|
|
40
|
-
| 동기화 방향 | Studio -> Local | 양방향 |
|
|
41
|
-
| 타입별 Direction | 미지원 | 지원 (Scripts / Values / Containers / Data / Services) |
|
|
42
|
-
| 타입별 Apply Mode | 미지원 | 지원 (Auto / Manual) |
|
|
43
|
-
| 상태/기록 조회 API | 미지원 | 지원 (`status_current_place`, `history`, `progress`) |
|
|
44
|
-
| `manage_sync` 도구 사용 | 미지원 | 지원 |
|
|
45
|
-
| 멀티 Place Sync | 미지원 | 지원 (최대 3개 Place) |
|
|
46
|
-
|
|
47
|
-
## 동기화 대상과 기본 제외 규칙
|
|
48
|
-
|
|
49
|
-
기본 동기화 대상 서비스:
|
|
50
|
-
|
|
51
|
-
- `Workspace`
|
|
52
|
-
- `Lighting`
|
|
53
|
-
- `ReplicatedStorage`
|
|
54
|
-
- `ServerStorage`
|
|
55
|
-
- `ServerScriptService`
|
|
56
|
-
- `StarterGui`
|
|
57
|
-
- `StarterPlayer`
|
|
58
|
-
- `StarterPack`
|
|
59
|
-
- `ReplicatedFirst`
|
|
60
|
-
- `SoundService`
|
|
61
|
-
- `Chat`
|
|
62
|
-
- `LocalizationService`
|
|
63
|
-
|
|
64
|
-
기본 제외 항목:
|
|
65
|
-
|
|
66
|
-
- 클래스: `Terrain`, `Camera`
|
|
67
|
-
- 보안상 금지 경로: `CoreGui`, `CorePackages`, `RobloxScript`, `RobloxScriptSecurity`
|
|
68
|
-
|
|
69
|
-
## Direction과 Apply Mode
|
|
70
|
-
|
|
71
|
-
### Direction (타입별 동기화 방향)
|
|
72
|
-
|
|
73
|
-
- `forward`: Studio -> Local
|
|
74
|
-
- `reverse`: Local -> Studio
|
|
75
|
-
- `bidirectional`: 양방향
|
|
76
|
-
|
|
77
|
-
타입은 `scripts`, `values`, `containers`, `data`, `services`로 분리되어 관리됩니다.
|
|
78
|
-
|
|
79
|
-
### Apply Mode (reverse 변경 적용 방식)
|
|
80
|
-
|
|
81
|
-
- `manual`: Studio 반영 전 사용자가 확인 후 적용
|
|
82
|
-
- `auto`: 감지된 변경을 자동 적용
|
|
83
|
-
|
|
84
|
-
Pro에서는 타입별로 Direction/Apply Mode를 다르게 설정해 워크플로우를 세밀하게 제어할 수 있습니다.
|
|
85
|
-
|
|
86
|
-
## `manage_sync` 액션 가이드 (Pro)
|
|
87
|
-
|
|
88
|
-
| 액션 | 설명 | 주요 인자 |
|
|
89
|
-
|------|------|-----------|
|
|
90
|
-
| `status_current_place` | 현재 연결된 Place의 동기화 상태 확인 | `-` |
|
|
91
|
-
| `history` | 변경 기록 조회 | `placeId`, `query.limit`, `query.offset` |
|
|
92
|
-
| `directions` | 타입별 Direction 조회 | `placeId` |
|
|
93
|
-
| `read_file` | 동기화된 파일 읽기 | `placeId`, `instancePath` |
|
|
94
|
-
| `write_file` | 동기화된 파일 쓰기 | `placeId`, `instancePath`, `content` |
|
|
95
|
-
| `progress` | 실시간 진행률/처리량 확인 | `placeId` |
|
|
96
|
-
|
|
97
|
-
## 추천 워크플로우
|
|
98
|
-
|
|
99
|
-
### 1) 안전하게 시작하기
|
|
100
|
-
|
|
101
|
-
- 먼저 Full Sync를 완료해 현재 상태를 기준점으로 만듭니다.
|
|
102
|
-
- 초반에는 `manual` 적용으로 운영해 변경 위험을 줄입니다.
|
|
103
|
-
|
|
104
|
-
### 2) AI와 함께 변경하기
|
|
105
|
-
|
|
106
|
-
- "Sync 상태 확인하고, 최근 변경 기록 기준으로 위험한 변경만 요약해줘"
|
|
107
|
-
- "`ServerScriptService` 쪽 스크립트만 우선 리팩터링하고, 변경 이력까지 남겨줘"
|
|
108
|
-
|
|
109
|
-
### 3) 충돌 발생 시 해결하기
|
|
110
|
-
|
|
111
|
-
양방향 동기화 중 Studio와 로컬 양쪽에서 변경이 감지되면, 아래와 같은 충돌 해결 화면이 나타납니다.
|
|
112
|
-
|
|
113
|
-

|
|
114
|
-
|
|
115
|
-
- **Studio Priority**: Studio 쪽 상태를 기준으로 덮어쓰기
|
|
116
|
-
- **Local Priority**: 로컬 파일을 기준으로 Studio에 반영
|
|
117
|
-
- **Per-File**: 파일별로 어느 쪽을 우선할지 개별 선택
|
|
118
|
-
|
|
119
|
-
### 4) 문제 발생 시 복구하기
|
|
120
|
-
|
|
121
|
-
- `history`로 최근 변경을 추적
|
|
122
|
-
- 필요한 파일을 `read_file`로 확인
|
|
123
|
-
- 복구할 내용을 `write_file`로 반영 후 Studio 상태 재확인
|
|
124
|
-
|
|
125
|
-
## 파일 포맷 (v2 nested directory)
|
|
126
|
-
|
|
127
|
-
각 Roblox 인스턴스는 자체 디렉토리로 저장되며, 해당 디렉토리 안에 메타 파일이 위치합니다:
|
|
128
|
-
|
|
129
|
-
```
|
|
130
|
-
explorer/
|
|
131
|
-
├── Workspace/
|
|
132
|
-
│ ├── _tree.json
|
|
133
|
-
│ ├── Part/
|
|
134
|
-
│ │ └── Part.props.json
|
|
135
|
-
│ ├── MyScript/
|
|
136
|
-
│ │ └── MyScript.server.luau
|
|
137
|
-
│ └── Coins/
|
|
138
|
-
│ └── Coins.value.json
|
|
139
|
-
```
|
|
140
|
-
|
|
141
|
-
파일 명명 규칙:
|
|
142
|
-
- 속성: `{Name}/{Name}.props.json`
|
|
143
|
-
- 스크립트: `{Name}/{Name}.server.luau` / `.client.luau` / `.module.luau`
|
|
144
|
-
- 값: `{Name}/{Name}.value.json`
|
|
145
|
-
|
|
146
|
-
동일 이름 인스턴스는 디렉토리에 `~N` 접미사를 붙여 구분합니다 (예: `Part~2/Part.props.json`).
|
|
147
|
-
이름에 `~`가 포함되면 `~~`로 이스케이프됩니다 (예: `Part~2` → `Part~~2/`). Odd-Count Tilde 규칙: 끝의 `~+N`에서 tilde 개수가 홀수일 때만 collision suffix로 해석됩니다.
|
|
148
|
-
|
|
149
|
-
## 함께 보면 좋은 문서
|
|
150
|
-
|
|
151
|
-
- [WEPPY Sync에서 `luau-lsp` 사용하기](./luau-lsp.md)
|
|
152
|
-
- [Tool 지원 범위 (Tools Overview)](../tools/overview.md)
|
|
153
|
-
- [Pro 업그레이드 가이드](https://weppyai.com/ko/plans)
|
|
@@ -1,104 +0,0 @@
|
|
|
1
|
-
# 에셋 & 오브젝트 연출
|
|
2
|
-
|
|
3
|
-
> 에셋 삽입, 트윈 애니메이션, 오디오, 파티클 이펙트, 물리 충돌 그룹을 관리합니다.
|
|
4
|
-
|
|
5
|
-
## 포함된 도구
|
|
6
|
-
|
|
7
|
-
| 도구 | 티어 | 설명 |
|
|
8
|
-
|------|:----:|------|
|
|
9
|
-
| `manage_assets` | Pro | Creator Store 검색, 모델/패키지 삽입, 에셋 정보 |
|
|
10
|
-
| `manage_tween` | Pro | 트윈 생성, 재생, 일시정지, 취소 |
|
|
11
|
-
| `manage_animation` | Pro | 애니메이션 로드, 재생, 정지, 트랙 조회 |
|
|
12
|
-
| `manage_audio` | Pro | 사운드 재생/정지/일시정지, 오디오 리스너 설정 |
|
|
13
|
-
| `manage_effects` | Pro | 파티클 방출, 초기화, 토글 |
|
|
14
|
-
| `manage_physics` | Pro | 충돌 그룹 등록, 충돌 여부 설정 |
|
|
15
|
-
|
|
16
|
-
## 주요 워크플로우
|
|
17
|
-
|
|
18
|
-
### 에셋으로 씬 구성
|
|
19
|
-
|
|
20
|
-
```
|
|
21
|
-
"Creator Store에서 '나무' 모델을 검색해서 Workspace에 3개 배치해줘"
|
|
22
|
-
```
|
|
23
|
-
|
|
24
|
-
`manage_assets`의 `search_insert`로 검색과 삽입을 한 번에 처리합니다.
|
|
25
|
-
|
|
26
|
-
### 인터랙티브 연출
|
|
27
|
-
|
|
28
|
-
```
|
|
29
|
-
"문을 클릭하면 3초에 걸쳐 열리는 트윈을 만들어줘"
|
|
30
|
-
```
|
|
31
|
-
|
|
32
|
-
`manage_tween`의 `create`로 트윈을 정의하고 `play`로 재생합니다. 동시에 `manage_audio`의 `play`로 문 여는 효과음을 추가합니다.
|
|
33
|
-
|
|
34
|
-
### 파티클 + 사운드 조합
|
|
35
|
-
|
|
36
|
-
```
|
|
37
|
-
"보스 등장 시 폭발 파티클과 함께 효과음을 재생해줘"
|
|
38
|
-
```
|
|
39
|
-
|
|
40
|
-
`manage_effects`의 `emit`으로 파티클을 방출하고, `manage_audio`의 `play`로 사운드를 동시에 재생합니다.
|
|
41
|
-
|
|
42
|
-
## 액션 레퍼런스
|
|
43
|
-
|
|
44
|
-
### Manage Assets (Pro)
|
|
45
|
-
|
|
46
|
-
| 액션 | 설명 | 티어 |
|
|
47
|
-
|------|------|------|
|
|
48
|
-
| `insert` | 에셋 ID로 모델 삽입 | Pro |
|
|
49
|
-
| `info` | 에셋 메타데이터 가져오기 | Pro |
|
|
50
|
-
| `search` | Creator Store 검색 | Pro |
|
|
51
|
-
| `search_insert` | 검색하여 첫 번째 일치 항목 삽입 | Pro |
|
|
52
|
-
| `insert_free` | 무료 모델 삽입 | Pro |
|
|
53
|
-
| `insert_package` | 패키지 삽입 | Pro |
|
|
54
|
-
| `export` | 현재 선택 내보내기 | Pro |
|
|
55
|
-
|
|
56
|
-
### Manage Tween (Pro)
|
|
57
|
-
|
|
58
|
-
| 액션 | 설명 | 티어 |
|
|
59
|
-
|------|------|------|
|
|
60
|
-
| `create` | 대상 속성을 가진 트윈 생성 | Pro |
|
|
61
|
-
| `play` | 생성된 트윈 재생 | Pro |
|
|
62
|
-
| `pause` | 실행 중인 트윈 일시정지 | Pro |
|
|
63
|
-
| `cancel` | 트윈 취소 | Pro |
|
|
64
|
-
|
|
65
|
-
### Manage Animation (Pro)
|
|
66
|
-
|
|
67
|
-
| 액션 | 설명 | 티어 |
|
|
68
|
-
|------|------|------|
|
|
69
|
-
| `load` | Humanoid/AnimationController에 애니메이션 로드 | Pro |
|
|
70
|
-
| `play` | 로드된 애니메이션 트랙 재생 | Pro |
|
|
71
|
-
| `stop` | 재생 중인 애니메이션 정지 | Pro |
|
|
72
|
-
| `get_tracks` | 로드된 모든 애니메이션 트랙 나열 | Pro |
|
|
73
|
-
|
|
74
|
-
### Manage Audio (Pro)
|
|
75
|
-
|
|
76
|
-
| 액션 | 설명 | 티어 |
|
|
77
|
-
|------|------|------|
|
|
78
|
-
| `play` | 사운드 재생 (필요시 Sound 생성) | Pro |
|
|
79
|
-
| `stop` | 재생 중인 사운드 정지 | Pro |
|
|
80
|
-
| `pause` | 재생 중인 사운드 일시정지 | Pro |
|
|
81
|
-
| `resume` | 일시정지된 사운드 재개 | Pro |
|
|
82
|
-
| `set_listener` | 오디오 리스너 타입/대상 설정 | Pro |
|
|
83
|
-
|
|
84
|
-
### Manage Effects (Pro)
|
|
85
|
-
|
|
86
|
-
| 액션 | 설명 | 티어 |
|
|
87
|
-
|------|------|------|
|
|
88
|
-
| `emit` | ParticleEmitter에서 파티클 방출 | Pro |
|
|
89
|
-
| `clear` | 모든 파티클 초기화 | Pro |
|
|
90
|
-
| `toggle` | 효과 활성화 또는 비활성화 | Pro |
|
|
91
|
-
|
|
92
|
-
### Manage Physics (Pro)
|
|
93
|
-
|
|
94
|
-
| 액션 | 설명 | 티어 |
|
|
95
|
-
|------|------|------|
|
|
96
|
-
| `register_group` | 충돌 그룹 등록 | Pro |
|
|
97
|
-
| `set_collidable` | 두 그룹이 충돌할 수 있는지 설정 | Pro |
|
|
98
|
-
| `get_groups` | 등록된 모든 충돌 그룹 나열 | Pro |
|
|
99
|
-
|
|
100
|
-
## 관련 문서
|
|
101
|
-
|
|
102
|
-
- [인스턴스 & 속성](instances-and-properties.md) — 오브젝트 생성 및 배치
|
|
103
|
-
- [월드 환경](world-and-environment.md) — 조명, 지형, 카메라
|
|
104
|
-
- [도구 전체 목록](overview.md)
|
|
@@ -1,104 +0,0 @@
|
|
|
1
|
-
# 인스턴스 & 속성
|
|
2
|
-
|
|
3
|
-
> Roblox Studio의 인스턴스를 검색, 생성, 수정하고 속성/어트리뷰트/태그를 관리합니다.
|
|
4
|
-
|
|
5
|
-
## 포함된 도구
|
|
6
|
-
|
|
7
|
-
| 도구 | 티어 | 설명 |
|
|
8
|
-
|------|:----:|------|
|
|
9
|
-
| `query_instances` | 혼합 | 인스턴스 검색, 계층 탐색, 클래스 정보 조회 |
|
|
10
|
-
| `mutate_instances` | 혼합 | 인스턴스 생성, 삭제, 복제, 이동 |
|
|
11
|
-
| `manage_properties` | 혼합 | 속성 읽기/쓰기, 어트리뷰트, 태그 관리 |
|
|
12
|
-
|
|
13
|
-
## 주요 워크플로우
|
|
14
|
-
|
|
15
|
-
### 씬 구조 파악
|
|
16
|
-
|
|
17
|
-
```
|
|
18
|
-
"Workspace 아래 모든 Part를 검색해서 위치와 크기를 알려줘"
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
`query_instances`의 `search_class`로 Part를 찾고, `manage_properties`의 `mass_get`으로 Position/Size를 일괄 조회합니다.
|
|
22
|
-
|
|
23
|
-
### 오브젝트 배치
|
|
24
|
-
|
|
25
|
-
```
|
|
26
|
-
"맵 중앙에 SpawnLocation 4개를 정사각형으로 배치하고 TeamColor를 각각 다르게 설정해줘"
|
|
27
|
-
```
|
|
28
|
-
|
|
29
|
-
`mutate_instances`의 `mass_create`로 한 번에 생성한 뒤, `manage_properties`의 `mass_set`으로 속성을 일괄 설정합니다.
|
|
30
|
-
|
|
31
|
-
### 태그 기반 관리
|
|
32
|
-
|
|
33
|
-
```
|
|
34
|
-
"'Collectible' 태그가 붙은 모든 오브젝트를 찾아서 Anchored를 true로 바꿔줘"
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
`manage_properties`의 `get_tagged`로 태그 인스턴스를 조회하고, `mass_set`으로 속성을 변경합니다.
|
|
38
|
-
|
|
39
|
-
## 액션 레퍼런스
|
|
40
|
-
|
|
41
|
-
### Query Instances (혼합)
|
|
42
|
-
|
|
43
|
-
| 액션 | 설명 | 티어 |
|
|
44
|
-
|------|------|------|
|
|
45
|
-
| `get` | 경로로 인스턴스 속성 가져오기 | Basic |
|
|
46
|
-
| `children` | 직계 자식 또는 모든 자손 가져오기 | Basic |
|
|
47
|
-
| `find_child` | 이름과 선택적 클래스 필터로 첫 번째 자식 찾기 | Basic |
|
|
48
|
-
| `find_descendant` | 이름으로 첫 번째 자손 찾기 | Basic |
|
|
49
|
-
| `wait_for_child` | 자식이 나타날 때까지 대기 (타임아웃 포함) | Basic |
|
|
50
|
-
| `class_info` | 클래스 정보 및 유효한 속성 가져오기 | Basic |
|
|
51
|
-
| `search_name` | 이름 패턴으로 인스턴스 검색 (와일드카드 지원) | Basic |
|
|
52
|
-
| `search_class` | 클래스 이름으로 인스턴스 검색 | Basic |
|
|
53
|
-
| `file_tree` | 루트에서 파일 트리 구조 가져오기 | Pro |
|
|
54
|
-
| `project_structure` | 전체 프로젝트 구조 가져오기 | Pro |
|
|
55
|
-
| `descendants` | 인스턴스의 모든 자손 가져오기 | Pro |
|
|
56
|
-
| `ancestors` | 인스턴스의 모든 조상 가져오기 | Pro |
|
|
57
|
-
| `search_property` | 속성 값으로 인스턴스 검색 | Pro |
|
|
58
|
-
| `search_tag` | 태그로 인스턴스 검색 | Pro |
|
|
59
|
-
|
|
60
|
-
### Mutate Instances (혼합)
|
|
61
|
-
|
|
62
|
-
| 액션 | 설명 | 티어 |
|
|
63
|
-
|------|------|------|
|
|
64
|
-
| `create` | 새 인스턴스 생성 | Basic |
|
|
65
|
-
| `create_with_props` | 초기 속성을 가진 인스턴스 생성 | Basic |
|
|
66
|
-
| `delete` | 인스턴스 삭제 | Basic |
|
|
67
|
-
| `clone` | 인스턴스 복제 | Basic |
|
|
68
|
-
| `move` | 인스턴스를 새 부모로 이동 | Basic |
|
|
69
|
-
| `rename` | 인스턴스 이름 변경 | Basic |
|
|
70
|
-
| `pivot` | 피벗 위치 또는 CFrame 설정 | Basic |
|
|
71
|
-
| `create_tree` | 계층적 인스턴스 트리 생성 | Pro |
|
|
72
|
-
| `mass_create` | 여러 인스턴스 한 번에 생성 | Pro |
|
|
73
|
-
| `mass_delete` | 여러 인스턴스 삭제 | Pro |
|
|
74
|
-
| `mass_duplicate` | 여러 인스턴스 복제 | Pro |
|
|
75
|
-
| `smart_duplicate` | 간격과 개수를 지정하여 복제 | Pro |
|
|
76
|
-
|
|
77
|
-
### Manage Properties (혼합)
|
|
78
|
-
|
|
79
|
-
| 액션 | 설명 | 티어 |
|
|
80
|
-
|------|------|------|
|
|
81
|
-
| `get` | 단일 속성 값 가져오기 | Basic |
|
|
82
|
-
| `set` | 단일 속성 값 설정 | Basic |
|
|
83
|
-
| `get_all` | 인스턴스의 모든 속성 가져오기 | Basic |
|
|
84
|
-
| `set_multiple` | 여러 속성 한 번에 설정 | Basic |
|
|
85
|
-
| `get_attr` | 어트리뷰트 값 가져오기 | Basic |
|
|
86
|
-
| `set_attr` | 어트리뷰트 값 설정 | Basic |
|
|
87
|
-
| `get_all_attrs` | 모든 어트리뷰트 가져오기 | Basic |
|
|
88
|
-
| `delete_attr` | 어트리뷰트 삭제 | Basic |
|
|
89
|
-
| `add_tag` | 인스턴스에 태그 추가 | Basic |
|
|
90
|
-
| `remove_tag` | 인스턴스에서 태그 제거 | Basic |
|
|
91
|
-
| `check_tag` | 인스턴스가 태그를 가지고 있는지 확인 | Basic |
|
|
92
|
-
| `get_tags` | 인스턴스의 모든 태그 가져오기 | Basic |
|
|
93
|
-
| `get_tagged` | 특정 태그를 가진 모든 인스턴스 가져오기 | Basic |
|
|
94
|
-
| `set_calculated` | 수식을 사용하여 속성 설정 | Pro |
|
|
95
|
-
| `set_relative` | 현재 값을 기준으로 상대적으로 속성 설정 | Pro |
|
|
96
|
-
| `mass_set` | 여러 인스턴스에 속성 설정 | Pro |
|
|
97
|
-
| `mass_get` | 여러 인스턴스에서 속성 가져오기 | Pro |
|
|
98
|
-
| `modify_children` | 부모의 모든 자식 수정 | Pro |
|
|
99
|
-
|
|
100
|
-
## 관련 문서
|
|
101
|
-
|
|
102
|
-
- [스크립트 & 코드 실행](scripting.md) — 인스턴스에 스크립트 추가/수정
|
|
103
|
-
- [에셋 & 오브젝트 연출](assets-and-effects.md) — 모델 삽입, 트윈, 이펙트
|
|
104
|
-
- [도구 전체 목록](overview.md)
|
|
@@ -1,277 +0,0 @@
|
|
|
1
|
-
# Roblox MCP 도구
|
|
2
|
-
|
|
3
|
-
MCP 도구의 상세 파라미터는 MCP 도구 정의를 직접 확인하세요.
|
|
4
|
-
|
|
5
|
-
## 기능별 가이드
|
|
6
|
-
|
|
7
|
-
워크플로우 중심의 상세 가이드를 참고하세요:
|
|
8
|
-
|
|
9
|
-
| 카테고리 | 설명 | 포함 도구 |
|
|
10
|
-
|---------|------|----------|
|
|
11
|
-
| [인스턴스 & 속성](instances-and-properties.md) | 인스턴스 검색, 생성, 수정, 태그 관리 | query_instances, mutate_instances, manage_properties |
|
|
12
|
-
| [스크립트 & 코드 실행](scripting.md) | 스크립트 관리, Luau 코드 실행 | manage_scripts, execute_luau |
|
|
13
|
-
| [월드 환경](world-and-environment.md) | 조명, 지형, 공간 쿼리, 카메라 | manage_lighting, manage_terrain, spatial_query, manage_camera |
|
|
14
|
-
| [에셋 & 오브젝트 연출](assets-and-effects.md) | 에셋 삽입, 트윈, 애니메이션, 오디오, 이펙트 | manage_assets, manage_tween, manage_animation, manage_audio, manage_effects, manage_physics |
|
|
15
|
-
| [플레이테스트 & 자동 테스트](playtest.md) | 플레이테스트 제어, 자동 테스트 실행 | system_info (play/stop/pause/resume/play_status/run_test) |
|
|
16
|
-
| [동기화](../sync/overview.md) | Studio ↔ 로컬 파일 동기화 | manage_sync, workspace_state |
|
|
17
|
-
| [시스템 & 디버깅](system-and-debugging.md) | 연결 확인, 로그, 선택, 배치 실행 | system_info (ping/connection/usage/...), manage_logs, manage_selection, batch_execute |
|
|
18
|
-
|
|
19
|
-
관련 문서:
|
|
20
|
-
- [Sync 기능 상세 가이드](../sync/overview.md)
|
|
21
|
-
|
|
22
|
-
Sync 정책:
|
|
23
|
-
- Basic: Studio -> Local 단방향 동기화
|
|
24
|
-
- Pro: 양방향 동기화 + 더 넓은 고급 action 범위(대량 작업으로 AI 토큰 효율 개선)
|
|
25
|
-
|
|
26
|
-
## Query Instances (혼합)
|
|
27
|
-
|
|
28
|
-
| 액션 | 설명 | 티어 |
|
|
29
|
-
|------|------|------|
|
|
30
|
-
| `get` | 경로로 인스턴스 속성 가져오기 | Basic |
|
|
31
|
-
| `children` | 직계 자식 또는 모든 자손 가져오기 | Basic |
|
|
32
|
-
| `find_child` | 이름과 선택적 클래스 필터로 첫 번째 자식 찾기 | Basic |
|
|
33
|
-
| `find_descendant` | 이름으로 첫 번째 자손 찾기 | Basic |
|
|
34
|
-
| `wait_for_child` | 자식이 나타날 때까지 대기 (타임아웃 포함) | Basic |
|
|
35
|
-
| `class_info` | 클래스 정보 및 유효한 속성 가져오기 | Basic |
|
|
36
|
-
| `search_name` | 이름 패턴으로 인스턴스 검색 (와일드카드 지원) | Basic |
|
|
37
|
-
| `search_class` | 클래스 이름으로 인스턴스 검색 | Basic |
|
|
38
|
-
| `file_tree` | 루트에서 파일 트리 구조 가져오기 | Pro |
|
|
39
|
-
| `project_structure` | 전체 프로젝트 구조 가져오기 | Pro |
|
|
40
|
-
| `descendants` | 인스턴스의 모든 자손 가져오기 | Pro |
|
|
41
|
-
| `ancestors` | 인스턴스의 모든 조상 가져오기 | Pro |
|
|
42
|
-
| `search_property` | 속성 값으로 인스턴스 검색 | Pro |
|
|
43
|
-
| `search_tag` | 태그로 인스턴스 검색 | Pro |
|
|
44
|
-
|
|
45
|
-
## Mutate Instances (혼합)
|
|
46
|
-
|
|
47
|
-
| 액션 | 설명 | 티어 |
|
|
48
|
-
|------|------|------|
|
|
49
|
-
| `create` | 새 인스턴스 생성 | Basic |
|
|
50
|
-
| `create_with_props` | 초기 속성을 가진 인스턴스 생성 | Basic |
|
|
51
|
-
| `delete` | 인스턴스 삭제 | Basic |
|
|
52
|
-
| `clone` | 인스턴스 복제 | Basic |
|
|
53
|
-
| `move` | 인스턴스를 새 부모로 이동 | Basic |
|
|
54
|
-
| `rename` | 인스턴스 이름 변경 | Basic |
|
|
55
|
-
| `pivot` | 피벗 위치 또는 CFrame 설정 | Basic |
|
|
56
|
-
| `create_tree` | 계층적 인스턴스 트리 생성 | Pro |
|
|
57
|
-
| `mass_create` | 여러 인스턴스 한 번에 생성 | Pro |
|
|
58
|
-
| `mass_delete` | 여러 인스턴스 삭제 | Pro |
|
|
59
|
-
| `mass_duplicate` | 여러 인스턴스 복제 | Pro |
|
|
60
|
-
| `smart_duplicate` | 간격과 개수를 지정하여 복제 | Pro |
|
|
61
|
-
|
|
62
|
-
## Manage Properties (혼합)
|
|
63
|
-
|
|
64
|
-
| 액션 | 설명 | 티어 |
|
|
65
|
-
|------|------|------|
|
|
66
|
-
| `get` | 단일 속성 값 가져오기 | Basic |
|
|
67
|
-
| `set` | 단일 속성 값 설정 | Basic |
|
|
68
|
-
| `get_all` | 인스턴스의 모든 속성 가져오기 | Basic |
|
|
69
|
-
| `set_multiple` | 여러 속성 한 번에 설정 | Basic |
|
|
70
|
-
| `get_attr` | 어트리뷰트 값 가져오기 | Basic |
|
|
71
|
-
| `set_attr` | 어트리뷰트 값 설정 | Basic |
|
|
72
|
-
| `get_all_attrs` | 모든 어트리뷰트 가져오기 | Basic |
|
|
73
|
-
| `delete_attr` | 어트리뷰트 삭제 | Basic |
|
|
74
|
-
| `add_tag` | 인스턴스에 태그 추가 | Basic |
|
|
75
|
-
| `remove_tag` | 인스턴스에서 태그 제거 | Basic |
|
|
76
|
-
| `check_tag` | 인스턴스가 태그를 가지고 있는지 확인 | Basic |
|
|
77
|
-
| `get_tags` | 인스턴스의 모든 태그 가져오기 | Basic |
|
|
78
|
-
| `get_tagged` | 특정 태그를 가진 모든 인스턴스 가져오기 | Basic |
|
|
79
|
-
| `set_calculated` | 수식을 사용하여 속성 설정 | Pro |
|
|
80
|
-
| `set_relative` | 현재 값을 기준으로 상대적으로 속성 설정 | Pro |
|
|
81
|
-
| `mass_set` | 여러 인스턴스에 속성 설정 | Pro |
|
|
82
|
-
| `mass_get` | 여러 인스턴스에서 속성 가져오기 | Pro |
|
|
83
|
-
| `modify_children` | 부모의 모든 자식 수정 | Pro |
|
|
84
|
-
|
|
85
|
-
## Manage Scripts (혼합)
|
|
86
|
-
|
|
87
|
-
| 액션 | 설명 | 티어 |
|
|
88
|
-
|------|------|------|
|
|
89
|
-
| `get_source` | 스크립트 소스 코드 가져오기 | Basic |
|
|
90
|
-
| `set_source` | 스크립트 소스 코드 설정 | Basic |
|
|
91
|
-
| `create` | 새 스크립트 생성 | Basic |
|
|
92
|
-
| `delete` | 스크립트 삭제 | Basic |
|
|
93
|
-
| `edit_replace` | 스크립트의 특정 줄 교체 | Basic |
|
|
94
|
-
| `edit_insert` | 특정 위치에 줄 삽입 | Basic |
|
|
95
|
-
| `edit_delete` | 특정 줄 삭제 | Basic |
|
|
96
|
-
| `search` | 스크립트에서 텍스트 검색 | Basic |
|
|
97
|
-
| `get_dependencies` | 스크립트 종속성 가져오기 | Basic |
|
|
98
|
-
| `replace` | 여러 스크립트에서 일괄 교체 | Pro |
|
|
99
|
-
|
|
100
|
-
## Manage Lighting (Pro)
|
|
101
|
-
|
|
102
|
-
| 액션 | 설명 | 티어 |
|
|
103
|
-
|------|------|------|
|
|
104
|
-
| `lighting` | Lighting 서비스 속성 설정 | Pro |
|
|
105
|
-
| `atmosphere` | Atmosphere 속성 설정 | Pro |
|
|
106
|
-
| `sky` | Sky 속성 설정 | Pro |
|
|
107
|
-
| `terrain_props` | Terrain 물/시각 속성 설정 | Pro |
|
|
108
|
-
| `time` | 시간대 설정 | Pro |
|
|
109
|
-
|
|
110
|
-
## Manage Selection (혼합)
|
|
111
|
-
|
|
112
|
-
| 액션 | 설명 | 티어 |
|
|
113
|
-
|------|------|------|
|
|
114
|
-
| `get` | 현재 선택 가져오기 | Basic |
|
|
115
|
-
| `set` | 현재 선택 교체 | Basic |
|
|
116
|
-
| `clear` | 선택 초기화 | Basic |
|
|
117
|
-
| `cached` | 왕복 없이 캐시된 선택 가져오기 | Basic |
|
|
118
|
-
| `context` | 소스와 속성을 포함한 상세 컨텍스트 가져오기 | Pro |
|
|
119
|
-
| `details` | 조상/자손을 포함한 계층적 상세 정보 가져오기 | Pro |
|
|
120
|
-
| `add` | 선택에 항목 추가 | Pro |
|
|
121
|
-
| `remove` | 선택에서 항목 제거 | Pro |
|
|
122
|
-
| `watch` | 선택 변경 모니터링 | Pro |
|
|
123
|
-
|
|
124
|
-
## Manage Camera (Basic)
|
|
125
|
-
|
|
126
|
-
| 액션 | 설명 | 티어 |
|
|
127
|
-
|------|------|------|
|
|
128
|
-
| `info` | 카메라 위치, 회전, FOV, 뷰포트 크기 가져오기 | Basic |
|
|
129
|
-
| `focus_path` | 카메라를 인스턴스에 포커스 이동 | Basic |
|
|
130
|
-
| `focus_position` | 카메라를 위치에 포커스 이동 | Basic |
|
|
131
|
-
| `suggest` | 대상에 대한 추천 카메라 뷰 가져오기 | Basic |
|
|
132
|
-
|
|
133
|
-
## Manage Tween (Pro)
|
|
134
|
-
|
|
135
|
-
| 액션 | 설명 | 티어 |
|
|
136
|
-
|------|------|------|
|
|
137
|
-
| `create` | 대상 속성을 가진 트윈 생성 | Pro |
|
|
138
|
-
| `play` | 생성된 트윈 재생 | Pro |
|
|
139
|
-
| `pause` | 실행 중인 트윈 일시정지 | Pro |
|
|
140
|
-
| `cancel` | 트윈 취소 | Pro |
|
|
141
|
-
|
|
142
|
-
## Manage Audio (Pro)
|
|
143
|
-
|
|
144
|
-
| 액션 | 설명 | 티어 |
|
|
145
|
-
|------|------|------|
|
|
146
|
-
| `play` | 사운드 재생 (필요시 Sound 생성) | Pro |
|
|
147
|
-
| `stop` | 재생 중인 사운드 정지 | Pro |
|
|
148
|
-
| `pause` | 재생 중인 사운드 일시정지 | Pro |
|
|
149
|
-
| `resume` | 일시정지된 사운드 재개 | Pro |
|
|
150
|
-
| `set_listener` | 오디오 리스너 타입/대상 설정 | Pro |
|
|
151
|
-
|
|
152
|
-
## Manage Animation (Pro)
|
|
153
|
-
|
|
154
|
-
| 액션 | 설명 | 티어 |
|
|
155
|
-
|------|------|------|
|
|
156
|
-
| `load` | Humanoid/AnimationController에 애니메이션 로드 | Pro |
|
|
157
|
-
| `play` | 로드된 애니메이션 트랙 재생 | Pro |
|
|
158
|
-
| `stop` | 재생 중인 애니메이션 정지 | Pro |
|
|
159
|
-
| `get_tracks` | 로드된 모든 애니메이션 트랙 나열 | Pro |
|
|
160
|
-
|
|
161
|
-
## Manage Physics (Pro)
|
|
162
|
-
|
|
163
|
-
| 액션 | 설명 | 티어 |
|
|
164
|
-
|------|------|------|
|
|
165
|
-
| `register_group` | 충돌 그룹 등록 | Pro |
|
|
166
|
-
| `set_collidable` | 두 그룹이 충돌할 수 있는지 설정 | Pro |
|
|
167
|
-
| `get_groups` | 등록된 모든 충돌 그룹 나열 | Pro |
|
|
168
|
-
|
|
169
|
-
## Manage Effects (Pro)
|
|
170
|
-
|
|
171
|
-
| 액션 | 설명 | 티어 |
|
|
172
|
-
|------|------|------|
|
|
173
|
-
| `emit` | ParticleEmitter에서 파티클 방출 | Pro |
|
|
174
|
-
| `clear` | 모든 파티클 초기화 | Pro |
|
|
175
|
-
| `toggle` | 효과 활성화 또는 비활성화 | Pro |
|
|
176
|
-
|
|
177
|
-
## Manage Terrain (Pro)
|
|
178
|
-
|
|
179
|
-
| 액션 | 설명 | 티어 |
|
|
180
|
-
|------|------|------|
|
|
181
|
-
| `fill_block` | 블록 형태의 지형 채우기 | Pro |
|
|
182
|
-
| `fill_ball` | 구 형태의 지형 채우기 | Pro |
|
|
183
|
-
| `fill_cylinder` | 원통 형태의 지형 채우기 | Pro |
|
|
184
|
-
| `fill_wedge` | 쐐기 형태의 지형 채우기 | Pro |
|
|
185
|
-
| `clear_region` | 영역의 지형 초기화 | Pro |
|
|
186
|
-
| `clear_bounds` | 경계의 지형 초기화 | Pro |
|
|
187
|
-
| `replace_material` | 영역의 재질 교체 | Pro |
|
|
188
|
-
| `colors_get` | 재질 색상 가져오기 | Pro |
|
|
189
|
-
| `colors_set` | 재질 색상 설정 | Pro |
|
|
190
|
-
| `read_voxel` | 단일 복셀 데이터 읽기 | Pro |
|
|
191
|
-
| `read_voxels` | 대량 복셀 데이터 읽기 | Pro |
|
|
192
|
-
| `write_voxels` | 대량 복셀 데이터 쓰기 | Pro |
|
|
193
|
-
| `generate` | 절차적 지형 생성 | Pro |
|
|
194
|
-
| `smooth` | 지형 부드럽게 하기 | Pro |
|
|
195
|
-
|
|
196
|
-
## Spatial Query (Pro)
|
|
197
|
-
|
|
198
|
-
| 액션 | 설명 | 티어 |
|
|
199
|
-
|------|------|------|
|
|
200
|
-
| `raycast` | 단일 광선 투사 | Pro |
|
|
201
|
-
| `find_ground` | 지점 아래 지면 위치 찾기 | Pro |
|
|
202
|
-
| `check_placement` | 배치가 충돌 없는지 확인 | Pro |
|
|
203
|
-
| `multi_raycast` | 여러 광선 일괄 투사 | Pro |
|
|
204
|
-
| `scan_area` | 영역의 높이맵 생성 | Pro |
|
|
205
|
-
| `find_flat` | 건축을 위한 평평한 영역 찾기 | Pro |
|
|
206
|
-
| `find_spawn` | 적절한 스폰 위치 찾기 | Pro |
|
|
207
|
-
| `analyze_walkable` | 이동 가능 영역 그리드 분석 | Pro |
|
|
208
|
-
| `spatial_map` | 모든 BasePart 위치 가져오기 | Pro |
|
|
209
|
-
| `find_space` | 오브젝트를 위한 빈 공간 찾기 | Pro |
|
|
210
|
-
| `bounds` | 인스턴스의 바운딩 박스 가져오기 | Pro |
|
|
211
|
-
| `snap_grid` | 위치를 그리드에 스냅 | Pro |
|
|
212
|
-
| `collision` | AABB 충돌 확인 | Pro |
|
|
213
|
-
|
|
214
|
-
## Manage Assets (Pro)
|
|
215
|
-
|
|
216
|
-
| 액션 | 설명 | 티어 |
|
|
217
|
-
|------|------|------|
|
|
218
|
-
| `insert` | 에셋 ID로 모델 삽입 | Pro |
|
|
219
|
-
| `info` | 에셋 메타데이터 가져오기 | Pro |
|
|
220
|
-
| `search` | Creator Store 검색 | Pro |
|
|
221
|
-
| `search_insert` | 검색하여 첫 번째 일치 항목 삽입 | Pro |
|
|
222
|
-
| `insert_free` | 무료 모델 삽입 | Pro |
|
|
223
|
-
| `insert_package` | 패키지 삽입 | Pro |
|
|
224
|
-
| `export` | 현재 선택 내보내기 | Pro |
|
|
225
|
-
|
|
226
|
-
## Manage Sync (Pro)
|
|
227
|
-
|
|
228
|
-
| 액션 | 설명 | 티어 |
|
|
229
|
-
|------|------|------|
|
|
230
|
-
| `status_current_place` | 현재 연결된 Place의 동기화 상태 가져오기 | Pro |
|
|
231
|
-
| `history` | 변경 기록 가져오기 | Pro |
|
|
232
|
-
| `directions` | 타입별 동기화 방향 가져오기 | Pro |
|
|
233
|
-
| `read_file` | 동기화된 파일 읽기 | Pro |
|
|
234
|
-
| `write_file` | 동기화된 파일에 쓰기 | Pro |
|
|
235
|
-
| `progress` | 실시간 동기화 진행률 및 대역폭 가져오기 | Pro |
|
|
236
|
-
|
|
237
|
-
## Workspace State (Pro)
|
|
238
|
-
|
|
239
|
-
| 액션 | 설명 | 티어 |
|
|
240
|
-
|------|------|------|
|
|
241
|
-
| `sync` | 현재 Workspace 상태 가져오기 | Pro |
|
|
242
|
-
| `snapshot` | 전체 인스턴스 트리 구조 가져오기 | Pro |
|
|
243
|
-
| `changes` | 최근 변경 사항 가져오기 | Pro |
|
|
244
|
-
| `viewport` | 카메라 및 뷰포트 정보 가져오기 | Pro |
|
|
245
|
-
|
|
246
|
-
## Manage Logs (Basic)
|
|
247
|
-
|
|
248
|
-
| 액션 | 설명 | 티어 |
|
|
249
|
-
|------|------|------|
|
|
250
|
-
| `get` | 필터링된 로그 가져오기 | Basic |
|
|
251
|
-
| `clear` | 로그 버퍼 초기화 | Basic |
|
|
252
|
-
| `errors` | 최근 오류만 가져오기 | Basic |
|
|
253
|
-
|
|
254
|
-
## System Info (혼합)
|
|
255
|
-
|
|
256
|
-
| 액션 | 설명 | 티어 |
|
|
257
|
-
|------|------|------|
|
|
258
|
-
| `ping` | 연결 테스트 | Basic |
|
|
259
|
-
| `connection` | 서버/플러그인 연결 정보 가져오기 | Basic |
|
|
260
|
-
| `usage` | 현재 티어 가져오기 (basic/pro) | Basic |
|
|
261
|
-
| `place_info` | Place ID, 이름, 제작자 가져오기 | Pro |
|
|
262
|
-
| `services` | 모든 Roblox 서비스 나열 | Pro |
|
|
263
|
-
| `studio_settings` | Studio 환경설정 가져오기 | Pro |
|
|
264
|
-
| `play` | Play(F5) 또는 Run(F8) 모드로 플레이테스트 시작 | Pro |
|
|
265
|
-
| `stop` | 현재 플레이테스트 중지 | Pro |
|
|
266
|
-
| `pause` | Run 모드 플레이테스트 일시정지 | Pro |
|
|
267
|
-
| `resume` | 일시정지된 Run 모드 플레이테스트 재개 | Pro |
|
|
268
|
-
| `play_status` | 플레이테스트 상태와 가능한 action 조회 | Pro |
|
|
269
|
-
| `run_test` | 임시 테스트 스크립트를 주입하고 플레이테스트 실행 후 로그와 로컬 리포트 파일 생성 | Pro |
|
|
270
|
-
|
|
271
|
-
## Batch Execute (Pro)
|
|
272
|
-
|
|
273
|
-
여러 명령을 단일 배치로 실행합니다. 각 명령은 도구 이름과 인수를 지정합니다. 명령은 순차적으로 실행되며 오류 시 계속 진행 여부를 선택할 수 있습니다.
|
|
274
|
-
|
|
275
|
-
## Execute Luau (Pro)
|
|
276
|
-
|
|
277
|
-
Roblox Studio 샌드박스에서 임의의 Luau 코드를 실행합니다. 차단된 서비스: HttpService, DataStoreService, MessagingService. CoreGui/CorePackages에 접근할 수 없습니다.
|