@weppy/roblox-mcp 2.5.1 → 2.6.0

package/docs/id/installation/roblox-explorer.md

@@ -1,58 +0,0 @@
-# WEPPY Roblox Explorer (Ekstensi VSCode)
-
-Tampilan pohon instansi seperti Explorer Roblox Studio, langsung di VSCode. Jelajahi instansi yang tersinkronisasi, buka skrip langsung, dan pantau status sinkronisasi tanpa meninggalkan editor.
-Ini adalah ekstensi pendamping untuk WEPPY, bukan integrasi Roblox yang berdiri sendiri.
-
-![WEPPY Roblox Explorer](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
-
-## Persyaratan
-
-- VSCode 1.85+
-- [Roblox MCP](../../../README.md) sudah terpasang dengan Sync aktif (Basic atau Pro)
-- Sync sudah menghasilkan `weppy-project-sync/place_*/.sync-meta.json` di bawah root proyek
-
-## Cara Instalasi
-
-Cari **WEPPY Roblox Explorer** di sidebar Ekstensi VSCode (`Ctrl+Shift+X` / `Cmd+Shift+X`) dan klik **Install**.
-
-Atau instal langsung dari marketplace berikut:
-
-- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
-- [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
-
-Penjelajahan tree dasar bekerja dari file sync di disk. Status sync live, indikator direction, dan pengiriman telemetri Explorer tersedia saat server MCP lokal dapat dijangkau.
-
-## Fitur
-
-- **Pohon instansi**: Hierarki layanan/instansi yang identik dengan Roblox Studio
-- **Ikon kelas Roblox**: Lebih dari 200 ikon dengan dukungan tema gelap/terang
-- **Multi-Place**: Akar pohon terpisah per Place yang tersinkronisasi
-- **Buka dengan klik**: Buka file pendukung (`.server.luau`, `.client.luau`, `.module.luau`, `.props.json`)
-- **Pencarian instansi**: Pencarian QuickPick di semua layanan
-- **Badge status Sync**: Lihat status `modified`, `studio`, `conflict` sekilas
-- **Pembaruan otomatis**: Pohon diperbarui otomatis saat file Sync berubah (debounce 500ms)
-- **Salin jalur instansi**: Klik kanan untuk menyalin jalur format `game.Workspace.Part`
-
-## Pengaturan
-
-| Pengaturan | Default | Deskripsi |
-|------------|---------|-----------|
-| `robloxExplorer.syncRoot` | `""` | Jalur absolut ke root `weppy-project-sync`. Jika kosong, akan dideteksi otomatis. WEPPY memakai `{projectRoot}/weppy-project-sync`. |
-| `robloxExplorer.hidePropsFiles` | `false` | Sembunyikan file Sync (`.props.json`, `_tree.json`, `.value.json`) di explorer VSCode default. |
-| `robloxExplorer.autoRefresh` | `true` | Perbarui pohon otomatis saat file Sync berubah. |
-| `robloxExplorer.showSyncStatus` | `true` | Tampilkan dekorasi status Sync pada item pohon. |
-
-## Perintah
-
-| Perintah | Deskripsi |
-|----------|-----------|
-| `WEPPY Explorer: Refresh` | Perbarui pohon instansi secara manual |
-| `WEPPY Explorer: Search Instances` | Cari instansi di semua layanan |
-| `WEPPY Explorer: Open Backing File` | Buka file pendukung instansi yang dipilih |
-| `WEPPY Explorer: Copy Instance Path` | Salin jalur instansi lengkap (contoh: `game.Workspace.Part`) |
-| `WEPPY Explorer: Reveal in Explorer` | Tampilkan file di explorer VSCode default |
-
-## Terkait
-
-- [Panduan Detail Sync](../sync/overview.md)
-- [Panduan Instalasi](README.md)

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

@@ -1,85 +0,0 @@
-# Instalasi Plugin Roblox
-
-Panduan instalasi plugin untuk menghubungkan AI agent di Roblox Studio.
-
-## 1. Unduh Plugin
-
-1. Buka [GitHub Releases](https://github.com/hope1026/weppy-roblox-mcp/releases/latest)
-2. Unduh `weppy-roblox-mcp-v{version}.zip`
-3. Ekstrak ZIP - Anda akan menemukan `roblox-plugin/WeppyRobloxMCP.rbxm` dan panduan instalasi
-
-Catatan:
-- Basic menggunakan paket plugin yang sama dengan kebijakan Basic (Studio -> Local satu arah)
-- Setelah lisensi langganan Pro aktif, sync dua arah dan fitur lanjutan yang lebih luas akan terbuka
-
-## 2. Instal Plugin
-
-1. Jalankan **Roblox Studio**
-2. Klik tab **Plugins**
-3. Klik **Plugins Folder**
-
-![Buka Plugins Folder](../../assets/screenshots/plugin/installation/plugins-menu.png)
-
-4. **Salin** `WeppyRobloxMCP.rbxm` ke folder Plugins
-5. **Restart Roblox Studio**
-
-## 3. Verifikasi Instalasi
-
-Setelah restart, tombol **WEPPY** muncul di tab Plugins.
-
-![Tombol WEPPY](../../assets/screenshots/plugin/installation/toolbar-button.png)
-
-## 4. Hubungkan AI Agent
-
-### Persiapan
-
-MCP server harus sudah terinstal. Selesaikan dulu panduan app AI yang Anda pakai:
-
-| Aplikasi AI | Panduan Instalasi |
-|-------------|-------------------|
-| Claude Code | [Cara Konfigurasi](ai-apps/claude-code.md) |
-| Claude Desktop | [Cara Konfigurasi](ai-apps/claude-app.md) |
-| Cursor | [Cara Konfigurasi](ai-apps/cursor.md) |
-| Codex CLI | [Cara Konfigurasi](ai-apps/codex-cli.md) |
-| Codex Desktop | [Cara Konfigurasi](ai-apps/codex-app.md) |
-| Gemini CLI | [Cara Konfigurasi](ai-apps/gemini-cli.md) |
-| Antigravity | [Cara Konfigurasi](ai-apps/antigravity.md) |
-
-### Menghubungkan
-
-1. Buka proyek apa saja di **Roblox Studio**
-2. Tab **Plugins** -> **WEPPY**
-3. Klik **Connect**
-4. Jika status **"Connected"** tampil, koneksi berhasil
-
-![Layar Utama Plugin](../../assets/screenshots/plugin/installation/main-screen.png)
-
-## 5. Pengaturan (Opsional)
-
-Gunakan tombol pengaturan di kanan atas plugin.
-
-![Layar Pengaturan](../../assets/screenshots/plugin/installation/settings-screen.png)
-
-- **Auto Connect**
-- **Auto Reconnect**
-- **Auto Camera Focus**
-- **Language**
-
-## Pemecahan Masalah
-
-### Plugin tidak terlihat
-
-- Restart Roblox Studio sepenuhnya
-- Pastikan file sudah disalin benar
-- Pastikan `.rbxm` tidak rusak
-
-### Tidak dapat terhubung
-
-- Pastikan MCP server berjalan
-- Klik **Connect** lagi
-- Cek konflik port 3002
-
-### Koneksi sering terputus
-
-- Aktifkan **Auto Reconnect**
-- Restart app AI

package/docs/id/pro-upgrade.md

@@ -1,96 +0,0 @@
-# Panduan Upgrade Pro
-
-## Mengapa Pro?
-
-### Sync dua arah untuk alur kerja pengembangan nyata
-
-Pro Sync melampaui sekadar export satu arah. Edit script secara lokal dan kirim ke Studio. Buat perubahan di Studio dan tarik kembali ke disk. Pro menjaga keduanya tetap sinkron.
-
-- **Sync dua arah** — Perubahan mengalir dua arah antara Studio dan file lokal.
-- **Direction per tipe** — Atur arah secara independen untuk Scripts, Values, Containers, Data, dan Services.
-- **Apply Mode per tipe** — Pilih Auto atau Manual per tipe untuk menyeimbangkan kecepatan dan kontrol.
-- **Full Sync / Resync** — Bangun ulang state proyek yang bersih setelah perubahan besar atau reconnect.
-- **Riwayat Perubahan** — Lacak apa yang berubah, kapan, dan ke arah mana sebelum menerapkan.
-- **Sync multi-place** — Sync hingga 3 Roblox Place sekaligus, masing-masing dengan penyimpanan terisolasi dan riwayat perubahan sendiri.
-
-### Hemat token AI dengan workflow berdampak tinggi
-
-Aksi massal dan lanjutan mengurangi panggilan berulang — lakukan lebih banyak per prompt.
-
-### AI yang mengontrol playtest secara langsung
-
-AI dapat mengontrol playtest Roblox Studio secara langsung. AI bisa memulai dan menghentikan Play (F5) atau Run (F8), menyuntikkan script pengujian, mengumpulkan log, dan membuat laporan secara otomatis.
-
-- "Mulai playtest mode Run dan periksa apakah NPC mencapai target."
-- "Tulis test yang memverifikasi SpawnLocation berada di atas tanah lalu jalankan."
-- "Validasi bahwa script yang baru aku ubah berjalan tanpa error di playtest."
-
-### Lebih banyak fitur eksklusif Pro
-
-Pro membuka fitur tambahan di luar alur kerja inti.
-
-- **Operasi massal** — Buat, ubah, atau hapus beberapa instance dalam satu permintaan
-- **Pembuatan terrain** — Isi dengan blok, bola, silinder, wedge, dan ganti material
-- **Pencarian/penyisipan aset** — Cari di marketplace Roblox dan sisipkan aset langsung
-- **Analisis spasial** — Raycast, temukan tanah, pencarian area datar, deteksi tabrakan
-- **Kontrol lingkungan** — Pencahayaan, atmosfer, langit, dan pengaturan waktu
-- **Audio/Animasi** — Pemutaran suara dan muat/putar animasi
-
-## Beli lalu aktifkan
-
-### Langkah 1: Beli lisensi langganan Pro di Gumroad
-
-1. Buka [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/faccjs?utm_source=github&utm_medium=repo&utm_campaign=pro_upgrade_md)
-2. Selesaikan pembelian lisensi langganan Pro
-3. Salin license key yang kamu terima setelah pembelian
-
-Kamu hanya perlu mengaktifkan lisensi sekali, baik di plugin maupun di dashboard. Keduanya berbagi status lisensi lokal MCP yang sama, jadi saat diaktifkan di satu tempat, status yang sama akan muncul di tempat lainnya.
-
-### Aktifkan di plugin
-
-1. Buka **WEPPY** di Roblox Studio lalu hubungkan ke MCP server.
-2. Buka bagian **Settings > License** di plugin.
-3. Tempel key yang sudah dibeli ke field `License key`.
-4. Klik **Activate** untuk mengaktifkan lisensi.
-5. Jika status belum langsung diperbarui, klik **Refresh**.
-6. Setelah aktivasi berhasil, status berubah dari Basic ke Pro dan fitur Pro bisa digunakan.
-
-![Layar aktivasi lisensi di plugin](../assets/screenshots/plugin/license/plugin-license-screen.png)
-
-### Aktifkan di dashboard
-
-1. Jalankan MCP server lalu buka **Settings > License** di dashboard.
-2. Pastikan provider disetel ke `gumroad`.
-3. Tempel key yang sudah dibeli ke field `License Key`.
-4. Klik **Activate License** untuk mengaktifkan lisensi.
-5. Jika perlu, gunakan **Refresh License** untuk mengambil status terbaru.
-
-![Layar aktivasi lisensi di dashboard](../assets/screenshots/plugin/license/dashboard-license-screen.png)
-
-### Setelah aktivasi
-
-- Jika status lisensi tampil sebagai `active` atau `grace`, fitur Pro sudah bisa digunakan.
-- Plugin dan dashboard berbagi status lisensi yang sama, jadi aktivasi di satu tempat akan tercermin di tempat lainnya.
-- Gunakan **Refresh** atau **Refresh License** jika ingin memeriksa status terbaru lagi.
-
-## Perbandingan Fitur
-
-| Fitur | Basic | Pro |
-|-------|:-----:|:---:|
-| Buat/edit script | ✅ | ✅ |
-| Buat/hapus/pindah instance | ✅ | ✅ + operasi massal |
-| Baca/ubah properti | ✅ | ✅ + perubahan massal |
-| Seleksi, tag, pencarian | ✅ | ✅ |
-| Kontrol kamera | ✅ | ✅ |
-| Pemantauan log | ✅ | ✅ |
-| Eksekusi kode Luau | ✅ | ✅ |
-| Sinkronisasi proyek | Studio → Local satu arah | Dua arah + arah/mode per tipe |
-| Sync multi-place | — | Hingga 3 Place secara bersamaan |
-| Riwayat perubahan | — | Lacak perubahan sebelum diterapkan |
-| Kontrol playtest | — | Putar / hentikan / jeda / lanjutkan + tes otomatis |
-| Pembuatan/pengeditan terrain | — | Blok, bola, silinder, wedge, penggantian material |
-| Pencarian/penyisipan aset | — | Cari di marketplace Roblox dan sisipkan langsung |
-| Analisis spasial | — | Raycast, temukan tanah, deteksi tabrakan |
-| Kontrol lingkungan | — | Pencahayaan, atmosfer, langit, waktu |
-| Audio / Animasi | — | Pemutaran suara, muat/putar animasi |
-| Efisiensi token AI | Aksi per-item | Lebih sedikit panggilan dengan aksi massal |

package/docs/id/sync/luau-lsp.md

@@ -1,41 +0,0 @@
-# Menggunakan `luau-lsp` dengan WEPPY Sync
-
-WEPPY Sync bisa membuat file sourcemap yang dibutuhkan `luau-lsp` secara otomatis, jadi kamu bisa menyalakan fitur editor yang paham konteks Roblox tanpa menyiapkan proyek Rojo terpisah.
-
-## File yang ditulis WEPPY
-
-Setelah Full Sync selesai, WEPPY menulis:
-
-- Place sourcemap: `weppy-project-sync/place_<id>/sourcemap.json`
-- File perwakilan root: `weppy-project-sync/sourcemap.json`
-
-Untuk kebanyakan user, path yang direkomendasikan adalah `weppy-project-sync/sourcemap.json`.
-
-## Manfaatnya
-
-Saat `luau-lsp` membaca sourcemap dari WEPPY, hal berikut akan membaik:
-
-- Autocomplete `game.*`
-- Navigasi antar script yang tersinkron
-- Resolusi `require` antar script yang tersinkron
-
-## Setup yang direkomendasikan
-
-1. Jalankan Full Sync sekali agar WEPPY membuat `weppy-project-sync/sourcemap.json`.
-2. Arahkan pengaturan sourcemap `luau-lsp` di editor kamu ke `weppy-project-sync/sourcemap.json`.
-3. Jika client kamu bisa mematikan autogenerate Rojo, set `luau-lsp.sourcemap.autogenerate` ke `false`.
-
-Contoh pengaturan VSCode:
-
-```json
-{
-  "luau-lsp.sourcemap.enabled": true,
-  "luau-lsp.sourcemap.autogenerate": false,
-  "luau-lsp.sourcemap.sourcemapFile": "weppy-project-sync/sourcemap.json"
-}
-```
-
-## Catatan Multi-place
-
-`weppy-project-sync/sourcemap.json` mengikuti place perwakilan proyek saat ini.
-Kalau kamu butuh place yang tetap, arahkan `luau-lsp` langsung ke `weppy-project-sync/place_<id>/sourcemap.json` milik place tersebut.

package/docs/id/sync/overview.md

@@ -1,153 +0,0 @@
-# Panduan detail Sync Roblox MCP
-
-Sync menghubungkan status Roblox Studio dan file lokal agar AI bisa membaca dan memodifikasi konteks proyek secara utuh dan stabil.
-
-## Kenapa Sync penting
-
-Tanpa Sync, AI hanya melihat potongan kode yang ditempel di chat. Dengan Sync aktif, AI bekerja dari keseluruhan proyek.
-
-- Terapkan refactor lintas banyak script secara konsisten
-- Tinjau perubahan berisiko lebih cepat lewat riwayat
-- Jaga sumber kebenaran antara Studio dan file lokal tetap jelas
-
-## Cara kerjanya
-
-![Alur Sync — tree Studio di-mirror ke file lokal](../../assets/screenshots/plugin/sync/sync-overview.png)
-
-1. Full Sync: mirror awal dari tree/instance Studio ke lokal
-2. Incremental Sync: perubahan baru terus disinkronkan
-3. Pelacakan History/Status: cek apa yang berubah, kapan, dan ke arah mana
-
-Data Sync disimpan di `{projectRoot}/weppy-project-sync/place_{placeId}/explorer`.
-Selain itu, WEPPY menulis sourcemap per place ke `{projectRoot}/weppy-project-sync/place_{placeId}/sourcemap.json` dan menjaga file perwakilan root yang direkomendasikan di `{projectRoot}/weppy-project-sync/sourcemap.json`.
-Untuk integrasi editor seperti `luau-lsp`, sebaiknya gunakan path root. Langkah setup dijelaskan di [Menggunakan `luau-lsp` dengan WEPPY Sync](./luau-lsp.md).
-
-### Jelajahi data sync di VSCode
-
-Instal ekstensi [WEPPY Roblox Explorer](../explorer/overview.md) untuk menjelajahi tree instance yang sudah tersinkron di VSCode, seperti di Roblox Studio.
-Explorer membaca file sync yang dihasilkan di sini, dan juga bisa menampilkan status sync live serta informasi direction saat server MCP lokal sedang berjalan.
-
-![WEPPY Roblox Explorer — jelajahi tree instance yang tersinkron di VSCode](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
-
-- Tree service/instance dengan ikon kelas Roblox
-- Klik script untuk membukanya dan mengedit
-- Badge status sync menampilkan status modified/conflict
-
-## Basic vs Pro
-
-| Item | Basic | Pro |
-|------|------|-----|
-| Arah sync | Studio -> Local | Dua arah |
-| Direction per tipe | Tidak didukung | Didukung (Scripts / Values / Containers / Data / Services) |
-| Apply Mode per tipe | Tidak didukung | Didukung (Auto / Manual) |
-| API status/riwayat | Tidak didukung | Didukung (`status_current_place`, `history`, `progress`) |
-| Tool `manage_sync` | Tidak didukung | Didukung |
-| Sync multiplace | Tidak didukung | Didukung (hingga 3 place) |
-
-## Target sync dan aturan eksklusi default
-
-Layanan yang disinkronkan secara default:
-
-- `Workspace`
-- `Lighting`
-- `ReplicatedStorage`
-- `ServerStorage`
-- `ServerScriptService`
-- `StarterGui`
-- `StarterPlayer`
-- `StarterPack`
-- `ReplicatedFirst`
-- `SoundService`
-- `Chat`
-- `LocalizationService`
-
-Eksklusi default:
-
-- Kelas: `Terrain`, `Camera`
-- Path terlarang demi keamanan: `CoreGui`, `CorePackages`, `RobloxScript`, `RobloxScriptSecurity`
-
-## Direction dan Apply Mode
-
-### Direction (arah sync per tipe)
-
-- `forward`: Studio -> Local
-- `reverse`: Local -> Studio
-- `bidirectional`: dua arah
-
-Tipe dikelola terpisah: `scripts`, `values`, `containers`, `data`, `services`.
-
-### Apply Mode (cara menerapkan perubahan reverse)
-
-- `manual`: user konfirmasi sebelum diterapkan ke Studio
-- `auto`: perubahan terdeteksi diterapkan otomatis
-
-Di Pro, Direction dan Apply Mode bisa diatur per tipe.
-
-## Panduan aksi `manage_sync` (Pro)
-
-| Aksi | Deskripsi | Parameter utama |
-|------|------|-----------|
-| `status_current_place` | Cek status sync saat ini untuk Place yang terhubung | `-` |
-| `history` | Ambil riwayat perubahan | `placeId`, `query.limit`, `query.offset` |
-| `directions` | Ambil Direction per tipe | `placeId` |
-| `read_file` | Baca file yang sudah tersinkron | `placeId`, `instancePath` |
-| `write_file` | Tulis file yang sudah tersinkron | `placeId`, `instancePath`, `content` |
-| `progress` | Lihat progres/throughput sync realtime | `placeId` |
-
-## Workflow yang disarankan
-
-### 1) Mulai dengan aman
-
-- Selesaikan Full Sync dulu sebagai baseline
-- Awali dengan mode `manual` untuk menurunkan risiko
-
-### 2) Bekerja dengan AI
-
-- "Cek status sync, lalu rangkum hanya perubahan berisiko dari riwayat terbaru"
-- "Refactor dulu script di `ServerScriptService` dan sertakan catatan riwayat"
-
-### 3) Menyelesaikan konflik
-
-Ketika perubahan terdeteksi di sisi Studio maupun lokal selama sinkronisasi dua arah, dialog resolusi konflik akan muncul.
-
-![Local Changes Detected — opsi resolusi konflik (Studio Priority / Local Priority / Per-File)](../../assets/screenshots/plugin/sync/sync-conflict.png)
-
-- **Studio Priority**: timpa dengan status Studio sebagai sumber kebenaran
-- **Local Priority**: terapkan file lokal ke Studio
-- **Per-File**: pilih sisi mana yang diprioritaskan untuk setiap file secara individual
-
-### 4) Pemulihan saat dibutuhkan
-
-- Lacak perubahan terbaru dengan `history`
-- Periksa file target dengan `read_file`
-- Pulihkan konten dengan `write_file`, lalu verifikasi status di Studio
-
-## Format file (v2 nested directory)
-
-Setiap instance Roblox disimpan sebagai direktori sendiri dengan file meta di dalamnya:
-
-```
-explorer/
-├── Workspace/
-│   ├── _tree.json
-│   ├── Part/
-│   │   └── Part.props.json
-│   ├── MyScript/
-│   │   └── MyScript.server.luau
-│   └── Coins/
-│       └── Coins.value.json
-```
-
-Konvensi penamaan:
-- Properti: `{Name}/{Name}.props.json`
-- Script: `{Name}/{Name}.server.luau` / `.client.luau` / `.module.luau`
-- Nilai: `{Name}/{Name}.value.json`
-
-Instance dengan nama duplikat menggunakan sufiks `~N` pada direktori (contoh: `Part~2/Part.props.json`).
-Nama yang mengandung `~` di-escape menjadi `~~` (contoh: `Part~2` → `Part~~2/`). Aturan Odd-Count Tilde: `~+N` di akhir ditafsirkan sebagai sufiks collision hanya jika jumlah tilde ganjil.
-
-## Dokumen terkait
-
-- [Menggunakan `luau-lsp` dengan WEPPY Sync](./luau-lsp.md)
-- [Cakupan tool (Tools Overview)](../tools/overview.md)
-- [Panduan Upgrade Pro](https://weppyai.com/en/plans)

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

@@ -1,104 +0,0 @@
-# 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

@@ -1,104 +0,0 @@
-# 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)