@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.
Files changed (72) hide show
  1. package/.claude-plugin/marketplace.json +3 -3
  2. package/CHANGELOG.md +5 -9
  3. package/README.md +38 -26
  4. package/docs/en/installation/README.md +51 -0
  5. package/docs/en/installation/roblox-plugin.md +6 -6
  6. package/docs/en/pro-upgrade.md +5 -6
  7. package/docs/en/tools/overview.md +87 -230
  8. package/docs/es/README.md +27 -28
  9. package/docs/es/installation/README.md +44 -0
  10. package/docs/es/installation/roblox-plugin.md +6 -6
  11. package/docs/es/pro-upgrade.md +5 -6
  12. package/docs/es/tools/overview.md +88 -231
  13. package/docs/id/README.md +39 -27
  14. package/docs/id/installation/README.md +51 -0
  15. package/docs/id/installation/roblox-plugin.md +6 -6
  16. package/docs/id/pro-upgrade.md +5 -6
  17. package/docs/id/tools/overview.md +88 -231
  18. package/docs/ja/README.md +40 -28
  19. package/docs/ja/installation/README.md +51 -0
  20. package/docs/ja/installation/roblox-plugin.md +6 -6
  21. package/docs/ja/pro-upgrade.md +5 -6
  22. package/docs/ja/tools/overview.md +88 -231
  23. package/docs/ko/README.md +39 -27
  24. package/docs/ko/installation/README.md +51 -0
  25. package/docs/ko/installation/roblox-plugin.md +6 -6
  26. package/docs/ko/pro-upgrade.md +5 -6
  27. package/docs/ko/tools/overview.md +88 -231
  28. package/docs/pt-br/README.md +39 -27
  29. package/docs/pt-br/installation/README.md +51 -0
  30. package/docs/pt-br/installation/roblox-plugin.md +6 -6
  31. package/docs/pt-br/pro-upgrade.md +5 -6
  32. package/docs/pt-br/tools/overview.md +88 -231
  33. package/package.json +1 -1
  34. package/plugins/weppy-roblox-mcp/.claude-plugin/plugin.json +1 -1
  35. package/plugins/weppy-roblox-mcp/dist/index.js +1 -1
  36. package/plugins/weppy-roblox-mcp/skills/roblox-game-dev/references/mcp-tools.md +9 -4
  37. /package/docs/en/installation/{antigravity.md → ai-apps/antigravity.md} +0 -0
  38. /package/docs/en/installation/{claude-app.md → ai-apps/claude-app.md} +0 -0
  39. /package/docs/en/installation/{claude-code.md → ai-apps/claude-code.md} +0 -0
  40. /package/docs/en/installation/{codex-app.md → ai-apps/codex-app.md} +0 -0
  41. /package/docs/en/installation/{codex-cli.md → ai-apps/codex-cli.md} +0 -0
  42. /package/docs/en/installation/{gemini-cli.md → ai-apps/gemini-cli.md} +0 -0
  43. /package/docs/es/installation/{antigravity.md → ai-apps/antigravity.md} +0 -0
  44. /package/docs/es/installation/{claude-app.md → ai-apps/claude-app.md} +0 -0
  45. /package/docs/es/installation/{claude-code.md → ai-apps/claude-code.md} +0 -0
  46. /package/docs/es/installation/{codex-app.md → ai-apps/codex-app.md} +0 -0
  47. /package/docs/es/installation/{codex-cli.md → ai-apps/codex-cli.md} +0 -0
  48. /package/docs/es/installation/{gemini-cli.md → ai-apps/gemini-cli.md} +0 -0
  49. /package/docs/id/installation/{antigravity.md → ai-apps/antigravity.md} +0 -0
  50. /package/docs/id/installation/{claude-app.md → ai-apps/claude-app.md} +0 -0
  51. /package/docs/id/installation/{claude-code.md → ai-apps/claude-code.md} +0 -0
  52. /package/docs/id/installation/{codex-app.md → ai-apps/codex-app.md} +0 -0
  53. /package/docs/id/installation/{codex-cli.md → ai-apps/codex-cli.md} +0 -0
  54. /package/docs/id/installation/{gemini-cli.md → ai-apps/gemini-cli.md} +0 -0
  55. /package/docs/ja/installation/{antigravity.md → ai-apps/antigravity.md} +0 -0
  56. /package/docs/ja/installation/{claude-app.md → ai-apps/claude-app.md} +0 -0
  57. /package/docs/ja/installation/{claude-code.md → ai-apps/claude-code.md} +0 -0
  58. /package/docs/ja/installation/{codex-app.md → ai-apps/codex-app.md} +0 -0
  59. /package/docs/ja/installation/{codex-cli.md → ai-apps/codex-cli.md} +0 -0
  60. /package/docs/ja/installation/{gemini-cli.md → ai-apps/gemini-cli.md} +0 -0
  61. /package/docs/ko/installation/{antigravity.md → ai-apps/antigravity.md} +0 -0
  62. /package/docs/ko/installation/{claude-app.md → ai-apps/claude-app.md} +0 -0
  63. /package/docs/ko/installation/{claude-code.md → ai-apps/claude-code.md} +0 -0
  64. /package/docs/ko/installation/{codex-app.md → ai-apps/codex-app.md} +0 -0
  65. /package/docs/ko/installation/{codex-cli.md → ai-apps/codex-cli.md} +0 -0
  66. /package/docs/ko/installation/{gemini-cli.md → ai-apps/gemini-cli.md} +0 -0
  67. /package/docs/pt-br/installation/{antigravity.md → ai-apps/antigravity.md} +0 -0
  68. /package/docs/pt-br/installation/{claude-app.md → ai-apps/claude-app.md} +0 -0
  69. /package/docs/pt-br/installation/{claude-code.md → ai-apps/claude-code.md} +0 -0
  70. /package/docs/pt-br/installation/{codex-app.md → ai-apps/codex-app.md} +0 -0
  71. /package/docs/pt-br/installation/{codex-cli.md → ai-apps/codex-cli.md} +0 -0
  72. /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
- MCP 도구의 상세 파라미터는 MCP 도구 정의를 직접 확인하세요.
3
+ AI와 Roblox Studio를 연결해서 다양한 작업을 자동화할 있습니다. 아래는 카테고리별로 어떤 일을 할 수 있는지 소개합니다.
4
4
 
5
5
  ---
6
6
 
7
- ## Basic 도구 (68개)
8
-
9
- ### Instance (인스턴스) - 13개
10
-
11
- | 도구 | 설명 |
12
- |------|-------------|
13
- | `create_instance` | 새로운 인스턴스 생성 |
14
- | `create_instance_with_properties` | 속성과 함께 인스턴스 생성 |
15
- | `clone_instance` | 기존 인스턴스 복제 |
16
- | `delete_instance` | 인스턴스 삭제 |
17
- | `move_instance` | 인스턴스를 새로운 부모로 이동 |
18
- | `rename_instance` | 인스턴스 이름 변경 |
19
- | `get_instance` | 인스턴스 정보 조회 |
20
- | `get_instance_children` | 인스턴스의 자식 목록 조회 |
21
- | `find_first_child` | 이름으로 첫 번째 자식 찾기 |
22
- | `find_first_descendant` | 이름으로 첫 번째 자손 찾기 |
23
- | `get_class_info` | 클래스 정보 조회 |
24
- | `wait_for_child` | 자식이 생길 때까지 대기 |
25
- | `pivot_to` | Pivot CFrame 설정 |
26
-
27
- ### Property (속성) - 10개
28
-
29
- | 도구 | 설명 |
30
- |------|-------------|
31
- | `get_property` | 속성 조회 |
32
- | `set_property` | 속성 값 설정 |
33
- | `get_all_properties` | 모든 속성 조회 |
34
- | `set_multiple_properties` | 여러 속성 동시 설정 |
35
- | `set_calculated_property` | 계산된 값으로 속성 설정 |
36
- | `set_relative_property` | 상대적인 값으로 속성 설정 |
37
- | `get_attribute` | 어트리뷰트 값 조회 |
38
- | `set_attribute` | 어트리뷰트 값 설정 |
39
- | `get_all_attributes` | 모든 어트리뷰트 조회 |
40
- | `delete_attribute` | 어트리뷰트 삭제 |
41
-
42
- ### Script (스크립트) - 9개
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 도구 (+72개)
117
- 👉 [Pro 업그레이드 가이드](pro-upgrade.md)
118
-
119
- ### Script (스크립트) - 2개
120
-
121
- | 도구 | 설명 |
122
- |------|-------------|
123
- | `replace_in_scripts` | 스크립트 내용 일괄 치환 |
124
- | `execute_script` | Luau 코드 직접 실행 |
125
-
126
- ### Search (검색) - 6개
127
-
128
- | 도구 | 설명 |
129
- |------|-------------|
130
- | `get_file_tree` | 파일 트리 조회 |
131
- | `get_project_structure` | 프로젝트 구조 트리 조회 |
132
- | `search_by_property` | 속성으로 검색 |
133
- | `search_by_tag` | 태그로 검색 |
134
- | `get_descendants` | 모든 자손 조회 |
135
- | `get_ancestors` | 조상 조회 |
136
-
137
- ### Bulk (대량 작업) - 8개
138
-
139
- | 도구 | 설명 |
140
- |------|-------------|
141
- | `mass_create_instances` | 인스턴스 대량 생성 |
142
- | `mass_delete_instances` | 인스턴스 대량 삭제 |
143
- | `mass_set_property` | 속성 대량 설정 |
144
- | `mass_get_property` | 속성 대량 조회 |
145
- | `mass_duplicate` | 인스턴스 대량 복제 |
146
- | `smart_duplicate` | 오프셋을 적용한 스마트 복제 |
147
- | `batch_execute` | 다중 명령 일괄 실행 |
148
- | `modify_children` | 모든 자식 수정 |
149
-
150
- ### Asset (에셋) - 7개
151
-
152
- | 도구 | 설명 |
153
- |------|-------------|
154
- | `insert_model` | Creator Store에서 모델 삽입 |
155
- | `get_asset_info` | 에셋 정보 조회 |
156
- | `search_creator_store` | Creator Store 에셋 검색 |
157
- | `search_and_insert_model` | 모델 검색 및 삽입 |
158
- | `insert_free_model` | 무료 모델 삽입 |
159
- | `insert_package` | 패키지 삽입 |
160
- | `export_selection` | 선택 항목 내보내기 |
161
-
162
- ### Environment (환경) - 5개
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)
@@ -1,47 +1,59 @@
1
1
  # Roblox MCP
2
2
 
3
- [English](../en/README.md) | [한국어](../ko/README.md) | [日本語](../ja/README.md) | [Español](../es/README.md) | **Português** | [Bahasa Indonesia](../id/README.md)
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
- > Controle o Roblox Studio com IA.
5
+ > Fale com a IA e ela executa direto no Roblox Studio.
6
6
 
7
7
  [![Demo](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
8
8
 
9
- ## Como Instalar
9
+ ## O que você pode fazer
10
10
 
11
- ### 1. Instalar o Plugin do Roblox
11
+ ### Criar jogos completos
12
12
 
13
- 👉 [Guia de Instalacao do Plugin](installation/roblox-plugin.md)
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
- ### 2. Configurar o Servidor MCP
15
+ > **Dica**: Peça "primeiro faz um plano" depois revise e diga "executa" para melhores resultados.
16
16
 
17
- Pode ser usado com qualquer aplicativo de IA que suporte MCP. Confira o guia correspondente ao seu aplicativo de IA:
17
+ ### Criar e posicionar objetos
18
18
 
19
- | Aplicativo de IA | Guia de Instalacao |
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
- ## Lista de Ferramentas
21
+ ### Escrever e editar scripts
29
22
 
30
- 👉 [Ver Lista Completa de Ferramentas](tools/overview.md)
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
- ## Solucao de Problemas
25
+ ### Configurar atmosfera do mapa
33
26
 
34
- - **"Not Connected"**: Clique novamente no botao Connect no plugin
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
- ## Links
29
+ ### Gerar terreno
38
30
 
39
- - [GitHub](https://github.com/hope1026/roblox-mcp)
40
- - [Relatar Problemas](https://github.com/hope1026/roblox-mcp/issues)
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
- ## Licenca
43
+ Confira logs de erro do jogo, encontre problemas e corrija com a ajuda da IA.
43
44
 
44
- Gratuito para uso em desenvolvimento de jogos.
45
+ > [Ver lista completa](tools/overview.md)
45
46
 
46
- **Permitido**: Desenvolvimento de jogos, jogos comerciais, projetos pessoais
47
- ❌ **Nao Permitido**: Revenda de software, desenvolvimento de produtos concorrentes
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
- | Cursor, Windsurf, etc. | [Como Configurar](antigravity.md) |
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 (72)
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://sunityplugin.gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin
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 140 ferramentas disponiveis!
39
+ 3. Todas as ferramentas disponiveis!
41
40
 
42
41
  ## Comparacao de Recursos
43
42
 
44
- | Recurso | Basic (68) | Pro (140) |
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 |