@weppy/roblox-mcp 2.5.0 → 2.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +2 -2
- package/.github/workflows/install-test.yml +55 -4
- package/CHANGELOG.md +25 -0
- package/README.md +29 -45
- package/SUPPORT.md +4 -6
- package/docs/assets/screenshots/roblox-explorer/roblox-explorer-property-window.png +0 -0
- package/install.ps1 +22 -9
- package/install.sh +19 -4
- package/llms-full.txt +8 -688
- package/llms.txt +3 -13
- package/package.json +1 -1
- package/plugins/weppy-roblox-mcp/.claude-plugin/plugin.json +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ChangelogDetailPage-DRfFUIvC.js → ChangelogDetailPage-C-ROvHGr.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ChangelogPage-Dgl8dBt6.js → ChangelogPage-CPm4ft8m.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ConfirmModal-DfdyAPrJ.js → ConfirmModal-BSTYLn14.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ConnectionPage-LSvSX1_u.js → ConnectionPage-BeJEgfmf.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{InfoLabel-DrK7vhO-.js → InfoLabel-BRbbxjjt.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{OverviewPage-CXsGuoPu.js → OverviewPage-BHd6yL_8.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{PlaytestPage-CgkzRAqQ.js → PlaytestPage-BiNJCh4I.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{PropertyDiff-Dy3MffNh.js → PropertyDiff-BKVe7m6g.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SettingsPage-Cg33y021.js +1 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{StatusBadge-hJyzgRAl.js → StatusBadge-A72TDL-q.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{SyncPage-eX2Rh-Ct.js → SyncPage-R4Qs9Xt3.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/TierComparison-CQewH4h_.js +1 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{TierPromoProgress-CLAr1gQq.js → TierPromoProgress-DolZjAqX.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ToolsPage-CqzfCxxH.js → ToolsPage-DRX93nSV.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/WhatsNewPage-uLdiNHd0.js +1 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{index-BfvSPSNj.js → index-oz4Gtzz9.js} +55 -21
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{useLiveUptime-BeRNzFBh.js → useLiveUptime-CRLLCM8t.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/index.html +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/weppy-icon.png +0 -0
- package/plugins/weppy-roblox-mcp/dist/index.js +76 -76
- package/plugins/weppy-roblox-mcp/roblox-plugin/WeppyRobloxMCP.rbxm +0 -0
- package/docs/assets/screenshots/roblox-explorer/install-from-vsix.png +0 -0
- package/docs/compatibility.md +0 -44
- package/docs/en/dashboard/changelog.md +0 -114
- package/docs/en/dashboard/connection.md +0 -77
- package/docs/en/dashboard/overview.md +0 -95
- package/docs/en/dashboard/playtest.md +0 -61
- package/docs/en/dashboard/settings.md +0 -60
- package/docs/en/dashboard/sync.md +0 -68
- package/docs/en/dashboard/tools.md +0 -69
- package/docs/en/installation/README.md +0 -95
- package/docs/en/installation/ai-apps/antigravity.md +0 -89
- package/docs/en/installation/ai-apps/claude-app.md +0 -78
- package/docs/en/installation/ai-apps/claude-code.md +0 -104
- package/docs/en/installation/ai-apps/codex-app.md +0 -56
- package/docs/en/installation/ai-apps/codex-cli.md +0 -67
- package/docs/en/installation/ai-apps/cursor.md +0 -77
- package/docs/en/installation/ai-apps/gemini-cli.md +0 -120
- package/docs/en/installation/roblox-explorer.md +0 -68
- package/docs/en/installation/roblox-plugin.md +0 -96
- package/docs/en/pro-upgrade.md +0 -96
- package/docs/en/sync/luau-lsp.md +0 -41
- package/docs/en/sync/overview.md +0 -153
- package/docs/en/tools/assets-and-effects.md +0 -104
- package/docs/en/tools/instances-and-properties.md +0 -104
- package/docs/en/tools/overview.md +0 -277
- package/docs/en/tools/playtest.md +0 -140
- package/docs/en/tools/scripting.md +0 -66
- package/docs/en/tools/system-and-debugging.md +0 -93
- package/docs/en/tools/world-and-environment.md +0 -102
- package/docs/es/README.md +0 -208
- package/docs/es/dashboard/changelog.md +0 -114
- package/docs/es/dashboard/connection.md +0 -77
- package/docs/es/dashboard/overview.md +0 -95
- package/docs/es/dashboard/playtest.md +0 -61
- package/docs/es/dashboard/settings.md +0 -60
- package/docs/es/dashboard/sync.md +0 -68
- package/docs/es/dashboard/tools.md +0 -69
- package/docs/es/installation/README.md +0 -87
- package/docs/es/installation/ai-apps/antigravity.md +0 -89
- package/docs/es/installation/ai-apps/claude-app.md +0 -78
- package/docs/es/installation/ai-apps/claude-code.md +0 -104
- package/docs/es/installation/ai-apps/codex-app.md +0 -56
- package/docs/es/installation/ai-apps/codex-cli.md +0 -67
- package/docs/es/installation/ai-apps/cursor.md +0 -77
- package/docs/es/installation/ai-apps/gemini-cli.md +0 -120
- package/docs/es/installation/roblox-explorer.md +0 -58
- package/docs/es/installation/roblox-plugin.md +0 -85
- package/docs/es/pro-upgrade.md +0 -96
- package/docs/es/sync/luau-lsp.md +0 -41
- package/docs/es/sync/overview.md +0 -153
- package/docs/es/tools/assets-and-effects.md +0 -104
- package/docs/es/tools/instances-and-properties.md +0 -104
- package/docs/es/tools/overview.md +0 -277
- package/docs/es/tools/playtest.md +0 -140
- package/docs/es/tools/scripting.md +0 -66
- package/docs/es/tools/system-and-debugging.md +0 -93
- package/docs/es/tools/world-and-environment.md +0 -102
- package/docs/id/README.md +0 -208
- package/docs/id/dashboard/changelog.md +0 -114
- package/docs/id/dashboard/connection.md +0 -77
- package/docs/id/dashboard/overview.md +0 -95
- package/docs/id/dashboard/playtest.md +0 -61
- package/docs/id/dashboard/settings.md +0 -60
- package/docs/id/dashboard/sync.md +0 -68
- package/docs/id/dashboard/tools.md +0 -69
- package/docs/id/installation/README.md +0 -93
- package/docs/id/installation/ai-apps/antigravity.md +0 -89
- package/docs/id/installation/ai-apps/claude-app.md +0 -78
- package/docs/id/installation/ai-apps/claude-code.md +0 -104
- package/docs/id/installation/ai-apps/codex-app.md +0 -56
- package/docs/id/installation/ai-apps/codex-cli.md +0 -67
- package/docs/id/installation/ai-apps/cursor.md +0 -77
- package/docs/id/installation/ai-apps/gemini-cli.md +0 -120
- package/docs/id/installation/roblox-explorer.md +0 -58
- package/docs/id/installation/roblox-plugin.md +0 -85
- package/docs/id/pro-upgrade.md +0 -96
- package/docs/id/sync/luau-lsp.md +0 -41
- package/docs/id/sync/overview.md +0 -153
- package/docs/id/tools/assets-and-effects.md +0 -104
- package/docs/id/tools/instances-and-properties.md +0 -104
- package/docs/id/tools/overview.md +0 -277
- package/docs/id/tools/playtest.md +0 -140
- package/docs/id/tools/scripting.md +0 -66
- package/docs/id/tools/system-and-debugging.md +0 -93
- package/docs/id/tools/world-and-environment.md +0 -102
- package/docs/installer/assets/index-Bz0amd7x.js +0 -63
- package/docs/installer/assets/index-ei4lRUa6.css +0 -1
- package/docs/installer/index.html +0 -14
- package/docs/installer/manifest.webmanifest +0 -15
- package/docs/installer/sw.js +0 -7
- package/docs/installer/weppy-icon.png +0 -0
- package/docs/ja/README.md +0 -206
- package/docs/ja/dashboard/changelog.md +0 -114
- package/docs/ja/dashboard/connection.md +0 -77
- package/docs/ja/dashboard/overview.md +0 -95
- package/docs/ja/dashboard/playtest.md +0 -61
- package/docs/ja/dashboard/settings.md +0 -60
- package/docs/ja/dashboard/sync.md +0 -68
- package/docs/ja/dashboard/tools.md +0 -69
- package/docs/ja/installation/README.md +0 -93
- package/docs/ja/installation/ai-apps/antigravity.md +0 -89
- package/docs/ja/installation/ai-apps/claude-app.md +0 -78
- package/docs/ja/installation/ai-apps/claude-code.md +0 -104
- package/docs/ja/installation/ai-apps/codex-app.md +0 -56
- package/docs/ja/installation/ai-apps/codex-cli.md +0 -67
- package/docs/ja/installation/ai-apps/cursor.md +0 -77
- package/docs/ja/installation/ai-apps/gemini-cli.md +0 -120
- package/docs/ja/installation/roblox-explorer.md +0 -58
- package/docs/ja/installation/roblox-plugin.md +0 -85
- package/docs/ja/pro-upgrade.md +0 -96
- package/docs/ja/sync/luau-lsp.md +0 -41
- package/docs/ja/sync/overview.md +0 -153
- package/docs/ja/tools/assets-and-effects.md +0 -104
- package/docs/ja/tools/instances-and-properties.md +0 -104
- package/docs/ja/tools/overview.md +0 -277
- package/docs/ja/tools/playtest.md +0 -140
- package/docs/ja/tools/scripting.md +0 -66
- package/docs/ja/tools/system-and-debugging.md +0 -93
- package/docs/ja/tools/world-and-environment.md +0 -102
- package/docs/ko/README.md +0 -206
- package/docs/ko/dashboard/changelog.md +0 -114
- package/docs/ko/dashboard/connection.md +0 -77
- package/docs/ko/dashboard/overview.md +0 -95
- package/docs/ko/dashboard/playtest.md +0 -61
- package/docs/ko/dashboard/settings.md +0 -60
- package/docs/ko/dashboard/sync.md +0 -68
- package/docs/ko/dashboard/tools.md +0 -69
- package/docs/ko/installation/README.md +0 -95
- package/docs/ko/installation/ai-apps/antigravity.md +0 -88
- package/docs/ko/installation/ai-apps/claude-app.md +0 -78
- package/docs/ko/installation/ai-apps/claude-code.md +0 -104
- package/docs/ko/installation/ai-apps/codex-app.md +0 -56
- package/docs/ko/installation/ai-apps/codex-cli.md +0 -67
- package/docs/ko/installation/ai-apps/cursor.md +0 -77
- package/docs/ko/installation/ai-apps/gemini-cli.md +0 -120
- package/docs/ko/installation/roblox-explorer.md +0 -68
- package/docs/ko/installation/roblox-plugin.md +0 -96
- package/docs/ko/pro-upgrade.md +0 -96
- package/docs/ko/sync/luau-lsp.md +0 -41
- package/docs/ko/sync/overview.md +0 -153
- package/docs/ko/tools/assets-and-effects.md +0 -104
- package/docs/ko/tools/instances-and-properties.md +0 -104
- package/docs/ko/tools/overview.md +0 -277
- package/docs/ko/tools/playtest.md +0 -134
- package/docs/ko/tools/scripting.md +0 -66
- package/docs/ko/tools/system-and-debugging.md +0 -93
- package/docs/ko/tools/world-and-environment.md +0 -102
- package/docs/pt-br/README.md +0 -208
- package/docs/pt-br/dashboard/changelog.md +0 -114
- package/docs/pt-br/dashboard/connection.md +0 -77
- package/docs/pt-br/dashboard/overview.md +0 -95
- package/docs/pt-br/dashboard/playtest.md +0 -61
- package/docs/pt-br/dashboard/settings.md +0 -60
- package/docs/pt-br/dashboard/sync.md +0 -68
- package/docs/pt-br/dashboard/tools.md +0 -69
- package/docs/pt-br/installation/README.md +0 -93
- package/docs/pt-br/installation/ai-apps/antigravity.md +0 -89
- package/docs/pt-br/installation/ai-apps/claude-app.md +0 -78
- package/docs/pt-br/installation/ai-apps/claude-code.md +0 -104
- package/docs/pt-br/installation/ai-apps/codex-app.md +0 -56
- package/docs/pt-br/installation/ai-apps/codex-cli.md +0 -67
- package/docs/pt-br/installation/ai-apps/cursor.md +0 -77
- package/docs/pt-br/installation/ai-apps/gemini-cli.md +0 -120
- package/docs/pt-br/installation/roblox-explorer.md +0 -58
- package/docs/pt-br/installation/roblox-plugin.md +0 -85
- package/docs/pt-br/pro-upgrade.md +0 -96
- package/docs/pt-br/sync/luau-lsp.md +0 -41
- package/docs/pt-br/sync/overview.md +0 -153
- package/docs/pt-br/tools/assets-and-effects.md +0 -104
- package/docs/pt-br/tools/instances-and-properties.md +0 -104
- package/docs/pt-br/tools/overview.md +0 -277
- package/docs/pt-br/tools/playtest.md +0 -140
- package/docs/pt-br/tools/scripting.md +0 -66
- package/docs/pt-br/tools/system-and-debugging.md +0 -93
- package/docs/pt-br/tools/world-and-environment.md +0 -102
- package/docs/troubleshooting.md +0 -47
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SettingsPage-D2ZBQ2KF.js +0 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/TierComparison-BwKqP_4s.js +0 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/WhatsNewPage-23o8LmsR.js +0 -1
|
@@ -1,102 +0,0 @@
|
|
|
1
|
-
# Mundo y entorno
|
|
2
|
-
|
|
3
|
-
> Construye e inspecciona el mundo del juego con lighting, terrain, consultas espaciales y herramientas de camara.
|
|
4
|
-
|
|
5
|
-
## Tools incluidas
|
|
6
|
-
|
|
7
|
-
| Tool | Tier | Descripcion |
|
|
8
|
-
|------|:----:|-------------|
|
|
9
|
-
| `manage_lighting` | Pro | Configura Lighting, Atmosphere, Sky y la hora del dia |
|
|
10
|
-
| `manage_terrain` | Pro | Genera y edita terrain, incluido datos voxel |
|
|
11
|
-
| `spatial_query` | Pro | Raycasts, busqueda de suelo, validacion de colocacion y mapas de altura |
|
|
12
|
-
| `manage_camera` | Basic | Inspecciona el estado de la camara, mueve el foco y sugiere vistas |
|
|
13
|
-
|
|
14
|
-
## Flujos principales
|
|
15
|
-
|
|
16
|
-
### Definir la atmosfera (Pro)
|
|
17
|
-
|
|
18
|
-
```
|
|
19
|
-
"Cambia el mapa a un ambiente de atardecer con cielo naranja, niebla mas densa y hora 18:00."
|
|
20
|
-
```
|
|
21
|
-
|
|
22
|
-
Usa `manage_lighting.time` para la hora, `manage_lighting.atmosphere` para la niebla y `manage_lighting.sky` para el cielo.
|
|
23
|
-
|
|
24
|
-
### Construir terrain (Pro)
|
|
25
|
-
|
|
26
|
-
```
|
|
27
|
-
"Crea una colina de pasto con radio 200 en el centro del mapa y rodeala con agua."
|
|
28
|
-
```
|
|
29
|
-
|
|
30
|
-
Usa `manage_terrain.fill_ball` para la colina y `manage_terrain.fill_block` para el agua circundante.
|
|
31
|
-
|
|
32
|
-
### Validar una colocacion (Pro)
|
|
33
|
-
|
|
34
|
-
```
|
|
35
|
-
"Encuentra un terreno plano donde pueda colocar este edificio."
|
|
36
|
-
```
|
|
37
|
-
|
|
38
|
-
Usa `spatial_query.find_flat` para encontrar candidatos, `spatial_query.check_placement` para validarlos y `manage_camera.focus_position` para inspeccion visual.
|
|
39
|
-
|
|
40
|
-
## Referencia de acciones
|
|
41
|
-
|
|
42
|
-
### Manage Lighting (Pro)
|
|
43
|
-
|
|
44
|
-
| Accion | Descripcion | Tier |
|
|
45
|
-
|--------|-------------|------|
|
|
46
|
-
| `lighting` | Definir propiedades del servicio Lighting | Pro |
|
|
47
|
-
| `atmosphere` | Definir propiedades de Atmosphere | Pro |
|
|
48
|
-
| `sky` | Definir propiedades de Sky | Pro |
|
|
49
|
-
| `terrain_props` | Definir propiedades visuales y de agua de Terrain | Pro |
|
|
50
|
-
| `time` | Definir la hora del dia | Pro |
|
|
51
|
-
|
|
52
|
-
### Manage Terrain (Pro)
|
|
53
|
-
|
|
54
|
-
| Accion | Descripcion | Tier |
|
|
55
|
-
|--------|-------------|------|
|
|
56
|
-
| `fill_block` | Rellenar terrain con forma de bloque | Pro |
|
|
57
|
-
| `fill_ball` | Rellenar terrain con forma esferica | Pro |
|
|
58
|
-
| `fill_cylinder` | Rellenar terrain con forma cilindrica | Pro |
|
|
59
|
-
| `fill_wedge` | Rellenar terrain con forma de cunha | Pro |
|
|
60
|
-
| `clear_region` | Limpiar terrain en una region | Pro |
|
|
61
|
-
| `clear_bounds` | Limpiar terrain dentro de limites | Pro |
|
|
62
|
-
| `replace_material` | Reemplazar material en una region | Pro |
|
|
63
|
-
| `colors_get` | Obtener colores de material | Pro |
|
|
64
|
-
| `colors_set` | Definir colores de material | Pro |
|
|
65
|
-
| `read_voxel` | Leer un voxel individual | Pro |
|
|
66
|
-
| `read_voxels` | Leer datos voxel en lote | Pro |
|
|
67
|
-
| `write_voxels` | Escribir datos voxel en lote | Pro |
|
|
68
|
-
| `generate` | Generar terrain procedural | Pro |
|
|
69
|
-
| `smooth` | Suavizar terrain | Pro |
|
|
70
|
-
|
|
71
|
-
### Spatial Query (Pro)
|
|
72
|
-
|
|
73
|
-
| Accion | Descripcion | Tier |
|
|
74
|
-
|--------|-------------|------|
|
|
75
|
-
| `raycast` | Lanzar un solo rayo | Pro |
|
|
76
|
-
| `find_ground` | Encontrar la posicion del suelo bajo un punto | Pro |
|
|
77
|
-
| `check_placement` | Verificar si una colocacion esta libre de colisiones | Pro |
|
|
78
|
-
| `multi_raycast` | Lanzar varios rayos en lote | Pro |
|
|
79
|
-
| `scan_area` | Generar un mapa de alturas de un area | Pro |
|
|
80
|
-
| `find_flat` | Encontrar zonas planas para construir | Pro |
|
|
81
|
-
| `find_spawn` | Encontrar posiciones de spawn adecuadas | Pro |
|
|
82
|
-
| `analyze_walkable` | Analizar una cuadricula transitable | Pro |
|
|
83
|
-
| `spatial_map` | Obtener todas las posiciones de BasePart | Pro |
|
|
84
|
-
| `find_space` | Encontrar espacio vacio para un objeto | Pro |
|
|
85
|
-
| `bounds` | Obtener cajas de limites de instancias | Pro |
|
|
86
|
-
| `snap_grid` | Ajustar una posicion a la cuadricula | Pro |
|
|
87
|
-
| `collision` | Verificar colision AABB | Pro |
|
|
88
|
-
|
|
89
|
-
### Manage Camera (Basic)
|
|
90
|
-
|
|
91
|
-
| Accion | Descripcion | Tier |
|
|
92
|
-
|--------|-------------|------|
|
|
93
|
-
| `info` | Obtener posicion, rotacion, FOV y tamano del viewport de la camara | Basic |
|
|
94
|
-
| `focus_path` | Mover la camara para enfocar una instancia | Basic |
|
|
95
|
-
| `focus_position` | Mover la camara para enfocar una posicion | Basic |
|
|
96
|
-
| `suggest` | Obtener una vista de camara sugerida para un objetivo | Basic |
|
|
97
|
-
|
|
98
|
-
## Documentos relacionados
|
|
99
|
-
|
|
100
|
-
- [Instancias y propiedades](instances-and-properties.md) - colocar objetos del mundo
|
|
101
|
-
- [Assets y efectos](assets-and-effects.md) - agregar efectos, audio y animacion
|
|
102
|
-
- [Lista completa de tools](overview.md)
|
package/docs/id/README.md
DELETED
|
@@ -1,208 +0,0 @@
|
|
|
1
|
-
# Roblox MCP — Server MCP untuk Roblox Studio | Pengembangan Game AI dengan Claude, Codex, Cursor & Gemini
|
|
2
|
-
|
|
3
|
-
> **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.
|
|
4
|
-
|
|
5
|
-
**Alat terkonsolidasi berbasis aksi · Sync dua arah · Playtest otomatis · Dukungan multi-place**
|
|
6
|
-
|
|
7
|
-
[English](../../README.md) | [한국어](../ko/README.md) | [日本語](../ja/README.md) | [Español](../es/README.md) | [Português](../pt-br/README.md) | **Bahasa Indonesia**
|
|
8
|
-
|
|
9
|
-
[](https://youtu.be/puQB4u1VlMw)
|
|
10
|
-
|
|
11
|
-
## Mengapa WEPPY (Weppy Roblox MCP)?
|
|
12
|
-
|
|
13
|
-
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.
|
|
14
|
-
|
|
15
|
-
**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**.
|
|
16
|
-
|
|
17
|
-
Tidak perlu copy-paste kode. AI bekerja dan kamu memverifikasi hasilnya.
|
|
18
|
-
|
|
19
|
-
## Instalasi Cepat
|
|
20
|
-
|
|
21
|
-
Install mengikuti panduan di halaman web.
|
|
22
|
-
|
|
23
|
-
👉 **[Halaman Instalasi](https://weppyai.com/en/install)**
|
|
24
|
-
|
|
25
|
-
### Instalasi Terminal
|
|
26
|
-
|
|
27
|
-
Jika kamu terbiasa dengan terminal, install semuanya dalam satu perintah.
|
|
28
|
-
|
|
29
|
-
**macOS / Linux**
|
|
30
|
-
|
|
31
|
-
```bash
|
|
32
|
-
curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
**Windows (PowerShell)**
|
|
36
|
-
|
|
37
|
-
```powershell
|
|
38
|
-
irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
Restart Roblox Studio — selesai!
|
|
42
|
-
|
|
43
|
-
Pendaftaran MCP otomatis mendukung **Claude Code, Claude Desktop, Cursor, Codex CLI/App, Gemini CLI, dan Antigravity**.
|
|
44
|
-
|
|
45
|
-
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`.
|
|
46
|
-
|
|
47
|
-
### Instalasi Manual
|
|
48
|
-
|
|
49
|
-
Jika instalasi satu perintah tidak berjalan, atau instalasi otomatis tidak bisa dipakai di lingkunganmu, gunakan instalasi manual di bawah sebagai alternatif.
|
|
50
|
-
|
|
51
|
-
**Langkah 1** — Install plugin Roblox Studio:
|
|
52
|
-
[Panduan instalasi plugin](installation/roblox-plugin.md)
|
|
53
|
-
|
|
54
|
-
**Langkah 2** — Daftarkan MCP server di aplikasi AI:
|
|
55
|
-
|
|
56
|
-
```bash
|
|
57
|
-
npx -y @weppy/roblox-mcp
|
|
58
|
-
```
|
|
59
|
-
|
|
60
|
-
| Aplikasi AI | Panduan |
|
|
61
|
-
|-------------|---------|
|
|
62
|
-
| Claude Code | [Setup](installation/ai-apps/claude-code.md) |
|
|
63
|
-
| Claude Desktop | [Setup](installation/ai-apps/claude-app.md) |
|
|
64
|
-
| Cursor | [Setup](installation/ai-apps/cursor.md) |
|
|
65
|
-
| Codex CLI | [Setup](installation/ai-apps/codex-cli.md) |
|
|
66
|
-
| Codex Desktop | [Setup](installation/ai-apps/codex-app.md) |
|
|
67
|
-
| Gemini CLI | [Setup](installation/ai-apps/gemini-cli.md) |
|
|
68
|
-
| Antigravity | [Setup](installation/ai-apps/antigravity.md) |
|
|
69
|
-
|
|
70
|
-
> Bekerja dengan semua klien MCP yang kompatibel. Perintah server: `npx -y @weppy/roblox-mcp`
|
|
71
|
-
|
|
72
|
-
## Kompatibilitas
|
|
73
|
-
|
|
74
|
-
| Claude Code | Claude Desktop | Cursor | Codex CLI | Gemini CLI | Antigravity |
|
|
75
|
-
|:-----------:|:--------------:|:------:|:---------:|:----------:|:-----------:|
|
|
76
|
-
| ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
|
77
|
-
|
|
78
|
-
**Persyaratan:** Node.js 18+, Roblox Studio, Windows 10+ atau macOS 12+
|
|
79
|
-
|
|
80
|
-
## Fitur utama
|
|
81
|
-
|
|
82
|
-
### 1) MCP Tool: eksekusi langsung di Studio dari bahasa alami
|
|
83
|
-
|
|
84
|
-
AI bisa langsung menangani script, instance, properti, terrain, lighting, asset, audio, dan animasi di dalam Studio.
|
|
85
|
-
|
|
86
|
-
- "Tambahkan partikel + suara + cooldown saat player melompat."
|
|
87
|
-
- "Buat arena boss di tengah map dan pasang spawn point yang aman dari tabrakan."
|
|
88
|
-
- "Ubah interface modul ini dan perbarui semua script yang bergantung padanya."
|
|
89
|
-
|
|
90
|
-
### 2) Sync: menjaga konteks penuh proyek untuk AI
|
|
91
|
-
|
|
92
|
-
AI bekerja dari mirror lokal yang tersinkron, jadi perubahan lintas banyak file tetap konsisten.
|
|
93
|
-
|
|
94
|
-
- Basic: sinkronisasi satu arah (Studio -> Local)
|
|
95
|
-
- Pro: sinkronisasi dua arah + Direction/Apply Mode per tipe + riwayat + multiplace
|
|
96
|
-
|
|
97
|
-

|
|
98
|
-
|
|
99
|
-
### 3) Playtest: AI menjalankan dan memverifikasi tes secara otomatis
|
|
100
|
-
|
|
101
|
-
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.
|
|
102
|
-
|
|
103
|
-
- "Mulai playtest mode Run dan cek apakah NPC mencapai target."
|
|
104
|
-
- "Tulis dan jalankan test untuk memastikan SpawnLocation berada di atas tanah."
|
|
105
|
-
- "Validasi lewat playtest bahwa script yang baru saya ubah berjalan tanpa error."
|
|
106
|
-
|
|
107
|
-

|
|
108
|
-
|
|
109
|
-
### 4) WEPPY Dashboard: pantau pekerjaan AI secara real-time
|
|
110
|
-
|
|
111
|
-
Dashboard berbasis web yang disediakan server MCP memungkinkan Anda melihat status koneksi, riwayat eksekusi alat, status sinkronisasi, dan riwayat perubahan game secara real-time.
|
|
112
|
-
|
|
113
|
-
- Lihat status koneksi server/plugin/agen dalam satu pandangan
|
|
114
|
-
- Bandingkan semua perubahan yang dilakukan AI dengan Before & After di Changelog
|
|
115
|
-
- Analisis alur kerja dengan riwayat dan statistik eksekusi alat
|
|
116
|
-
|
|
117
|
-

|
|
118
|
-
|
|
119
|
-
### 5) WEPPY Roblox Explorer: jelajahi hierarki Studio di VSCode
|
|
120
|
-
|
|
121
|
-
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.
|
|
122
|
-
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.
|
|
123
|
-
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).
|
|
124
|
-
|
|
125
|
-
- Ikon class yang sama dengan Studio untuk pengenalan instan
|
|
126
|
-
- Klik untuk membuka script dan file properti yang tersinkron
|
|
127
|
-
- Dukungan multiplace dengan indikator status sinkronisasi
|
|
128
|
-
|
|
129
|
-

|
|
130
|
-
|
|
131
|
-
## Nilai yang langsung terasa
|
|
132
|
-
|
|
133
|
-
- Ringkas pekerjaan berulang: banyak edit manual jadi satu perintah
|
|
134
|
-
- Ubah file terkait sekaligus: bukan hanya satu file target
|
|
135
|
-
- Risiko lebih rendah: putuskan perubahan dari status sync dan riwayat
|
|
136
|
-
- Efisiensi token lebih baik (Pro): kurangi bolak-balik dengan aksi massal
|
|
137
|
-
|
|
138
|
-
## Kasus penggunaan
|
|
139
|
-
|
|
140
|
-
- **Prototipe cepat**: Jelaskan mekanik game dalam bahasa alami dan lihat AI membuatnya di Studio
|
|
141
|
-
- **Refaktor massal**: Ubah nama interface modul dan perbarui semua script dependen dalam satu permintaan
|
|
142
|
-
- **Terrain & lingkungan**: Hasilkan terrain prosedural, atur lighting/atmosfer, tempatkan asset — semua dari satu prompt
|
|
143
|
-
- **Konsistensi multi-file**: AI membaca seluruh proyek via Sync dan menerapkan perubahan di script terkait secara bersamaan
|
|
144
|
-
- **Integrasi asset**: Cari di Creator Store, sisipkan model, dan konfigurasi properti tanpa meninggalkan editor
|
|
145
|
-
|
|
146
|
-
## Dokumen detail
|
|
147
|
-
|
|
148
|
-
- [Panduan instalasi](installation/README.md)
|
|
149
|
-
- [Daftar tool lengkap](tools/overview.md)
|
|
150
|
-
- [Panduan detail Sync](sync/overview.md)
|
|
151
|
-
- [Panduan dashboard](dashboard/overview.md)
|
|
152
|
-
- [WEPPY Roblox Explorer (Ekstensi VSCode)](installation/roblox-explorer.md)
|
|
153
|
-
- [Kompatibilitas](../compatibility.md)
|
|
154
|
-
- [Panduan pemecahan masalah](../troubleshooting.md)
|
|
155
|
-
|
|
156
|
-
### Panduan per alur kerja
|
|
157
|
-
|
|
158
|
-
- [Instance & properti](tools/instances-and-properties.md) - pencarian, pembuatan, pengeditan, dan tag
|
|
159
|
-
- [Scripting & eksekusi kode](tools/scripting.md) - pengelolaan script dan eksekusi Luau
|
|
160
|
-
- [Dunia & lingkungan](tools/world-and-environment.md) - lighting, terrain, dan kamera
|
|
161
|
-
- [Asset & efek](tools/assets-and-effects.md) - penyisipan model, tween, dan efek
|
|
162
|
-
- [Playtest & tes otomatis](tools/playtest.md) - kontrol playtest dan validasi otomatis
|
|
163
|
-
- [Sistem & debugging](tools/system-and-debugging.md) - koneksi, log, dan eksekusi batch
|
|
164
|
-
|
|
165
|
-
## FAQ
|
|
166
|
-
|
|
167
|
-
### Bagaimana cara menghubungkan Claude Code ke Roblox Studio?
|
|
168
|
-
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).
|
|
169
|
-
|
|
170
|
-
### Bagaimana cara menggunakan Codex CLI dengan Roblox Studio?
|
|
171
|
-
Install plugin, lalu tambahkan konfigurasi MCP server ke Codex CLI. Lihat [Setup Codex CLI](installation/ai-apps/codex-cli.md).
|
|
172
|
-
|
|
173
|
-
### Apakah Roblox MCP bekerja dengan Cursor?
|
|
174
|
-
Ya. Lihat [Setup Cursor](installation/ai-apps/cursor.md). Semua klien AI yang kompatibel MCP bisa dipakai.
|
|
175
|
-
|
|
176
|
-
### Bisakah AI membuat game Roblox dengan ini?
|
|
177
|
-
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.
|
|
178
|
-
|
|
179
|
-
### Apa perbedaan antara Basic dan Pro?
|
|
180
|
-
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).
|
|
181
|
-
|
|
182
|
-
### Apa bedanya Weppy dengan server MCP Roblox lainnya?
|
|
183
|
-
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.
|
|
184
|
-
|
|
185
|
-
### Apakah aman? Bisakah AI merusak game saya?
|
|
186
|
-
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.
|
|
187
|
-
|
|
188
|
-
## Upgrade Pro
|
|
189
|
-
|
|
190
|
-
Sync dua arah, kemampuan kreasi lanjutan, dan efisiensi token AI — semua dalam satu upgrade.
|
|
191
|
-
|
|
192
|
-
[Panduan Upgrade Pro](https://weppyai.com/en/plans)
|
|
193
|
-
|
|
194
|
-
## Lisensi
|
|
195
|
-
|
|
196
|
-
Repositori ini dilisensikan di bawah `AGPL-3.0`.
|
|
197
|
-
|
|
198
|
-
Lisensi komersial tersedia secara terpisah. Lihat [COMMERCIAL-LICENSE.md](../../COMMERCIAL-LICENSE.md).
|
|
199
|
-
|
|
200
|
-
Penggunaan nama dan logo Weppy diatur oleh [TRADEMARKS.md](../../TRADEMARKS.md).
|
|
201
|
-
|
|
202
|
-
---
|
|
203
|
-
|
|
204
|
-
[](https://www.npmjs.com/package/@weppy/roblox-mcp) [](https://nodejs.org/) [](https://smithery.ai/server/@hope1026/weppy-roblox-mcp)
|
|
205
|
-
|
|
206
|
-
[](https://glama.ai/mcp/servers/hope1026/roblox-mcp)
|
|
207
|
-
|
|
208
|
-
[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)
|
|
@@ -1,114 +0,0 @@
|
|
|
1
|
-
# Changelog
|
|
2
|
-
|
|
3
|
-
> Mencatat semua perubahan yang dilakukan AI di Roblox Studio per sesi, dan menyediakan ringkasan perubahan/timeline/Before & After.
|
|
4
|
-
|
|
5
|
-

|
|
6
|
-
|
|
7
|
-
## Ikhtisar
|
|
8
|
-
|
|
9
|
-
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.
|
|
10
|
-
|
|
11
|
-
## Daftar Kartu Sesi
|
|
12
|
-
|
|
13
|
-
Layar utama Changelog menampilkan daftar kartu per sesi.
|
|
14
|
-
|
|
15
|
-
### Status Sesi
|
|
16
|
-
|
|
17
|
-
Setiap kartu sesi menampilkan status:
|
|
18
|
-
|
|
19
|
-
| Status | Arti |
|
|
20
|
-
|--------|------|
|
|
21
|
-
| **Active** | Sesi yang sedang berlangsung (pembaruan real-time) |
|
|
22
|
-
| **Completed** | Sesi yang telah selesai |
|
|
23
|
-
| **Bootstrap** | Sesi sinkronisasi awal |
|
|
24
|
-
|
|
25
|
-
### Ringkasan Sesi
|
|
26
|
-
|
|
27
|
-
Setiap kartu merangkum jumlah perubahan sesi tersebut per kategori:
|
|
28
|
-
|
|
29
|
-
- Script — jumlah pembuatan/pengeditan script
|
|
30
|
-
- Instance — jumlah pembuatan/penghapusan/pemindahan instance
|
|
31
|
-
- Property — jumlah perubahan properti
|
|
32
|
-
- Lighting — jumlah pengaturan pencahayaan/lingkungan
|
|
33
|
-
- Terrain — jumlah perubahan terrain
|
|
34
|
-
- Asset — jumlah penyisipan aset
|
|
35
|
-
|
|
36
|
-
### Tab Filter
|
|
37
|
-
|
|
38
|
-
Anda dapat memfilter sesi menggunakan tab di bagian atas:
|
|
39
|
-
- **All** — semua sesi
|
|
40
|
-
- **Active** — hanya sesi yang sedang berlangsung
|
|
41
|
-
- **Completed** — hanya sesi yang telah selesai
|
|
42
|
-
|
|
43
|
-
## Tampilan Detail Sesi
|
|
44
|
-
|
|
45
|
-
Klik kartu sesi untuk masuk ke tampilan detail.
|
|
46
|
-
|
|
47
|
-

|
|
48
|
-
|
|
49
|
-
### Change Summary
|
|
50
|
-
|
|
51
|
-
Memvisualisasikan perubahan sesi dalam 6 kartu kategori:
|
|
52
|
-
|
|
53
|
-
| Kategori | Ikon | Deskripsi |
|
|
54
|
-
|----------|------|-----------|
|
|
55
|
-
| Scripts | Script | Jumlah pembuatan/pengeditan script |
|
|
56
|
-
| Instances | Instance | Jumlah pembuatan/penghapusan/pemindahan instance |
|
|
57
|
-
| Properties | Properti | Jumlah perubahan properti |
|
|
58
|
-
| Lighting | Pencahayaan | Jumlah perubahan pencahayaan/lingkungan |
|
|
59
|
-
| Terrain | Terrain | Jumlah perubahan terrain |
|
|
60
|
-
| Assets | Aset | Jumlah penyisipan aset |
|
|
61
|
-
|
|
62
|
-
### Change Timeline
|
|
63
|
-
|
|
64
|
-
Menampilkan semua perubahan dalam sesi secara kronologis.
|
|
65
|
-
|
|
66
|
-
- Setiap item menampilkan timestamp, tag kategori perubahan, dan path target
|
|
67
|
-
- Gunakan dropdown **Category** untuk memfilter kategori tertentu
|
|
68
|
-
- Klik item untuk membuka tampilan perbandingan Before & After
|
|
69
|
-
|
|
70
|
-
### Before & After
|
|
71
|
-
|
|
72
|
-
Membandingkan data sebelum dan sesudah perubahan. Tingkat informasi berbeda tergantung jenis perubahan:
|
|
73
|
-
|
|
74
|
-
| Tingkat Kepercayaan | Arti | Contoh |
|
|
75
|
-
|---------------------|------|--------|
|
|
76
|
-
| **exact** | Nilai sebelum dan sesudah tercatat dengan tepat | Perubahan properti, pengeditan script |
|
|
77
|
-
| **partial** | Hanya sebagian informasi yang tercatat | Perubahan kompleks |
|
|
78
|
-
| **after-only** | Hanya nilai sesudah yang tersedia | Pembuatan instance baru |
|
|
79
|
-
| **intent-only** | Hanya niat yang tercatat | Penghapusan, dll. |
|
|
80
|
-
|
|
81
|
-
## Contoh Penggunaan
|
|
82
|
-
|
|
83
|
-
### Verifikasi Pekerjaan
|
|
84
|
-
|
|
85
|
-
```
|
|
86
|
-
"Saya ingin mengecek script apa saja yang baru saja dimodifikasi oleh AI"
|
|
87
|
-
```
|
|
88
|
-
|
|
89
|
-
Filter kategori Script pada sesi Active di Changelog untuk melihat daftar script yang dimodifikasi dan membandingkan kode sebelum dan sesudah.
|
|
90
|
-
|
|
91
|
-
### Pelacakan Perubahan
|
|
92
|
-
|
|
93
|
-
```
|
|
94
|
-
"Saya ingin melihat kembali bagaimana Lighting diatur di sesi kemarin"
|
|
95
|
-
```
|
|
96
|
-
|
|
97
|
-
Cari sesi tersebut di tab Completed dan filter berdasarkan kategori Lighting untuk melihat riwayat perubahan dan nilai pengaturan.
|
|
98
|
-
|
|
99
|
-
### Debugging Masalah
|
|
100
|
-
|
|
101
|
-
```
|
|
102
|
-
"Saya perlu menemukan kapan instance tertentu dihapus"
|
|
103
|
-
```
|
|
104
|
-
|
|
105
|
-
Filter kategori Instance di timeline dan lacak perubahan tipe delete secara kronologis.
|
|
106
|
-
|
|
107
|
-
## Dokumen Terkait
|
|
108
|
-
|
|
109
|
-
- [WEPPY Dashboard Overview](overview.md)
|
|
110
|
-
- [Connection](connection.md)
|
|
111
|
-
- [Sync](sync.md)
|
|
112
|
-
- [Playtest](playtest.md)
|
|
113
|
-
- [Tools](tools.md)
|
|
114
|
-
- [Settings](settings.md)
|
|
@@ -1,77 +0,0 @@
|
|
|
1
|
-
# Connection
|
|
2
|
-
|
|
3
|
-
> Pantau status koneksi server, agen AI, dan plugin di satu tempat.
|
|
4
|
-
|
|
5
|
-

|
|
6
|
-
|
|
7
|
-
## Ikhtisar
|
|
8
|
-
|
|
9
|
-
Halaman Connection memantau semua status koneksi sistem MCP di satu tempat. Halaman ini selalu dapat diakses saat dashboard berada dalam status **Server terhubung** atau **Studio terhubung**.
|
|
10
|
-
|
|
11
|
-
## Server Status
|
|
12
|
-
|
|
13
|
-
Menampilkan informasi inti server:
|
|
14
|
-
|
|
15
|
-
| Item | Deskripsi |
|
|
16
|
-
|------|-----------|
|
|
17
|
-
| Status | Badge status koneksi (Online/Offline) |
|
|
18
|
-
| Version | Versi server MCP |
|
|
19
|
-
| PID | ID proses server |
|
|
20
|
-
| Uptime | Waktu aktif server |
|
|
21
|
-
| Session ID | Identifier sesi saat ini |
|
|
22
|
-
| Exec Path | Path eksekusi server |
|
|
23
|
-
|
|
24
|
-
## AI Agents
|
|
25
|
-
|
|
26
|
-
Menampilkan daftar agen AI yang sedang terhubung dalam bentuk tabel:
|
|
27
|
-
|
|
28
|
-
| Kolom | Deskripsi |
|
|
29
|
-
|-------|-----------|
|
|
30
|
-
| Name | Nama agen (contoh: Claude Code) |
|
|
31
|
-
| PID | ID proses agen |
|
|
32
|
-
| Working Dir | Direktori kerja agen |
|
|
33
|
-
| Connected | Waktu sejak terhubung |
|
|
34
|
-
|
|
35
|
-
Jika beberapa agen terhubung secara bersamaan, semuanya akan ditampilkan.
|
|
36
|
-
|
|
37
|
-
## Plugins
|
|
38
|
-
|
|
39
|
-
Menampilkan daftar plugin Roblox Studio yang terhubung:
|
|
40
|
-
|
|
41
|
-
| Kolom | Deskripsi |
|
|
42
|
-
|-------|-----------|
|
|
43
|
-
| Place | Nama Place |
|
|
44
|
-
| Client ID | Identifier klien plugin |
|
|
45
|
-
| Last Seen | Waktu komunikasi terakhir |
|
|
46
|
-
| Version | Versi plugin |
|
|
47
|
-
|
|
48
|
-
## Connection Log
|
|
49
|
-
|
|
50
|
-
Menampilkan event terkait koneksi secara real-time. Event koneksi/pemutusan agen/plugin ditambahkan secara otomatis melalui SSE.
|
|
51
|
-
|
|
52
|
-
## Contoh Penggunaan
|
|
53
|
-
|
|
54
|
-
### Diagnosis Masalah Koneksi
|
|
55
|
-
|
|
56
|
-
```
|
|
57
|
-
"Sepertinya AI tidak terhubung dengan Studio"
|
|
58
|
-
```
|
|
59
|
-
|
|
60
|
-
Periksa apakah Server Status menunjukkan Online dan apakah plugin muncul di tabel Plugins. Anda dapat melacak event koneksi/pemutusan di Connection Log.
|
|
61
|
-
|
|
62
|
-
### Konfirmasi Agen
|
|
63
|
-
|
|
64
|
-
```
|
|
65
|
-
"Saya ingin melihat AI mana yang sedang terhubung"
|
|
66
|
-
```
|
|
67
|
-
|
|
68
|
-
Periksa nama, PID, dan direktori kerja agen yang sedang terhubung di tabel AI Agents.
|
|
69
|
-
|
|
70
|
-
## Dokumen Terkait
|
|
71
|
-
|
|
72
|
-
- [WEPPY Dashboard Overview](overview.md)
|
|
73
|
-
- [Changelog](changelog.md)
|
|
74
|
-
- [Sync](sync.md)
|
|
75
|
-
- [Playtest](playtest.md)
|
|
76
|
-
- [Tools](tools.md)
|
|
77
|
-
- [Settings](settings.md)
|
|
@@ -1,95 +0,0 @@
|
|
|
1
|
-
# Dashboard
|
|
2
|
-
|
|
3
|
-
> Pantau dan kelola status, koneksi, sinkronisasi, riwayat eksekusi alat, dan riwayat perubahan game dari server MCP secara real-time melalui browser web.
|
|
4
|
-
|
|
5
|
-

|
|
6
|
-
|
|
7
|
-
## Apa itu Dashboard?
|
|
8
|
-
|
|
9
|
-
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.
|
|
10
|
-
|
|
11
|
-
- Pahami status secara visual tanpa perlu menelusuri log terminal
|
|
12
|
-
- Lacak apa saja yang diubah AI di Studio melalui riwayat perubahan
|
|
13
|
-
- Lihat status sinkronisasi, status koneksi, dan statistik eksekusi alat di satu tempat
|
|
14
|
-
|
|
15
|
-
## Struktur Halaman
|
|
16
|
-
|
|
17
|
-
| Halaman | Deskripsi | Panduan Detail |
|
|
18
|
-
|---------|-----------|----------------|
|
|
19
|
-
| [Overview](#overview) | Kartu status Server/Plugin/Agent/Sync, feed perubahan terbaru | Dokumen ini |
|
|
20
|
-
| [Changelog](changelog.md) | Riwayat perubahan game — kartu per sesi, ringkasan perubahan, timeline, Before & After | [Panduan detail](changelog.md) |
|
|
21
|
-
| [Connection](connection.md) | Status server, daftar agen AI, informasi koneksi plugin | [Panduan detail](connection.md) |
|
|
22
|
-
| [Sync](sync.md) | Status sinkronisasi, pengaturan arah, log | [Panduan detail](sync.md) |
|
|
23
|
-
| [Playtest](playtest.md) | Status playtest, riwayat pengujian | [Panduan detail](playtest.md) |
|
|
24
|
-
| [Tools](tools.md) | Riwayat eksekusi alat, statistik, distribusi tier | [Panduan detail](tools.md) |
|
|
25
|
-
| [Settings](settings.md) | Lisensi, level log, bahasa | [Panduan detail](settings.md) |
|
|
26
|
-
|
|
27
|
-
## Cara Mengakses
|
|
28
|
-
|
|
29
|
-
Saat server MCP dijalankan, dashboard akan terbuka secara otomatis di browser. Untuk mengakses secara manual:
|
|
30
|
-
|
|
31
|
-
```
|
|
32
|
-
http://localhost:3002
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
> Atur `DASHBOARD_AUTO_OPEN=false` untuk menonaktifkan pembukaan otomatis (lihat halaman [Settings](settings.md)).
|
|
36
|
-
|
|
37
|
-
## Status Koneksi
|
|
38
|
-
|
|
39
|
-
Fitur yang tersedia di dashboard berbeda tergantung pada status koneksi:
|
|
40
|
-
|
|
41
|
-
| Status | Kondisi | Halaman yang Tersedia |
|
|
42
|
-
|--------|---------|----------------------|
|
|
43
|
-
| **Server terputus** | Server tidak terhubung | Hanya menampilkan layar menunggu koneksi ulang |
|
|
44
|
-
| **Server terhubung** | Server terhubung, plugin tidak terhubung | Connection, Tools, Settings |
|
|
45
|
-
| **Studio terhubung** | Server + Plugin keduanya terhubung | Semua halaman |
|
|
46
|
-
|
|
47
|
-
Saat dashboard berada dalam status **Server terhubung**, halaman Overview, Changelog, Sync, dan Playtest tidak dapat diakses.
|
|
48
|
-
|
|
49
|
-
## Overview
|
|
50
|
-
|
|
51
|
-
Halaman Overview adalah layar utama dashboard yang menampilkan status keseluruhan sistem dalam satu pandangan.
|
|
52
|
-
|
|
53
|
-
### Kartu Status
|
|
54
|
-
|
|
55
|
-
| Kartu | Informasi yang Ditampilkan |
|
|
56
|
-
|-------|---------------------------|
|
|
57
|
-
| **Server** | Status koneksi server (Online/Offline) |
|
|
58
|
-
| **Plugin** | Status koneksi plugin, informasi Place |
|
|
59
|
-
| **Agent** | Nama agen AI yang sedang terhubung |
|
|
60
|
-
| **Sync** | Status sinkronisasi (Idle/Syncing/Error) |
|
|
61
|
-
|
|
62
|
-
### Perubahan Game Terbaru (Recent Game Changes)
|
|
63
|
-
|
|
64
|
-
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).
|
|
65
|
-
|
|
66
|
-
Ikon kategori:
|
|
67
|
-
- Script — pembuatan/pengeditan script
|
|
68
|
-
- Instance — pembuatan/penghapusan/pemindahan instance
|
|
69
|
-
- Property — perubahan properti
|
|
70
|
-
- Lighting — pengaturan pencahayaan/lingkungan
|
|
71
|
-
- Terrain — perubahan terrain
|
|
72
|
-
- Asset — penyisipan aset
|
|
73
|
-
|
|
74
|
-
### Ringkasan Perubahan Sesi (Session Change Summary)
|
|
75
|
-
|
|
76
|
-
Menampilkan statistik perubahan sesi saat ini yang diagregasi per kategori (contoh: "4 scripts - 3 properties").
|
|
77
|
-
|
|
78
|
-
## Pembaruan Real-time
|
|
79
|
-
|
|
80
|
-
Dashboard menggunakan SSE (Server-Sent Events) untuk memperbarui data secara real-time:
|
|
81
|
-
|
|
82
|
-
- Status server: polling setiap 5 detik
|
|
83
|
-
- Feed perubahan, event koneksi: streaming real-time via SSE
|
|
84
|
-
- Saat koneksi SSE terputus: koneksi ulang otomatis setelah 3 detik
|
|
85
|
-
|
|
86
|
-
## Dokumen Terkait
|
|
87
|
-
|
|
88
|
-
- [Changelog](changelog.md) — pelacakan riwayat perubahan game
|
|
89
|
-
- [Connection](connection.md) — status koneksi server/agen/plugin
|
|
90
|
-
- [Sync](sync.md) — pemantauan status sinkronisasi
|
|
91
|
-
- [Playtest](playtest.md) — riwayat playtest
|
|
92
|
-
- [Tools](tools.md) — riwayat/statistik eksekusi alat
|
|
93
|
-
- [Settings](settings.md) — lisensi, pengaturan server, bahasa
|
|
94
|
-
- [Daftar tool lengkap](../tools/overview.md)
|
|
95
|
-
- [Panduan detail fitur Sync](../sync/overview.md)
|
|
@@ -1,61 +0,0 @@
|
|
|
1
|
-
# Playtest
|
|
2
|
-
|
|
3
|
-
> Periksa status playtest yang dijalankan AI dan hasil pengujian.
|
|
4
|
-
|
|
5
|
-

|
|
6
|
-
|
|
7
|
-
## Ikhtisar
|
|
8
|
-
|
|
9
|
-
Halaman Playtest menampilkan status dan hasil pengujian dari playtest yang dijalankan AI. Halaman ini hanya dapat diakses saat dashboard berada dalam status **Studio terhubung**.
|
|
10
|
-
|
|
11
|
-
## Playtest Status
|
|
12
|
-
|
|
13
|
-
Menampilkan status playtest saat ini:
|
|
14
|
-
|
|
15
|
-
| Status | Arti |
|
|
16
|
-
|--------|------|
|
|
17
|
-
| **NotRunning** | Playtest tidak berjalan |
|
|
18
|
-
| **Running** | Playtest sedang berjalan |
|
|
19
|
-
| **Paused** | Playtest dijeda (mode Run) |
|
|
20
|
-
|
|
21
|
-
## Test History
|
|
22
|
-
|
|
23
|
-
Menampilkan hasil pengujian yang dijalankan AI melalui aksi `run_test` secara kronologis:
|
|
24
|
-
|
|
25
|
-
| Item | Deskripsi |
|
|
26
|
-
|------|-----------|
|
|
27
|
-
| Timestamp | Waktu eksekusi pengujian |
|
|
28
|
-
| Test Report | Tautan ke laporan pengujian |
|
|
29
|
-
| Mode | Mode eksekusi (play/run) |
|
|
30
|
-
| Duration | Durasi pengujian |
|
|
31
|
-
| Status | Hasil (Passed/Failed) |
|
|
32
|
-
|
|
33
|
-
Klik laporan pengujian untuk melihat laporan detail dalam format markdown beserta log.
|
|
34
|
-
|
|
35
|
-
## Contoh Penggunaan
|
|
36
|
-
|
|
37
|
-
### Analisis Kegagalan Pengujian
|
|
38
|
-
|
|
39
|
-
```
|
|
40
|
-
"Saya ingin mencari penyebab kegagalan pengujian otomatis yang baru saja dijalankan"
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
Cari pengujian dengan status Failed di Test History dan klik Test Report untuk melihat log detail dan penyebab kegagalan.
|
|
44
|
-
|
|
45
|
-
### Memeriksa Riwayat Pengujian
|
|
46
|
-
|
|
47
|
-
```
|
|
48
|
-
"Saya ingin melihat status keberhasilan/kegagalan pengujian yang dijalankan hari ini"
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
Periksa timestamp dan Status di Test History untuk memahami tren hasil pengujian.
|
|
52
|
-
|
|
53
|
-
## Dokumen Terkait
|
|
54
|
-
|
|
55
|
-
- [WEPPY Dashboard Overview](overview.md)
|
|
56
|
-
- [Changelog](changelog.md)
|
|
57
|
-
- [Connection](connection.md)
|
|
58
|
-
- [Sync](sync.md)
|
|
59
|
-
- [Tools](tools.md)
|
|
60
|
-
- [Settings](settings.md)
|
|
61
|
-
- [Playtest & tes otomatis (alat)](../tools/playtest.md)
|