@weppy/roblox-mcp 0.1.7 → 0.1.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +3 -3
- package/CHANGELOG.md +5 -9
- package/README.md +38 -26
- package/docs/en/installation/README.md +51 -0
- package/docs/en/installation/roblox-plugin.md +6 -6
- package/docs/en/pro-upgrade.md +5 -6
- package/docs/en/tools/overview.md +87 -230
- package/docs/es/README.md +27 -28
- package/docs/es/installation/README.md +44 -0
- package/docs/es/installation/roblox-plugin.md +6 -6
- package/docs/es/pro-upgrade.md +5 -6
- package/docs/es/tools/overview.md +88 -231
- package/docs/id/README.md +39 -27
- package/docs/id/installation/README.md +51 -0
- package/docs/id/installation/roblox-plugin.md +6 -6
- package/docs/id/pro-upgrade.md +5 -6
- package/docs/id/tools/overview.md +88 -231
- package/docs/ja/README.md +40 -28
- package/docs/ja/installation/README.md +51 -0
- package/docs/ja/installation/roblox-plugin.md +6 -6
- package/docs/ja/pro-upgrade.md +5 -6
- package/docs/ja/tools/overview.md +88 -231
- package/docs/ko/README.md +39 -27
- package/docs/ko/installation/README.md +51 -0
- package/docs/ko/installation/roblox-plugin.md +6 -6
- package/docs/ko/pro-upgrade.md +5 -6
- package/docs/ko/tools/overview.md +88 -231
- package/docs/pt-br/README.md +39 -27
- package/docs/pt-br/installation/README.md +51 -0
- package/docs/pt-br/installation/roblox-plugin.md +6 -6
- package/docs/pt-br/pro-upgrade.md +5 -6
- package/docs/pt-br/tools/overview.md +88 -231
- package/package.json +1 -1
- package/plugins/weppy-roblox-mcp/.claude-plugin/plugin.json +1 -1
- package/plugins/weppy-roblox-mcp/dist/index.js +1 -1
- package/plugins/weppy-roblox-mcp/skills/roblox-game-dev/references/mcp-tools.md +9 -4
- /package/docs/en/installation/{antigravity.md → ai-apps/antigravity.md} +0 -0
- /package/docs/en/installation/{claude-app.md → ai-apps/claude-app.md} +0 -0
- /package/docs/en/installation/{claude-code.md → ai-apps/claude-code.md} +0 -0
- /package/docs/en/installation/{codex-app.md → ai-apps/codex-app.md} +0 -0
- /package/docs/en/installation/{codex-cli.md → ai-apps/codex-cli.md} +0 -0
- /package/docs/en/installation/{gemini-cli.md → ai-apps/gemini-cli.md} +0 -0
- /package/docs/es/installation/{antigravity.md → ai-apps/antigravity.md} +0 -0
- /package/docs/es/installation/{claude-app.md → ai-apps/claude-app.md} +0 -0
- /package/docs/es/installation/{claude-code.md → ai-apps/claude-code.md} +0 -0
- /package/docs/es/installation/{codex-app.md → ai-apps/codex-app.md} +0 -0
- /package/docs/es/installation/{codex-cli.md → ai-apps/codex-cli.md} +0 -0
- /package/docs/es/installation/{gemini-cli.md → ai-apps/gemini-cli.md} +0 -0
- /package/docs/id/installation/{antigravity.md → ai-apps/antigravity.md} +0 -0
- /package/docs/id/installation/{claude-app.md → ai-apps/claude-app.md} +0 -0
- /package/docs/id/installation/{claude-code.md → ai-apps/claude-code.md} +0 -0
- /package/docs/id/installation/{codex-app.md → ai-apps/codex-app.md} +0 -0
- /package/docs/id/installation/{codex-cli.md → ai-apps/codex-cli.md} +0 -0
- /package/docs/id/installation/{gemini-cli.md → ai-apps/gemini-cli.md} +0 -0
- /package/docs/ja/installation/{antigravity.md → ai-apps/antigravity.md} +0 -0
- /package/docs/ja/installation/{claude-app.md → ai-apps/claude-app.md} +0 -0
- /package/docs/ja/installation/{claude-code.md → ai-apps/claude-code.md} +0 -0
- /package/docs/ja/installation/{codex-app.md → ai-apps/codex-app.md} +0 -0
- /package/docs/ja/installation/{codex-cli.md → ai-apps/codex-cli.md} +0 -0
- /package/docs/ja/installation/{gemini-cli.md → ai-apps/gemini-cli.md} +0 -0
- /package/docs/ko/installation/{antigravity.md → ai-apps/antigravity.md} +0 -0
- /package/docs/ko/installation/{claude-app.md → ai-apps/claude-app.md} +0 -0
- /package/docs/ko/installation/{claude-code.md → ai-apps/claude-code.md} +0 -0
- /package/docs/ko/installation/{codex-app.md → ai-apps/codex-app.md} +0 -0
- /package/docs/ko/installation/{codex-cli.md → ai-apps/codex-cli.md} +0 -0
- /package/docs/ko/installation/{gemini-cli.md → ai-apps/gemini-cli.md} +0 -0
- /package/docs/pt-br/installation/{antigravity.md → ai-apps/antigravity.md} +0 -0
- /package/docs/pt-br/installation/{claude-app.md → ai-apps/claude-app.md} +0 -0
- /package/docs/pt-br/installation/{claude-code.md → ai-apps/claude-code.md} +0 -0
- /package/docs/pt-br/installation/{codex-app.md → ai-apps/codex-app.md} +0 -0
- /package/docs/pt-br/installation/{codex-cli.md → ai-apps/codex-cli.md} +0 -0
- /package/docs/pt-br/installation/{gemini-cli.md → ai-apps/gemini-cli.md} +0 -0
|
@@ -1,238 +1,95 @@
|
|
|
1
|
-
# Roblox MCP
|
|
1
|
+
# Roblox MCP 기능
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
AI와 Roblox Studio를 연결해서 다양한 작업을 자동화할 수 있습니다. 아래는 카테고리별로 어떤 일을 할 수 있는지 소개합니다.
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
## Basic
|
|
8
|
-
|
|
9
|
-
###
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
| 도구 | 설명 |
|
|
45
|
-
|------|-------------|
|
|
46
|
-
| `create_script` | 새로운 스크립트 생성 |
|
|
47
|
-
| `get_script_source` | 스크립트 소스 코드 조회 |
|
|
48
|
-
| `set_script_source` | 스크립트 소스 코드 업데이트 |
|
|
49
|
-
| `delete_script` | 스크립트 삭제 |
|
|
50
|
-
| `edit_script_lines` | 특정 라인 편집 |
|
|
51
|
-
| `insert_script_lines` | 라인 삽입 |
|
|
52
|
-
| `delete_script_lines` | 라인 삭제 |
|
|
53
|
-
| `search_in_scripts` | 스크립트 내 검색 |
|
|
54
|
-
| `get_script_dependencies` | 의존성 조회 |
|
|
55
|
-
|
|
56
|
-
### Selection (선택) - 12개
|
|
57
|
-
|
|
58
|
-
| 도구 | 설명 |
|
|
59
|
-
|------|-------------|
|
|
60
|
-
| `get_selection` | 현재 선택된 인스턴스 조회 |
|
|
61
|
-
| `get_selection_context` | 컨텍스트와 함께 선택 항목 조회 |
|
|
62
|
-
| `get_selection_details` | 선택 항목 상세 정보 조회 |
|
|
63
|
-
| `set_selection` | 인스턴스 선택 설정 |
|
|
64
|
-
| `clear_selection` | 선택 해제 |
|
|
65
|
-
| `add_to_selection` | 선택에 추가 |
|
|
66
|
-
| `remove_from_selection` | 선택에서 제거 |
|
|
67
|
-
| `get_place_info` | Place 정보 조회 |
|
|
68
|
-
| `get_services` | 게임 서비스 목록 조회 |
|
|
69
|
-
| `get_studio_settings` | Studio 설정 조회 |
|
|
70
|
-
| `run_command` | Studio 명령 실행 |
|
|
71
|
-
| `watch_selection` | 선택 변경 감시 |
|
|
72
|
-
|
|
73
|
-
### Search (검색) - 2개
|
|
74
|
-
|
|
75
|
-
| 도구 | 설명 |
|
|
76
|
-
|------|-------------|
|
|
77
|
-
| `search_by_name` | 이름으로 인스턴스 검색 |
|
|
78
|
-
| `search_by_class` | 클래스로 인스턴스 검색 |
|
|
79
|
-
|
|
80
|
-
### Tag (태그) - 5개
|
|
81
|
-
|
|
82
|
-
| 도구 | 설명 |
|
|
83
|
-
|------|-------------|
|
|
84
|
-
| `add_tag` | 인스턴스에 태그 추가 |
|
|
85
|
-
| `remove_tag` | 인스턴스에서 태그 제거 |
|
|
86
|
-
| `get_tags` | 인스턴스의 태그 목록 조회 |
|
|
87
|
-
| `get_tagged` | 태그가 된 인스턴스 목록 조회 |
|
|
88
|
-
| `has_tag` | 인스턴스 태그 보유 여부 확인 |
|
|
89
|
-
|
|
90
|
-
### Camera (카메라) - 4개
|
|
91
|
-
|
|
92
|
-
| 도구 | 설명 |
|
|
93
|
-
|------|-------------|
|
|
94
|
-
| `get_camera_info` | 카메라 정보 조회 |
|
|
95
|
-
| `get_suggested_camera_view` | 추천 카메라 뷰 조회 |
|
|
96
|
-
| `focus_camera_path` | 경로로 인스턴스에 카메라 포커스 |
|
|
97
|
-
| `focus_camera_position` | 월드 위치에 카메라 포커스 |
|
|
98
|
-
|
|
99
|
-
### Log (로그) - 3개
|
|
100
|
-
|
|
101
|
-
| 도구 | 설명 |
|
|
102
|
-
|------|-------------|
|
|
103
|
-
| `get_output_logs` | 출력 로그 조회 |
|
|
104
|
-
| `clear_output_logs` | 출력 로그 초기화 |
|
|
105
|
-
| `get_recent_errors` | 최근 에러 조회 |
|
|
106
|
-
|
|
107
|
-
### Connection (연결) - 2개
|
|
108
|
-
|
|
109
|
-
| 도구 | 설명 |
|
|
110
|
-
|------|-------------|
|
|
111
|
-
| `get_connection_info` | 연결 상태 조회 |
|
|
112
|
-
| `get_usage_status` | 사용량/할당량 상태 조회 |
|
|
7
|
+
## Basic (무료)
|
|
8
|
+
|
|
9
|
+
### 오브젝트 관리
|
|
10
|
+
|
|
11
|
+
파트, 모델, 폴더 등 게임 오브젝트를 만들고, 복제하고, 삭제하고, 이동할 수 있습니다. "빨간 파트를 만들어줘", "이 모델을 복제해서 옆에 놔줘" 같은 작업이 가능합니다.
|
|
12
|
+
|
|
13
|
+
### 속성 설정
|
|
14
|
+
|
|
15
|
+
오브젝트의 크기, 색상, 위치, 재질 등 모든 속성을 읽고 변경할 수 있습니다. 여러 속성을 한번에 바꾸거나, 현재 값을 기준으로 상대적으로 조정하는 것도 가능합니다.
|
|
16
|
+
|
|
17
|
+
### 스크립트
|
|
18
|
+
|
|
19
|
+
새 스크립트를 만들고, 기존 코드를 읽고, 수정할 수 있습니다. 특정 줄만 편집하거나, 스크립트 안에서 텍스트를 검색하거나, 어떤 모듈을 참조하는지 의존성을 파악하는 것도 가능합니다.
|
|
20
|
+
|
|
21
|
+
### 선택
|
|
22
|
+
|
|
23
|
+
현재 선택한 오브젝트를 확인하고, 선택을 변경하고, 선택을 초기화할 수 있습니다. Studio에서 작업 중인 대상을 이해하고 제어하는 데 필수적입니다.
|
|
24
|
+
|
|
25
|
+
### 검색
|
|
26
|
+
|
|
27
|
+
이름이나 클래스(종류)로 게임 안의 오브젝트를 찾을 수 있습니다.
|
|
28
|
+
|
|
29
|
+
### 태그
|
|
30
|
+
|
|
31
|
+
오브젝트에 태그를 붙이거나 떼고, 특정 태그가 달린 오브젝트를 한번에 찾을 수 있습니다. 같은 종류의 오브젝트를 그룹으로 관리할 때 유용합니다.
|
|
32
|
+
|
|
33
|
+
### 카메라
|
|
34
|
+
|
|
35
|
+
카메라를 특정 오브젝트나 위치로 이동시킬 수 있습니다. 작업 중인 영역을 빠르게 확인할 때 편리합니다.
|
|
36
|
+
|
|
37
|
+
### 로그
|
|
38
|
+
|
|
39
|
+
게임 실행 중 발생한 출력 로그와 에러를 확인할 수 있습니다. 버그를 찾고 수정하는 데 도움이 됩니다.
|
|
40
|
+
|
|
41
|
+
### 연결
|
|
42
|
+
|
|
43
|
+
MCP 서버와 Roblox Studio의 연결 상태와 사용량을 확인할 수 있습니다.
|
|
113
44
|
|
|
114
45
|
---
|
|
115
46
|
|
|
116
|
-
## Pro
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|------|-------------|
|
|
166
|
-
| `set_lighting` | 조명 속성 설정 |
|
|
167
|
-
| `set_atmosphere` | Atmosphere 속성 설정 |
|
|
168
|
-
| `set_sky` | Sky 속성 설정 |
|
|
169
|
-
| `set_terrain` | Terrain 속성 설정 |
|
|
170
|
-
| `set_time_of_day` | 시간 설정 |
|
|
171
|
-
|
|
172
|
-
### State (상태) - 9개
|
|
173
|
-
|
|
174
|
-
| 도구 | 설명 |
|
|
175
|
-
|------|-------------|
|
|
176
|
-
| `sync_workspace_state` | Workspace 상태 동기화 |
|
|
177
|
-
| `get_workspace_snapshot` | Workspace 스냅샷 조회 |
|
|
178
|
-
| `get_recent_changes` | 최근 변경 사항 조회 |
|
|
179
|
-
| `clear_change_history` | 변경 이력 초기화 |
|
|
180
|
-
| `get_viewport_info` | 뷰포트 상태 정보 조회 |
|
|
181
|
-
| `get_workspace_metadata` | Workspace 메타데이터 조회 |
|
|
182
|
-
| `get_script_list` | 스크립트 목록 조회 |
|
|
183
|
-
| `get_selection_info` | 선택 정보 조회 |
|
|
184
|
-
| `clear_state_cache` | 상태 캐시 초기화 |
|
|
185
|
-
|
|
186
|
-
### Spatial (공간) - 5개
|
|
187
|
-
|
|
188
|
-
| 도구 | 설명 |
|
|
189
|
-
|------|-------------|
|
|
190
|
-
| `get_spatial_map` | 영역의 공간 맵 조회 |
|
|
191
|
-
| `find_empty_space` | 영역 내 빈 공간 찾기 |
|
|
192
|
-
| `get_bounds` | 인스턴스의 경계 박스 조회 |
|
|
193
|
-
| `snap_to_grid` | 위치를 그리드에 스냅 |
|
|
194
|
-
| `check_collision` | 인스턴스 간 충돌 확인 |
|
|
195
|
-
|
|
196
|
-
### Raycast (레이캐스트) - 8개
|
|
197
|
-
|
|
198
|
-
| 도구 | 설명 |
|
|
199
|
-
|------|-------------|
|
|
200
|
-
| `raycast` | 레이캐스트 실행 및 충돌 정보 조회 |
|
|
201
|
-
| `find_ground` | 해당 지점의 지면 위치 찾기 |
|
|
202
|
-
| `check_placement` | 물체 배치 가능 여부 확인 |
|
|
203
|
-
| `multi_raycast` | 다중 레이캐스트 수행 |
|
|
204
|
-
| `scan_area` | 영역 스캔 및 높이맵 생성 |
|
|
205
|
-
| `find_flat_areas` | 평평한 배치 영역 찾기 |
|
|
206
|
-
| `find_spawn_positions` | 유효한 스폰 위치 찾기 |
|
|
207
|
-
| `analyze_walkable_area` | 이동 가능 영역 분석 |
|
|
208
|
-
|
|
209
|
-
### Terrain (지형) - 14개
|
|
210
|
-
|
|
211
|
-
| 도구 | 설명 |
|
|
212
|
-
|------|-------------|
|
|
213
|
-
| `terrain_fill_block` | 블록 형태로 지형 채우기 |
|
|
214
|
-
| `terrain_fill_ball` | 구 형태로 지형 채우기 |
|
|
215
|
-
| `terrain_fill_cylinder` | 원통 형태로 지형 채우기 |
|
|
216
|
-
| `terrain_fill_wedge` | 쐐기 형태로 지형 채우기 |
|
|
217
|
-
| `terrain_clear` | 지형 삭제 (Region 객체 사용) |
|
|
218
|
-
| `terrain_clear_region` | 지형 삭제 (최소/최대 좌표 사용) |
|
|
219
|
-
| `terrain_replace_material` | 지형 재질 교체 |
|
|
220
|
-
| `terrain_get_material_color` | 지형 재질 색상 조회 |
|
|
221
|
-
| `terrain_set_material_color` | 지형 재질 색상 설정 |
|
|
222
|
-
| `terrain_read_voxel` | 단일 복셀 읽기 |
|
|
223
|
-
| `terrain_read_voxels` | 복셀 데이터 읽기 |
|
|
224
|
-
| `terrain_write_voxels` | 복셀 데이터 쓰기 |
|
|
225
|
-
| `terrain_generate` | 절차적 지형 생성 |
|
|
226
|
-
| `terrain_smooth` | 지형 부드럽게 하기 |
|
|
227
|
-
|
|
228
|
-
### Visualization (시각화) - 7개
|
|
229
|
-
|
|
230
|
-
| 도구 | 설명 |
|
|
231
|
-
|------|-------------|
|
|
232
|
-
| `visualization_create_area` | 영역 시각화 생성 |
|
|
233
|
-
| `visualization_create_marker` | 마커 시각화 생성 (미리보기 포함) |
|
|
234
|
-
| `visualization_create_line` | 선 시각화 생성 |
|
|
235
|
-
| `visualization_remove` | 시각화 제거 |
|
|
236
|
-
| `visualization_clear` | 모든 시각화 제거 |
|
|
237
|
-
| `visualization_get_status` | 시각화 상태 조회 |
|
|
238
|
-
| `visualization_focus` | 시각화 항목으로 카메라 포커스 |
|
|
47
|
+
## Pro
|
|
48
|
+
|
|
49
|
+
더 강력한 기능이 필요하다면 Pro로 업그레이드할 수 있습니다.
|
|
50
|
+
|
|
51
|
+
### 고급 선택
|
|
52
|
+
|
|
53
|
+
선택한 오브젝트의 속성과 소스 코드를 포함한 상세 컨텍스트를 확인하고, 선택 계층을 탐색하고, 선택에 항목을 추가/제거하고, Place 정보와 게임 서비스를 조회할 수 있습니다. 고급 워크플로우와 자동화에 유용합니다.
|
|
54
|
+
|
|
55
|
+
### 고급 스크립트
|
|
56
|
+
|
|
57
|
+
여러 스크립트의 내용을 한번에 일괄 치환하거나, Luau 코드를 즉시 실행할 수 있습니다. 반복적인 코드 수정이나 빠른 테스트에 유용합니다.
|
|
58
|
+
|
|
59
|
+
### 고급 검색
|
|
60
|
+
|
|
61
|
+
파일 트리 전체를 탐색하거나, 속성이나 태그로 오브젝트를 검색할 수 있습니다. 프로젝트 구조를 한눈에 파악하고, 특정 오브젝트의 모든 자손이나 조상을 조회할 수 있습니다.
|
|
62
|
+
|
|
63
|
+
### 대량 작업
|
|
64
|
+
|
|
65
|
+
수백 개의 오브젝트를 한번에 생성, 삭제, 수정, 복제할 수 있습니다. 맵에 나무를 심거나, 모든 파트의 색을 바꾸거나, 패턴에 따라 오브젝트를 배치하는 대규모 작업을 빠르게 처리합니다.
|
|
66
|
+
|
|
67
|
+
### 에셋
|
|
68
|
+
|
|
69
|
+
Roblox Creator Store에서 무료 모델을 검색하고 바로 삽입할 수 있습니다. "중세 성 모델 찾아줘", "무기 모델 넣어줘"처럼 대화만으로 에셋을 추가합니다.
|
|
70
|
+
|
|
71
|
+
### 환경 설정
|
|
72
|
+
|
|
73
|
+
조명, 하늘, 안개, 지형 속성, 시간대를 자연어로 설정할 수 있습니다. "석양 분위기로 바꿔줘", "밤 12시로 설정해줘" 같은 요청이 가능합니다.
|
|
74
|
+
|
|
75
|
+
### 상태 관리
|
|
76
|
+
|
|
77
|
+
Workspace의 현재 상태를 스냅샷으로 저장하고, 최근 변경 사항과 뷰포트 상태를 확인할 수 있습니다. 복잡한 작업을 할 때 현재 상태를 파악하는 데 도움이 됩니다.
|
|
78
|
+
|
|
79
|
+
### 공간 분석
|
|
80
|
+
|
|
81
|
+
오브젝트의 크기와 위치를 정확하게 파악하고, 빈 공간을 찾고, 충돌 여부를 확인할 수 있습니다. 오브젝트를 그리드에 맞춰 정렬하는 것도 가능합니다.
|
|
82
|
+
|
|
83
|
+
### 레이캐스트
|
|
84
|
+
|
|
85
|
+
보이지 않는 광선을 쏴서 지형이나 오브젝트와의 충돌 지점을 찾습니다. 지면 위치 찾기, 오브젝트 배치 가능 여부 확인, 스폰 위치 찾기, 이동 가능 영역 분석 등 게임 레벨 디자인에 필수적인 기능입니다.
|
|
86
|
+
|
|
87
|
+
### 지형
|
|
88
|
+
|
|
89
|
+
블록, 구, 원통, 쐐기 등 다양한 형태로 지형을 채우고, 깎고, 부드럽게 다듬을 수 있습니다. 재질과 색상을 변경하거나, 산과 강이 있는 자연 지형을 절차적으로 자동 생성할 수도 있습니다.
|
|
90
|
+
|
|
91
|
+
### 시각화
|
|
92
|
+
|
|
93
|
+
영역, 마커, 선 등을 화면에 표시하여 작업 중인 공간을 시각적으로 확인할 수 있습니다. 디버깅이나 레벨 디자인 검토에 유용합니다.
|
|
94
|
+
|
|
95
|
+
👉 [Pro 업그레이드 가이드](../pro-upgrade.md)
|
package/docs/pt-br/README.md
CHANGED
|
@@ -1,47 +1,59 @@
|
|
|
1
1
|
# Roblox MCP
|
|
2
2
|
|
|
3
|
-
[English](
|
|
3
|
+
[English](../../README.md) | [한국어](../ko/README.md) | [日本語](../ja/README.md) | [Español](../es/README.md) | **Português** | [Bahasa Indonesia](../id/README.md)
|
|
4
4
|
|
|
5
|
-
>
|
|
5
|
+
> Fale com a IA e ela executa direto no Roblox Studio.
|
|
6
6
|
|
|
7
7
|
[](https://youtu.be/3jrUpBbZPaw)
|
|
8
8
|
|
|
9
|
-
##
|
|
9
|
+
## O que você pode fazer
|
|
10
10
|
|
|
11
|
-
###
|
|
11
|
+
### Criar jogos completos
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
"Cria um jogo de sobrevivência estilo Minecraft", "Cria um jogo de puzzle de escape room" — a IA projeta a estrutura do jogo e cria mapas, objetos e scripts diretamente. Com uma ideia simples você consegue um jogo jogável completo.
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
> **Dica**: Peça "primeiro faz um plano" depois revise e diga "executa" para melhores resultados.
|
|
16
16
|
|
|
17
|
-
|
|
17
|
+
### Criar e posicionar objetos
|
|
18
18
|
|
|
19
|
-
|
|
20
|
-
|------------------|---------------------|
|
|
21
|
-
| Claude Code | [Como Configurar](installation/claude-code.md) |
|
|
22
|
-
| Claude Desktop | [Como Configurar](installation/claude-app.md) |
|
|
23
|
-
| Codex CLI | [Como Configurar](installation/codex-cli.md) |
|
|
24
|
-
| Codex Desktop | [Como Configurar](installation/codex-app.md) |
|
|
25
|
-
| Gemini CLI | [Como Configurar](installation/gemini-cli.md) |
|
|
26
|
-
| Cursor, Windsurf, etc. | [Como Configurar](installation/antigravity.md) |
|
|
19
|
+
"Cria uma casa de tijolos vermelhos", "Planta 10 árvores em linha" — a IA cria direto no Roblox Studio. Pode ser um objeto ou centenas de uma vez.
|
|
27
20
|
|
|
28
|
-
|
|
21
|
+
### Escrever e editar scripts
|
|
29
22
|
|
|
30
|
-
|
|
23
|
+
"Quando o jogador pular, mostra partículas", "Encontra o bug nesse script" — a IA escreve e edita código diretamente. Também analisa scripts existentes e identifica dependências.
|
|
31
24
|
|
|
32
|
-
|
|
25
|
+
### Configurar atmosfera do mapa
|
|
33
26
|
|
|
34
|
-
|
|
35
|
-
- **Porta**: Utiliza a porta 3002 (localhost)
|
|
27
|
+
"Muda pra clima de pôr do sol", "Deixa escuro como dia de chuva" — uma frase e a IA ajusta iluminação, céu e névoa automaticamente.
|
|
36
28
|
|
|
37
|
-
|
|
29
|
+
### Gerar terreno
|
|
38
30
|
|
|
39
|
-
|
|
40
|
-
|
|
31
|
+
Crie montanhas, rios, planícies e cavernas só conversando. Material, cor e tamanho, tudo personalizável.
|
|
32
|
+
|
|
33
|
+
### Buscar e inserir assets
|
|
34
|
+
|
|
35
|
+
Busca modelos e assets gratuitos no Creator Store e coloca direto no seu jogo. "Procura um modelo de castelo medieval e insere" — simples assim.
|
|
36
|
+
|
|
37
|
+
### Análise espacial e posicionamento
|
|
38
|
+
|
|
39
|
+
"Acha espaço vazio nessa área", "Analisa onde os monstros podem andar" — a IA cuida das questões espaciais.
|
|
40
|
+
|
|
41
|
+
### Depuração e análise
|
|
41
42
|
|
|
42
|
-
|
|
43
|
+
Confira logs de erro do jogo, encontre problemas e corrija com a ajuda da IA.
|
|
43
44
|
|
|
44
|
-
|
|
45
|
+
> [Ver lista completa](tools/overview.md)
|
|
45
46
|
|
|
46
|
-
|
|
47
|
-
|
|
47
|
+
## Começar
|
|
48
|
+
|
|
49
|
+
A instalação tem dois passos:
|
|
50
|
+
|
|
51
|
+
1. **Instalar plugin do Roblox Studio** — Faz a ponte entre Studio e IA
|
|
52
|
+
2. **Registrar servidor MCP no app de IA** — Configura seu app de IA para reconhecer o Roblox MCP
|
|
53
|
+
|
|
54
|
+
Leva 5 minutos. 👉 [Ver guia de instalação](installation/README.md)
|
|
55
|
+
|
|
56
|
+
## Links
|
|
57
|
+
|
|
58
|
+
- [GitHub](https://github.com/hope1026/roblox-mcp)
|
|
59
|
+
- [Reportar Problema](https://github.com/hope1026/roblox-mcp/issues)
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
# Guia de Instalação
|
|
2
|
+
|
|
3
|
+
Para usar o Roblox MCP você precisa instalar **duas coisas**.
|
|
4
|
+
|
|
5
|
+
```
|
|
6
|
+
App de IA (Claude, Codex, Gemini, etc.)
|
|
7
|
+
│
|
|
8
|
+
Servidor MCP ← Aqui os comandos da IA são convertidos para o formato do Roblox
|
|
9
|
+
│
|
|
10
|
+
Plugin Roblox Studio ← Executa os comandos dentro do Studio
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
Quando o app de IA diz "cria uma parte azul", o servidor MCP converte o pedido e o plugin do Roblox Studio cria a parte de verdade.
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## Passo 1: Instalar plugin do Roblox Studio
|
|
18
|
+
|
|
19
|
+
Baixe o arquivo do plugin no GitHub e coloque na pasta Plugins do Roblox Studio.
|
|
20
|
+
|
|
21
|
+
👉 [Guia de instalação do plugin](roblox-plugin.md)
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## Passo 2: Registrar servidor MCP no app de IA
|
|
26
|
+
|
|
27
|
+
Registre o servidor MCP no seu app de IA. Funciona com qualquer app que suporte MCP.
|
|
28
|
+
|
|
29
|
+
| App de IA | Guia de Instalação |
|
|
30
|
+
|-----------|-------------------|
|
|
31
|
+
| Claude Code | [Como Configurar](ai-apps/claude-code.md) |
|
|
32
|
+
| Claude Desktop | [Como Configurar](ai-apps/claude-app.md) |
|
|
33
|
+
| Codex CLI | [Como Configurar](ai-apps/codex-cli.md) |
|
|
34
|
+
| Codex Desktop | [Como Configurar](ai-apps/codex-app.md) |
|
|
35
|
+
| Gemini CLI | [Como Configurar](ai-apps/gemini-cli.md) |
|
|
36
|
+
| Antigravity | [Como Configurar](ai-apps/antigravity.md) |
|
|
37
|
+
|
|
38
|
+
> Apps de IA que não estão na lista também funcionam se suportarem MCP. O comando do servidor MCP é `npx -y @weppy/roblox-mcp`.
|
|
39
|
+
|
|
40
|
+
---
|
|
41
|
+
|
|
42
|
+
## Depois da instalação
|
|
43
|
+
|
|
44
|
+
1. Abra o **Roblox Studio** e na aba Plugins clique em **W-MCP** → **Connect**
|
|
45
|
+
2. No **app de IA** teste assim:
|
|
46
|
+
|
|
47
|
+
```
|
|
48
|
+
Crie uma parte azul no Roblox Studio
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
Se a parte aparecer, a instalação está completa!
|
|
@@ -32,12 +32,12 @@ O servidor MCP deve estar instalado. Complete primeiro o guia correspondente ao
|
|
|
32
32
|
|
|
33
33
|
| Aplicativo de IA | Guia de Instalacao |
|
|
34
34
|
|------------------|---------------------|
|
|
35
|
-
| Claude Code | [Como Configurar](claude-code.md) |
|
|
36
|
-
| Claude Desktop | [Como Configurar](claude-app.md) |
|
|
37
|
-
| Codex CLI | [Como Configurar](codex-cli.md) |
|
|
38
|
-
| Codex Desktop | [Como Configurar](codex-app.md) |
|
|
39
|
-
| Gemini CLI | [Como Configurar](gemini-cli.md) |
|
|
40
|
-
|
|
|
35
|
+
| Claude Code | [Como Configurar](ai-apps/claude-code.md) |
|
|
36
|
+
| Claude Desktop | [Como Configurar](ai-apps/claude-app.md) |
|
|
37
|
+
| Codex CLI | [Como Configurar](ai-apps/codex-cli.md) |
|
|
38
|
+
| Codex Desktop | [Como Configurar](ai-apps/codex-app.md) |
|
|
39
|
+
| Gemini CLI | [Como Configurar](ai-apps/gemini-cli.md) |
|
|
40
|
+
| Antigravity | [Como Configurar](ai-apps/antigravity.md) |
|
|
41
41
|
|
|
42
42
|
### Conectar
|
|
43
43
|
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
**Jogos de Alta Qualidade** - Com ferramentas de terreno, ambiente, ativos e espaciais, voce pode criar mundos de jogo completos, nao apenas prototipos.
|
|
8
8
|
|
|
9
|
-
## Ferramentas Adicionadas pelo Pro
|
|
9
|
+
## Ferramentas Adicionadas pelo Pro
|
|
10
10
|
|
|
11
11
|
| Categoria | Funcionalidade |
|
|
12
12
|
|-----------|----------------|
|
|
@@ -21,8 +21,7 @@
|
|
|
21
21
|
|
|
22
22
|
### Passo 1: Compre no Gumroad
|
|
23
23
|
|
|
24
|
-
1. Acesse [Gumroad - Weppy Roblox Plugin](https://
|
|
25
|
-
)
|
|
24
|
+
1. Acesse [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin)
|
|
26
25
|
2. Baixe o plugin
|
|
27
26
|
|
|
28
27
|
### Passo 2: Instale o Plugin
|
|
@@ -37,12 +36,12 @@
|
|
|
37
36
|
|
|
38
37
|
1. Abra o plugin W-MCP
|
|
39
38
|
2. Verifique se o emblema "Pro" e exibido
|
|
40
|
-
3. Todas as
|
|
39
|
+
3. Todas as ferramentas disponiveis!
|
|
41
40
|
|
|
42
41
|
## Comparacao de Recursos
|
|
43
42
|
|
|
44
|
-
| Recurso | Basic
|
|
45
|
-
|
|
43
|
+
| Recurso | Basic | Pro |
|
|
44
|
+
|---------|:-----:|:---:|
|
|
46
45
|
| Instance, Script, Property | ✅ Acesso Total | ✅ Acesso Total |
|
|
47
46
|
| Selection, Tag, Camera, Log | ✅ Acesso Total | ✅ Acesso Total |
|
|
48
47
|
| Operacoes em Massa (Bulk) | ― | ✅ Ilimitado |
|