@weppy/roblox-mcp 1.4.2 → 1.5.1

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

@@ -0,0 +1,102 @@
+# Mundo y entorno
+
+> Construye e inspecciona el mundo del juego con lighting, terrain, consultas espaciales y herramientas de camara.
+
+## Tools incluidas
+
+| Tool | Tier | Descripcion |
+|------|:----:|-------------|
+| `manage_lighting` | Pro | Configura Lighting, Atmosphere, Sky y la hora del dia |
+| `manage_terrain` | Pro | Genera y edita terrain, incluido datos voxel |
+| `spatial_query` | Pro | Raycasts, busqueda de suelo, validacion de colocacion y mapas de altura |
+| `manage_camera` | Basic | Inspecciona el estado de la camara, mueve el foco y sugiere vistas |
+
+## Flujos principales
+
+### Definir la atmosfera (Pro)
+
+```
+"Cambia el mapa a un ambiente de atardecer con cielo naranja, niebla mas densa y hora 18:00."
+```
+
+Usa `manage_lighting.time` para la hora, `manage_lighting.atmosphere` para la niebla y `manage_lighting.sky` para el cielo.
+
+### Construir terrain (Pro)
+
+```
+"Crea una colina de pasto con radio 200 en el centro del mapa y rodeala con agua."
+```
+
+Usa `manage_terrain.fill_ball` para la colina y `manage_terrain.fill_block` para el agua circundante.
+
+### Validar una colocacion (Pro)
+
+```
+"Encuentra un terreno plano donde pueda colocar este edificio."
+```
+
+Usa `spatial_query.find_flat` para encontrar candidatos, `spatial_query.check_placement` para validarlos y `manage_camera.focus_position` para inspeccion visual.
+
+## Referencia de acciones
+
+### Manage Lighting (Pro)
+
+| Accion | Descripcion | Tier |
+|--------|-------------|------|
+| `lighting` | Definir propiedades del servicio Lighting | Pro |
+| `atmosphere` | Definir propiedades de Atmosphere | Pro |
+| `sky` | Definir propiedades de Sky | Pro |
+| `terrain_props` | Definir propiedades visuales y de agua de Terrain | Pro |
+| `time` | Definir la hora del dia | Pro |
+
+### Manage Terrain (Pro)
+
+| Accion | Descripcion | Tier |
+|--------|-------------|------|
+| `fill_block` | Rellenar terrain con forma de bloque | Pro |
+| `fill_ball` | Rellenar terrain con forma esferica | Pro |
+| `fill_cylinder` | Rellenar terrain con forma cilindrica | Pro |
+| `fill_wedge` | Rellenar terrain con forma de cunha | Pro |
+| `clear_region` | Limpiar terrain en una region | Pro |
+| `clear_bounds` | Limpiar terrain dentro de limites | Pro |
+| `replace_material` | Reemplazar material en una region | Pro |
+| `colors_get` | Obtener colores de material | Pro |
+| `colors_set` | Definir colores de material | Pro |
+| `read_voxel` | Leer un voxel individual | Pro |
+| `read_voxels` | Leer datos voxel en lote | Pro |
+| `write_voxels` | Escribir datos voxel en lote | Pro |
+| `generate` | Generar terrain procedural | Pro |
+| `smooth` | Suavizar terrain | Pro |
+
+### Spatial Query (Pro)
+
+| Accion | Descripcion | Tier |
+|--------|-------------|------|
+| `raycast` | Lanzar un solo rayo | Pro |
+| `find_ground` | Encontrar la posicion del suelo bajo un punto | Pro |
+| `check_placement` | Verificar si una colocacion esta libre de colisiones | Pro |
+| `multi_raycast` | Lanzar varios rayos en lote | Pro |
+| `scan_area` | Generar un mapa de alturas de un area | Pro |
+| `find_flat` | Encontrar zonas planas para construir | Pro |
+| `find_spawn` | Encontrar posiciones de spawn adecuadas | Pro |
+| `analyze_walkable` | Analizar una cuadricula transitable | Pro |
+| `spatial_map` | Obtener todas las posiciones de BasePart | Pro |
+| `find_space` | Encontrar espacio vacio para un objeto | Pro |
+| `bounds` | Obtener cajas de limites de instancias | Pro |
+| `snap_grid` | Ajustar una posicion a la cuadricula | Pro |
+| `collision` | Verificar colision AABB | Pro |
+
+### Manage Camera (Basic)
+
+| Accion | Descripcion | Tier |
+|--------|-------------|------|
+| `info` | Obtener posicion, rotacion, FOV y tamano del viewport de la camara | Basic |
+| `focus_path` | Mover la camara para enfocar una instancia | Basic |
+| `focus_position` | Mover la camara para enfocar una posicion | Basic |
+| `suggest` | Obtener una vista de camara sugerida para un objetivo | Basic |
+
+## Documentos relacionados
+
+- [Instancias y propiedades](instances-and-properties.md) - colocar objetos del mundo
+- [Assets y efectos](assets-and-effects.md) - agregar efectos, audio y animacion
+- [Lista completa de tools](overview.md)

package/docs/id/README.md

@@ -56,7 +56,15 @@ AI bekerja dari mirror lokal yang tersinkron, jadi perubahan lintas banyak file
 - Basic: sinkronisasi satu arah (Studio -> Local)
 - Pro: sinkronisasi dua arah + Direction/Apply Mode per tipe + riwayat + multiplace
 
-### 3) Roblox Explorer: jelajahi hierarki Studio di VSCode
+### 3) Playtest: AI menjalankan dan memverifikasi tes secara otomatis
+
+AI bisa mengontrol playtest Studio secara langsung. AI dapat memulai dan menghentikan Play (F5) atau Run (F8), menyuntikkan script test, mengumpulkan log, dan menghasilkan laporan lokal secara otomatis.
+
+- "Mulai playtest mode Run dan cek apakah NPC mencapai target."
+- "Tulis dan jalankan test untuk memastikan SpawnLocation berada di atas tanah."
+- "Validasi lewat playtest bahwa script yang baru saya ubah berjalan tanpa error."
+
+### 4) Roblox Explorer: jelajahi hierarki Studio di VSCode
 
 Lihat seluruh pohon instance dari place Roblox Studio langsung di dalam VSCode. Navigasi service, buka script dan file properti yang tersinkron, dan pantau status sinkronisasi — semua tanpa beralih ke Studio.
 
@@ -76,12 +84,21 @@ Lihat seluruh pohon instance dari place Roblox Studio langsung di dalam VSCode.
 ## Dokumen detail
 
 - [Panduan instalasi](../en/installation/README.md)
-- [Cakupan tool](../en/tools/overview.md)
-- [Panduan detail Sync](../en/sync/overview.md)
+- [Daftar tool lengkap](tools/overview.md)
+- [Panduan detail Sync](sync/overview.md)
 - [Roblox Explorer (Ekstensi VSCode)](../en/installation/roblox-explorer.md)
 - [Kompatibilitas](../compatibility.md)
 - [Panduan pemecahan masalah](../troubleshooting.md)
 
+### Panduan per alur kerja
+
+- [Instance & properti](tools/instances-and-properties.md) - pencarian, pembuatan, pengeditan, dan tag
+- [Scripting & eksekusi kode](tools/scripting.md) - pengelolaan script dan eksekusi Luau
+- [Dunia & lingkungan](tools/world-and-environment.md) - lighting, terrain, dan kamera
+- [Asset & efek](tools/assets-and-effects.md) - penyisipan model, tween, dan efek
+- [Playtest & tes otomatis](tools/playtest.md) - kontrol playtest dan validasi otomatis
+- [Sistem & debugging](tools/system-and-debugging.md) - koneksi, log, dan eksekusi batch
+
 ## Upgrade Pro
 
 Sync dua arah, kemampuan kreasi lanjutan, dan efisiensi token AI — semua dalam satu upgrade.

package/docs/id/pro-upgrade.md

@@ -53,5 +53,6 @@ Pembuatan terrain, pencarian aset, analisis spasial, animasi, audio, dan otomasi
 | Resync / Bangun ulang state | ❌ | ✅ |
 | Riwayat Perubahan | ❌ | ✅ |
 | Sync multi-place | ❌ | ✅ Hingga 3 place dengan penyimpanan terisolasi |
+| Kontrol Playtest (Putar/Hentikan/Jeda/Lanjutkan) | ❌ | ✅ |
 | Cakupan tools lanjutan | Set dasar | Set lanjutan lebih luas |
 | Efisiensi token AI | Standar | Lebih efisien dengan aksi massal / berdampak tinggi |

package/docs/id/tools/assets-and-effects.md

@@ -0,0 +1,104 @@
+# Asset & efek
+
+> Sisipkan asset dan kendalikan tween, audio, partikel, animasi, dan grup tabrakan.
+
+## Tool yang termasuk
+
+| Tool | Tier | Deskripsi |
+|------|:----:|-----------|
+| `manage_assets` | Pro | Mencari di Creator Store, menyisipkan model dan package, memeriksa info asset |
+| `manage_tween` | Pro | Membuat, memutar, menjeda, dan membatalkan tween |
+| `manage_animation` | Pro | Memuat, memutar, menghentikan, dan memeriksa track animasi |
+| `manage_audio` | Pro | Memutar, menghentikan, menjeda, dan melanjutkan suara; mengatur listener |
+| `manage_effects` | Pro | Mengeluarkan partikel, membersihkan efek, dan mengubah status efek |
+| `manage_physics` | Pro | Mendaftarkan grup tabrakan dan mengatur tabrakan |
+
+## Alur kerja utama
+
+### Menyusun scene dengan asset
+
+```
+"Cari model pohon di Creator Store lalu tempatkan tiga buah di Workspace."
+```
+
+Gunakan `manage_assets.search_insert` untuk mencari dan menyisipkan dalam satu langkah.
+
+### Membuat interaksi visual
+
+```
+"Buat pintu terbuka dengan tween 3 detik saat diklik."
+```
+
+Gunakan `manage_tween.create` untuk mendefinisikan gerakan dan `manage_tween.play` untuk memutarnya. Bisa dipadukan dengan `manage_audio.play` untuk efek suara.
+
+### Menggabungkan partikel dan audio
+
+```
+"Putar suara ledakan dan keluarkan partikel saat boss muncul."
+```
+
+Gunakan `manage_effects.emit` untuk partikelnya dan `manage_audio.play` untuk suaranya.
+
+## Referensi aksi
+
+### Manage Assets (Pro)
+
+| Aksi | Deskripsi | Tier |
+|------|-----------|------|
+| `insert` | Menyisipkan model berdasarkan ID asset | Pro |
+| `info` | Mendapatkan metadata asset | Pro |
+| `search` | Mencari di Creator Store | Pro |
+| `search_insert` | Mencari dan menyisipkan kecocokan pertama | Pro |
+| `insert_free` | Menyisipkan model gratis | Pro |
+| `insert_package` | Menyisipkan package | Pro |
+| `export` | Mengekspor seleksi saat ini | Pro |
+
+### Manage Tween (Pro)
+
+| Aksi | Deskripsi | Tier |
+|------|-----------|------|
+| `create` | Membuat tween dengan properti target | Pro |
+| `play` | Memutar tween yang dibuat | Pro |
+| `pause` | Menjeda tween yang berjalan | Pro |
+| `cancel` | Membatalkan tween | Pro |
+
+### Manage Animation (Pro)
+
+| Aksi | Deskripsi | Tier |
+|------|-----------|------|
+| `load` | Memuat animasi pada Humanoid atau AnimationController | Pro |
+| `play` | Memutar track animasi yang dimuat | Pro |
+| `stop` | Menghentikan animasi yang diputar | Pro |
+| `get_tracks` | Mendaftar semua track animasi yang dimuat | Pro |
+
+### Manage Audio (Pro)
+
+| Aksi | Deskripsi | Tier |
+|------|-----------|------|
+| `play` | Memutar suara dan membuat `Sound` jika diperlukan | Pro |
+| `stop` | Menghentikan suara yang diputar | Pro |
+| `pause` | Menjeda suara yang diputar | Pro |
+| `resume` | Melanjutkan suara yang dijeda | Pro |
+| `set_listener` | Mengatur tipe atau target listener audio | Pro |
+
+### Manage Effects (Pro)
+
+| Aksi | Deskripsi | Tier |
+|------|-----------|------|
+| `emit` | Mengeluarkan partikel dari `ParticleEmitter` | Pro |
+| `clear` | Membersihkan semua partikel | Pro |
+| `toggle` | Mengaktifkan atau menonaktifkan efek | Pro |
+
+### Manage Physics (Pro)
+
+| Aksi | Deskripsi | Tier |
+|------|-----------|------|
+| `register_group` | Mendaftarkan grup tabrakan | Pro |
+| `set_collidable` | Mengatur apakah dua grup bisa bertabrakan | Pro |
+| `get_groups` | Mendaftar semua grup tabrakan yang terdaftar | Pro |
+
+## Dokumen terkait
+
+- [Instance & properti](instances-and-properties.md) - membuat dan menempatkan objek
+- [Dunia & lingkungan](world-and-environment.md) - lighting, terrain, dan kamera
+- [Daftar tool lengkap](overview.md)

package/docs/id/tools/instances-and-properties.md

@@ -0,0 +1,104 @@
+# Instance & properti
+
+> Cari, buat, dan edit instance Roblox Studio sambil mengelola properti, atribut, dan tag.
+
+## Tool yang termasuk
+
+| Tool | Tier | Deskripsi |
+|------|:----:|-----------|
+| `query_instances` | Campuran | Mencari instance, menelusuri hierarki, dan memeriksa info kelas |
+| `mutate_instances` | Campuran | Membuat, menghapus, mengkloning, memindahkan, dan mengganti nama instance |
+| `manage_properties` | Campuran | Membaca dan menulis properti, atribut, dan tag |
+
+## Alur kerja utama
+
+### Memahami struktur scene
+
+```
+"Cari semua Part di bawah Workspace lalu beri tahu posisi dan ukurannya."
+```
+
+Gunakan `query_instances.search_class` untuk menemukan Part, lalu `manage_properties.mass_get` untuk membaca `Position` dan `Size` secara massal.
+
+### Menempatkan objek secara massal
+
+```
+"Tempatkan 4 SpawnLocation membentuk persegi di tengah map dan beri TeamColor yang berbeda untuk masing-masing."
+```
+
+Gunakan `mutate_instances.mass_create` untuk membuat semuanya dalam satu permintaan, lalu `manage_properties.mass_set` untuk mengatur propertinya.
+
+### Mengelola objek berdasarkan tag
+
+```
+"Cari semua objek dengan tag Collectible lalu ubah Anchored menjadi true."
+```
+
+Gunakan `manage_properties.get_tagged` untuk mengumpulkan instance, lalu `manage_properties.mass_set` untuk memperbaruinya.
+
+## Referensi aksi
+
+### Query Instances (Campuran)
+
+| Aksi | Deskripsi | Tier |
+|------|-----------|------|
+| `get` | Mendapatkan properti instance berdasarkan path | Basic |
+| `children` | Mendapatkan anak langsung atau semua keturunan | Basic |
+| `find_child` | Mencari anak pertama berdasarkan nama dan filter kelas opsional | Basic |
+| `find_descendant` | Mencari keturunan pertama berdasarkan nama | Basic |
+| `wait_for_child` | Menunggu anak muncul (dengan timeout) | Basic |
+| `class_info` | Mendapatkan informasi kelas dan properti yang valid | Basic |
+| `search_name` | Mencari instance berdasarkan pola nama (mendukung wildcard) | Basic |
+| `search_class` | Mencari instance berdasarkan nama kelas | Basic |
+| `file_tree` | Mendapatkan struktur pohon file dari root | Pro |
+| `project_structure` | Mendapatkan struktur proyek lengkap | Pro |
+| `descendants` | Mendapatkan semua keturunan dari sebuah instance | Pro |
+| `ancestors` | Mendapatkan semua leluhur dari sebuah instance | Pro |
+| `search_property` | Mencari instance berdasarkan nilai properti | Pro |
+| `search_tag` | Mencari instance berdasarkan tag | Pro |
+
+### Mutate Instances (Campuran)
+
+| Aksi | Deskripsi | Tier |
+|------|-----------|------|
+| `create` | Membuat instance baru | Basic |
+| `create_with_props` | Membuat instance dengan properti awal | Basic |
+| `delete` | Menghapus instance | Basic |
+| `clone` | Mengkloning instance | Basic |
+| `move` | Memindahkan instance ke parent baru | Basic |
+| `rename` | Mengganti nama instance | Basic |
+| `pivot` | Mengatur posisi pivot atau CFrame | Basic |
+| `create_tree` | Membuat pohon instance hierarkis | Pro |
+| `mass_create` | Membuat beberapa instance sekaligus | Pro |
+| `mass_delete` | Menghapus beberapa instance | Pro |
+| `mass_duplicate` | Menduplikasi beberapa instance | Pro |
+| `smart_duplicate` | Menduplikasi dengan jarak dan jumlah | Pro |
+
+### Manage Properties (Campuran)
+
+| Aksi | Deskripsi | Tier |
+|------|-----------|------|
+| `get` | Mendapatkan nilai satu properti | Basic |
+| `set` | Mengatur nilai satu properti | Basic |
+| `get_all` | Mendapatkan semua properti dari sebuah instance | Basic |
+| `set_multiple` | Mengatur beberapa properti sekaligus | Basic |
+| `get_attr` | Mendapatkan nilai atribut | Basic |
+| `set_attr` | Mengatur nilai atribut | Basic |
+| `get_all_attrs` | Mendapatkan semua atribut | Basic |
+| `delete_attr` | Menghapus atribut | Basic |
+| `add_tag` | Menambahkan tag ke instance | Basic |
+| `remove_tag` | Menghapus tag dari instance | Basic |
+| `check_tag` | Memeriksa apakah instance memiliki tag | Basic |
+| `get_tags` | Mendapatkan semua tag pada instance | Basic |
+| `get_tagged` | Mendapatkan semua instance dengan tag tertentu | Basic |
+| `set_calculated` | Mengatur properti menggunakan ekspresi matematika | Pro |
+| `set_relative` | Mengatur properti relatif terhadap nilai saat ini | Pro |
+| `mass_set` | Mengatur properti pada beberapa instance | Pro |
+| `mass_get` | Mendapatkan properti dari beberapa instance | Pro |
+| `modify_children` | Memodifikasi semua anak dari sebuah parent | Pro |
+
+## Dokumen terkait
+
+- [Scripting & eksekusi kode](scripting.md) - menambah atau mengubah script pada instance
+- [Asset & efek](assets-and-effects.md) - menyisipkan model, tween, dan efek
+- [Daftar tool lengkap](overview.md)

package/docs/id/tools/overview.md

@@ -2,6 +2,20 @@
 
 Untuk parameter detail, periksa definisi alat MCP secara langsung.
 
+## Panduan per alur kerja
+
+Gunakan panduan berbasis alur kerja ini untuk menavigasi kumpulan tool:
+
+| Kategori | Deskripsi | Tool yang termasuk |
+|----------|-----------|--------------------|
+| [Instance & properti](instances-and-properties.md) | Pencarian, pembuatan, pengeditan, dan tag instance | `query_instances`, `mutate_instances`, `manage_properties` |
+| [Scripting & eksekusi kode](scripting.md) | Pengelolaan script dan eksekusi Luau | `manage_scripts`, `execute_luau` |
+| [Dunia & lingkungan](world-and-environment.md) | Lighting, terrain, query spasial, dan kamera | `manage_lighting`, `manage_terrain`, `spatial_query`, `manage_camera` |
+| [Asset & efek](assets-and-effects.md) | Penyisipan asset, tween, animasi, audio, dan efek | `manage_assets`, `manage_tween`, `manage_animation`, `manage_audio`, `manage_effects`, `manage_physics` |
+| [Playtest & tes otomatis](playtest.md) | Kontrol playtest dan validasi otomatis | `system_info` (`play`, `stop`, `pause`, `resume`, `play_status`, `run_test`) |
+| [Sync](../sync/overview.md) | Sinkronisasi Studio dan file lokal | `manage_sync`, `workspace_state` |
+| [Sistem & debugging](system-and-debugging.md) | Koneksi, log, seleksi, dan eksekusi batch | `system_info` (`ping`, `connection`, `usage`, ...), `manage_logs`, `manage_selection`, `batch_execute` |
+
 Dokumen terkait:
 - [Panduan detail Sync](../sync/overview.md)
 
@@ -248,6 +262,12 @@ Kebijakan Sync:
 | `place_info` | Mendapatkan Place ID, nama, kreator | Pro |
 | `services` | Mendaftar semua layanan Roblox | Pro |
 | `studio_settings` | Mendapatkan preferensi Studio | Pro |
+| `play` | Memulai playtest dalam mode Play (F5) atau Run (F8) | Pro |
+| `stop` | Menghentikan playtest yang aktif | Pro |
+| `pause` | Menjeda playtest aktif pada mode Run | Pro |
+| `resume` | Melanjutkan playtest mode Run yang dijeda | Pro |
+| `play_status` | Mendapatkan status playtest dan aksi yang tersedia | Pro |
+| `run_test` | Menyuntikkan script test sementara, menjalankan playtest, mengumpulkan log, dan menulis laporan lokal | Pro |
 
 ## Batch Execute (Pro)
 

package/docs/id/tools/playtest.md

@@ -0,0 +1,140 @@
+# Playtest & tes otomatis
+
+> Kendalikan playtest Roblox Studio dengan AI, suntikkan script test, lalu hasilkan log dan laporan lokal secara otomatis.
+
+## Tool yang termasuk
+
+| Tool | Tier | Deskripsi |
+|------|:----:|-----------|
+| `system_info` | Pro | aksi `play`, `stop`, `pause`, `resume`, `play_status`, `run_test` |
+
+> Untuk aksi `system_info` lain seperti `ping`, `connection`, dan `usage`, lihat [Sistem & debugging](system-and-debugging.md).
+
+## Alur kerja utama
+
+### Kontrol playtest manual
+
+```
+"Mulai game dalam mode Play (F5)."
+"Hentikan playtest yang sedang berjalan."
+```
+
+Alur umum: `play` -> `play_status` -> `stop`.
+
+### Menjalankan tes otomatis
+
+```
+"Tulis dan jalankan test yang memeriksa apakah SpawnLocation berada di posisi yang benar."
+```
+
+`run_test` menyuntikkan script test, memulai playtest otomatis, mengumpulkan log, dan membersihkan semuanya.
+
+### Verifikasi gaya CI
+
+```
+"Jalankan test mode Run (F8) yang memeriksa apakah NPC mencapai target, lalu tampilkan log jika gagal."
+```
+
+Gunakan `run_test` dengan `mode: "run"` untuk validasi yang fokus pada server.
+
+## State machine playtest
+
+```text
+Edit --play--> Running --stop--> Edit
+                  |               ^
+                pause             |
+                  |               |
+                  v               |
+               Paused --resume--> Running
+```
+
+| Status | Aksi yang tersedia |
+|--------|--------------------|
+| `edit` | `play` |
+| `running` | `stop`, `pause` (hanya mode Run) |
+| `paused` | `resume`, `stop` |
+
+- Mode Play (F5): simulasi client + server, tidak mendukung pause atau resume
+- Mode Run (F8): simulasi server saja, mendukung pause dan resume
+
+## Alur `run_test`
+
+`run_test` mengorkestrasi langkah-langkah berikut secara otomatis:
+
+### 1. Persiapan
+
+- Membaca informasi place dengan `place_info`
+- Mengosongkan buffer log yang ada
+
+### 2. Penyuntikan script
+
+- Membuat `ServerScriptService.__MCP_TestRunner` dengan script test yang dibungkus
+- Wrapper menangani sinyal `START` dan `FINISHED` serta traceback error
+
+### 3. Eksekusi dan pemantauan
+
+- Memulai playtest dalam mode Play atau Run
+- Mem-poll log setiap 500 ms
+- Selesai ketika `[WEPPY_TEST]:FINISHED` terdeteksi
+- Berhenti otomatis saat timeout tercapai (default 60 detik, maksimum 300)
+
+### 4. Pembersihan
+
+- Menghentikan playtest secara otomatis
+- Menghapus script test yang disuntikkan
+- Mengumpulkan log terakhir
+
+### 5. Penulisan laporan
+
+Laporan dan log ditulis ke file lokal:
+
+```text
+roblox-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/
+├── test-report.md
+└── test-log.txt
+```
+
+Contoh `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
+```
+
+## Referensi aksi
+
+| Aksi | Deskripsi | Parameter | Tier |
+|------|-----------|-----------|------|
+| `play` | Memulai playtest dalam mode Play (F5) atau Run (F8) | `mode`: `"play"` \| `"run"` | Pro |
+| `stop` | Menghentikan playtest saat ini | - | Pro |
+| `pause` | Menjeda playtest mode Run | - | Pro |
+| `resume` | Melanjutkan playtest mode Run yang dijeda | - | Pro |
+| `play_status` | Mendapatkan status playtest dan aksi yang tersedia | - | Pro |
+| `run_test` | Menyuntikkan script test, menjalankan playtest, mengumpulkan log, dan menulis laporan | `script` (wajib), `test_name`, `mode`, `timeout` | Pro |
+
+### Parameter `run_test`
+
+| Parameter | Tipe | Wajib | Deskripsi |
+|-----------|------|:-----:|-----------|
+| `script` | string | ✅ | Isi kode Luau test yang akan dijalankan |
+| `test_name` | string | - | Nama yang ditampilkan pada laporan |
+| `mode` | `"play"` \| `"run"` | - | Mode playtest, default `"play"` |
+| `timeout` | number | - | Timeout dalam detik, default 60, maksimum 300 |
+
+## Dokumen terkait
+
+- [Sistem & debugging](system-and-debugging.md) - aksi koneksi dan pengelolaan log
+- [Scripting & eksekusi kode](scripting.md) - menulis script dan menjalankan Luau
+- [Daftar tool lengkap](overview.md)

package/docs/id/tools/scripting.md

@@ -0,0 +1,66 @@
+# Scripting & eksekusi kode
+
+> Kelola source code script dan jalankan Luau arbitrer di dalam Roblox Studio.
+
+## Tool yang termasuk
+
+| Tool | Tier | Deskripsi |
+|------|:----:|-----------|
+| `manage_scripts` | Campuran | Membuat, membaca, mengedit, mencari, dan menganalisis dependensi script |
+| `execute_luau` | Pro | Menjalankan Luau arbitrer di sandbox Roblox Studio |
+
+## Alur kerja utama
+
+### Mengedit script
+
+```
+"Ubah maxPlayers dari 12 menjadi 24 di script GameManager dalam ServerScriptService."
+```
+
+Gunakan `manage_scripts.search` untuk menemukan baris yang tepat lalu `manage_scripts.edit_replace` untuk memperbaruinya.
+
+### Refaktor banyak script (Pro)
+
+```
+"Ganti OldModule dengan NewModule di semua script."
+```
+
+Gunakan `manage_scripts.replace` untuk menerapkan perubahan ke banyak script dalam satu permintaan.
+
+### Memeriksa data runtime (Pro)
+
+```
+"Hitung rata-rata Health dari semua Humanoid yang sedang ada di Workspace."
+```
+
+Gunakan `execute_luau` untuk menjalankan Luau kustom dan membaca data runtime yang aktif.
+
+## Referensi aksi
+
+### Manage Scripts (Campuran)
+
+| Aksi | Deskripsi | Tier |
+|------|-----------|------|
+| `get_source` | Mendapatkan kode sumber script | Basic |
+| `set_source` | Mengatur kode sumber script | Basic |
+| `create` | Membuat script baru | Basic |
+| `delete` | Menghapus script | Basic |
+| `edit_replace` | Mengganti baris tertentu di script | Basic |
+| `edit_insert` | Menyisipkan baris pada posisi | Basic |
+| `edit_delete` | Menghapus baris tertentu | Basic |
+| `search` | Mencari teks di script | Basic |
+| `get_dependencies` | Mendapatkan dependensi script | Basic |
+| `replace` | Penggantian massal di seluruh script | Pro |
+
+### Execute Luau (Pro)
+
+Menjalankan Luau arbitrer di dalam sandbox Roblox Studio.
+
+- Layanan yang diblokir: `HttpService`, `DataStoreService`, `MessagingService`
+- API yang tidak bisa diakses: `CoreGui`, `CorePackages`
+
+## Dokumen terkait
+
+- [Instance & properti](instances-and-properties.md) - membuat atau memindahkan instance script
+- [Playtest & tes otomatis](playtest.md) - menyuntik dan menjalankan script test
+- [Daftar tool lengkap](overview.md)

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

@@ -0,0 +1,85 @@
+# Sistem & debugging
+
+> Periksa status koneksi, kelola log, kendalikan seleksi Studio, dan jalankan batch command untuk alur debugging.
+
+## Tool yang termasuk
+
+| Tool | Tier | Deskripsi |
+|------|:----:|-----------|
+| `system_info` | Campuran | `ping`, `connection`, `usage`, `place_info`, `services`, `studio_settings` |
+| `manage_logs` | Basic | Mengambil log, mengosongkan buffer, dan memfilter error terbaru |
+| `manage_selection` | Campuran | Membaca, mengganti, dan memantau seleksi Studio |
+| `batch_execute` | Pro | Menjalankan banyak command dalam satu batch |
+
+> Untuk aksi playtest di `system_info` seperti `play`, `stop`, dan `run_test`, lihat [Playtest & tes otomatis](playtest.md).
+
+## Alur kerja utama
+
+### Memeriksa koneksi
+
+```
+"Cek apakah Studio sudah terhubung dengan benar."
+```
+
+Gunakan `system_info.ping` untuk pemeriksaan cepat.
+
+### Mencari error terbaru
+
+```
+"Tampilkan error terbaru."
+```
+
+Gunakan `manage_logs.errors` untuk mengambil hanya error terbaru. `manage_logs.get` juga mendukung polling inkremental dengan cursor `sinceSeq`.
+
+### Menjalankan alur batch (Pro)
+
+```
+"Ubah semua Part di Workspace menjadi merah, lalu fokuskan kamera ke Part pertama."
+```
+
+Gunakan `batch_execute` untuk menggabungkan beberapa command dalam satu permintaan.
+
+## Referensi aksi
+
+### System Info (Campuran)
+
+| Aksi | Deskripsi | Tier |
+|------|-----------|------|
+| `ping` | Menguji koneksi | Basic |
+| `connection` | Mendapatkan info koneksi server dan plugin | Basic |
+| `usage` | Mendapatkan tier saat ini (`basic` atau `pro`) | Basic |
+| `place_info` | Mendapatkan Place ID, nama, dan kreator | Pro |
+| `services` | Mendaftar semua layanan Roblox | Pro |
+| `studio_settings` | Mendapatkan preferensi Studio | Pro |
+
+### Manage Logs (Basic)
+
+| Aksi | Deskripsi | Tier |
+|------|-----------|------|
+| `get` | Mendapatkan log terfilter dengan dukungan cursor `sinceSeq` opsional | Basic |
+| `clear` | Mengosongkan buffer log | Basic |
+| `errors` | Mendapatkan hanya error terbaru | Basic |
+
+### Manage Selection (Campuran)
+
+| Aksi | Deskripsi | Tier |
+|------|-----------|------|
+| `get` | Mendapatkan seleksi saat ini | Basic |
+| `set` | Mengganti seleksi saat ini | Basic |
+| `clear` | Menghapus seleksi | Basic |
+| `cached` | Mendapatkan seleksi cache tanpa round-trip | Basic |
+| `context` | Mendapatkan konteks detail dengan source dan properti | Pro |
+| `details` | Mendapatkan detail hierarkis dengan leluhur dan keturunan | Pro |
+| `add` | Menambahkan item ke seleksi | Pro |
+| `remove` | Menghapus item dari seleksi | Pro |
+| `watch` | Memantau perubahan seleksi | Pro |
+
+### Batch Execute (Pro)
+
+Menjalankan banyak command dalam satu batch. Setiap command menyertakan nama tool dan argumen, dijalankan berurutan, dan bisa tetap lanjut setelah error jika diatur.
+
+## Dokumen terkait
+
+- [Playtest & tes otomatis](playtest.md) - aksi playtest di `system_info`
+- [Scripting & eksekusi kode](scripting.md) - menjalankan Luau untuk investigasi dan debugging
+- [Daftar tool lengkap](overview.md)