@weppy/roblox-mcp 0.1.11 → 1.0.0

package/docs/ja/pro-upgrade.md

@@ -1,51 +1,57 @@
 # Proアップグレードガイド
 
-## なぜProなのか？
+## なぜProか？
 
-**AIトークンの節約** - 1つの一括操作コマンドが数十の個別操作を置き換えます。繰り返し作業が減り、トークン使用量が削減され、結果も速くなります。
+### 実際の開発ワークフローのための双方向Sync
 
-**完成度の高いゲーム** - 地形、環境、アセット、空間ツールでプロトタイプではなく完成されたゲームワールドを作成できます。
+Pro Syncは単方向エクスポートを超えます。ローカルでスクリプトを編集してStudioに反映。Studioで変更してローカルに取り込む。Proが両側を常に同期します。
 
-## Proが追加するツール
+- **双方向Sync** — StudioとローカルファイルのSyncが双方向で変更を反映します。
+- **タイプ別Direction** — Scripts、Values、Containers、Data、Servicesをそれぞれ独立して設定。
+- **タイプ別Apply Mode** — タイプごとにAutoまたはManualを選択し、速度と制御のバランスを調整。
+- **Full Sync / Resync** — 大規模変更や再接続後に即座にクリーンなプロジェクト状態を再構築。
+- **変更履歴** — 適用前に何が、いつ、どの方向に変更されたかを追跡。
+- **マルチ Place Sync** — 最大3つのRoblox Placeを同時にSync。各Placeは独立したストレージと変更履歴を持ちます。
 
-| カテゴリ | 機能 |
-|---------|------|
-| **一括操作** | 1つのコマンドで木を100本生成。すべてのパーツを同時に修正。 |
-| **地形生成** | 山、洞窟、風景を手続き的に生成。 |
-| **アセット管理** | Creator Store検索後、モデルを直接挿入。 |
-| **レイキャスト** | スポーン位置の検出、衝突検出、移動可能エリアの分析。 |
-| **環境制御** | ライティング、大気、空、時間帯の設定。 |
-| **可視化** | エリア表示、マーカー作成、ゾーンハイライト。 |
+### 高効率ワークフローでAIトークンを節約
 
-## 購入方法
+一括/高度なアクションで繰り返し呼び出しを削減 — 1プロンプトでより多くの作業を。
 
-### ステップ1: Gumroadで購入
+### より広い高度な機能
 
-1. [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin) にアクセス
-2. プラグインをダウンロード
+地形生成、アセット検索、空間解析、アニメーション、オーディオ、大規模自動化。
 
-### ステップ2: プラグインのインストール
+## サブスク購入とダウンロード
 
-1. Roblox Studioを起動
-2. Pluginsタブ → **Plugins Folder** をクリック
-3. 既存の `WeppyRobloxMCP.rbxm` (Basicバージョン) を**削除**
-4. ダウンロードした `WeppyRobloxMCP-Pro.rbxm` をフォルダに**コピー**
-5. Roblox Studioを再起動
+### ステップ1: GumroadでProサブスクライセンスを購入
+
+1. [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/faccjs?utm_source=github&utm_medium=repo&utm_campaign=pro_upgrade_md) にアクセス
+2. Proサブスクライセンスを購入
+
+### ステップ2: GitHub Releasesからダウンロード
+
+1. [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest) を開く
+2. `weppy-roblox-mcp-v{version}.zip` をダウンロード
+3. 解凍して `roblox-plugin/WeppyRobloxMCP.rbxm` を Roblox Plugins フォルダへコピー
 
 ### ステップ3: 確認
 
-1. W-MCPプラグインを開く
-2. "Pro" バッジが表示されているか確認
-3. すべてのツールが使用可能！
+1. Roblox StudioでW-MCPを開く
+2. Proバッジが表示されることを確認
+3. Proアクション（例: `manage_sync`、一括操作）を実行
 
 ## 機能比較
 
 | 機能 | Basic | Pro |
 |-----|:-----:|:---:|
-| Instance, Script, Property | ✅ 全機能利用可能 | ✅ 全機能利用可能 |
-| Selection, Tag, Camera, Log | ✅ 全機能利用可能 | ✅ 全機能利用可能 |
-| 一括操作 (Bulk) | ― | ✅ 無制限 |
-| アセット検索・挿入 | ― | ✅ 無制限 |
-| 地形生成 (Terrain) | ― | ✅ 無制限 |
-| 環境、レイキャスト、空間 | ― | ✅ 無制限 |
-| 可視化ツール | ― | ✅ 無制限 |
+| Script、Instance、Property管理 | ✅ フル利用可 | ✅ フル利用可 |
+| Selection、Tag、Camera、Log | ✅ フル利用可 | ✅ フル利用可 |
+| Sync方向 | Studio → Local（片方向） | 双方向 |
+| タイプ別Sync Direction | ❌ | ✅ Scripts / Values / Containers / Data / Services |
+| タイプ別Apply Mode | ❌ | ✅ Auto / Manual |
+| Full Sync | ❌ | ✅ |
+| Resync / 状態再構築 | ❌ | ✅ |
+| 変更履歴 | ❌ | ✅ |
+| マルチ Place Sync | ❌ | ✅ 最大3 Place、各Place独立ストレージ |
+| 高度ツール範囲 | コア範囲 | より広い高度範囲 |
+| AIトークン効率 | 標準 | 一括/高効率アクションで有利 |

package/docs/ja/tools/overview.md

@@ -2,6 +2,10 @@
 
 AIとRoblox Studioを接続して、さまざまな作業を自動化できます。カテゴリ別にどんなことができるかを紹介します。
 
+Syncポリシー:
+- Basic: Studio -> Local（片方向）
+- Pro: 双方向Sync + より広い高度機能（バルク操作でAIトークン効率向上）
+
 ---
 
 ## Basic（無料）

package/docs/ko/README.md

@@ -53,6 +53,12 @@ Creator Store에서 무료 모델과 에셋을 검색해서 바로 게임에 넣
 
 5분이면 끝나요. 👉 [설치 가이드 보기](installation/README.md)
 
+## Pro로 시작하세요
+
+제한 없이 제작하세요. 양방향 Sync, 고급 제작 기능, AI 토큰 효율 — 한 번의 업그레이드로 모두 누리세요.
+
+👉 [Pro 업그레이드 가이드](pro-upgrade.md)
+
 ## 링크
 
 - [GitHub](https://github.com/hope1026/roblox-mcp)

package/docs/ko/installation/roblox-plugin.md

@@ -4,8 +4,13 @@ Roblox Studio에서 AI 에이전트와 연결하기 위한 플러그인 설치
 
 ## 1. 플러그인 다운로드
 
-1. [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)에서 `weppy-roblox-mcp-basic-v{버전}.zip`을 다운로드합니다
-2. ZIP 파일을 압축 해제합니다 — `roblox-plugin/WeppyRobloxMCP.rbxm` 파일과 설치 가이드가 포함되어 있습니다
+1. [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest) 열기
+2. `weppy-roblox-mcp-v{버전}.zip` 다운로드
+3. ZIP 압축 해제 - `roblox-plugin/WeppyRobloxMCP.rbxm` 파일과 설치 가이드 포함
+
+참고:
+- Basic은 동일한 플러그인 패키지를 설치하고 Basic 정책(Studio -> Local 단방향 Sync)으로 동작합니다.
+- Pro 구독 라이선스 활성화 시 양방향 Sync와 더 넓은 고급 Tool 기능을 사용할 수 있습니다.
 
 ## 2. 플러그인 설치
 
@@ -42,9 +47,9 @@ MCP 서버가 설치되어 있어야 합니다. 사용하는 AI 앱에 맞는
 ### 연결하기
 
 1. **Roblox Studio**에서 아무 프로젝트를 엽니다
-2. 상단 **Plugins** 탭 → **W-MCP** 클릭
+2. 상단 **Plugins** 탭 -> **W-MCP** 클릭
 3. 플러그인 창에서 **Connect** 버튼 클릭
-4. **"Connected"** 상태가 표시되면 연결 완료!
+4. **"Connected"** 상태가 표시되면 연결 완료
 
 ![플러그인 메인 화면](../../assets/screenshots/plugin_main.png)
 
@@ -76,4 +81,4 @@ MCP 서버가 설치되어 있어야 합니다. 사용하는 AI 앱에 맞는
 ### 연결이 자주 끊어져요
 
 - 설정에서 **자동 재연결** 옵션 활성화
-- AI 앱을 재시작해보세요
+- AI 앱을 재시작

package/docs/ko/pro-upgrade.md

@@ -2,50 +2,56 @@
 
 ## 왜 Pro인가?
 
-**AI 토큰 절약** - 하나의 대량 작업 명령이 수십 개의 개별 작업을 대체합니다. 반복 작업이 줄어 토큰 사용량이 감소하고 결과도 빨라집니다.
+### 실제 개발 워크플로우를 위한 양방향 Sync
 
-**완성도 높은 게임** - 지형, 환경, 에셋, 공간 도구로 프로토타입이 아닌 완성된 게임 월드를 만들 수 있습니다.
+Pro Sync는 단방향 내보내기를 넘어섭니다. 로컬에서 스크립트를 편집하고 Studio에 반영하세요. Studio에서 변경하고 로컬로 가져오세요. Pro는 양쪽을 항상 동기화합니다.
 
-## Pro가 추가하는 도구
+- **양방향 Sync** — Studio와 로컬 파일 간 양방향으로 변경사항이 흐릅니다.
+- **타입별 Direction** — Scripts, Values, Containers, Data, Services를 각각 독립적으로 방향 설정.
+- **타입별 Apply Mode** — 타입별로 Auto 또는 Manual을 선택하여 속도와 제어를 균형있게.
+- **Full Sync / Resync** — 대규모 변경이나 재연결 후 즉시 깨끗한 프로젝트 상태를 재구축.
+- **변경 기록** — 적용 전에 무엇이, 언제, 어느 방향으로 변경됐는지 추적.
+- **멀티 Place Sync** — 최대 3개의 Roblox Place를 동시에 Sync하며, 각 Place마다 독립된 저장소와 변경 기록을 유지합니다.
 
-| 카테고리 | 기능 |
-|---------|------|
-| **대량 작업** | 한 번의 명령으로 나무 100개 생성. 모든 파트를 동시에 수정. |
-| **지형 생성** | 산, 동굴, 풍경을 절차적으로 생성. |
-| **에셋 관리** | Creator Store 검색 후 모델 직접 삽입. |
-| **레이캐스트** | 스폰 위치 찾기, 충돌 감지, 이동 가능 영역 분석. |
-| **환경 제어** | 조명, 대기, 하늘, 시간대 설정. |
-| **시각화** | 영역 표시, 마커 생성, 구역 하이라이트. |
+### 고효율 워크플로우로 AI 토큰 절약
 
-## 구매 방법
+대량 및 고급 작업으로 반복 호출을 줄여 프롬프트 한 번에 더 많은 작업을 처리합니다.
 
-### 1단계: Gumroad에서 구매
+### 더 넓은 고급 기능
 
-1. [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin) 접속
-2. 플러그인 다운로드
+지형 생성, 에셋 검색, 공간 분석, 애니메이션, 오디오, 대규모 자동화.
 
-### 2단계: 플러그인 설치
+## 구독 및 다운로드
 
-1. Roblox Studio 실행
-2. Plugins 탭 → **Plugins Folder** 클릭
-3. 기존 `WeppyRobloxMCP.rbxm` (Basic 버전) **삭제**
-4. 다운로드한 `WeppyRobloxMCP-Pro.rbxm` 폴더에 **복사**
-5. Roblox Studio 재시작
+### 1단계: Gumroad에서 Pro 구독 라이선스 구매
+
+1. [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/faccjs?utm_source=github&utm_medium=repo&utm_campaign=pro_upgrade_md) 접속
+2. Pro 구독 라이선스 구매 완료
+
+### 2단계: GitHub Releases에서 다운로드
+
+1. [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest) 열기
+2. `weppy-roblox-mcp-v{version}.zip` 다운로드
+3. 압축 해제 후 `roblox-plugin/WeppyRobloxMCP.rbxm`를 Roblox Plugins 폴더에 복사
 
 ### 3단계: 확인
 
-1. W-MCP 플러그인 열기
-2. "Pro" 배지가 표시되는지 확인
-3. 모든 도구 사용 가능!
+1. Roblox Studio에서 W-MCP 열기
+2. Pro 배지가 표시되는지 확인
+3. Pro action(예: `manage_sync`, 대량 작업) 실행 확인
 
 ## 기능 비교
 
 | 기능 | Basic | Pro |
 |-----|:-----:|:---:|
-| Instance, Script, Property | ✅ 전체 사용 | ✅ 전체 사용 |
+| Script, Instance, Property 관리 | ✅ 전체 사용 | ✅ 전체 사용 |
 | Selection, Tag, Camera, Log | ✅ 전체 사용 | ✅ 전체 사용 |
-| 대량 작업 (Bulk) | ― | ✅ 무제한 |
-| 에셋 검색 및 삽입 | ― | ✅ 무제한 |
-| 지형 생성 (Terrain) | ― | ✅ 무제한 |
-| 환경, 레이캐스트, 공간 | ― | ✅ 무제한 |
-| 시각화 도구 | ― | ✅ 무제한 |
+| Sync 방향 | Studio → Local (단방향) | 양방향 |
+| 타입별 Sync Direction | ❌ | ✅ Scripts / Values / Containers / Data / Services |
+| 타입별 Apply Mode | ❌ | ✅ Auto / Manual |
+| Full Sync | ❌ | ✅ |
+| Resync / 상태 재구축 | ❌ | ✅ |
+| 변경 기록 | ❌ | ✅ |
+| 멀티 Place Sync | ❌ | ✅ 최대 3개 Place, 각각 독립 저장소 |
+| 고급 Tool 범위 | 기본 범위 | 더 넓은 고급 범위 |
+| AI 토큰 효율 | 기본 | 대량/고효율 action으로 더 유리 |

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)