@weppy/roblox-mcp 1.5.5 → 2.0.1

package/docs/id/dashboard/changelog.md

@@ -0,0 +1,114 @@
+# Changelog
+
+> Mencatat semua perubahan yang dilakukan AI di Roblox Studio per sesi, dan menyediakan ringkasan perubahan/timeline/Before & After.
+
+![Changelog — daftar kartu perubahan per sesi](../../assets/screenshots/dashboard/dashboard_changelog1.png)
+
+## Ikhtisar
+
+Changelog adalah halaman yang melacak riwayat perubahan game yang dilakukan agen AI di Studio. Perubahan dikelompokkan berdasarkan sesi, sehingga Anda dapat melihat sekilas jenis dan jumlah perubahan yang terjadi di setiap sesi.
+
+## Daftar Kartu Sesi
+
+Layar utama Changelog menampilkan daftar kartu per sesi.
+
+### Status Sesi
+
+Setiap kartu sesi menampilkan status:
+
+| Status | Arti |
+|--------|------|
+| **Active** | Sesi yang sedang berlangsung (pembaruan real-time) |
+| **Completed** | Sesi yang telah selesai |
+| **Bootstrap** | Sesi sinkronisasi awal |
+
+### Ringkasan Sesi
+
+Setiap kartu merangkum jumlah perubahan sesi tersebut per kategori:
+
+- Script — jumlah pembuatan/pengeditan script
+- Instance — jumlah pembuatan/penghapusan/pemindahan instance
+- Property — jumlah perubahan properti
+- Lighting — jumlah pengaturan pencahayaan/lingkungan
+- Terrain — jumlah perubahan terrain
+- Asset — jumlah penyisipan aset
+
+### Tab Filter
+
+Anda dapat memfilter sesi menggunakan tab di bagian atas:
+- **All** — semua sesi
+- **Active** — hanya sesi yang sedang berlangsung
+- **Completed** — hanya sesi yang telah selesai
+
+## Tampilan Detail Sesi
+
+Klik kartu sesi untuk masuk ke tampilan detail.
+
+![Tampilan detail Changelog — ringkasan perubahan, timeline, Before & After](../../assets/screenshots/dashboard/dashboard_changelog2.png)
+
+### Change Summary
+
+Memvisualisasikan perubahan sesi dalam 6 kartu kategori:
+
+| Kategori | Ikon | Deskripsi |
+|----------|------|-----------|
+| Scripts | Script | Jumlah pembuatan/pengeditan script |
+| Instances | Instance | Jumlah pembuatan/penghapusan/pemindahan instance |
+| Properties | Properti | Jumlah perubahan properti |
+| Lighting | Pencahayaan | Jumlah perubahan pencahayaan/lingkungan |
+| Terrain | Terrain | Jumlah perubahan terrain |
+| Assets | Aset | Jumlah penyisipan aset |
+
+### Change Timeline
+
+Menampilkan semua perubahan dalam sesi secara kronologis.
+
+- Setiap item menampilkan timestamp, tag kategori perubahan, dan path target
+- Gunakan dropdown **Category** untuk memfilter kategori tertentu
+- Klik item untuk membuka tampilan perbandingan Before & After
+
+### Before & After
+
+Membandingkan data sebelum dan sesudah perubahan. Tingkat informasi berbeda tergantung jenis perubahan:
+
+| Tingkat Kepercayaan | Arti | Contoh |
+|---------------------|------|--------|
+| **exact** | Nilai sebelum dan sesudah tercatat dengan tepat | Perubahan properti, pengeditan script |
+| **partial** | Hanya sebagian informasi yang tercatat | Perubahan kompleks |
+| **after-only** | Hanya nilai sesudah yang tersedia | Pembuatan instance baru |
+| **intent-only** | Hanya niat yang tercatat | Penghapusan, dll. |
+
+## Contoh Penggunaan
+
+### Verifikasi Pekerjaan
+
+```
+"Saya ingin mengecek script apa saja yang baru saja dimodifikasi oleh AI"
+```
+
+Filter kategori Script pada sesi Active di Changelog untuk melihat daftar script yang dimodifikasi dan membandingkan kode sebelum dan sesudah.
+
+### Pelacakan Perubahan
+
+```
+"Saya ingin melihat kembali bagaimana Lighting diatur di sesi kemarin"
+```
+
+Cari sesi tersebut di tab Completed dan filter berdasarkan kategori Lighting untuk melihat riwayat perubahan dan nilai pengaturan.
+
+### Debugging Masalah
+
+```
+"Saya perlu menemukan kapan instance tertentu dihapus"
+```
+
+Filter kategori Instance di timeline dan lacak perubahan tipe delete secara kronologis.
+
+## Dokumen Terkait
+
+- [Dashboard Overview](overview.md)
+- [Connection](connection.md)
+- [Sync](sync.md)
+- [Playtest](playtest.md)
+- [Tools](tools.md)
+- [Settings](settings.md)

package/docs/id/dashboard/connection.md

@@ -0,0 +1,77 @@
+# Connection
+
+> Pantau status koneksi server, agen AI, dan plugin di satu tempat.
+
+![Connection — status server, agen AI, informasi koneksi plugin](../../assets/screenshots/dashboard/dashboard_connection.png)
+
+## Ikhtisar
+
+Halaman Connection memantau semua status koneksi sistem MCP di satu tempat. Halaman ini selalu dapat diakses selama server terhubung (L1 ke atas).
+
+## Server Status
+
+Menampilkan informasi inti server:
+
+| Item | Deskripsi |
+|------|-----------|
+| Status | Badge status koneksi (Online/Offline) |
+| Version | Versi server MCP |
+| PID | ID proses server |
+| Uptime | Waktu aktif server |
+| Session ID | Identifier sesi saat ini |
+| Exec Path | Path eksekusi server |
+
+## AI Agents
+
+Menampilkan daftar agen AI yang sedang terhubung dalam bentuk tabel:
+
+| Kolom | Deskripsi |
+|-------|-----------|
+| Name | Nama agen (contoh: Claude Code) |
+| PID | ID proses agen |
+| Working Dir | Direktori kerja agen |
+| Connected | Waktu sejak terhubung |
+
+Jika beberapa agen terhubung secara bersamaan, semuanya akan ditampilkan.
+
+## Plugins
+
+Menampilkan daftar plugin Roblox Studio yang terhubung:
+
+| Kolom | Deskripsi |
+|-------|-----------|
+| Place | Nama Place |
+| Client ID | Identifier klien plugin |
+| Last Seen | Waktu komunikasi terakhir |
+| Version | Versi plugin |
+
+## Connection Log
+
+Menampilkan event terkait koneksi secara real-time. Event koneksi/pemutusan agen/plugin ditambahkan secara otomatis melalui SSE.
+
+## Contoh Penggunaan
+
+### Diagnosis Masalah Koneksi
+
+```
+"Sepertinya AI tidak terhubung dengan Studio"
+```
+
+Periksa apakah Server Status menunjukkan Online dan apakah plugin muncul di tabel Plugins. Anda dapat melacak event koneksi/pemutusan di Connection Log.
+
+### Konfirmasi Agen
+
+```
+"Saya ingin melihat AI mana yang sedang terhubung"
+```
+
+Periksa nama, PID, dan direktori kerja agen yang sedang terhubung di tabel AI Agents.
+
+## Dokumen Terkait
+
+- [Dashboard Overview](overview.md)
+- [Changelog](changelog.md)
+- [Sync](sync.md)
+- [Playtest](playtest.md)
+- [Tools](tools.md)
+- [Settings](settings.md)

package/docs/id/dashboard/overview.md

@@ -0,0 +1,95 @@
+# Dashboard
+
+> Pantau dan kelola status, koneksi, sinkronisasi, riwayat eksekusi alat, dan riwayat perubahan game dari server MCP secara real-time melalui browser web.
+
+![Dashboard Overview — status server, perubahan terbaru, dan ringkasan sesi dalam satu tampilan](../../assets/screenshots/dashboard/dashboard_overview.png)
+
+## Apa itu Dashboard?
+
+Dashboard adalah antarmuka pemantauan berbasis web yang disediakan oleh server MCP. Saat server MCP dijalankan, dashboard akan terbuka secara otomatis di browser, memungkinkan Anda melacak semua operasi yang dilakukan agen AI di Roblox Studio secara real-time.
+
+- Pahami status secara visual tanpa perlu menelusuri log terminal
+- Lacak apa saja yang diubah AI di Studio melalui riwayat perubahan
+- Lihat status sinkronisasi, status koneksi, dan statistik eksekusi alat di satu tempat
+
+## Struktur Halaman
+
+| Halaman | Deskripsi | Panduan Detail |
+|---------|-----------|----------------|
+| [Overview](#overview) | Kartu status Server/Plugin/Agent/Sync, feed perubahan terbaru | Dokumen ini |
+| [Changelog](changelog.md) | Riwayat perubahan game — kartu per sesi, ringkasan perubahan, timeline, Before & After | [Panduan detail](changelog.md) |
+| [Connection](connection.md) | Status server, daftar agen AI, informasi koneksi plugin | [Panduan detail](connection.md) |
+| [Sync](sync.md) | Status sinkronisasi, pengaturan arah, log | [Panduan detail](sync.md) |
+| [Playtest](playtest.md) | Status playtest, riwayat pengujian | [Panduan detail](playtest.md) |
+| [Tools](tools.md) | Riwayat eksekusi alat, statistik, distribusi tier | [Panduan detail](tools.md) |
+| [Settings](settings.md) | Lisensi, level log, pengaturan Sync, bahasa | [Panduan detail](settings.md) |
+
+## Cara Mengakses
+
+Saat server MCP dijalankan, dashboard akan terbuka secara otomatis di browser. Untuk mengakses secara manual:
+
+```
+http://localhost:3002
+```
+
+> Atur `DASHBOARD_AUTO_OPEN=false` untuk menonaktifkan pembukaan otomatis (lihat halaman [Settings](settings.md)).
+
+## Level Koneksi
+
+Fitur yang tersedia di dashboard berbeda tergantung pada status koneksi:
+
+| Level | Kondisi | Halaman yang Tersedia |
+|:-----:|---------|----------------------|
+| **L0** | Server tidak terhubung | Hanya menampilkan layar menunggu koneksi ulang |
+| **L1** | Server terhubung, plugin tidak terhubung | Connection, Tools, Settings |
+| **L2** | Server + Plugin keduanya terhubung | Semua halaman |
+
+Saat plugin belum terhubung (L1), halaman Overview, Changelog, Sync, dan Playtest tidak dapat diakses.
+
+## Overview
+
+Halaman Overview adalah layar utama dashboard yang menampilkan status keseluruhan sistem dalam satu pandangan.
+
+### Kartu Status
+
+| Kartu | Informasi yang Ditampilkan |
+|-------|---------------------------|
+| **Server** | Status koneksi server (Online/Offline) |
+| **Plugin** | Status koneksi plugin, informasi Place |
+| **Agent** | Nama agen AI yang sedang terhubung |
+| **Sync** | Status sinkronisasi (Idle/Syncing/Error) |
+
+### Perubahan Game Terbaru (Recent Game Changes)
+
+Menampilkan perubahan terbaru yang dilakukan AI di Studio secara real-time (maksimal 20 item). Setiap item ditampilkan dengan ikon kategori perubahan, dan mengkliknya akan membawa Anda ke tampilan detail di [Changelog](changelog.md).
+
+Ikon kategori:
+- Script — pembuatan/pengeditan script
+- Instance — pembuatan/penghapusan/pemindahan instance
+- Property — perubahan properti
+- Lighting — pengaturan pencahayaan/lingkungan
+- Terrain — perubahan terrain
+- Asset — penyisipan aset
+
+### Ringkasan Perubahan Sesi (Session Change Summary)
+
+Menampilkan statistik perubahan sesi saat ini yang diagregasi per kategori (contoh: "4 scripts - 3 properties").
+
+## Pembaruan Real-time
+
+Dashboard menggunakan SSE (Server-Sent Events) untuk memperbarui data secara real-time:
+
+- Status server: polling setiap 5 detik
+- Feed perubahan, event koneksi: streaming real-time via SSE
+- Saat koneksi SSE terputus: koneksi ulang otomatis setelah 3 detik
+
+## Dokumen Terkait
+
+- [Changelog](changelog.md) — pelacakan riwayat perubahan game
+- [Connection](connection.md) — status koneksi server/agen/plugin
+- [Sync](sync.md) — pemantauan status sinkronisasi
+- [Playtest](playtest.md) — riwayat playtest
+- [Tools](tools.md) — riwayat/statistik eksekusi alat
+- [Settings](settings.md) — lisensi, pengaturan server, bahasa
+- [Daftar tool lengkap](../tools/overview.md)
+- [Panduan detail fitur Sync](../sync/overview.md)

package/docs/id/dashboard/playtest.md

@@ -0,0 +1,61 @@
+# Playtest
+
+> Periksa status playtest yang dijalankan AI dan hasil pengujian.
+
+![Playtest — status playtest dan riwayat pengujian](../../assets/screenshots/dashboard/dashboard_playtest.png)
+
+## Ikhtisar
+
+Halaman Playtest menampilkan status dan hasil pengujian dari playtest yang dijalankan AI. Halaman ini hanya dapat diakses saat plugin terhubung (L2).
+
+## Playtest Status
+
+Menampilkan status playtest saat ini:
+
+| Status | Arti |
+|--------|------|
+| **NotRunning** | Playtest tidak berjalan |
+| **Running** | Playtest sedang berjalan |
+| **Paused** | Playtest dijeda (mode Run) |
+
+## Test History
+
+Menampilkan hasil pengujian yang dijalankan AI melalui aksi `run_test` secara kronologis:
+
+| Item | Deskripsi |
+|------|-----------|
+| Timestamp | Waktu eksekusi pengujian |
+| Test Report | Tautan ke laporan pengujian |
+| Mode | Mode eksekusi (play/run) |
+| Duration | Durasi pengujian |
+| Status | Hasil (Passed/Failed) |
+
+Klik laporan pengujian untuk melihat laporan detail dalam format markdown beserta log.
+
+## Contoh Penggunaan
+
+### Analisis Kegagalan Pengujian
+
+```
+"Saya ingin mencari penyebab kegagalan pengujian otomatis yang baru saja dijalankan"
+```
+
+Cari pengujian dengan status Failed di Test History dan klik Test Report untuk melihat log detail dan penyebab kegagalan.
+
+### Memeriksa Riwayat Pengujian
+
+```
+"Saya ingin melihat status keberhasilan/kegagalan pengujian yang dijalankan hari ini"
+```
+
+Periksa timestamp dan Status di Test History untuk memahami tren hasil pengujian.
+
+## Dokumen Terkait
+
+- [Dashboard Overview](overview.md)
+- [Changelog](changelog.md)
+- [Connection](connection.md)
+- [Sync](sync.md)
+- [Tools](tools.md)
+- [Settings](settings.md)
+- [Playtest & tes otomatis (alat)](../tools/playtest.md)

package/docs/id/dashboard/settings.md

@@ -0,0 +1,67 @@
+# Settings
+
+> Periksa dan kelola informasi lisensi, pengaturan server, pengaturan sinkronisasi, dan bahasa.
+
+## Ikhtisar
+
+Di halaman Settings, Anda dapat melihat informasi lisensi dan pengaturan server, serta mengubah sebagian pengaturan. Halaman ini selalu dapat diakses selama server terhubung (L1 ke atas).
+
+## License (hanya-baca)
+
+Menampilkan status lisensi saat ini:
+
+| Item | Deskripsi |
+|------|-----------|
+| Status | Badge status (Active/Inactive) |
+| Tier | Tier saat ini (Basic/Pro) |
+| License Key | Kunci lisensi yang disamarkan |
+| Provider | Informasi penyedia lisensi |
+
+## General
+
+| Pengaturan | Deskripsi |
+|------------|-----------|
+| Log Level | Tingkat output log |
+| History Recording | Apakah riwayat eksekusi alat disimpan |
+| Stats Collection | Apakah statistik alat dikumpulkan |
+| Request Timeout | Batas waktu permintaan (detik) |
+
+## Server Environment (hanya-baca)
+
+Menampilkan pengaturan server yang dikonfigurasi melalui variabel lingkungan:
+
+| Variabel Lingkungan | Deskripsi | Nilai Default |
+|---------------------|-----------|---------------|
+| `HTTP_PORT` | Port HTTP | 3002 |
+| `HTTP_HOST` | Host HTTP | 127.0.0.1 |
+| `DASHBOARD_AUTO_OPEN` | Pembukaan otomatis dashboard | true |
+
+## Sync Settings
+
+| Pengaturan | Deskripsi |
+|------------|-----------|
+| Max Depth | Kedalaman maksimum sinkronisasi |
+| Max Instances | Jumlah maksimum instance yang disinkronkan |
+
+## Language
+
+Mengubah bahasa UI dashboard. Mendukung 6 bahasa + Auto (deteksi otomatis bahasa browser).
+
+| Opsi | Bahasa |
+|------|--------|
+| Auto | Deteksi otomatis bahasa browser |
+| English | Inggris |
+| 한국어 | Korea |
+| 日本語 | Jepang |
+| Español | Spanyol |
+| Português | Portugis |
+| Bahasa Indonesia | Indonesia |
+
+## Dokumen Terkait
+
+- [Dashboard Overview](overview.md)
+- [Changelog](changelog.md)
+- [Connection](connection.md)
+- [Sync](sync.md)
+- [Playtest](playtest.md)
+- [Tools](tools.md)

package/docs/id/dashboard/sync.md

@@ -0,0 +1,75 @@
+# Sync
+
+> Pantau status saat ini, pengaturan arah, dan log sinkronisasi Studio <-> file lokal.
+
+![Sync — status sinkronisasi, pengaturan arah, log](../../assets/screenshots/dashboard/dashboard_sync.png)
+
+> Untuk panduan detail fitur Sync itu sendiri, lihat [Panduan detail fitur Sync](../sync/overview.md).
+
+## Ikhtisar
+
+Halaman Sync menampilkan status dan pengaturan sinkronisasi Studio <-> file lokal secara visual. Halaman ini hanya dapat diakses saat plugin terhubung (L2).
+
+## Sync Status
+
+Menampilkan status sinkronisasi saat ini:
+
+| Status | Arti |
+|--------|------|
+| **Idle** | Menunggu sinkronisasi |
+| **Initializing** | Sinkronisasi awal sedang berlangsung |
+| **Syncing** | Sinkronisasi inkremental sedang berlangsung |
+| **Error** | Terjadi kesalahan sinkronisasi |
+
+Kartu status juga menampilkan path sinkronisasi, jumlah instance yang disinkronkan, dan mode penerapan saat ini (Auto/Manual).
+
+## Sync Directions
+
+Menampilkan arah sinkronisasi per tipe dalam bentuk tabel:
+
+| Kolom | Deskripsi |
+|-------|-----------|
+| Type | Tipe target sinkronisasi (Scripts, Values, Instances, Data, Services) |
+| Direction | Arah sinkronisasi (Local -> Studio, Studio -> Local) |
+| Apply Mode | Mode penerapan (Auto/Manual) |
+
+Periksa arah sinkronisasi setiap tipe untuk memahami perubahan mana yang direfleksikan ke arah mana.
+
+## Sync Config
+
+Menampilkan nilai pengaturan sinkronisasi:
+- Max Depth — kedalaman maksimum sinkronisasi
+- Max Instances — jumlah maksimum instance yang disinkronkan
+- Interval — interval sinkronisasi
+
+## Sync Log
+
+Menampilkan event sinkronisasi secara kronologis. Setiap item log mencakup tag jenis perubahan (create, update, delete, dll.) dan path target.
+
+## Contoh Penggunaan
+
+### Memeriksa Status Sinkronisasi
+
+```
+"Saya ingin memastikan Sync berjalan dengan benar"
+```
+
+Periksa apakah Sync Status menunjukkan Idle, dan konfirmasi di Sync Log bahwa perubahan terbaru tercatat dengan normal.
+
+### Memahami Arah Sinkronisasi
+
+```
+"Saya ingin tahu ke arah mana perubahan script disinkronkan"
+```
+
+Periksa Direction dari tipe Scripts di tabel Sync Directions.
+
+## Dokumen Terkait
+
+- [Dashboard Overview](overview.md)
+- [Changelog](changelog.md)
+- [Connection](connection.md)
+- [Playtest](playtest.md)
+- [Tools](tools.md)
+- [Settings](settings.md)
+- [Panduan detail fitur Sync](../sync/overview.md)

package/docs/id/dashboard/tools.md

@@ -0,0 +1,69 @@
+# Tools
+
+> Periksa riwayat eksekusi dan statistik alat MCP yang dijalankan oleh AI.
+
+![Tools — riwayat eksekusi dan statistik alat](../../assets/screenshots/dashboard/dashboard_tools.png)
+
+## Ikhtisar
+
+Halaman Tools menyediakan riwayat eksekusi dan statistik alat MCP yang dijalankan oleh AI. Terdiri dari dua sub-tab: **History** dan **Statistics**. Halaman ini selalu dapat diakses selama server terhubung (L1 ke atas).
+
+## Tab History
+
+Menampilkan riwayat eksekusi alat dalam tabel kronologis:
+
+| Kolom | Deskripsi |
+|-------|-----------|
+| Time | Waktu eksekusi |
+| Tool.Action | Alat dan aksi yang dieksekusi (contoh: `query_instances.get_instance`) |
+| Duration | Durasi eksekusi |
+| Status | Status hasil (OK/Error) |
+| Tier | Tier yang digunakan (Basic/Pro) |
+
+Fitur:
+- Dropdown **Tool filter** untuk memfilter alat tertentu
+- Paginasi untuk menelusuri riwayat dalam jumlah besar
+- Penambahan riwayat eksekusi baru secara real-time
+
+## Tab Statistics
+
+Menganalisis statistik penggunaan alat secara visual:
+
+- **Distribusi tier** — rasio penggunaan alat Basic/Pro
+- **Statistik per alat** — jumlah panggilan dan rata-rata waktu respons setiap alat
+- **Analisis per aksi** — statistik detail per aksi dalam alat
+
+## Fitur Khusus Tier Basic
+
+UI tambahan ditampilkan untuk pengguna tier Basic:
+
+- **Tier Usage Progress** — progress bar penggunaan
+- **Modal perbandingan Basic vs Pro** — informasi fitur tambahan tier Pro
+
+## Contoh Penggunaan
+
+### Analisis Performa Alat
+
+```
+"Saya ingin tahu alat mana yang paling lama eksekusinya"
+```
+
+Periksa rata-rata waktu respons per alat di tab Statistics.
+
+### Pelacakan Error
+
+```
+"Saya ingin tahu mengapa alat yang baru saja dieksekusi gagal"
+```
+
+Cari item dengan Status Error di tab History untuk melihat informasi detail.
+
+## Dokumen Terkait
+
+- [Dashboard Overview](overview.md)
+- [Changelog](changelog.md)
+- [Connection](connection.md)
+- [Sync](sync.md)
+- [Playtest](playtest.md)
+- [Settings](settings.md)
+- [Daftar tool lengkap](../tools/overview.md)

package/docs/ja/README.md

@@ -66,7 +66,17 @@ AIがStudioプレイテストを直接制御します。Play（F5）/Run（F8）
 - 「SpawnLocationが地面の上にあることを確認するテストを書いて実行して。」
 - 「今修正したスクリプトがエラーなしで動くかプレイテストで検証して。」
 
-### 4) Roblox Explorer: VSCodeでStudioの階層構造を閲覧
+### 4) Dashboard: AI作業をリアルタイムでモニタリング
+
+MCPサーバーが提供するWebダッシュボードで、接続状態、ツール実行履歴、同期状態、ゲーム変更履歴をリアルタイムで確認します。
+
+![ダッシュボード Overview — サーバー状態、最近の変更、セッション要約](../assets/screenshots/dashboard/dashboard_overview.png)
+
+- サーバー/プラグイン/エージェントの接続状態を一目で確認
+- AIが変更したすべての内容をChangelogでBefore & Afterで比較
+- ツール実行履歴と統計で作業フローを分析
+
+### 5) Roblox Explorer: VSCodeでStudioの階層構造を閲覧
 
 Roblox Studioのインスタンスツリー全体をVSCode内で直接確認できます。サービスを探索し、同期されたスクリプトやプロパティファイルを開き、同期状態を追跡 — Studioに切り替える必要はありません。
 
@@ -88,6 +98,7 @@ Roblox Studioのインスタンスツリー全体をVSCode内で直接確認で
 - [インストールガイド](../en/installation/README.md)
 - [Tool一覧](tools/overview.md)
 - [Sync機能詳細ガイド](sync/overview.md)
+- [ダッシュボードガイド](dashboard/overview.md)
 - [Roblox Explorer (VSCode拡張)](../en/installation/roblox-explorer.md)
 - [互換性](../compatibility.md)
 - [トラブルシューティング](../troubleshooting.md)