@weppy/roblox-mcp 2.5.1 → 2.6.1

package/docs/es/tools/playtest.md

@@ -1,140 +0,0 @@
-# Playtest y pruebas automatizadas
-
-> Controla el playtest de Roblox Studio con IA, inyecta scripts de prueba y genera logs y reportes locales automaticamente.
-
-## Tools incluidas
-
-| Tool | Tier | Descripcion |
-|------|:----:|-------------|
-| `system_info` | Pro | acciones `play`, `stop`, `pause`, `resume`, `play_status`, `run_test` |
-
-> Para otras acciones de `system_info` como `ping`, `connection` y `usage`, consulta [Sistema y depuracion](system-and-debugging.md).
-
-## Flujos principales
-
-### Control manual de playtest
-
-```
-"Inicia el juego en modo Play (F5)."
-"Deten el playtest actual."
-```
-
-Flujo tipico: `play` -> `play_status` -> `stop`.
-
-### Ejecutar una prueba automatizada
-
-```
-"Escribe y ejecuta una prueba que verifique si el SpawnLocation esta bien posicionado."
-```
-
-`run_test` inyecta el script de prueba, inicia el playtest automaticamente, recopila logs y hace la limpieza.
-
-### Verificacion estilo CI
-
-```
-"Ejecuta una prueba en modo Run (F8) que verifique si el NPC llega al objetivo y muestrame los logs si falla."
-```
-
-Usa `run_test` con `mode: "run"` para validaciones enfocadas en el servidor.
-
-## Maquina de estados del playtest
-
-```text
-Edit --play--> Running --stop--> Edit
-                  |               ^
-                pause             |
-                  |               |
-                  v               |
-               Paused --resume--> Running
-```
-
-| Estado | Acciones disponibles |
-|--------|----------------------|
-| `edit` | `play` |
-| `running` | `stop`, `pause` (solo modo Run) |
-| `paused` | `resume`, `stop` |
-
-- Modo Play (F5): simulacion de cliente + servidor, sin pausa ni reanudacion
-- Modo Run (F8): simulacion solo de servidor, con pausa y reanudacion
-
-## Flujo de `run_test`
-
-`run_test` orquesta estos pasos automaticamente:
-
-### 1. Preparacion
-
-- Leer informacion del place con `place_info`
-- Limpiar el buffer de logs existente
-
-### 2. Inyeccion del script
-
-- Crear `ServerScriptService.__MCP_TestRunner` con un script de prueba envuelto
-- El wrapper maneja las senales `START` y `FINISHED` y los tracebacks de error
-
-### 3. Ejecucion y monitoreo
-
-- Iniciar el playtest en modo Play o Run
-- Consultar logs cada 500 ms
-- Finalizar cuando se detecte `[WEPPY_TEST]:FINISHED`
-- Detener automaticamente al llegar al timeout (60 segundos por defecto, 300 maximo)
-
-### 4. Limpieza
-
-- Detener el playtest automaticamente
-- Eliminar el script de prueba inyectado
-- Recoger los logs finales
-
-### 5. Escritura de reportes
-
-Los reportes y logs se escriben en `{projectRoot}/weppy-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/`.
-
-```text
-{projectRoot}/weppy-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/
-├── test-report.md
-└── test-log.txt
-```
-
-Ejemplo de `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
-```
-
-## Referencia de acciones
-
-| Accion | Descripcion | Parametros | Tier |
-|--------|-------------|------------|------|
-| `play` | Iniciar playtest en modo Play (F5) o Run (F8) | `mode`: `"play"` \| `"run"` | Pro |
-| `stop` | Detener el playtest actual | - | Pro |
-| `pause` | Pausar un playtest en modo Run | - | Pro |
-| `resume` | Reanudar un playtest pausado en modo Run | - | Pro |
-| `play_status` | Obtener el estado del playtest y acciones disponibles | - | Pro |
-| `run_test` | Inyectar script de prueba, ejecutar playtest, recopilar logs y escribir reportes | `script` (obligatorio), `test_name`, `mode`, `timeout` | Pro |
-
-### Parametros de `run_test`
-
-| Parametro | Tipo | Obligatorio | Descripcion |
-|-----------|------|:-----------:|-------------|
-| `script` | string | ✅ | Cuerpo del codigo Luau de prueba a ejecutar |
-| `test_name` | string | - | Nombre mostrado en el reporte |
-| `mode` | `"play"` \| `"run"` | - | Modo de playtest, por defecto `"play"` |
-| `timeout` | number | - | Timeout en segundos, por defecto 60, maximo 300 |
-
-## Documentos relacionados
-
-- [Sistema y depuracion](system-and-debugging.md) - acciones de conexion y gestion de logs
-- [Scripting y ejecucion de codigo](scripting.md) - escribir scripts y ejecutar Luau
-- [Lista completa de tools](overview.md)

package/docs/es/tools/scripting.md

@@ -1,66 +0,0 @@
-# Scripting y ejecucion de codigo
-
-> Administra el codigo fuente de scripts y ejecuta Luau arbitrario dentro de Roblox Studio.
-
-## Tools incluidas
-
-| Tool | Tier | Descripcion |
-|------|:----:|-------------|
-| `manage_scripts` | Mixto | Crear, leer, editar, buscar y analizar dependencias de scripts |
-| `execute_luau` | Pro | Ejecutar Luau arbitrario en el sandbox de Roblox Studio |
-
-## Flujos principales
-
-### Editar un script
-
-```
-"Cambia maxPlayers de 12 a 24 en el script GameManager dentro de ServerScriptService."
-```
-
-Usa `manage_scripts.search` para encontrar la linea correcta y `manage_scripts.edit_replace` para actualizarla.
-
-### Refactorizar varios scripts (Pro)
-
-```
-"Reemplaza OldModule por NewModule en todos los scripts."
-```
-
-Usa `manage_scripts.replace` para aplicar el cambio en varios scripts en una sola solicitud.
-
-### Inspeccionar datos de runtime (Pro)
-
-```
-"Calcula la salud promedio de todos los Humanoid que estan en Workspace."
-```
-
-Usa `execute_luau` para ejecutar Luau personalizado y leer datos del runtime actual.
-
-## Referencia de acciones
-
-### Manage Scripts (Mixto)
-
-| Accion | Descripcion | Tier |
-|--------|-------------|------|
-| `get_source` | Obtener codigo fuente del script | Basic |
-| `set_source` | Definir codigo fuente del script | Basic |
-| `create` | Crear un script nuevo | Basic |
-| `delete` | Eliminar un script | Basic |
-| `edit_replace` | Reemplazar lineas especificas en un script | Basic |
-| `edit_insert` | Insertar lineas en una posicion | Basic |
-| `edit_delete` | Eliminar lineas especificas | Basic |
-| `search` | Buscar texto en scripts | Basic |
-| `get_dependencies` | Obtener dependencias de un script | Basic |
-| `replace` | Reemplazo masivo en scripts | Pro |
-
-### Execute Luau (Pro)
-
-Ejecuta Luau arbitrario dentro del sandbox de Roblox Studio.
-
-- Servicios bloqueados: `HttpService`, `DataStoreService`, `MessagingService`
-- APIs inaccesibles: `CoreGui`, `CorePackages`
-
-## Documentos relacionados
-
-- [Instancias y propiedades](instances-and-properties.md) - crear o mover instancias de script
-- [Playtest y pruebas automatizadas](playtest.md) - inyectar y ejecutar scripts de prueba
-- [Lista completa de tools](overview.md)

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

@@ -1,93 +0,0 @@
-# Sistema y depuracion
-
-> Verifica la conexion, administra logs, controla la seleccion de Studio y ejecuta lotes para flujos de depuracion.
-
-## Tools incluidas
-
-| Tool | Tier | Descripcion |
-|------|:----:|-------------|
-| `system_info` | Mixto | `ping`, `connection`, `usage`, `place_info`, `services`, `studio_settings` |
-| `manage_logs` | Basic | Consultar logs, limpiar buffers y filtrar errores recientes |
-| `manage_selection` | Mixto | Leer, reemplazar y monitorear la seleccion de Studio |
-| `batch_execute` | Pro | Ejecutar varios comandos en un solo lote |
-
-> Para las acciones de playtest de `system_info` como `play`, `stop` y `run_test`, consulta [Playtest y pruebas automatizadas](playtest.md).
-
-## Flujos principales
-
-### Verificar la conexion
-
-```
-"Comprueba si Studio esta conectado correctamente."
-```
-
-Usa `system_info.ping` para una verificacion rapida.
-
-### Depurar errores recientes
-
-```
-"Muestrame los errores mas recientes."
-```
-
-Usa `manage_logs.errors` para obtener solo los errores recientes. `manage_logs.get` tambien soporta consulta incremental con el cursor `sinceSeq`.
-
-### Ejecutar un flujo por lotes (Pro)
-
-```
-"Cambia a rojo todos los Part de Workspace y luego enfoca la camara en el primero."
-```
-
-Usa `batch_execute` para agrupar varios comandos en una sola solicitud.
-
-## Referencia de acciones
-
-### System Info (Mixto)
-
-| Accion | Descripcion | Tier |
-|--------|-------------|------|
-| `ping` | Probar la conexion | Basic |
-| `connection` | Obtener informacion de conexion del servidor y plugin | Basic |
-| `usage` | Obtener el tier actual (`basic` o `pro`) | Basic |
-| `place_info` | Obtener Place ID, nombre y creador | Pro |
-| `services` | Listar todos los servicios de Roblox | Pro |
-| `studio_settings` | Obtener preferencias de Studio | Pro |
-
-### Manage Logs (Basic)
-
-| Accion | Descripcion | Tier |
-|--------|-------------|------|
-| `get` | Obtener logs filtrados con soporte opcional de cursor `sinceSeq` | Basic |
-| `clear` | Limpiar el buffer de logs | Basic |
-| `errors` | Obtener solo errores recientes | Basic |
-
-### Manage Selection (Mixto)
-
-| Accion | Descripcion | Tier |
-|--------|-------------|------|
-| `get` | Obtener la seleccion actual | Basic |
-| `set` | Reemplazar la seleccion actual | Basic |
-| `clear` | Limpiar la seleccion | Basic |
-| `cached` | Obtener la seleccion cacheada sin round-trip | Basic |
-| `context` | Obtener contexto detallado con codigo fuente y propiedades | Pro |
-| `details` | Obtener detalles jerarquicos con ancestros y descendientes | Pro |
-| `add` | Agregar elementos a la seleccion | Pro |
-| `remove` | Quitar elementos de la seleccion | Pro |
-| `watch` | Monitorear cambios de seleccion | Pro |
-
-### Manage Context (Basic)
-
-| Accion | Descripcion | Tier |
-|--------|-------------|------|
-| `begin` | Inicia un contexto de ejecucion estructurado para el alcance actual de sesion/place | Basic |
-| `update` | Actualiza la intencion, las areas afectadas o los metadatos de replay del contexto activo | Basic |
-| `end` | Cierra el contexto de ejecucion activo y guarda el snapshot final | Basic |
-
-### Batch Execute (Pro)
-
-Ejecuta varios comandos en un solo lote. Cada comando incluye nombre de tool y argumentos, se ejecuta en orden y puede continuar despues de errores si se configura asi.
-
-## Documentos relacionados
-
-- [Playtest y pruebas automatizadas](playtest.md) - acciones de playtest en `system_info`
-- [Scripting y ejecucion de codigo](scripting.md) - ejecutar Luau para investigacion y depuracion
-- [Lista completa de tools](overview.md)

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

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

@@ -1,209 +0,0 @@
-# Roblox MCP — Server MCP untuk Roblox Studio | Pengembangan Game AI dengan Claude, Codex, Cursor & Gemini
-
-> **WEPPY** adalah server MCP yang memungkinkan agen pengkodean AI mengontrol sesi Roblox Studio secara langsung — buat dan edit script, instance, terrain, lighting, asset, audio, dan animasi dengan bahasa alami.
-
-**Alat terkonsolidasi berbasis aksi · Sync dua arah · Playtest otomatis · Dukungan multi-place**
-
-[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/puQB4u1VlMw/maxresdefault.jpg)](https://youtu.be/puQB4u1VlMw)
-
-## Mengapa WEPPY (Weppy Roblox MCP)?
-
-Agen pengkodean AI seperti Claude, Codex, dan Gemini sangat kuat — tetapi tidak bisa melihat atau mengubah apa pun di dalam Roblox Studio. DataModel, script, terrain, dan lighting semuanya tidak terlihat oleh alat eksternal. Tanpa jembatan, AI hanya bisa menghasilkan potongan kode yang harus kamu tempelkan secara manual.
-
-**WEPPY** adalah jembatan antara agen AI dan Roblox Studio. AI langsung membuat dan memodifikasi instance, script, properti, terrain, dan lainnya di dalam Studio, dan perubahan langsung tercermin di Studio dan dashboard sehingga kamu bisa **melihat persis apa yang berubah**.
-
-Tidak perlu copy-paste kode. AI bekerja dan kamu memverifikasi hasilnya.
-
-## Instalasi Cepat
-
-Install mengikuti panduan di halaman web.
-
-👉 **[Halaman Instalasi](https://weppyai.com/en/install)**
-
-### Instalasi Terminal
-
-Jika kamu terbiasa dengan terminal, install semuanya dalam satu perintah.
-
-**macOS / Linux**
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
-```
-
-**Windows (PowerShell)**
-
-```powershell
-irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
-```
-
-Restart Roblox Studio — selesai!
-
-Pendaftaran MCP otomatis mendukung **Claude Code, Claude Desktop, Cursor, Codex CLI/App, Gemini CLI, dan Antigravity**.
-
-Jika eksekusi PowerShell diblokir di Windows, lanjutkan dengan instalasi manual di bawah. Jika kamu memakai paket ZIP, kamu juga bisa memakai `setup-plugin.bat` dan `setup-mcp.bat`.
-
-### 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:
-[Panduan instalasi plugin](installation/roblox-plugin.md)
-
-**Langkah 2** — Daftarkan MCP server di aplikasi AI:
-
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-| Aplikasi AI | Panduan |
-|-------------|---------|
-| Claude Code | [Setup](installation/ai-apps/claude-code.md) |
-| Claude Desktop | [Setup](installation/ai-apps/claude-app.md) |
-| Cursor | [Setup](installation/ai-apps/cursor.md) |
-| Codex CLI | [Setup](installation/ai-apps/codex-cli.md) |
-| Codex Desktop | [Setup](installation/ai-apps/codex-app.md) |
-| Gemini CLI | [Setup](installation/ai-apps/gemini-cli.md) |
-| Antigravity | [Setup](installation/ai-apps/antigravity.md) |
-
-> Bekerja dengan semua klien MCP yang kompatibel. Perintah server: `npx -y @weppy/roblox-mcp`
-
-## Kompatibilitas
-
-| Claude Code | Claude Desktop | Cursor | Codex CLI | Gemini CLI | Antigravity |
-|:-----------:|:--------------:|:------:|:---------:|:----------:|:-----------:|
-| ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
-
-**Persyaratan:** Node.js 18+, Roblox Studio, Windows 10+ atau macOS 12+
-
-## Fitur utama
-
-### 1) MCP Tool: eksekusi langsung di Studio dari bahasa alami
-
-AI bisa langsung menangani script, instance, properti, terrain, lighting, asset, audio, dan animasi di dalam Studio.
-
-- "Tambahkan partikel + suara + cooldown saat player melompat."
-- "Buat arena boss di tengah map dan pasang spawn point yang aman dari tabrakan."
-- "Ubah interface modul ini dan perbarui semua script yang bergantung padanya."
-
-### 2) Sync: menjaga konteks penuh proyek untuk AI
-
-AI bekerja dari mirror lokal yang tersinkron, jadi perubahan lintas banyak file tetap konsisten.
-
-- Basic: sinkronisasi satu arah (Studio -> Local)
-- Pro: sinkronisasi dua arah + Direction/Apply Mode per tipe + riwayat + multiplace
-
-![Alur Sync — Studio dan file lokal tersinkron secara real time](../assets/screenshots/plugin/sync/sync-overview.png)
-
-### 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."
-
-![WEPPY Playtest Dashboard — riwayat tes dan laporan detail](../assets/screenshots/dashboard/dashboard_playtest.png)
-
-### 4) WEPPY Dashboard: pantau pekerjaan AI secara real-time
-
-Dashboard berbasis web yang disediakan server MCP memungkinkan Anda melihat status koneksi, riwayat eksekusi alat, status sinkronisasi, dan riwayat perubahan game secara real-time.
-
-- Lihat status koneksi server/plugin/agen dalam satu pandangan
-- Bandingkan semua perubahan yang dilakukan AI dengan Before & After di Changelog
-- Analisis alur kerja dengan riwayat dan statistik eksekusi alat
-
-![WEPPY WEPPY Dashboard Overview — status server, perubahan terbaru, ringkasan sesi](../assets/screenshots/dashboard/dashboard_overview.png)
-
-### 5) WEPPY 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.
-WEPPY Roblox Explorer adalah ekstensi pendamping VSCode untuk data sync yang dihasilkan oleh WEPPY. Penjelajahan tree dasar bekerja dari file yang sudah tersinkron di disk, dan indikator live untuk status sync atau direction menjadi lebih lengkap saat server MCP lokal sedang berjalan.
-Instal dari [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer) atau [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer).
-
-- Ikon class yang sama dengan Studio untuk pengenalan instan
-- Klik untuk membuka script dan file properti yang tersinkron
-- Dukungan multiplace dengan indikator status sinkronisasi
-
-![WEPPY Roblox Explorer — pohon instance Studio ditampilkan di sidebar VSCode](../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
-
-## Nilai yang langsung terasa
-
-- Ringkas pekerjaan berulang: banyak edit manual jadi satu perintah
-- Ubah file terkait sekaligus: bukan hanya satu file target
-- Risiko lebih rendah: putuskan perubahan dari status sync dan riwayat
-- Efisiensi token lebih baik (Pro): kurangi bolak-balik dengan aksi massal
-
-## Kasus penggunaan
-
-- **Prototipe cepat**: Jelaskan mekanik game dalam bahasa alami dan lihat AI membuatnya di Studio
-- **Refaktor massal**: Ubah nama interface modul dan perbarui semua script dependen dalam satu permintaan
-- **Terrain & lingkungan**: Hasilkan terrain prosedural, atur lighting/atmosfer, tempatkan asset — semua dari satu prompt
-- **Konsistensi multi-file**: AI membaca seluruh proyek via Sync dan menerapkan perubahan di script terkait secara bersamaan
-- **Integrasi asset**: Cari di Creator Store, sisipkan model, dan konfigurasi properti tanpa meninggalkan editor
-
-## Dokumen detail
-
-- [Panduan instalasi](installation/README.md)
-- [Daftar tool lengkap](tools/overview.md)
-- [Panduan detail Sync](sync/overview.md)
-- [Panduan dashboard](dashboard/overview.md)
-- [Panduan lengkap WEPPY Roblox Explorer](explorer/overview.md)
-- [Instalasi WEPPY Roblox Explorer](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
-
-## FAQ
-
-### Bagaimana cara menghubungkan Claude Code ke Roblox Studio?
-Install plugin Roblox Studio, lalu daftarkan MCP server (`npx -y @weppy/roblox-mcp`) di Claude Code. Claude dapat langsung membaca dan menulis script di dalam Studio. Lihat [Setup Claude Code](installation/ai-apps/claude-code.md).
-
-### Bagaimana cara menggunakan Codex CLI dengan Roblox Studio?
-Install plugin, lalu tambahkan konfigurasi MCP server ke Codex CLI. Lihat [Setup Codex CLI](installation/ai-apps/codex-cli.md).
-
-### Apakah Roblox MCP bekerja dengan Cursor?
-Ya. Lihat [Setup Cursor](installation/ai-apps/cursor.md). Semua klien AI yang kompatibel MCP bisa dipakai.
-
-### Bisakah AI membuat game Roblox dengan ini?
-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](https://weppyai.com/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.
-
-### Apakah aman? Bisakah AI merusak game saya?
-Server hanya berjalan di localhost (127.0.0.1:3002). Path terlarang (CoreGui, CorePackages) diblokir. Rate limiting (450 req/min) dan timeout 30 detik mencegah operasi yang tidak terkendali. Semua perubahan bisa dilacak melalui riwayat sinkronisasi.
-
-## Upgrade Pro
-
-Sync dua arah, kemampuan kreasi lanjutan, dan efisiensi token AI — semua dalam satu upgrade.
-
-[Panduan Upgrade Pro](https://weppyai.com/en/plans)
-
-## Lisensi
-
-Repositori ini dilisensikan di bawah `AGPL-3.0`.
-
-Lisensi komersial tersedia secara terpisah. Lihat [COMMERCIAL-LICENSE.md](../../COMMERCIAL-LICENSE.md).
-
-Penggunaan nama dan logo Weppy diatur oleh [TRADEMARKS.md](../../TRADEMARKS.md).
-
----
-
-[![npm version](https://img.shields.io/npm/v/@weppy/roblox-mcp)](https://www.npmjs.com/package/@weppy/roblox-mcp) [![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org/) [![Smithery](https://smithery.ai/badge/@hope1026/weppy-roblox-mcp)](https://smithery.ai/server/@hope1026/weppy-roblox-mcp)
-
-[![Roblox MCP on Glama](https://glama.ai/mcp/servers/hope1026/roblox-mcp/badges/card.svg)](https://glama.ai/mcp/servers/hope1026/roblox-mcp)
-
-[GitHub Issues](https://github.com/hope1026/weppy-roblox-mcp/issues) · [Discussions](https://github.com/hope1026/weppy-roblox-mcp/discussions) · [npm](https://www.npmjs.com/package/@weppy/roblox-mcp)