@weppy/roblox-mcp 2.5.0 → 2.6.0

package/docs/ko/tools/playtest.md

@@ -1,134 +0,0 @@
-# 플레이테스트 & 자동 테스트
-
-> Studio 플레이테스트를 AI로 제어하고, 테스트 스크립트를 주입해 자동으로 실행/검증/리포트를 생성합니다.
-
-## 포함된 도구
-
-| 도구 | 티어 | 설명 |
-|------|:----:|------|
-| `system_info` | Pro | play, stop, pause, resume, play_status, run_test 액션 |
-
-> `system_info`의 나머지 액션(ping, connection, usage 등)은 [시스템 & 디버깅](system-and-debugging.md)을 참고하세요.
-
-## 주요 워크플로우
-
-### 수동 플레이테스트 제어
-
-```
-"Play 모드(F5)로 게임을 시작해줘"
-"현재 플레이테스트를 멈춰줘"
-```
-
-`play` → `play_status`로 상태 확인 → `stop`으로 종료합니다.
-
-### 자동 테스트 실행 (run_test)
-
-```
-"SpawnLocation이 올바른 위치에 있는지 확인하는 테스트를 작성해서 실행해줘"
-```
-
-`run_test`는 테스트 스크립트를 주입하고 플레이테스트를 자동으로 시작/수집/정리합니다.
-
-### CI 스타일 검증
-
-```
-"NPC AI가 목표 지점까지 이동하는지 Run 모드(F8)에서 테스트하고, 실패하면 로그를 보여줘"
-```
-
-`run_test`를 `mode: "run"`으로 실행하여 서버 사이드 테스트를 진행합니다.
-
-## 플레이테스트 상태 머신
-
-```
-Edit ──play──→ Running ──stop──→ Edit
-                  │                 ↑
-                pause             stop
-                  │                 │
-                  ↓                 │
-               Paused ──resume──→ Running
-```
-
-| 상태 | 가능한 액션 |
-|------|------------|
-| `edit` | play |
-| `running` | stop, pause (Run 모드만) |
-| `paused` | resume, stop |
-
-- **Play 모드 (F5)**: 클라이언트+서버 시뮬레이션. pause/resume 불가.
-- **Run 모드 (F8)**: 서버 전용 시뮬레이션. pause/resume 가능.
-
-## run_test 파이프라인
-
-`run_test`는 다음 단계를 자동으로 오케스트레이션합니다:
-
-### 1. 준비
-- Place 정보 조회 (`place_info`)
-- 기존 로그 버퍼 초기화
-
-### 2. 스크립트 주입
-- `ServerScriptService.__MCP_TestRunner`에 래핑된 테스트 스크립트 생성
-- 래퍼가 자동으로 START/FINISHED 시그널과 에러 트레이스백을 처리
-
-### 3. 실행 및 모니터링
-- 플레이테스트 시작 (Play 또는 Run 모드)
-- 500ms 간격으로 로그 폴링
-- `[WEPPY_TEST]:FINISHED` 시그널 수신 시 완료 판정
-- 타임아웃 초과 시 자동 중단 (기본 60초, 최대 300초)
-
-### 4. 정리
-- 플레이테스트 자동 중지
-- 주입된 테스트 스크립트 삭제
-- 마지막 로그 수집
-
-### 5. 리포트 생성
-리포트와 로그는 로컬 `{projectRoot}/weppy-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/` 아래에 저장됩니다.
-
-```
-{projectRoot}/weppy-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/
-├── test-report.md    # 결과 요약 (상태, 시간, 시그널)
-└── test-log.txt      # 전체 로그 (타임스탬프, 시퀀스, 레벨)
-```
-
-**test-report.md 예시:**
-```markdown
-# Test Report
-
-- Status: passed
-- Test Name: spawn_location_test
-- Mode: run
-- Place ID: 123456
-- Duration (ms): 1523
-- Total Logs: 12
-- Signal Count: 2
-
-## Signals
-
-- START: 2026-03-12T10:30:00.000Z
-- FINISHED: 2026-03-12T10:30:01.523Z
-```
-
-## 액션 레퍼런스
-
-| 액션 | 설명 | 파라미터 | 티어 |
-|------|------|---------|------|
-| `play` | Play(F5) 또는 Run(F8) 모드로 플레이테스트 시작 | `mode`: "play" \| "run" | Pro |
-| `stop` | 현재 플레이테스트 중지 | — | Pro |
-| `pause` | Run 모드 플레이테스트 일시정지 | — | Pro |
-| `resume` | 일시정지된 Run 모드 플레이테스트 재개 | — | Pro |
-| `play_status` | 플레이테스트 상태와 가능한 액션 조회 | — | Pro |
-| `run_test` | 테스트 스크립트 주입 → 실행 → 로그 수집 → 리포트 생성 | `script` (필수), `test_name`, `mode`, `timeout` | Pro |
-
-### run_test 파라미터
-
-| 파라미터 | 타입 | 필수 | 설명 |
-|---------|------|:----:|------|
-| `script` | string | ✅ | 실행할 Luau 테스트 코드 본문 |
-| `test_name` | string | — | 리포트에 표시할 테스트 이름 |
-| `mode` | "play" \| "run" | — | 플레이테스트 모드 (기본: "play") |
-| `timeout` | number | — | 타임아웃 초 (기본: 60, 최대: 300) |
-
-## 관련 문서
-
-- [시스템 & 디버깅](system-and-debugging.md) — system_info의 연결/상태 액션, 로그 관리
-- [스크립트 & 코드 실행](scripting.md) — 스크립트 작성 및 Luau 실행
-- [도구 전체 목록](overview.md)

package/docs/ko/tools/scripting.md

@@ -1,66 +0,0 @@
-# 스크립트 & 코드 실행
-
-> 스크립트 소스 코드를 관리하고, 임의의 Luau 코드를 Studio에서 실행합니다.
-
-## 포함된 도구
-
-| 도구 | 티어 | 설명 |
-|------|:----:|------|
-| `manage_scripts` | 혼합 | 스크립트 생성, 읽기, 수정, 검색, 종속성 분석 |
-| `execute_luau` | Pro | Roblox Studio 샌드박스에서 임의의 Luau 코드 실행 |
-
-## 주요 워크플로우
-
-### 스크립트 수정
-
-```
-"ServerScriptService의 GameManager 스크립트에서 maxPlayers를 12에서 24로 변경해줘"
-```
-
-`manage_scripts`의 `search`로 해당 줄을 찾고, `edit_replace`로 수정합니다.
-
-### 일괄 리팩터링 (Pro)
-
-```
-"모든 스크립트에서 'OldModule'을 'NewModule'로 일괄 교체해줘"
-```
-
-`manage_scripts`의 `replace`로 여러 스크립트에서 한 번에 교체합니다.
-
-### 런타임 데이터 조회 (Pro)
-
-```
-"현재 Workspace에 있는 모든 Humanoid의 Health 평균을 계산해줘"
-```
-
-`execute_luau`로 임의 Luau 코드를 실행해 런타임 데이터를 가져옵니다.
-
-## 액션 레퍼런스
-
-### Manage Scripts (혼합)
-
-| 액션 | 설명 | 티어 |
-|------|------|------|
-| `get_source` | 스크립트 소스 코드 가져오기 | Basic |
-| `set_source` | 스크립트 소스 코드 설정 | Basic |
-| `create` | 새 스크립트 생성 | Basic |
-| `delete` | 스크립트 삭제 | Basic |
-| `edit_replace` | 스크립트의 특정 줄 교체 | Basic |
-| `edit_insert` | 특정 위치에 줄 삽입 | Basic |
-| `edit_delete` | 특정 줄 삭제 | Basic |
-| `search` | 스크립트에서 텍스트 검색 | Basic |
-| `get_dependencies` | 스크립트 종속성 가져오기 | Basic |
-| `replace` | 여러 스크립트에서 일괄 교체 | Pro |
-
-### Execute Luau (Pro)
-
-Roblox Studio 샌드박스에서 임의의 Luau 코드를 실행합니다.
-
-- **차단된 서비스**: HttpService, DataStoreService, MessagingService
-- **접근 불가**: CoreGui, CorePackages
-
-## 관련 문서
-
-- [인스턴스 & 속성](instances-and-properties.md) — 스크립트 인스턴스 생성/이동
-- [플레이테스트 & 자동 테스트](playtest.md) — 테스트 스크립트 주입 및 실행
-- [도구 전체 목록](overview.md)

package/docs/ko/tools/system-and-debugging.md

@@ -1,93 +0,0 @@
-# 시스템 & 디버깅
-
-> 연결 상태 확인, 로그 관리, 선택 제어, 배치 실행으로 개발/디버깅 생산성을 높입니다.
-
-## 포함된 도구
-
-| 도구 | 티어 | 설명 |
-|------|:----:|------|
-| `system_info` | 혼합 | ping, connection, usage, place_info, services, studio_settings |
-| `manage_logs` | Basic | 로그 조회, 초기화, 오류 필터링 |
-| `manage_selection` | 혼합 | 선택 가져오기/설정/모니터링 |
-| `batch_execute` | Pro | 여러 명령을 단일 배치로 실행 |
-
-> `system_info`의 플레이테스트 액션(play, stop, pause, resume, play_status, run_test)은 [플레이테스트 & 자동 테스트](playtest.md)를 참고하세요.
-
-## 주요 워크플로우
-
-### 연결 확인
-
-```
-"Studio와 연결이 잘 되어 있는지 확인해줘"
-```
-
-`system_info`의 `ping`으로 빠르게 연결을 테스트합니다.
-
-### 오류 디버깅
-
-```
-"최근 오류 로그를 보여줘"
-```
-
-`manage_logs`의 `errors`로 오류만 필터링하여 조회합니다. `get`은 `sinceSeq` 커서로 증분 조회를 지원합니다.
-
-### 일괄 작업 (Pro)
-
-```
-"Workspace의 모든 Part 색상을 빨간색으로 바꾸고, 카메라를 첫 번째 Part에 포커스해줘"
-```
-
-`batch_execute`로 여러 명령을 하나의 요청으로 묶어 실행합니다.
-
-## 액션 레퍼런스
-
-### System Info (혼합)
-
-| 액션 | 설명 | 티어 |
-|------|------|------|
-| `ping` | 연결 테스트 | Basic |
-| `connection` | 서버/플러그인 연결 정보 가져오기 | Basic |
-| `usage` | 현재 티어 가져오기 (basic/pro) | Basic |
-| `place_info` | Place ID, 이름, 제작자 가져오기 | Pro |
-| `services` | 모든 Roblox 서비스 나열 | Pro |
-| `studio_settings` | Studio 환경설정 가져오기 | Pro |
-
-### Manage Logs (Basic)
-
-| 액션 | 설명 | 티어 |
-|------|------|------|
-| `get` | 필터링된 로그 가져오기 (`sinceSeq` 커서 증분 조회 지원) | Basic |
-| `clear` | 로그 버퍼 초기화 | Basic |
-| `errors` | 최근 오류만 가져오기 | Basic |
-
-### Manage Selection (혼합)
-
-| 액션 | 설명 | 티어 |
-|------|------|------|
-| `get` | 현재 선택 가져오기 | Basic |
-| `set` | 현재 선택 교체 | Basic |
-| `clear` | 선택 초기화 | Basic |
-| `cached` | 왕복 없이 캐시된 선택 가져오기 | Basic |
-| `context` | 소스와 속성을 포함한 상세 컨텍스트 가져오기 | Pro |
-| `details` | 조상/자손을 포함한 계층적 상세 정보 가져오기 | Pro |
-| `add` | 선택에 항목 추가 | Pro |
-| `remove` | 선택에서 항목 제거 | Pro |
-| `watch` | 선택 변경 모니터링 | Pro |
-
-### Manage Context (Basic)
-
-| 액션 | 설명 | 티어 |
-|------|------|------|
-| `begin` | 현재 세션/Place 범위에서 구조화된 실행 컨텍스트를 시작합니다 | Basic |
-| `update` | 활성 컨텍스트의 intent, affected areas, replay metadata를 갱신합니다 | Basic |
-| `end` | 활성 실행 컨텍스트를 종료하고 최종 스냅샷을 저장합니다 | Basic |
-
-### Batch Execute (Pro)
-
-여러 명령을 단일 배치로 실행합니다. 각 명령은 도구 이름과 인수를 지정합니다. 명령은 순차적으로 실행되며 오류 시 계속 진행 여부를 선택할 수 있습니다.
-
-## 관련 문서
-
-- [플레이테스트 & 자동 테스트](playtest.md) — system_info의 플레이테스트 액션
-- [스크립트 & 코드 실행](scripting.md) — execute_luau로 디버깅 코드 실행
-- [도구 전체 목록](overview.md)

package/docs/ko/tools/world-and-environment.md

@@ -1,102 +0,0 @@
-# 월드 환경
-
-> 조명, 지형, 공간 쿼리, 카메라를 사용해 게임 월드를 구축하고 확인합니다.
-
-## 포함된 도구
-
-| 도구 | 티어 | 설명 |
-|------|:----:|------|
-| `manage_lighting` | Pro | Lighting, Atmosphere, Sky, 시간대 설정 |
-| `manage_terrain` | Pro | 지형 생성/수정/복셀 데이터 관리 |
-| `spatial_query` | Pro | 레이캐스트, 지면 탐색, 배치 검증, 높이맵 |
-| `manage_camera` | Basic | 카메라 정보 조회, 포커스 이동, 추천 뷰 |
-
-## 주요 워크플로우
-
-### 월드 분위기 설정 (Pro)
-
-```
-"해질녘 분위기로 바꿔줘. 주황색 하늘, 안개 밀도 높이고, 시간대는 18시로 설정"
-```
-
-`manage_lighting`의 `time`으로 시간대 설정, `atmosphere`로 안개 조정, `sky`로 하늘 컬러를 변경합니다.
-
-### 지형 빌딩 (Pro)
-
-```
-"맵 중앙에 반경 200의 잔디 언덕을 만들고, 주변에 물을 채워줘"
-```
-
-`manage_terrain`의 `fill_ball`로 언덕을 생성하고, `fill_block`으로 주변 물 영역을 채웁니다.
-
-### 배치 검증 (Pro)
-
-```
-"이 건물을 놓을 수 있는 평평한 땅을 찾아줘"
-```
-
-`spatial_query`의 `find_flat`으로 적합한 위치를 찾고, `check_placement`로 충돌 여부를 확인한 뒤, `manage_camera`의 `focus_position`으로 결과를 시각적으로 확인합니다.
-
-## 액션 레퍼런스
-
-### Manage Lighting (Pro)
-
-| 액션 | 설명 | 티어 |
-|------|------|------|
-| `lighting` | Lighting 서비스 속성 설정 | Pro |
-| `atmosphere` | Atmosphere 속성 설정 | Pro |
-| `sky` | Sky 속성 설정 | Pro |
-| `terrain_props` | Terrain 물/시각 속성 설정 | Pro |
-| `time` | 시간대 설정 | Pro |
-
-### Manage Terrain (Pro)
-
-| 액션 | 설명 | 티어 |
-|------|------|------|
-| `fill_block` | 블록 형태의 지형 채우기 | Pro |
-| `fill_ball` | 구 형태의 지형 채우기 | Pro |
-| `fill_cylinder` | 원통 형태의 지형 채우기 | Pro |
-| `fill_wedge` | 쐐기 형태의 지형 채우기 | Pro |
-| `clear_region` | 영역의 지형 초기화 | Pro |
-| `clear_bounds` | 경계의 지형 초기화 | Pro |
-| `replace_material` | 영역의 재질 교체 | Pro |
-| `colors_get` | 재질 색상 가져오기 | Pro |
-| `colors_set` | 재질 색상 설정 | Pro |
-| `read_voxel` | 단일 복셀 데이터 읽기 | Pro |
-| `read_voxels` | 대량 복셀 데이터 읽기 | Pro |
-| `write_voxels` | 대량 복셀 데이터 쓰기 | Pro |
-| `generate` | 절차적 지형 생성 | Pro |
-| `smooth` | 지형 부드럽게 하기 | Pro |
-
-### Spatial Query (Pro)
-
-| 액션 | 설명 | 티어 |
-|------|------|------|
-| `raycast` | 단일 광선 투사 | Pro |
-| `find_ground` | 지점 아래 지면 위치 찾기 | Pro |
-| `check_placement` | 배치가 충돌 없는지 확인 | Pro |
-| `multi_raycast` | 여러 광선 일괄 투사 | Pro |
-| `scan_area` | 영역의 높이맵 생성 | Pro |
-| `find_flat` | 건축을 위한 평평한 영역 찾기 | Pro |
-| `find_spawn` | 적절한 스폰 위치 찾기 | Pro |
-| `analyze_walkable` | 이동 가능 영역 그리드 분석 | Pro |
-| `spatial_map` | 모든 BasePart 위치 가져오기 | Pro |
-| `find_space` | 오브젝트를 위한 빈 공간 찾기 | Pro |
-| `bounds` | 인스턴스의 바운딩 박스 가져오기 | Pro |
-| `snap_grid` | 위치를 그리드에 스냅 | Pro |
-| `collision` | AABB 충돌 확인 | Pro |
-
-### Manage Camera (Basic)
-
-| 액션 | 설명 | 티어 |
-|------|------|------|
-| `info` | 카메라 위치, 회전, FOV, 뷰포트 크기 가져오기 | Basic |
-| `focus_path` | 카메라를 인스턴스에 포커스 이동 | Basic |
-| `focus_position` | 카메라를 위치에 포커스 이동 | Basic |
-| `suggest` | 대상에 대한 추천 카메라 뷰 가져오기 | Basic |
-
-## 관련 문서
-
-- [인스턴스 & 속성](instances-and-properties.md) — 월드 오브젝트 배치
-- [에셋 & 오브젝트 연출](assets-and-effects.md) — 이펙트, 트윈, 오디오
-- [도구 전체 목록](overview.md)

package/docs/pt-br/README.md

@@ -1,208 +0,0 @@
-# Roblox MCP — Servidor MCP para Roblox Studio | Desenvolvimento de jogos com IA usando Claude, Codex, Cursor e Gemini
-
-> **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.
-
-**Ferramentas consolidadas baseadas em ações · Sync bidirecional · Playtest automatizado · Suporte multi-place**
-
-[English](../../README.md) | [한국어](../ko/README.md) | [日本語](../ja/README.md) | [Español](../es/README.md) | **Português** | [Bahasa Indonesia](../id/README.md)
-
-[![Demo — IA criando um jogo Roblox em tempo real](https://img.youtube.com/vi/puQB4u1VlMw/maxresdefault.jpg)](https://youtu.be/puQB4u1VlMw)
-
-## Por que WEPPY (Weppy Roblox MCP)?
-
-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.
-
-**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**.
-
-Sem necessidade de copiar e colar código. A IA trabalha e você confere os resultados.
-
-## Instalacao rapida
-
-Instale seguindo o guia na pagina web.
-
-👉 **[Pagina de instalacao](https://weppyai.com/en/install)**
-
-### Instalacao por terminal
-
-Se voce esta confortavel com o terminal, instale tudo em uma linha.
-
-**macOS / Linux**
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
-```
-
-**Windows (PowerShell)**
-
-```powershell
-irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
-```
-
-Reinicie o Roblox Studio — pronto!
-
-O registro automático de MCP suporta **Claude Code, Claude Desktop, Cursor, Codex CLI/App, Gemini CLI e Antigravity**.
-
-Se a execução do PowerShell estiver bloqueada no Windows, siga a instalação manual abaixo. Se estiver usando o pacote ZIP, você também pode usar `setup-plugin.bat` e `setup-mcp.bat`.
-
-### Instalacao manual
-
-Se a instalacao em um comando nao funcionar, ou se a instalacao automatica nao puder ser usada no seu ambiente, use a instalacao manual abaixo como alternativa.
-
-**Passo 1** — Instale o plugin do Roblox Studio:
-[Guia de instalacao do plugin](installation/roblox-plugin.md)
-
-**Passo 2** — Registre o servidor MCP no seu app de IA:
-
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-| App de IA | Guia |
-|-----------|------|
-| Claude Code | [Configuracao](installation/ai-apps/claude-code.md) |
-| Claude Desktop | [Configuracao](installation/ai-apps/claude-app.md) |
-| Cursor | [Configuracao](installation/ai-apps/cursor.md) |
-| Codex CLI | [Configuracao](installation/ai-apps/codex-cli.md) |
-| Codex Desktop | [Configuracao](installation/ai-apps/codex-app.md) |
-| Gemini CLI | [Configuracao](installation/ai-apps/gemini-cli.md) |
-| Antigravity | [Configuracao](installation/ai-apps/antigravity.md) |
-
-> Funciona com qualquer cliente MCP compativel. O comando do servidor e `npx -y @weppy/roblox-mcp`.
-
-## Compatibilidade
-
-| Claude Code | Claude Desktop | Cursor | Codex CLI | Gemini CLI | Antigravity |
-|:-----------:|:--------------:|:------:|:---------:|:----------:|:-----------:|
-| ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
-
-**Requisitos:** Node.js 18+, Roblox Studio, Windows 10+ ou macOS 12+
-
-## Funcionalidades principais
-
-### 1) MCP Tool: execucao direta no Studio via linguagem natural
-
-A IA consegue operar diretamente scripts, instancias, propriedades, terreno, iluminacao, assets, audio e animacao dentro do Studio.
-
-- "Adiciona particulas + som + cooldown quando o jogador pular."
-- "Cria uma arena de boss no centro do mapa e coloca spawns sem colisao."
-- "Muda a interface deste modulo e atualiza todos os scripts dependentes."
-
-### 2) Sync: mantem contexto completo do projeto para a IA
-
-A IA trabalha com um espelho local sincronizado, entao alteracoes em varios arquivos continuam consistentes.
-
-- Basic: sincronizacao unidirecional (Studio -> Local)
-- Pro: sincronizacao bidirecional + Direction/Apply Mode por tipo + historico + multiplace
-
-![Fluxo de Sync — Studio e arquivos locais sincronizados em tempo real](../assets/screenshots/plugin/sync/sync-overview.png)
-
-### 3) Playtest: a IA executa e valida testes automaticamente
-
-A IA pode controlar diretamente o playtest do Studio. Ela pode iniciar e parar Play (F5) ou Run (F8), injetar scripts de teste, coletar logs e gerar relatorios locais automaticamente.
-
-- "Inicie um playtest em modo Run e verifique se o NPC chega ao objetivo."
-- "Escreva e execute um teste para confirmar que o SpawnLocation esta acima do chao."
-- "Valide com playtest se o script que acabei de alterar roda sem erros."
-
-![WEPPY Playtest Dashboard — historico de testes e relatorio detalhado](../assets/screenshots/dashboard/dashboard_playtest.png)
-
-### 4) WEPPY Dashboard: monitore as operacoes da IA em tempo real
-
-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.
-
-- Visualize o status de conexao do servidor/plugin/agente de uma so vez
-- Compare todas as alteracoes feitas pela IA com Before & After no Changelog
-- Analise o fluxo de trabalho com historico e estatisticas de execucao de ferramentas
-
-![WEPPY WEPPY Dashboard Overview — status do servidor, alteracoes recentes e resumo da sessao](../assets/screenshots/dashboard/dashboard_overview.png)
-
-### 5) WEPPY Roblox Explorer: navegue a hierarquia do Studio no VSCode
-
-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.
-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.
-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).
-
-- Icones de classe iguais ao Studio para reconhecimento imediato
-- Clique para abrir scripts e arquivos de propriedades sincronizados
-- Suporte multiplace com indicadores de status de sincronizacao
-
-![WEPPY Roblox Explorer — arvore de instancias do Studio exibida na barra lateral do VSCode](../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
-
-## Valor imediato para o usuario
-
-- Comprimir trabalho repetitivo: transformar muitas edicoes manuais em um pedido
-- Alterar arquivos relacionados juntos: nao apenas um arquivo alvo
-- Reduzir risco: decidir com base no estado do sync e no historico
-- Melhor eficiencia de tokens (Pro): menos round trips com acoes em massa
-
-## Casos de uso
-
-- **Prototipagem rápida**: Descreva uma mecânica de jogo em linguagem natural e veja a IA construí-la no Studio
-- **Refatoração em massa**: Renomeie uma interface de módulo e atualize todos os scripts dependentes em uma única solicitação
-- **Terrain e ambiente**: Gere terrain procedural, configure iluminação/atmosfera, posicione assets — tudo a partir de um único prompt
-- **Consistência multi-arquivo**: A IA lê o projeto completo via Sync e aplica alterações em scripts relacionados de forma conjunta
-- **Integração de assets**: Pesquise no Creator Store, insira modelos e configure propriedades sem sair do editor
-
-## Documentacao detalhada
-
-- [Guia de instalacao](installation/README.md)
-- [Lista completa de tools](tools/overview.md)
-- [Guia detalhado de Sync](sync/overview.md)
-- [Guia do WEPPY Dashboard](dashboard/overview.md)
-- [WEPPY Roblox Explorer (Extensao VSCode)](installation/roblox-explorer.md)
-- [Compatibilidade](../compatibility.md)
-- [Solucao de problemas](../troubleshooting.md)
-
-### Guias por fluxo
-
-- [Instancias e propriedades](tools/instances-and-properties.md) - busca, criacao, edicao e tags
-- [Scripts e execucao de codigo](tools/scripting.md) - gerenciamento de scripts e execucao de Luau
-- [Mundo e ambiente](tools/world-and-environment.md) - iluminacao, terrain e camera
-- [Assets e efeitos](tools/assets-and-effects.md) - insercao de modelos, tween e efeitos
-- [Playtest e testes automatizados](tools/playtest.md) - controle de playtest e validacao automatica
-- [Sistema e depuracao](tools/system-and-debugging.md) - conexao, logs e execucao em lote
-
-## FAQ
-
-### Como conecto o Claude Code ao Roblox Studio?
-Instale o plugin do Roblox Studio e registre o servidor MCP (`npx -y @weppy/roblox-mcp`) no Claude Code. O Claude poderá ler e escrever scripts diretamente dentro do Studio. Consulte [Configuração do Claude Code](installation/ai-apps/claude-code.md).
-
-### Como uso o Codex CLI com o Roblox Studio?
-Instale o plugin e adicione a configuração do servidor MCP ao Codex CLI. Consulte [Configuração do Codex CLI](installation/ai-apps/codex-cli.md).
-
-### O Roblox MCP funciona com o Cursor?
-Sim. Consulte [Configuração do Cursor](installation/ai-apps/cursor.md). Qualquer cliente de IA compatível com MCP funciona.
-
-### A IA pode criar jogos Roblox com isso?
-Sim. A IA pode criar instâncias, escrever scripts, gerar terrain, configurar iluminação, inserir assets, configurar física e mais — tudo dentro de uma sessão de Studio ao vivo. Vai além da geração de código para ações executáveis.
-
-### Qual é a diferença entre Basic e Pro?
-Basic (gratuito) inclui execução de ferramentas MCP e sincronização unidirecional (Studio -> Local). Pro adiciona sincronização bidirecional, operações em massa, geração de terrain, análise espacial, controle de áudio/animação e suporte multi-place. Consulte o [Guia de upgrade Pro](https://weppyai.com/en/plans).
-
-### Como o Weppy se diferencia de outros servidores MCP para Roblox?
-O Weppy usa despacho baseado em ações em vez de ferramentas separadas para cada função. Isso reduz significativamente o consumo de tokens de IA. Também fornece sincronização bidirecional de projeto e suporte multi-place, que a maioria das alternativas não possui.
-
-### É seguro? A IA pode quebrar meu jogo?
-O servidor roda apenas em localhost (127.0.0.1:3002). Caminhos proibidos (CoreGui, CorePackages) são bloqueados. Limitação de taxa (450 req/min) e timeouts de 30 segundos previnem operações descontroladas. Todas as alterações são rastreáveis pelo histórico de sincronização.
-
-## Upgrade Pro
-
-Sync bidirecional, recursos avancados de criacao e eficiencia de tokens de IA — tudo em uma unica atualizacao.
-
-[Guia de upgrade Pro](https://weppyai.com/en/plans)
-
-## Licença
-
-Este repositório está licenciado sob `AGPL-3.0`.
-
-Licenciamento comercial está disponível separadamente. Consulte [COMMERCIAL-LICENSE.md](../../COMMERCIAL-LICENSE.md).
-
-O uso do nome e logotipos Weppy é regido por [TRADEMARKS.md](../../TRADEMARKS.md).
-
----
-
-[![npm version](https://img.shields.io/npm/v/@weppy/roblox-mcp)](https://www.npmjs.com/package/@weppy/roblox-mcp) [![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org/) [![Smithery](https://smithery.ai/badge/@hope1026/weppy-roblox-mcp)](https://smithery.ai/server/@hope1026/weppy-roblox-mcp)
-
-[![Roblox MCP on Glama](https://glama.ai/mcp/servers/hope1026/roblox-mcp/badges/card.svg)](https://glama.ai/mcp/servers/hope1026/roblox-mcp)
-
-[GitHub Issues](https://github.com/hope1026/weppy-roblox-mcp/issues) · [Discussions](https://github.com/hope1026/weppy-roblox-mcp/discussions) · [npm](https://www.npmjs.com/package/@weppy/roblox-mcp)