@weppy/roblox-mcp 2.2.2 → 2.3.1

package/docs/es/pro-upgrade.md

@@ -25,9 +25,16 @@ La IA puede controlar los playtests de Roblox Studio de forma directa. Puede ini
 - "Escribe un test que compruebe si el SpawnLocation está sobre el suelo y ejecútalo."
 - "Valida que el script que acabo de cambiar funciona sin errores en el playtest."
 
-### Capacidades avanzadas más amplias
+### Más funciones exclusivas de Pro
 
-Generación de terreno, búsqueda de assets, análisis espacial, animación, audio y automatización a escala de producción.
+Pro desbloquea funciones adicionales más allá del flujo de trabajo principal.
+
+- **Operaciones masivas** — Crear, modificar o eliminar múltiples instancias en una sola solicitud
+- **Generación de terreno** — Rellenar con bloque, esfera, cilindro, cuña y reemplazar materiales
+- **Búsqueda/inserción de assets** — Buscar en el marketplace de Roblox e insertar assets directamente
+- **Análisis espacial** — Raycast, encontrar suelo, búsqueda de área plana, detección de colisiones
+- **Control de entorno** — Iluminación, atmósfera, cielo y hora del día
+- **Audio/Animación** — Reproducción de sonido y carga/reproducción de animaciones
 
 ## Compra y activación
 
@@ -70,13 +77,20 @@ Solo necesitas activar la licencia una vez, ya sea en el plugin o en el dashboar
 
 | Función | Basic | Pro |
 |---------|:-----:|:---:|
-| Gestión de Script, Instance, Property | ✅ Acceso completo | ✅ Acceso completo |
-| Selection, Tag, Camera, Log | ✅ Acceso completo | ✅ Acceso completo |
-| Dirección de Sync | Studio → Local (una vía) | Bidireccional |
-| Sync Direction por tipo | ❌ | ✅ Scripts / Values / Containers / Data / Services |
-| Apply Mode por tipo | ❌ | ✅ Auto / Manual |
-| Historial de cambios | ❌ | ✅ |
-| Sync multi-place | ❌ | ✅ Hasta 3 places con almacenamiento aislado |
-| Control de Playtest (Reproducir/Detener/Pausar/Reanudar) | ❌ | ✅ |
-| Cobertura avanzada de tools | Conjunto base | Conjunto avanzado más amplio |
-| Eficiencia de tokens IA | Estándar | Mejor con acciones masivas / de alto impacto |
+| Creación/edición de scripts | ✅ | ✅ |
+| Crear/eliminar/mover instancias | ✅ | ✅ + operaciones masivas |
+| Leer/modificar propiedades | ✅ | ✅ + cambios masivos |
+| Selección, tags, búsqueda | ✅ | ✅ |
+| Control de cámara | ✅ | ✅ |
+| Monitoreo de logs | ✅ | ✅ |
+| Ejecución de código Luau | ✅ | ✅ |
+| Sincronización de proyecto | Studio → Local una vía | Bidireccional + dirección/modo por tipo |
+| Sync multi-place | — | Hasta 3 Places simultáneamente |
+| Historial de cambios | — | Rastreo de cambios antes de aplicar |
+| Control de playtest | — | Reproducir / detener / pausar / reanudar + tests automáticos |
+| Generación/edición de terreno | — | Bloque, esfera, cilindro, cuña, reemplazo de material |
+| Búsqueda/inserción de assets | — | Buscar en marketplace de Roblox e insertar directamente |
+| Análisis espacial | — | Raycast, encontrar suelo, detección de colisiones |
+| Control de entorno | — | Iluminación, atmósfera, cielo, hora del día |
+| Audio / Animación | — | Reproducción de sonido, carga/reproducción de animaciones |
+| Eficiencia de tokens IA | Acciones individuales | Menos llamadas con acciones masivas |

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

@@ -0,0 +1,41 @@
+# Usar `luau-lsp` con WROX Sync
+
+WROX Sync puede generar automaticamente los archivos sourcemap que necesita `luau-lsp`, para que puedas activar funciones de editor con contexto de Roblox sin preparar un proyecto Rojo aparte.
+
+## Que escribe WROX
+
+Despues de que termina Full Sync, WROX escribe:
+
+- Place sourcemap: `wrox-project-sync/place_<id>/sourcemap.json`
+- Archivo representante en la raiz: `wrox-project-sync/sourcemap.json`
+
+Para la mayoria de usuarios, la ruta recomendada es `wrox-project-sync/sourcemap.json`.
+
+## Que mejora
+
+Cuando `luau-lsp` usa el sourcemap de WROX, mejora:
+
+- Autocomplete de `game.*`
+- Navegacion entre scripts sincronizados
+- Resolucion de `require` entre scripts sincronizados
+
+## Configuracion recomendada
+
+1. Ejecuta Full Sync una vez para que WROX cree `wrox-project-sync/sourcemap.json`.
+2. Haz que la configuracion de sourcemap de `luau-lsp` en tu editor apunte a `wrox-project-sync/sourcemap.json`.
+3. Si tu cliente puede desactivar la generacion automatica con Rojo, establece `luau-lsp.sourcemap.autogenerate` en `false`.
+
+Ejemplo de configuracion en VSCode:
+
+```json
+{
+  "luau-lsp.sourcemap.enabled": true,
+  "luau-lsp.sourcemap.autogenerate": false,
+  "luau-lsp.sourcemap.sourcemapFile": "wrox-project-sync/sourcemap.json"
+}
+```
+
+## Nota sobre Multi-place
+
+`wrox-project-sync/sourcemap.json` sigue el place representante actual del proyecto.
+Si necesitas fijarlo a un place especifico, apunta `luau-lsp` directamente a `wrox-project-sync/place_<id>/sourcemap.json`.

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,7 +18,13 @@ Tidak perlu copy-paste kode. AI bekerja dan kamu memverifikasi hasilnya.
 
 ## Instalasi Cepat
 
-**Instalasi satu perintah** — Install MCP server, plugin Roblox Studio, dan daftarkan ke aplikasi AI dalam satu langkah:
+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**
 
@@ -42,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:
 
@@ -171,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.
@@ -183,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

@@ -16,7 +16,7 @@ Ketika aplikasi AI bilang "buatkan part biru", MCP server mengonversi perintah i
 
 ## Instalasi Satu Perintah (Direkomendasikan)
 
-Install MCP server, plugin Roblox Studio, dan daftarkan ke aplikasi AI dalam satu langkah:
+Install semuanya dengan satu perintah:
 
 **macOS / Linux**
 
@@ -40,13 +40,13 @@ Jika eksekusi PowerShell diblokir di Windows, lanjutkan dengan instalasi manual
 
 ## Instalasi Manual
 
-Ini adalah metode alternatif jika instalasi satu perintah tidak berjalan, atau jika instalasi otomatis tidak bisa dipakai di lingkunganmu.
+Jika instalasi satu perintah tidak berjalan, atau jika instalasi otomatis tidak bisa dipakai di lingkunganmu, gunakan instalasi manual di bawah sebagai alternatif.
 
 ### Langkah 1: Install Plugin Roblox Studio
 
 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)