@weppy/roblox-mcp 2.5.0 → 2.6.0

package/docs/id/installation/ai-apps/cursor.md

@@ -1,77 +0,0 @@
-# Pengaturan Cursor
-
-Cara menggunakan Roblox MCP dengan [Cursor](https://cursor.com/).
-
-## Prasyarat
-
-- **Cursor** sudah terpasang
-- **Node.js** (v18.0.0 atau lebih baru)
-- **Plugin Roblox Studio** sudah terpasang
-
-## Mendaftarkan server MCP
-
-### Metode 1: Konfigurasi proyek
-
-Tambahkan isi berikut ke `.cursor/mcp.json` di proyek Anda:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-### Metode 2: Konfigurasi global
-
-Tambahkan isi yang sama ke file konfigurasi global Cursor.
-
-**Lokasi file konfigurasi:**
-
-| Cakupan | Path |
-|---------|------|
-| Proyek | `<proyek>/.cursor/mcp.json` |
-| Global (macOS/Linux) | `~/.cursor/mcp.json` |
-| Global (Windows) | `%USERPROFILE%\\.cursor\\mcp.json` |
-
-> Jika file sudah ada, gabungkan entri `weppy-roblox-mcp` ke dalam objek `mcpServers` yang sudah ada.
-
-### Terapkan perubahan
-
-Setelah mengubah konfigurasi, muat ulang jendela Cursor atau mulai ulang aplikasinya.
-
-## Uji koneksi
-
-1. Buka **Roblox Studio** → tab Plugins → **WEPPY** → **Connect**
-2. Di **Cursor**, masukkan:
-   ```
-   Tell me what's currently selected in Roblox Studio
-   ```
-
-## Pemecahan masalah
-
-### Server MCP tidak muncul
-
-- Pastikan path file konfigurasi sudah benar
-- Pastikan sintaks JSON valid
-- Muat ulang Cursor setelah mengubah konfigurasi
-
-### Server tidak bisa dijalankan
-
-Jalankan server MCP secara langsung untuk memeriksa error:
-
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### Koneksi gagal
-
-- Pastikan plugin Roblox Studio berada dalam status **Connected**
-- Periksa apakah port 3002 diblokir firewall
-
-## Referensi
-
-- [Dokumentasi Cursor MCP](https://docs.cursor.com/context/model-context-protocol)

package/docs/id/installation/ai-apps/gemini-cli.md

@@ -1,120 +0,0 @@
-# Pengaturan Gemini CLI
-
-Cara menggunakan Roblox MCP dengan [Google Gemini CLI](https://github.com/google-gemini/gemini-cli).
-
-## Prasyarat
-
-1. **Node.js** (v18.0.0 atau lebih tinggi)
-   ```bash
-   node --version
-   ```
-
-2. **Gemini CLI** terinstal
-   ```bash
-   npm install -g @google/gemini-cli
-   ```
-
-3. **Plugin Roblox Studio** terinstal
-
-## Mendaftarkan Server MCP
-
-### Metode 1: Perintah CLI (Disarankan)
-
-Daftarkan dengan satu perintah di terminal Anda:
-
-```bash
-gemini mcp add weppy-roblox-mcp npx --trust -- -y @weppy/roblox-mcp
-```
-
-> Flag `--trust` melewati prompt konfirmasi untuk setiap pemanggilan tool.
-
-Untuk mendaftar secara global, tambahkan `-s user`:
-
-```bash
-gemini mcp add weppy-roblox-mcp npx -s user --trust -- -y @weppy/roblox-mcp
-```
-
-### Metode 2: Edit File Konfigurasi
-
-Tambahkan konten berikut ke file `.gemini/settings.json`:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-**Lokasi file konfigurasi:**
-| Lingkup | Path |
-|---------|------|
-| Proyek | `<proyek>/.gemini/settings.json` |
-| Global | `~/.gemini/settings.json` |
-
-### Metode 3: Menggunakan Variabel Lingkungan
-
-Jika variabel lingkungan tertentu diperlukan:
-
-**CLI:**
-```bash
-gemini mcp add weppy-roblox-mcp npx --trust -e HTTP_PORT=3002 -- -y @weppy/roblox-mcp
-```
-
-**File konfigurasi:**
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "env": {
-        "HTTP_PORT": "3002"
-      }
-    }
-  }
-}
-```
-
-## Tes Koneksi
-
-1. Buka **Roblox Studio** → tab Plugins → **WEPPY** → **Connect**
-2. Jalankan **Gemini CLI** dan masukkan:
-   ```
-   Beritahu saya apa yang sedang dipilih di Roblox Studio
-   ```
-
-## Memeriksa Status Server MCP
-
-Anda dapat memeriksa status server yang terhubung dengan perintah `/mcp` di Gemini CLI:
-
-```
-/mcp
-```
-
-## Pemecahan Masalah
-
-### Server tidak dapat dimulai
-
-Jalankan server MCP secara langsung untuk memeriksa kesalahan:
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### Koneksi gagal
-
-- Verifikasi bahwa plugin Roblox Studio dalam status **Connected**
-- Periksa apakah port 3002 diblokir oleh firewall
-- Periksa status server dengan perintah `/mcp`
-
-### Konflik tool
-
-Jika beberapa server MCP memiliki tool dengan nama yang sama, mereka akan diberi awalan dengan format `serverAlias__toolName`.
-
-## Referensi
-
-- [Dokumentasi Resmi Gemini CLI MCP](https://geminicli.com/docs/tools/mcp-server/)
-- [Panduan Konfigurasi Gemini CLI](https://geminicli.com/docs/get-started/configuration/)

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](../installation/roblox-explorer.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)