@weppy/roblox-mcp 2.3.0 → 2.3.1

package/docs/es/sync/overview.md

@@ -19,6 +19,8 @@ Sin Sync, la IA solo ve fragmentos pegados en el chat. Con Sync activo, trabaja
 3. Seguimiento de History/Status: ver que cambio, cuando y en que direccion
 
 Los datos de Sync se guardan en `{projectRoot}/wrox-project-sync/place_{placeId}/explorer`.
+Ademas, WROX escribe un sourcemap por place en `{projectRoot}/wrox-project-sync/place_{placeId}/sourcemap.json` y mantiene el archivo representante recomendado en la raiz en `{projectRoot}/wrox-project-sync/sourcemap.json`.
+Para integraciones de editor como `luau-lsp`, se recomienda usar la ruta de la raiz. Los pasos de configuracion estan en [Usar `luau-lsp` con WROX Sync](./luau-lsp.md).
 
 ### Explorar datos sincronizados en VSCode
 
@@ -146,5 +148,6 @@ Los nombres que contienen `~` se escapan como `~~` (ej. `Part~2` → `Part~~2/`)
 
 ## Documentos relacionados
 
+- [Usar `luau-lsp` con WROX Sync](./luau-lsp.md)
 - [Cobertura de herramientas (Tools Overview)](../tools/overview.md)
-- [Guia de upgrade Pro](../pro-upgrade.md)
+- [Guia de upgrade Pro](https://weppy-web.pages.dev/en/plans)

package/docs/id/README.md

@@ -6,7 +6,7 @@
 
 [English](../../README.md) | [한국어](../ko/README.md) | [日本語](../ja/README.md) | [Español](../es/README.md) | [Português](../pt-br/README.md) | **Bahasa Indonesia**
 
-[![Demo — AI membuat game Roblox secara real-time](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
+[![Demo — AI membuat game Roblox secara real-time](https://img.youtube.com/vi/puQB4u1VlMw/maxresdefault.jpg)](https://youtu.be/puQB4u1VlMw)
 
 ## Mengapa WROX (Weppy Roblox MCP)?
 
@@ -18,6 +18,14 @@ Tidak perlu copy-paste kode. AI bekerja dan kamu memverifikasi hasilnya.
 
 ## Instalasi Cepat
 
+Install mengikuti panduan di halaman web.
+
+👉 **[Halaman Instalasi](https://weppy-web.pages.dev/en/install)**
+
+### Instalasi Terminal
+
+Jika kamu terbiasa dengan terminal, install semuanya dalam satu perintah.
+
 **macOS / Linux**
 
 ```bash
@@ -40,8 +48,8 @@ Jika eksekusi PowerShell diblokir di Windows, lanjutkan dengan instalasi manual
 
 Jika instalasi satu perintah tidak berjalan, atau instalasi otomatis tidak bisa dipakai di lingkunganmu, gunakan instalasi manual di bawah sebagai alternatif.
 
-**Langkah 1** — Install plugin Roblox Studio (jembatan antara Studio dan AI):
-[Panduan instalasi plugin](installation/roblox-plugin.md)
+**Langkah 1** — Install plugin Roblox Studio:
+[Panduan instalasi plugin](https://weppy-web.pages.dev/en/install#plugin)
 
 **Langkah 2** — Daftarkan MCP server di aplikasi AI:
 
@@ -169,7 +177,7 @@ Ya. Lihat [Setup Cursor](installation/ai-apps/cursor.md). Semua klien AI yang ko
 Ya. AI dapat membuat instance, menulis script, menghasilkan terrain, mengatur lighting, menyisipkan asset, mengkonfigurasi fisika, dan lainnya — semua di dalam sesi Studio yang sedang berjalan. Ini melampaui pembuatan kode menuju aksi yang dapat dieksekusi.
 
 ### Apa perbedaan antara Basic dan Pro?
-Basic (gratis) mencakup eksekusi alat MCP dan sinkronisasi satu arah (Studio -> Local). Pro menambahkan sinkronisasi dua arah, operasi massal, pembuatan terrain, analisis spasial, kontrol audio/animasi, dan dukungan multi-place. Lihat [Panduan Upgrade Pro](pro-upgrade.md).
+Basic (gratis) mencakup eksekusi alat MCP dan sinkronisasi satu arah (Studio -> Local). Pro menambahkan sinkronisasi dua arah, operasi massal, pembuatan terrain, analisis spasial, kontrol audio/animasi, dan dukungan multi-place. Lihat [Panduan Upgrade Pro](https://weppy-web.pages.dev/en/plans).
 
 ### Apa bedanya Weppy dengan server MCP Roblox lainnya?
 Weppy menggunakan dispatching berbasis aksi alih-alih alat terpisah untuk setiap fungsi. Ini mengurangi konsumsi token AI secara signifikan. Weppy juga menyediakan sinkronisasi proyek dua arah dan dukungan multi-place, yang tidak dimiliki kebanyakan alternatif lain.
@@ -181,7 +189,7 @@ Server hanya berjalan di localhost (127.0.0.1:3002). Path terlarang (CoreGui, Co
 
 Sync dua arah, kemampuan kreasi lanjutan, dan efisiensi token AI — semua dalam satu upgrade.
 
-[Panduan Upgrade Pro](pro-upgrade.md)
+[Panduan Upgrade Pro](https://weppy-web.pages.dev/en/plans)
 
 ## Lisensi
 

package/docs/id/installation/README.md

@@ -46,7 +46,7 @@ Jika instalasi satu perintah tidak berjalan, atau jika instalasi otomatis tidak
 
 Download file plugin dari GitHub, lalu taruh di folder Plugins Roblox Studio.
 
-👉 [Panduan Instalasi Plugin](roblox-plugin.md)
+👉 [Panduan Instalasi Plugin](https://weppy-web.pages.dev/en/install#plugin)
 
 ---
 
@@ -73,7 +73,7 @@ Daftarkan MCP server ke aplikasi AI yang kamu pakai. Bisa digunakan di semua apl
 Jelajahi tree instance yang sudah disinkronkan di dalam VSCode dengan ikon kelas Roblox.
 Ekstensi opsional ini mengharuskan setup Roblox MCP di atas sudah selesai lebih dulu, karena Explorer membaca data Sync dari `wrox-project-sync` di bawah root proyek.
 
-👉 [Panduan Instalasi WROX Roblox Explorer](roblox-explorer.md)
+👉 [Panduan Instalasi WROX Roblox Explorer](https://weppy-web.pages.dev/en/install#explorer)
 
 Instal langsung:
 - [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)

package/docs/id/pro-upgrade.md

@@ -25,9 +25,16 @@ AI dapat mengontrol playtest Roblox Studio secara langsung. AI bisa memulai dan
 - "Tulis test yang memverifikasi SpawnLocation berada di atas tanah lalu jalankan."
 - "Validasi bahwa script yang baru aku ubah berjalan tanpa error di playtest."
 
-### Kemampuan lanjutan yang lebih luas
+### Lebih banyak fitur eksklusif Pro
 
-Pembuatan terrain, pencarian aset, analisis spasial, animasi, audio, dan otomasi skala produksi.
+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
 
@@ -70,13 +77,20 @@ Kamu hanya perlu mengaktifkan lisensi sekali, baik di plugin maupun di dashboard
 
 | Fitur | Basic | Pro |
 |-------|:-----:|:---:|
-| Manajemen Script, Instance, Property | ✅ Akses penuh | ✅ Akses penuh |
-| Selection, Tag, Camera, Log | ✅ Akses penuh | ✅ Akses penuh |
-| Arah Sync | Studio → Local (satu arah) | Dua arah |
-| Sync Direction per tipe | ❌ | ✅ Scripts / Values / Containers / Data / Services |
-| Apply Mode per tipe | ❌ | ✅ Auto / Manual |
-| 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 |
+| 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

@@ -0,0 +1,41 @@
+# Menggunakan `luau-lsp` dengan WROX Sync
+
+WROX 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 WROX
+
+Setelah Full Sync selesai, WROX menulis:
+
+- Place sourcemap: `wrox-project-sync/place_<id>/sourcemap.json`
+- File perwakilan root: `wrox-project-sync/sourcemap.json`
+
+Untuk kebanyakan user, path yang direkomendasikan adalah `wrox-project-sync/sourcemap.json`.
+
+## Manfaatnya
+
+Saat `luau-lsp` membaca sourcemap dari WROX, 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 WROX membuat `wrox-project-sync/sourcemap.json`.
+2. Arahkan pengaturan sourcemap `luau-lsp` di editor kamu ke `wrox-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": "wrox-project-sync/sourcemap.json"
+}
+```
+
+## Catatan Multi-place
+
+`wrox-project-sync/sourcemap.json` mengikuti place perwakilan proyek saat ini.
+Kalau kamu butuh place yang tetap, arahkan `luau-lsp` langsung ke `wrox-project-sync/place_<id>/sourcemap.json` milik place tersebut.

package/docs/id/sync/overview.md

@@ -19,6 +19,8 @@ Tanpa Sync, AI hanya melihat potongan kode yang ditempel di chat. Dengan Sync ak
 3. Pelacakan History/Status: cek apa yang berubah, kapan, dan ke arah mana
 
 Data Sync disimpan di `{projectRoot}/wrox-project-sync/place_{placeId}/explorer`.
+Selain itu, WROX menulis sourcemap per place ke `{projectRoot}/wrox-project-sync/place_{placeId}/sourcemap.json` dan menjaga file perwakilan root yang direkomendasikan di `{projectRoot}/wrox-project-sync/sourcemap.json`.
+Untuk integrasi editor seperti `luau-lsp`, sebaiknya gunakan path root. Langkah setup dijelaskan di [Menggunakan `luau-lsp` dengan WROX Sync](./luau-lsp.md).
 
 ### Jelajahi data sync di VSCode
 
@@ -146,5 +148,6 @@ Nama yang mengandung `~` di-escape menjadi `~~` (contoh: `Part~2` → `Part~~2/`
 
 ## Dokumen terkait
 
+- [Menggunakan `luau-lsp` dengan WROX Sync](./luau-lsp.md)
 - [Cakupan tool (Tools Overview)](../tools/overview.md)
-- [Panduan Upgrade Pro](../pro-upgrade.md)
+- [Panduan Upgrade Pro](https://weppy-web.pages.dev/en/plans)