@weppy/roblox-mcp 0.1.7 → 0.1.9

package/docs/id/tools/overview.md

@@ -1,238 +1,95 @@
-# Tools Roblox MCP
+# Fitur Roblox MCP
 
-Untuk parameter detail tools MCP, silakan periksa definisi tools MCP secara langsung.
+Hubungkan AI dengan Roblox Studio dan otomatiskan berbagai pekerjaan. Berikut adalah hal-hal yang bisa kamu lakukan berdasarkan kategori.
 
 ---
 
-## Tools Basic (68)
-
-### Instance - 13
-
-| Tool | Deskripsi |
-|------|-----------|
-| `create_instance` | Buat instance baru |
-| `create_instance_with_properties` | Buat instance dengan properties |
-| `clone_instance` | Duplikat instance yang ada |
-| `delete_instance` | Hapus instance |
-| `move_instance` | Pindahkan instance ke parent baru |
-| `rename_instance` | Ubah nama instance |
-| `get_instance` | Ambil informasi instance |
-| `get_instance_children` | Ambil daftar children dari instance |
-| `find_first_child` | Temukan child pertama berdasarkan nama |
-| `find_first_descendant` | Temukan descendant pertama berdasarkan nama |
-| `get_class_info` | Ambil informasi class |
-| `wait_for_child` | Tunggu sampai child muncul |
-| `pivot_to` | Atur Pivot CFrame |
-
-### Property - 10
-
-| Tool | Deskripsi |
-|------|-----------|
-| `get_property` | Ambil nilai property |
-| `set_property` | Atur nilai property |
-| `get_all_properties` | Ambil semua properties |
-| `set_multiple_properties` | Atur beberapa properties sekaligus |
-| `set_calculated_property` | Atur property dengan nilai yang dihitung |
-| `set_relative_property` | Atur property dengan nilai relatif |
-| `get_attribute` | Ambil nilai attribute |
-| `set_attribute` | Atur nilai attribute |
-| `get_all_attributes` | Ambil semua attributes |
-| `delete_attribute` | Hapus attribute |
-
-### Script - 9
-
-| Tool | Deskripsi |
-|------|-----------|
-| `create_script` | Buat script baru |
-| `get_script_source` | Ambil source code script |
-| `set_script_source` | Update source code script |
-| `delete_script` | Hapus script |
-| `edit_script_lines` | Edit baris tertentu |
-| `insert_script_lines` | Sisipkan baris |
-| `delete_script_lines` | Hapus baris |
-| `search_in_scripts` | Cari dalam scripts |
-| `get_script_dependencies` | Ambil dependencies |
-
-### Selection - 12
-
-| Tool | Deskripsi |
-|------|-----------|
-| `get_selection` | Ambil instance yang sedang dipilih |
-| `get_selection_context` | Ambil pilihan dengan context |
-| `get_selection_details` | Ambil detail informasi pilihan |
-| `set_selection` | Atur pilihan instance |
-| `clear_selection` | Hapus pilihan |
-| `add_to_selection` | Tambahkan ke pilihan |
-| `remove_from_selection` | Hapus dari pilihan |
-| `get_place_info` | Ambil informasi Place |
-| `get_services` | Ambil daftar game services |
-| `get_studio_settings` | Ambil pengaturan Studio |
-| `run_command` | Jalankan perintah Studio |
-| `watch_selection` | Pantau perubahan pilihan |
-
-### Search - 2
-
-| Tool | Deskripsi |
-|------|-----------|
-| `search_by_name` | Cari instance berdasarkan nama |
-| `search_by_class` | Cari instance berdasarkan class |
-
-### Tag - 5
-
-| Tool | Deskripsi |
-|------|-----------|
-| `add_tag` | Tambahkan tag ke instance |
-| `remove_tag` | Hapus tag dari instance |
-| `get_tags` | Ambil daftar tag dari instance |
-| `get_tagged` | Ambil daftar instance dengan tag |
-| `has_tag` | Periksa apakah instance memiliki tag |
-
-### Camera - 4
-
-| Tool | Deskripsi |
-|------|-----------|
-| `get_camera_info` | Ambil informasi camera |
-| `get_suggested_camera_view` | Ambil view camera yang disarankan |
-| `focus_camera_path` | Fokuskan camera ke instance berdasarkan path |
-| `focus_camera_position` | Fokuskan camera ke posisi world |
-
-### Log - 3
-
-| Tool | Deskripsi |
-|------|-----------|
-| `get_output_logs` | Ambil log output |
-| `clear_output_logs` | Bersihkan log output |
-| `get_recent_errors` | Ambil error terbaru |
-
-### Connection - 2
-
-| Tool | Deskripsi |
-|------|-----------|
-| `get_connection_info` | Ambil status koneksi |
-| `get_usage_status` | Ambil status penggunaan/kuota |
+## Basic (Gratis)
+
+### Manajemen Objek
+
+Buat, duplikat, hapus, dan pindahkan objek game seperti part, model, dan folder. Pekerjaan seperti "Buatkan part merah" atau "Duplikat model ini dan taruh di sebelahnya" bisa dilakukan.
+
+### Properti
+
+Baca dan ubah semua properti objek seperti ukuran, warna, posisi, dan material. Kamu bisa mengubah beberapa properti sekaligus atau menyesuaikan secara relatif berdasarkan nilai saat ini.
+
+### Script
+
+Buat script baru, baca kode yang ada, dan modifikasi. Kamu bisa mengedit baris tertentu, mencari teks di dalam script, atau mengidentifikasi dependensi untuk melihat modul mana yang direferensikan.
+
+### Seleksi
+
+Cek objek yang sedang dipilih, ubah seleksi, dan bersihkan seleksi. Penting untuk memahami dan mengontrol apa yang sedang kamu kerjakan di Studio.
+
+### Pencarian
+
+Temukan objek di game berdasarkan nama atau kelas (tipe).
+
+### Tag
+
+Tambah atau hapus tag dari objek dan temukan semua objek dengan tag tertentu sekaligus. Berguna untuk mengelola grup objek sejenis.
+
+### Kamera
+
+Pindahkan kamera ke objek atau posisi tertentu. Praktis untuk melihat area yang sedang kamu kerjakan dengan cepat.
+
+### Log
+
+Cek output log dan error yang terjadi saat game berjalan. Membantu menemukan dan memperbaiki bug.
+
+### Koneksi
+
+Cek status koneksi dan penggunaan antara server MCP dan Roblox Studio.
 
 ---
 
-## Tools Pro (+72)
-👉 [Panduan Upgrade Pro](pro-upgrade.md)
-
-### Script - 2
-
-| Tool | Deskripsi |
-|------|-----------|
-| `replace_in_scripts` | Ganti konten script secara massal |
-| `execute_script` | Jalankan kode Luau secara langsung |
-
-### Search - 6
-
-| Tool | Deskripsi |
-|------|-----------|
-| `get_file_tree` | Ambil file tree |
-| `get_project_structure` | Ambil tree struktur proyek |
-| `search_by_property` | Cari berdasarkan property |
-| `search_by_tag` | Cari berdasarkan tag |
-| `get_descendants` | Ambil semua descendants |
-| `get_ancestors` | Ambil ancestors |
-
-### Bulk - 8
-
-| Tool | Deskripsi |
-|------|-----------|
-| `mass_create_instances` | Buat instance secara massal |
-| `mass_delete_instances` | Hapus instance secara massal |
-| `mass_set_property` | Atur properties secara massal |
-| `mass_get_property` | Ambil properties secara massal |
-| `mass_duplicate` | Duplikat instance secara massal |
-| `smart_duplicate` | Duplikat cerdas dengan offset |
-| `batch_execute` | Eksekusi batch beberapa perintah |
-| `modify_children` | Modifikasi semua children |
-
-### Asset - 7
-
-| Tool | Deskripsi |
-|------|-----------|
-| `insert_model` | Sisipkan model dari Creator Store |
-| `get_asset_info` | Ambil informasi asset |
-| `search_creator_store` | Cari asset di Creator Store |
-| `search_and_insert_model` | Cari dan sisipkan model |
-| `insert_free_model` | Sisipkan model gratis |
-| `insert_package` | Sisipkan package |
-| `export_selection` | Ekspor pilihan |
-
-### Environment - 5
-
-| Tool | Deskripsi |
-|------|-----------|
-| `set_lighting` | Atur properties pencahayaan |
-| `set_atmosphere` | Atur properties Atmosphere |
-| `set_sky` | Atur properties Sky |
-| `set_terrain` | Atur properties Terrain |
-| `set_time_of_day` | Atur waktu hari |
-
-### State - 9
-
-| Tool | Deskripsi |
-|------|-----------|
-| `sync_workspace_state` | Sinkronkan state Workspace |
-| `get_workspace_snapshot` | Ambil snapshot Workspace |
-| `get_recent_changes` | Ambil perubahan terbaru |
-| `clear_change_history` | Bersihkan riwayat perubahan |
-| `get_viewport_info` | Ambil informasi status viewport |
-| `get_workspace_metadata` | Ambil metadata Workspace |
-| `get_script_list` | Ambil daftar scripts |
-| `get_selection_info` | Ambil informasi pilihan |
-| `clear_state_cache` | Bersihkan cache state |
-
-### Spatial - 5
-
-| Tool | Deskripsi |
-|------|-----------|
-| `get_spatial_map` | Ambil peta spatial dari area |
-| `find_empty_space` | Temukan ruang kosong dalam area |
-| `get_bounds` | Ambil bounding box instance |
-| `snap_to_grid` | Snap posisi ke grid |
-| `check_collision` | Periksa tabrakan antar instance |
-
-### Raycast - 8
-
-| Tool | Deskripsi |
-|------|-----------|
-| `raycast` | Lakukan raycast dan ambil informasi tabrakan |
-| `find_ground` | Temukan posisi ground di titik tersebut |
-| `check_placement` | Periksa apakah objek dapat ditempatkan |
-| `multi_raycast` | Lakukan beberapa raycast |
-| `scan_area` | Scan area dan hasilkan heightmap |
-| `find_flat_areas` | Temukan area datar untuk penempatan |
-| `find_spawn_positions` | Temukan posisi spawn yang valid |
-| `analyze_walkable_area` | Analisis area yang dapat dilalui |
-
-### Terrain - 14
-
-| Tool | Deskripsi |
-|------|-----------|
-| `terrain_fill_block` | Isi terrain dengan bentuk blok |
-| `terrain_fill_ball` | Isi terrain dengan bentuk bola |
-| `terrain_fill_cylinder` | Isi terrain dengan bentuk silinder |
-| `terrain_fill_wedge` | Isi terrain dengan bentuk wedge |
-| `terrain_clear` | Hapus terrain (menggunakan objek Region) |
-| `terrain_clear_region` | Hapus terrain (menggunakan koordinat min/max) |
-| `terrain_replace_material` | Ganti material terrain |
-| `terrain_get_material_color` | Ambil warna material terrain |
-| `terrain_set_material_color` | Atur warna material terrain |
-| `terrain_read_voxel` | Baca single voxel |
-| `terrain_read_voxels` | Baca data voxels |
-| `terrain_write_voxels` | Tulis data voxels |
-| `terrain_generate` | Hasilkan terrain prosedural |
-| `terrain_smooth` | Haluskan terrain |
-
-### Visualization - 7
-
-| Tool | Deskripsi |
-|------|-----------|
-| `visualization_create_area` | Buat visualisasi area |
-| `visualization_create_marker` | Buat visualisasi marker (dengan preview) |
-| `visualization_create_line` | Buat visualisasi garis |
-| `visualization_remove` | Hapus visualisasi |
-| `visualization_clear` | Hapus semua visualisasi |
-| `visualization_get_status` | Ambil status visualisasi |
-| `visualization_focus` | Fokuskan camera ke item visualisasi |
+## Pro
+
+Kalau butuh fitur yang lebih kuat, kamu bisa upgrade ke Pro.
+
+### Seleksi Lanjutan
+
+Dapatkan konteks seleksi detail dengan properti dan source code, jelajahi hierarki seleksi, tambah/hapus item dari seleksi, dan lihat informasi Place serta service game. Berguna untuk workflow lanjutan dan otomasi.
+
+### Script Lanjutan
+
+Ganti konten di beberapa script sekaligus atau jalankan kode Luau secara instan. Berguna untuk modifikasi kode berulang atau pengujian cepat.
+
+### Pencarian Lanjutan
+
+Jelajahi seluruh file tree atau cari objek berdasarkan properti atau tag. Dapatkan gambaran lengkap struktur proyek dan lihat semua descendant atau ancestor dari objek tertentu.
+
+### Operasi Massal
+
+Buat, hapus, modifikasi, atau duplikat ratusan objek sekaligus. Tangani pekerjaan skala besar dengan cepat seperti menanam pohon di map, mengubah warna semua part, atau menempatkan objek sesuai pola.
+
+### Aset
+
+Cari model gratis di Roblox Creator Store dan masukkan langsung. Tambahkan aset lewat percakapan seperti "Carikan model kastil abad pertengahan" atau "Masukkan model senjata".
+
+### Lingkungan
+
+Atur pencahayaan, langit, kabut, properti terrain, dan waktu dengan bahasa alami. Permintaan seperti "Ubah ke suasana senja" atau "Set waktu ke tengah malam" bisa dilakukan.
+
+### Manajemen State
+
+Simpan state Workspace saat ini sebagai snapshot dan cek perubahan terbaru serta status viewport. Membantu memahami state saat ini selama pekerjaan kompleks.
+
+### Analisis Spasial
+
+Tentukan ukuran dan posisi objek secara akurat, temukan ruang kosong, dan cek tabrakan. Kamu juga bisa menyelaraskan objek ke grid.
+
+### Raycast
+
+Tembakkan sinar tak terlihat untuk menemukan titik tabrakan dengan terrain atau objek. Penting untuk desain level game: menemukan posisi tanah, mengecek apakah objek bisa ditempatkan, mencari lokasi spawn, dan menganalisis area yang bisa dilalui.
+
+### Terrain
+
+Isi, pahat, dan haluskan terrain dengan berbagai bentuk seperti blok, bola, silinder, dan baji. Ubah material dan warna, atau buat terrain alam secara prosedural dengan gunung dan sungai.
+
+### Visualisasi
+
+Tampilkan area, marker, dan garis di layar untuk mengonfirmasi ruang kerja secara visual. Berguna untuk debugging dan review desain level.
+
+👉 [Panduan Upgrade Pro](../pro-upgrade.md)

package/docs/ja/README.md

@@ -1,47 +1,59 @@
 # Roblox MCP
 
-[English](../en/README.md) | [한국어](../ko/README.md) | **日本語** | [Español](../es/README.md) | [Português](../pt-br/README.md) | [Bahasa Indonesia](../id/README.md)
+[English](../../README.md) | [한국어](../ko/README.md) | **日本語** | [Español](../es/README.md) | [Português](../pt-br/README.md) | [Bahasa Indonesia](../id/README.md)
 
-> AIでRoblox Studioを操作しましょう。
+> AIに話しかけるだけで、Roblox Studioで実行されます。
 
-[![Demo](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
+[![デモ](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
 
-## インストール方法
+## できること
 
-### 1. Robloxプラグインのインストール
+### ゲームを一度に作成
 
-👉 [プラグインインストールガイド](installation/roblox-plugin.md)
+「マインクラフト風のサバイバルゲームを作って」「脱出パズルゲームを作って」のようにリクエストすると、AIがゲーム構造を設計し、マップ、オブジェクト、スクリプトまで直接作成してくれます。シンプルなアイデア一つで、プレイ可能なゲームを完成できます。
 
-### 2. MCPサーバーの設定
+> **ヒント**: 「まず計画を立てて」とリクエストしてから、計画を確認して「実行して」と指示すると、より完成度の高い結果が得られます。
 
-MCPをサポートするすべてのAIアプリで使用できます。お使いのAIアプリに合ったガイドをご確認ください:
+### オブジェクトの作成と配置
 
-| AIアプリ | インストールガイド |
-|-------|-------------|
-| Claude Code | [設定方法](installation/claude-code.md) |
-| Claude Desktop | [設定方法](installation/claude-app.md) |
-| Codex CLI | [設定方法](installation/codex-cli.md) |
-| Codex Desktop | [設定方法](installation/codex-app.md) |
-| Gemini CLI | [設定方法](installation/gemini-cli.md) |
-| Cursor, Windsurf など | [設定方法](installation/antigravity.md) |
+「赤いレンガの家を作って」「木を10本一列に植えて」のように言うと、AIがRoblox Studioに直接作成してくれます。一つずつ作ることもできますし、数百個を一度に作ることもできます。
 
-## ツール一覧
+### スクリプトの作成と修正
 
-👉 [全ツール一覧を見る](tools/overview.md)
+「プレイヤーがジャンプしたらパーティクルを出して」「このスクリプトのバグを見つけて」のようにリクエストすると、AIが直接コードを作成・修正します。既存のスクリプトを分析し、依存関係も把握してくれます。
 
-## トラブルシューティング
+### マップの雰囲気設定
 
-- **"Not Connected"**: プラグインでConnectボタンを再度押してください
-- **ポート**: 3002番ポートを使用します (localhost)
+「夕焼けの雰囲気に変えて」「雨の日のように暗くして」の一言で、照明、空、霧を自動的に調整します。
 
-## リンク
+### 地形の生成
 
-- [GitHub](https://github.com/hope1026/roblox-mcp)
-- [Issue報告](https://github.com/hope1026/roblox-mcp/issues)
+山、川、平原、洞窟などの自然地形を会話だけで作成できます。素材、色、サイズも自由に調整できます。
+
+### アセットの検索と挿入
+
+Creator Storeから無料モデルとアセットを検索して、すぐにゲームに追加できます。「中世の城のモデルを探して入れて」のように言うだけです。
+
+### 空間分析と配置
+
+「このエリアの空きスペースを見つけて」「モンスターが歩き回れるエリアを分析して」のような空間関連の作業もAIが処理します。
+
+### デバッグと分析
 
-## ライセンス
+ゲームのエラーログを確認し、問題を見つけて修正するところまでAIと一緒にできます。
 
-ゲーム開発に無料で使用できます。
+> [全機能リスト](tools/overview.md)
 
-✅ **許可**: ゲーム開発、商用ゲーム、個人プロジェクト
-❌ **不可**: ソフトウェアの再販売、競合製品の開発
+## はじめに
+
+インストールは2つのステップで完了します:
+
+1. **Roblox Studioプラグインのインストール** — StudioとAIを接続する橋渡しの役割をします
+2. **AIアプリにMCPサーバーを登録** — 使用するAIアプリでRoblox MCPを認識できるように設定します
+
+5分で終わります。👉 [インストールガイド](installation/README.md)
+
+## リンク
+
+- [GitHub](https://github.com/hope1026/roblox-mcp)
+- [Issue報告](https://github.com/hope1026/roblox-mcp/issues)

package/docs/ja/installation/README.md

@@ -0,0 +1,51 @@
+# インストールガイド
+
+Roblox MCPを使用するには、**2つ**をインストールする必要があります。
+
+```
+AIアプリ (Claude、Codex、Geminiなど)
+       │
+   MCPサーバー ← ここでAIの命令をRobloxが理解できる形式に変換
+       │
+Roblox Studioプラグイン ← Studio内で命令を実行
+```
+
+AIアプリが「青いパーツを作って」と言うと、MCPサーバーがこのリクエストを変換し、Roblox Studioプラグインが実際にパーツを作成します。
+
+---
+
+## ステップ1: Roblox Studioプラグインのインストール
+
+GitHubからプラグインファイルをダウンロードして、Roblox StudioのPluginsフォルダに配置します。
+
+👉 [プラグインインストールガイド](roblox-plugin.md)
+
+---
+
+## ステップ2: AIアプリにMCPサーバーを登録
+
+使用しているAIアプリにMCPサーバーを登録します。MCPをサポートするすべてのAIアプリで使用できます。
+
+| AIアプリ | 設定方法 |
+|---------|---------|
+| Claude Code | [設定手順](ai-apps/claude-code.md) |
+| Cline | [設定手順](ai-apps/cline.md) |
+| Roo Code | [設定手順](ai-apps/roo-code.md) |
+| Cursor | [設定手順](ai-apps/cursor.md) |
+| Zed | [設定手順](ai-apps/zed.md) |
+| その他のMCP対応アプリ | [設定手順](ai-apps/other-mcp-clients.md) |
+
+> 上記のリストにないAIアプリでも、MCPをサポートしていれば使用できます。MCPサーバーコマンド: `npx -y @weppy/roblox-mcp`
+
+---
+
+## インストール後
+
+1. **Roblox Studio**を開き、Pluginsタブから **W-MCP** → **Connect** をクリック
+2. **AIアプリ**で次のようにテストしてみてください:
+
+```
+Roblox Studioに青いパーツを作って
+```
+
+正常にパーツが作成されれば、インストール完了です!

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

@@ -32,12 +32,12 @@ MCPサーバーがインストールされている必要があります。お
 
 | AIアプリ | インストールガイド |
 |-------|-------------|
-| Claude Code | [設定方法](claude-code.md) |
-| Claude Desktop | [設定方法](claude-app.md) |
-| Codex CLI | [設定方法](codex-cli.md) |
-| Codex Desktop | [設定方法](codex-app.md) |
-| Gemini CLI | [設定方法](gemini-cli.md) |
-| Cursor, Windsurf など | [設定方法](antigravity.md) |
+| Claude Code | [設定方法](ai-apps/claude-code.md) |
+| Claude Desktop | [設定方法](ai-apps/claude-app.md) |
+| Codex CLI | [設定方法](ai-apps/codex-cli.md) |
+| Codex Desktop | [設定方法](ai-apps/codex-app.md) |
+| Gemini CLI | [設定方法](ai-apps/gemini-cli.md) |
+| Antigravity | [設定方法](ai-apps/antigravity.md) |
 
 ### 接続する
 

package/docs/ja/pro-upgrade.md

@@ -6,7 +6,7 @@
 
 **完成度の高いゲーム** - 地形、環境、アセット、空間ツールでプロトタイプではなく完成されたゲームワールドを作成できます。
 
-## Proが追加するツール (72個)
+## Proが追加するツール
 
 | カテゴリ | 機能 |
 |---------|------|
@@ -21,8 +21,7 @@
 
 ### ステップ1: Gumroadで購入
 
-1. [Gumroad - Weppy Roblox Plugin](https://sunityplugin.gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin
-) にアクセス
+1. [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin) にアクセス
 2. プラグインをダウンロード
 
 ### ステップ2: プラグインのインストール
@@ -37,12 +36,12 @@
 
 1. W-MCPプラグインを開く
 2. "Pro" バッジが表示されているか確認
-3. 140個の全ツールが使用可能！
+3. すべてのツールが使用可能！
 
 ## 機能比較
 
-| 機能 | Basic (68個) | Pro (140個) |
-|-----|:------------:|:-----------:|
+| 機能 | Basic | Pro |
+|-----|:-----:|:---:|
 | Instance, Script, Property | ✅ 全機能利用可能 | ✅ 全機能利用可能 |
 | Selection, Tag, Camera, Log | ✅ 全機能利用可能 | ✅ 全機能利用可能 |
 | 一括操作 (Bulk) | ― | ✅ 無制限 |