@weppy/roblox-mcp 0.1.10 → 1.0.0

package/docs/ko/tools/overview.md

@@ -1,95 +1,255 @@
-# Roblox MCP 기능
-
-AI와 Roblox Studio를 연결해서 다양한 작업을 자동화할 수 있습니다. 아래는 카테고리별로 어떤 일을 할 수 있는지 소개합니다.
-
----
-
-## Basic (무료)
-
-### 오브젝트 관리
-
-파트, 모델, 폴더 등 게임 오브젝트를 만들고, 복제하고, 삭제하고, 이동할 수 있습니다. "빨간 파트를 만들어줘", "이 모델을 복제해서 옆에 놔줘" 같은 작업이 가능합니다.
-
-### 속성 설정
-
-오브젝트의 크기, 색상, 위치, 재질 등 모든 속성을 읽고 변경할 수 있습니다. 여러 속성을 한번에 바꾸거나, 현재 값을 기준으로 상대적으로 조정하는 것도 가능합니다.
-
-### 스크립트
-
-새 스크립트를 만들고, 기존 코드를 읽고, 수정할 수 있습니다. 특정 줄만 편집하거나, 스크립트 안에서 텍스트를 검색하거나, 어떤 모듈을 참조하는지 의존성을 파악하는 것도 가능합니다.
-
-### 선택
-
-현재 선택한 오브젝트를 확인하고, 선택을 변경하고, 선택을 초기화할 수 있습니다. Studio에서 작업 중인 대상을 이해하고 제어하는 데 필수적입니다.
-
-### 검색
-
-이름이나 클래스(종류)로 게임 안의 오브젝트를 찾을 수 있습니다.
-
-### 태그
-
-오브젝트에 태그를 붙이거나 떼고, 특정 태그가 달린 오브젝트를 한번에 찾을 수 있습니다. 같은 종류의 오브젝트를 그룹으로 관리할 때 유용합니다.
-
-### 카메라
-
-카메라를 특정 오브젝트나 위치로 이동시킬 수 있습니다. 작업 중인 영역을 빠르게 확인할 때 편리합니다.
-
-### 로그
-
-게임 실행 중 발생한 출력 로그와 에러를 확인할 수 있습니다. 버그를 찾고 수정하는 데 도움이 됩니다.
-
-### 연결
-
-MCP 서버와 Roblox Studio의 연결 상태와 사용량을 확인할 수 있습니다.
-
----
-
-## Pro
-
-더 강력한 기능이 필요하다면 Pro로 업그레이드할 수 있습니다.
-
-### 고급 선택
-
-선택한 오브젝트의 속성과 소스 코드를 포함한 상세 컨텍스트를 확인하고, 선택 계층을 탐색하고, 선택에 항목을 추가/제거하고, Place 정보와 게임 서비스를 조회할 수 있습니다. 고급 워크플로우와 자동화에 유용합니다.
-
-### 고급 스크립트
-
-여러 스크립트의 내용을 한번에 일괄 치환하거나, Luau 코드를 즉시 실행할 수 있습니다. 반복적인 코드 수정이나 빠른 테스트에 유용합니다.
-
-### 고급 검색
-
-파일 트리 전체를 탐색하거나, 속성이나 태그로 오브젝트를 검색할 수 있습니다. 프로젝트 구조를 한눈에 파악하고, 특정 오브젝트의 모든 자손이나 조상을 조회할 수 있습니다.
-
-### 대량 작업
-
-수백 개의 오브젝트를 한번에 생성, 삭제, 수정, 복제할 수 있습니다. 맵에 나무를 심거나, 모든 파트의 색을 바꾸거나, 패턴에 따라 오브젝트를 배치하는 대규모 작업을 빠르게 처리합니다.
-
-### 에셋
-
-Roblox Creator Store에서 무료 모델을 검색하고 바로 삽입할 수 있습니다. "중세 성 모델 찾아줘", "무기 모델 넣어줘"처럼 대화만으로 에셋을 추가합니다.
-
-### 환경 설정
-
-조명, 하늘, 안개, 지형 속성, 시간대를 자연어로 설정할 수 있습니다. "석양 분위기로 바꿔줘", "밤 12시로 설정해줘" 같은 요청이 가능합니다.
-
-### 상태 관리
-
-Workspace의 현재 상태를 스냅샷으로 저장하고, 최근 변경 사항과 뷰포트 상태를 확인할 수 있습니다. 복잡한 작업을 할 때 현재 상태를 파악하는 데 도움이 됩니다.
-
-### 공간 분석
-
-오브젝트의 크기와 위치를 정확하게 파악하고, 빈 공간을 찾고, 충돌 여부를 확인할 수 있습니다. 오브젝트를 그리드에 맞춰 정렬하는 것도 가능합니다.
-
-### 레이캐스트
-
-보이지 않는 광선을 쏴서 지형이나 오브젝트와의 충돌 지점을 찾습니다. 지면 위치 찾기, 오브젝트 배치 가능 여부 확인, 스폰 위치 찾기, 이동 가능 영역 분석 등 게임 레벨 디자인에 필수적인 기능입니다.
-
-### 지형
-
-블록, 구, 원통, 쐐기 등 다양한 형태로 지형을 채우고, 깎고, 부드럽게 다듬을 수 있습니다. 재질과 색상을 변경하거나, 산과 강이 있는 자연 지형을 절차적으로 자동 생성할 수도 있습니다.
-
-### 시각화
-
-영역, 마커, 선 등을 화면에 표시하여 작업 중인 공간을 시각적으로 확인할 수 있습니다. 디버깅이나 레벨 디자인 검토에 유용합니다.
-
-👉 [Pro 업그레이드 가이드](../pro-upgrade.md)
+# Roblox MCP 도구
+
+MCP 도구의 상세 파라미터는 MCP 도구 정의를 직접 확인하세요.
+
+Sync 정책:
+- Basic: Studio -> Local 단방향 동기화
+- Pro: 양방향 동기화 + 더 넓은 고급 action 범위(대량 작업으로 AI 토큰 효율 개선)
+
+## Query Instances (혼합)
+
+| 액션 | 설명 | 티어 |
+|------|------|------|
+| `get` | 경로로 인스턴스 속성 가져오기 | Basic |
+| `children` | 직계 자식 또는 모든 자손 가져오기 | Basic |
+| `find_child` | 이름과 선택적 클래스 필터로 첫 번째 자식 찾기 | Basic |
+| `find_descendant` | 이름으로 첫 번째 자손 찾기 | Basic |
+| `wait_for_child` | 자식이 나타날 때까지 대기 (타임아웃 포함) | Basic |
+| `class_info` | 클래스 정보 및 유효한 속성 가져오기 | Basic |
+| `search_name` | 이름 패턴으로 인스턴스 검색 (와일드카드 지원) | Basic |
+| `search_class` | 클래스 이름으로 인스턴스 검색 | Basic |
+| `file_tree` | 루트에서 파일 트리 구조 가져오기 | Pro |
+| `project_structure` | 전체 프로젝트 구조 가져오기 | Pro |
+| `descendants` | 인스턴스의 모든 자손 가져오기 | Pro |
+| `ancestors` | 인스턴스의 모든 조상 가져오기 | Pro |
+| `search_property` | 속성 값으로 인스턴스 검색 | Pro |
+| `search_tag` | 태그로 인스턴스 검색 | Pro |
+
+## Mutate Instances (혼합)
+
+| 액션 | 설명 | 티어 |
+|------|------|------|
+| `create` | 새 인스턴스 생성 | Basic |
+| `create_with_props` | 초기 속성을 가진 인스턴스 생성 | Basic |
+| `delete` | 인스턴스 삭제 | Basic |
+| `clone` | 인스턴스 복제 | Basic |
+| `move` | 인스턴스를 새 부모로 이동 | Basic |
+| `rename` | 인스턴스 이름 변경 | Basic |
+| `pivot` | 피벗 위치 또는 CFrame 설정 | Basic |
+| `create_tree` | 계층적 인스턴스 트리 생성 | Pro |
+| `mass_create` | 여러 인스턴스 한 번에 생성 | Pro |
+| `mass_delete` | 여러 인스턴스 삭제 | Pro |
+| `mass_duplicate` | 여러 인스턴스 복제 | Pro |
+| `smart_duplicate` | 간격과 개수를 지정하여 복제 | Pro |
+
+## Manage Properties (혼합)
+
+| 액션 | 설명 | 티어 |
+|------|------|------|
+| `get` | 단일 속성 값 가져오기 | Basic |
+| `set` | 단일 속성 값 설정 | Basic |
+| `get_all` | 인스턴스의 모든 속성 가져오기 | Basic |
+| `set_multiple` | 여러 속성 한 번에 설정 | Basic |
+| `get_attr` | 어트리뷰트 값 가져오기 | Basic |
+| `set_attr` | 어트리뷰트 값 설정 | Basic |
+| `get_all_attrs` | 모든 어트리뷰트 가져오기 | Basic |
+| `delete_attr` | 어트리뷰트 삭제 | Basic |
+| `add_tag` | 인스턴스에 태그 추가 | Basic |
+| `remove_tag` | 인스턴스에서 태그 제거 | Basic |
+| `check_tag` | 인스턴스가 태그를 가지고 있는지 확인 | Basic |
+| `get_tags` | 인스턴스의 모든 태그 가져오기 | Basic |
+| `get_tagged` | 특정 태그를 가진 모든 인스턴스 가져오기 | Basic |
+| `set_calculated` | 수식을 사용하여 속성 설정 | Pro |
+| `set_relative` | 현재 값을 기준으로 상대적으로 속성 설정 | Pro |
+| `mass_set` | 여러 인스턴스에 속성 설정 | Pro |
+| `mass_get` | 여러 인스턴스에서 속성 가져오기 | Pro |
+| `modify_children` | 부모의 모든 자식 수정 | Pro |
+
+## 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 |
+
+## Manage Lighting (Pro)
+
+| 액션 | 설명 | 티어 |
+|------|------|------|
+| `lighting` | Lighting 서비스 속성 설정 | Pro |
+| `atmosphere` | Atmosphere 속성 설정 | Pro |
+| `sky` | Sky 속성 설정 | Pro |
+| `terrain_props` | Terrain 물/시각 속성 설정 | Pro |
+| `time` | 시간대 설정 | Pro |
+
+## Manage Selection (혼합)
+
+| 액션 | 설명 | 티어 |
+|------|------|------|
+| `get` | 현재 선택 가져오기 | Basic |
+| `set` | 현재 선택 교체 | Basic |
+| `clear` | 선택 초기화 | Basic |
+| `cached` | 왕복 없이 캐시된 선택 가져오기 | Basic |
+| `context` | 소스와 속성을 포함한 상세 컨텍스트 가져오기 | Pro |
+| `details` | 조상/자손을 포함한 계층적 상세 정보 가져오기 | Pro |
+| `add` | 선택에 항목 추가 | Pro |
+| `remove` | 선택에서 항목 제거 | Pro |
+| `watch` | 선택 변경 모니터링 | Pro |
+
+## Manage Camera (Basic)
+
+| 액션 | 설명 | 티어 |
+|------|------|------|
+| `info` | 카메라 위치, 회전, FOV, 뷰포트 크기 가져오기 | Basic |
+| `focus_path` | 카메라를 인스턴스에 포커스 이동 | Basic |
+| `focus_position` | 카메라를 위치에 포커스 이동 | Basic |
+| `suggest` | 대상에 대한 추천 카메라 뷰 가져오기 | Basic |
+
+## Manage Tween (Pro)
+
+| 액션 | 설명 | 티어 |
+|------|------|------|
+| `create` | 대상 속성을 가진 트윈 생성 | Pro |
+| `play` | 생성된 트윈 재생 | Pro |
+| `pause` | 실행 중인 트윈 일시정지 | Pro |
+| `cancel` | 트윈 취소 | Pro |
+
+## Manage Audio (Pro)
+
+| 액션 | 설명 | 티어 |
+|------|------|------|
+| `play` | 사운드 재생 (필요시 Sound 생성) | Pro |
+| `stop` | 재생 중인 사운드 정지 | Pro |
+| `pause` | 재생 중인 사운드 일시정지 | Pro |
+| `resume` | 일시정지된 사운드 재개 | Pro |
+| `set_listener` | 오디오 리스너 타입/대상 설정 | Pro |
+
+## Manage Animation (Pro)
+
+| 액션 | 설명 | 티어 |
+|------|------|------|
+| `load` | Humanoid/AnimationController에 애니메이션 로드 | Pro |
+| `play` | 로드된 애니메이션 트랙 재생 | Pro |
+| `stop` | 재생 중인 애니메이션 정지 | Pro |
+| `get_tracks` | 로드된 모든 애니메이션 트랙 나열 | Pro |
+
+## Manage Physics (Pro)
+
+| 액션 | 설명 | 티어 |
+|------|------|------|
+| `register_group` | 충돌 그룹 등록 | Pro |
+| `set_collidable` | 두 그룹이 충돌할 수 있는지 설정 | Pro |
+| `get_groups` | 등록된 모든 충돌 그룹 나열 | Pro |
+
+## Manage Effects (Pro)
+
+| 액션 | 설명 | 티어 |
+|------|------|------|
+| `emit` | ParticleEmitter에서 파티클 방출 | Pro |
+| `clear` | 모든 파티클 초기화 | Pro |
+| `toggle` | 효과 활성화 또는 비활성화 | 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 Assets (Pro)
+
+| 액션 | 설명 | 티어 |
+|------|------|------|
+| `insert` | 에셋 ID로 모델 삽입 | Pro |
+| `info` | 에셋 메타데이터 가져오기 | Pro |
+| `search` | Creator Store 검색 | Pro |
+| `search_insert` | 검색하여 첫 번째 일치 항목 삽입 | Pro |
+| `insert_free` | 무료 모델 삽입 | Pro |
+| `insert_package` | 패키지 삽입 | Pro |
+| `export` | 현재 선택 내보내기 | Pro |
+
+## Manage Sync (Pro)
+
+| 액션 | 설명 | 티어 |
+|------|------|------|
+| `status` | Place의 동기화 상태 가져오기 | Pro |
+| `config` | 동기화 설정 가져오기/설정 | Pro |
+| `history` | 변경 기록 가져오기 | Pro |
+| `directions` | 타입별 동기화 방향 가져오기/설정 | Pro |
+| `read_file` | 동기화된 파일 읽기 | Pro |
+| `write_file` | 동기화된 파일에 쓰기 | Pro |
+
+## Workspace State (Pro)
+
+| 액션 | 설명 | 티어 |
+|------|------|------|
+| `sync` | 현재 Workspace 상태 가져오기 | Pro |
+| `snapshot` | 전체 인스턴스 트리 구조 가져오기 | Pro |
+| `changes` | 최근 변경 사항 가져오기 | Pro |
+| `viewport` | 카메라 및 뷰포트 정보 가져오기 | Pro |
+
+## Manage Logs (Basic)
+
+| 액션 | 설명 | 티어 |
+|------|------|------|
+| `get` | 필터링된 로그 가져오기 | Basic |
+| `clear` | 로그 버퍼 초기화 | Basic |
+| `errors` | 최근 오류만 가져오기 | Basic |
+
+## System Info (혼합)
+
+| 액션 | 설명 | 티어 |
+|------|------|------|
+| `ping` | 연결 테스트 | Basic |
+| `connection` | 서버/플러그인 연결 정보 가져오기 | Basic |
+| `usage` | 현재 티어 가져오기 (basic/pro) | Basic |
+| `place_info` | Place ID, 이름, 제작자 가져오기 | Pro |
+| `services` | 모든 Roblox 서비스 나열 | Pro |
+| `studio_settings` | Studio 환경설정 가져오기 | Pro |
+| `run_command` | Studio 명령 실행 | Pro |
+
+## Batch Execute (Pro)
+
+여러 명령을 단일 배치로 실행합니다. 각 명령은 도구 이름과 인수를 지정합니다. 명령은 순차적으로 실행되며 오류 시 계속 진행 여부를 선택할 수 있습니다.
+
+## Execute Luau (Pro)
+
+Roblox Studio 샌드박스에서 임의의 Luau 코드를 실행합니다. 차단된 서비스: HttpService, DataStoreService, MessagingService. CoreGui/CorePackages에 접근할 수 없습니다.

package/docs/pt-br/README.md

@@ -53,6 +53,12 @@ A instalação tem dois passos:
 
 Leva 5 minutos. 👉 [Ver guia de instalação](installation/README.md)
 
+## Comece com Pro
+
+Crie sem limites. Sync bidirecional, recursos avançados de criação e eficiência de tokens de IA — tudo em uma única atualização.
+
+👉 [Guia de upgrade Pro](pro-upgrade.md)
+
 ## Links
 
 - [GitHub](https://github.com/hope1026/roblox-mcp)

package/docs/pt-br/installation/ai-apps/gemini-cli.md

@@ -1,8 +1,8 @@
-# Configuracao do Gemini CLI
+# Configuração do Gemini CLI
 
-Como usar o Roblox MCP no [Google Gemini CLI](https://github.com/google-gemini/gemini-cli).
+Como usar o Roblox MCP com [Google Gemini CLI](https://github.com/google-gemini/gemini-cli).
 
-## Pre-requisitos
+## Pré-requisitos
 
 1. **Node.js** (v18.0.0 ou superior)
    ```bash
@@ -16,11 +16,27 @@ Como usar o Roblox MCP no [Google Gemini CLI](https://github.com/google-gemini/g
 
 3. **Plugin do Roblox Studio** instalado
 
-## Registrar o Servidor MCP
+## Registrar servidor MCP
 
-### Metodo 1: Editar Arquivo de Configuracao (Recomendado)
+### Método 1: Comando CLI (Recomendado)
 
-Adicione o seguinte conteudo ao arquivo `.gemini/settings.json`:
+Registre com um único comando no terminal:
+
+```bash
+gemini mcp add weppy-roblox-mcp npx --trust -- -y @weppy/roblox-mcp
+```
+
+> A flag `--trust` ignora as solicitações de confirmação para cada chamada de ferramenta.
+
+Para registrar globalmente, adicione `-s user`:
+
+```bash
+gemini mcp add weppy-roblox-mcp npx -s user --trust -- -y @weppy/roblox-mcp
+```
+
+### Método 2: Editar arquivo de configuração
+
+Adicione o seguinte conteúdo ao arquivo `.gemini/settings.json`:
 
 ```json
 {
@@ -33,16 +49,22 @@ Adicione o seguinte conteudo ao arquivo `.gemini/settings.json`:
 }
 ```
 
-**Localizacao do arquivo de configuracao:**
+**Localizações do arquivo de configuração:**
 | Escopo | Caminho |
 |--------|---------|
 | Projeto | `<projeto>/.gemini/settings.json` |
 | Global | `~/.gemini/settings.json` |
 
-### Metodo 2: Usar Variaveis de Ambiente
+### Método 3: Usando variáveis de ambiente
+
+Se variáveis de ambiente específicas forem necessárias:
 
-Se variaveis de ambiente especificas forem necessarias:
+**CLI:**
+```bash
+gemini mcp add weppy-roblox-mcp npx --trust -e MCP_PORT=3002 -- -y @weppy/roblox-mcp
+```
 
+**Arquivo de configuração:**
 ```json
 {
   "mcpServers": {
@@ -57,71 +79,42 @@ Se variaveis de ambiente especificas forem necessarias:
 }
 ```
 
-## Teste de Conexao
+## Teste de conexão
 
-1. Inicie o **Roblox Studio** → Aba Plugins → **W-MCP** → **Connect**
-2. Inicie o **Gemini CLI** e digite:
+1. Abra o **Roblox Studio** → aba Plugins → **W-MCP** → **Connect**
+2. Execute o **Gemini CLI** e digite:
    ```
-   Diga-me o que esta selecionado atualmente no Roblox Studio
+   Me diga o que está selecionado atualmente no Roblox Studio
    ```
 
-## Verificar Status do Servidor MCP
+## Verificar status do servidor MCP
 
-Voce pode verificar o status do servidor conectado com o comando `/mcp` no Gemini CLI:
+Você pode verificar o status dos servidores conectados com o comando `/mcp` no Gemini CLI:
 
 ```
 /mcp
 ```
 
-## Configuracao Avancada
-
-### Filtragem de Ferramentas
-
-Voce pode usar ou excluir ferramentas especificas:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "excludeTools": ["execute_script"],
-      "includeTools": ["get_selection", "create_instance", "set_property"]
-    }
-  }
-}
-```
-
-> `excludeTools` tem prioridade sobre `includeTools`.
-
-### Modo de Depuracao
-
-Para depurar problemas de conexao:
-
-```bash
-gemini --debug
-```
-
-## Solucao de Problemas
+## Solução de problemas
 
-### O servidor nao inicia
+### Servidor não inicia
 
 Execute o servidor MCP diretamente para verificar erros:
 ```bash
 npx -y @weppy/roblox-mcp
 ```
 
-### Falha na conexao
+### Falha na conexão
 
-- Verifique se o plugin do Roblox Studio esta no estado **Connected**
-- Verifique se a porta 3002 nao esta bloqueada pelo firewall
+- Verifique se o plugin do Roblox Studio está no estado **Connected**
+- Verifique se a porta 3002 está bloqueada por um firewall
 - Verifique o status do servidor com o comando `/mcp`
 
-### Conflito de ferramentas
+### Conflitos de ferramentas
 
-Se varios servidores MCP tiverem ferramentas com o mesmo nome, elas serao prefixadas no formato `serverAlias__toolName`.
+Se vários servidores MCP tiverem ferramentas com o mesmo nome, elas receberão o prefixo no formato `serverAlias__toolName`.
 
-## Referencias
+## Referências
 
-- [Documentacao Oficial de MCP do Gemini CLI](https://geminicli.com/docs/tools/mcp-server/)
-- [Guia de Configuracao do Gemini CLI](https://geminicli.com/docs/get-started/configuration/)
+- [Documentação oficial do Gemini CLI MCP](https://geminicli.com/docs/tools/mcp-server/)
+- [Guia de configuração do Gemini CLI](https://geminicli.com/docs/get-started/configuration/)

package/docs/pt-br/installation/roblox-plugin.md

@@ -1,21 +1,26 @@
 # Instalacao do Plugin Roblox
 
-Como instalar o plugin para conectar com agentes de IA no Roblox Studio.
+Como instalar o plugin para conectar agentes de IA no Roblox Studio.
 
 ## 1. Baixar o Plugin
 
-1. Baixe `weppy-roblox-mcp-basic-v{versão}.zip` em [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
-2. Extraia o arquivo ZIP — voce encontrara o arquivo `roblox-plugin/WeppyRobloxMCP.rbxm` e guias de instalacao
+1. Abra [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
+2. Baixe `weppy-roblox-mcp-v{version}.zip`
+3. Extraia o ZIP - voce encontrara `roblox-plugin/WeppyRobloxMCP.rbxm` e guias de instalacao
+
+Nota:
+- Basic usa o mesmo pacote com politica Basic (Studio -> Local, unidirecional)
+- Com licenca Pro por assinatura, sync bidirecional e recursos avancados mais amplos sao liberados
 
 ## 2. Instalar o Plugin
 
 1. Inicie o **Roblox Studio**
-2. Clique na aba **Plugins** no menu superior
-3. Clique no botao **Plugins Folder**
+2. Clique na aba **Plugins**
+3. Clique em **Plugins Folder**
 
 ![Abrir Plugins Folder](../../assets/screenshots/plugins_menu.png)
 
-4. **Copie** o arquivo `WeppyRobloxMCP.rbxm` da pasta extraida para a pasta de Plugins aberta
+4. **Copie** `WeppyRobloxMCP.rbxm` para a pasta de Plugins
 5. **Reinicie o Roblox Studio**
 
 ## 3. Verificar a Instalacao
@@ -28,7 +33,7 @@ Apos reiniciar, o botao **W-MCP** aparecera na aba Plugins.
 
 ### Pre-requisitos
 
-O servidor MCP deve estar instalado. Complete primeiro o guia correspondente ao seu aplicativo de IA:
+O servidor MCP deve estar instalado. Complete primeiro o guia do seu app de IA:
 
 | Aplicativo de IA | Guia de Instalacao |
 |------------------|---------------------|
@@ -42,38 +47,38 @@ O servidor MCP deve estar instalado. Complete primeiro o guia correspondente ao
 ### Conectar
 
 1. Abra qualquer projeto no **Roblox Studio**
-2. Aba **Plugins** no topo → Clique em **W-MCP**
-3. Clique no botao **Connect** na janela do plugin
-4. Quando aparecer o status **"Connected"**, a conexao foi estabelecida!
+2. Aba **Plugins** -> **W-MCP**
+3. Clique em **Connect**
+4. Quando aparecer **"Connected"**, esta pronto
 
 ![Tela Principal do Plugin](../../assets/screenshots/plugin_main.png)
 
 ## 5. Configuracoes (Opcional)
 
-Clique no botao de configuracoes no canto superior direito do plugin para modificar varias opcoes.
+Use o botao de configuracoes no canto superior direito.
 
 ![Tela de Configuracoes](../../assets/screenshots/settings.png)
 
-- **Conexao Automatica**: Conecta automaticamente ao servidor MCP ao iniciar o Studio
-- **Reconexao Automatica**: Tenta reconectar automaticamente quando a conexao e perdida
-- **Foco Automatico da Camera**: Move automaticamente a camera para objetos criados
-- **Idioma**: Alterar o idioma da interface do plugin
+- **Conexao Automatica**
+- **Reconexao Automatica**
+- **Foco Automatico da Camera**
+- **Idioma**
 
 ## Solucao de Problemas
 
 ### O plugin nao aparece
 
-- Feche completamente o Roblox Studio e reinicie
-- Verifique se o arquivo foi copiado corretamente para a Plugins Folder
-- Verifique se o arquivo `.rbxm` nao esta corrompido
+- Reinicie o Roblox Studio por completo
+- Verifique se o arquivo foi copiado corretamente
+- Verifique se `.rbxm` nao esta corrompido
 
 ### Nao consigo conectar
 
-- Verifique se o servidor MCP esta em execucao no aplicativo de IA
-- Clique novamente no botao **Connect** no plugin
-- Verifique se a porta 3002 nao esta sendo usada por outro programa
+- Verifique se o servidor MCP esta em execucao
+- Clique em **Connect** novamente
+- Verifique conflito na porta 3002
 
 ### A conexao cai frequentemente
 
-- Ative a opcao **Reconexao Automatica** nas configuracoes
-- Tente reiniciar o aplicativo de IA
+- Ative **Reconexao Automatica**
+- Reinicie o app de IA