@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.
Files changed (212) hide show
  1. package/.claude-plugin/marketplace.json +2 -2
  2. package/.github/workflows/install-test.yml +55 -4
  3. package/CHANGELOG.md +25 -0
  4. package/README.md +29 -45
  5. package/SUPPORT.md +4 -6
  6. package/docs/assets/screenshots/roblox-explorer/roblox-explorer-property-window.png +0 -0
  7. package/install.ps1 +22 -9
  8. package/install.sh +19 -4
  9. package/llms-full.txt +8 -688
  10. package/llms.txt +3 -13
  11. package/package.json +1 -1
  12. package/plugins/weppy-roblox-mcp/.claude-plugin/plugin.json +1 -1
  13. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ChangelogDetailPage-DRfFUIvC.js → ChangelogDetailPage-C-ROvHGr.js} +1 -1
  14. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ChangelogPage-Dgl8dBt6.js → ChangelogPage-CPm4ft8m.js} +1 -1
  15. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ConfirmModal-DfdyAPrJ.js → ConfirmModal-BSTYLn14.js} +1 -1
  16. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ConnectionPage-LSvSX1_u.js → ConnectionPage-BeJEgfmf.js} +1 -1
  17. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{InfoLabel-DrK7vhO-.js → InfoLabel-BRbbxjjt.js} +1 -1
  18. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{OverviewPage-CXsGuoPu.js → OverviewPage-BHd6yL_8.js} +1 -1
  19. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{PlaytestPage-CgkzRAqQ.js → PlaytestPage-BiNJCh4I.js} +1 -1
  20. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{PropertyDiff-Dy3MffNh.js → PropertyDiff-BKVe7m6g.js} +1 -1
  21. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SettingsPage-Cg33y021.js +1 -0
  22. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{StatusBadge-hJyzgRAl.js → StatusBadge-A72TDL-q.js} +1 -1
  23. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{SyncPage-eX2Rh-Ct.js → SyncPage-R4Qs9Xt3.js} +1 -1
  24. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/TierComparison-CQewH4h_.js +1 -0
  25. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{TierPromoProgress-CLAr1gQq.js → TierPromoProgress-DolZjAqX.js} +1 -1
  26. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ToolsPage-CqzfCxxH.js → ToolsPage-DRX93nSV.js} +1 -1
  27. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/WhatsNewPage-uLdiNHd0.js +1 -0
  28. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{index-BfvSPSNj.js → index-oz4Gtzz9.js} +55 -21
  29. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{useLiveUptime-BeRNzFBh.js → useLiveUptime-CRLLCM8t.js} +1 -1
  30. package/plugins/weppy-roblox-mcp/dashboard/dist/index.html +1 -1
  31. package/plugins/weppy-roblox-mcp/dashboard/dist/weppy-icon.png +0 -0
  32. package/plugins/weppy-roblox-mcp/dist/index.js +76 -76
  33. package/plugins/weppy-roblox-mcp/roblox-plugin/WeppyRobloxMCP.rbxm +0 -0
  34. package/docs/assets/screenshots/roblox-explorer/install-from-vsix.png +0 -0
  35. package/docs/compatibility.md +0 -44
  36. package/docs/en/dashboard/changelog.md +0 -114
  37. package/docs/en/dashboard/connection.md +0 -77
  38. package/docs/en/dashboard/overview.md +0 -95
  39. package/docs/en/dashboard/playtest.md +0 -61
  40. package/docs/en/dashboard/settings.md +0 -60
  41. package/docs/en/dashboard/sync.md +0 -68
  42. package/docs/en/dashboard/tools.md +0 -69
  43. package/docs/en/installation/README.md +0 -95
  44. package/docs/en/installation/ai-apps/antigravity.md +0 -89
  45. package/docs/en/installation/ai-apps/claude-app.md +0 -78
  46. package/docs/en/installation/ai-apps/claude-code.md +0 -104
  47. package/docs/en/installation/ai-apps/codex-app.md +0 -56
  48. package/docs/en/installation/ai-apps/codex-cli.md +0 -67
  49. package/docs/en/installation/ai-apps/cursor.md +0 -77
  50. package/docs/en/installation/ai-apps/gemini-cli.md +0 -120
  51. package/docs/en/installation/roblox-explorer.md +0 -68
  52. package/docs/en/installation/roblox-plugin.md +0 -96
  53. package/docs/en/pro-upgrade.md +0 -96
  54. package/docs/en/sync/luau-lsp.md +0 -41
  55. package/docs/en/sync/overview.md +0 -153
  56. package/docs/en/tools/assets-and-effects.md +0 -104
  57. package/docs/en/tools/instances-and-properties.md +0 -104
  58. package/docs/en/tools/overview.md +0 -277
  59. package/docs/en/tools/playtest.md +0 -140
  60. package/docs/en/tools/scripting.md +0 -66
  61. package/docs/en/tools/system-and-debugging.md +0 -93
  62. package/docs/en/tools/world-and-environment.md +0 -102
  63. package/docs/es/README.md +0 -208
  64. package/docs/es/dashboard/changelog.md +0 -114
  65. package/docs/es/dashboard/connection.md +0 -77
  66. package/docs/es/dashboard/overview.md +0 -95
  67. package/docs/es/dashboard/playtest.md +0 -61
  68. package/docs/es/dashboard/settings.md +0 -60
  69. package/docs/es/dashboard/sync.md +0 -68
  70. package/docs/es/dashboard/tools.md +0 -69
  71. package/docs/es/installation/README.md +0 -87
  72. package/docs/es/installation/ai-apps/antigravity.md +0 -89
  73. package/docs/es/installation/ai-apps/claude-app.md +0 -78
  74. package/docs/es/installation/ai-apps/claude-code.md +0 -104
  75. package/docs/es/installation/ai-apps/codex-app.md +0 -56
  76. package/docs/es/installation/ai-apps/codex-cli.md +0 -67
  77. package/docs/es/installation/ai-apps/cursor.md +0 -77
  78. package/docs/es/installation/ai-apps/gemini-cli.md +0 -120
  79. package/docs/es/installation/roblox-explorer.md +0 -58
  80. package/docs/es/installation/roblox-plugin.md +0 -85
  81. package/docs/es/pro-upgrade.md +0 -96
  82. package/docs/es/sync/luau-lsp.md +0 -41
  83. package/docs/es/sync/overview.md +0 -153
  84. package/docs/es/tools/assets-and-effects.md +0 -104
  85. package/docs/es/tools/instances-and-properties.md +0 -104
  86. package/docs/es/tools/overview.md +0 -277
  87. package/docs/es/tools/playtest.md +0 -140
  88. package/docs/es/tools/scripting.md +0 -66
  89. package/docs/es/tools/system-and-debugging.md +0 -93
  90. package/docs/es/tools/world-and-environment.md +0 -102
  91. package/docs/id/README.md +0 -208
  92. package/docs/id/dashboard/changelog.md +0 -114
  93. package/docs/id/dashboard/connection.md +0 -77
  94. package/docs/id/dashboard/overview.md +0 -95
  95. package/docs/id/dashboard/playtest.md +0 -61
  96. package/docs/id/dashboard/settings.md +0 -60
  97. package/docs/id/dashboard/sync.md +0 -68
  98. package/docs/id/dashboard/tools.md +0 -69
  99. package/docs/id/installation/README.md +0 -93
  100. package/docs/id/installation/ai-apps/antigravity.md +0 -89
  101. package/docs/id/installation/ai-apps/claude-app.md +0 -78
  102. package/docs/id/installation/ai-apps/claude-code.md +0 -104
  103. package/docs/id/installation/ai-apps/codex-app.md +0 -56
  104. package/docs/id/installation/ai-apps/codex-cli.md +0 -67
  105. package/docs/id/installation/ai-apps/cursor.md +0 -77
  106. package/docs/id/installation/ai-apps/gemini-cli.md +0 -120
  107. package/docs/id/installation/roblox-explorer.md +0 -58
  108. package/docs/id/installation/roblox-plugin.md +0 -85
  109. package/docs/id/pro-upgrade.md +0 -96
  110. package/docs/id/sync/luau-lsp.md +0 -41
  111. package/docs/id/sync/overview.md +0 -153
  112. package/docs/id/tools/assets-and-effects.md +0 -104
  113. package/docs/id/tools/instances-and-properties.md +0 -104
  114. package/docs/id/tools/overview.md +0 -277
  115. package/docs/id/tools/playtest.md +0 -140
  116. package/docs/id/tools/scripting.md +0 -66
  117. package/docs/id/tools/system-and-debugging.md +0 -93
  118. package/docs/id/tools/world-and-environment.md +0 -102
  119. package/docs/installer/assets/index-Bz0amd7x.js +0 -63
  120. package/docs/installer/assets/index-ei4lRUa6.css +0 -1
  121. package/docs/installer/index.html +0 -14
  122. package/docs/installer/manifest.webmanifest +0 -15
  123. package/docs/installer/sw.js +0 -7
  124. package/docs/installer/weppy-icon.png +0 -0
  125. package/docs/ja/README.md +0 -206
  126. package/docs/ja/dashboard/changelog.md +0 -114
  127. package/docs/ja/dashboard/connection.md +0 -77
  128. package/docs/ja/dashboard/overview.md +0 -95
  129. package/docs/ja/dashboard/playtest.md +0 -61
  130. package/docs/ja/dashboard/settings.md +0 -60
  131. package/docs/ja/dashboard/sync.md +0 -68
  132. package/docs/ja/dashboard/tools.md +0 -69
  133. package/docs/ja/installation/README.md +0 -93
  134. package/docs/ja/installation/ai-apps/antigravity.md +0 -89
  135. package/docs/ja/installation/ai-apps/claude-app.md +0 -78
  136. package/docs/ja/installation/ai-apps/claude-code.md +0 -104
  137. package/docs/ja/installation/ai-apps/codex-app.md +0 -56
  138. package/docs/ja/installation/ai-apps/codex-cli.md +0 -67
  139. package/docs/ja/installation/ai-apps/cursor.md +0 -77
  140. package/docs/ja/installation/ai-apps/gemini-cli.md +0 -120
  141. package/docs/ja/installation/roblox-explorer.md +0 -58
  142. package/docs/ja/installation/roblox-plugin.md +0 -85
  143. package/docs/ja/pro-upgrade.md +0 -96
  144. package/docs/ja/sync/luau-lsp.md +0 -41
  145. package/docs/ja/sync/overview.md +0 -153
  146. package/docs/ja/tools/assets-and-effects.md +0 -104
  147. package/docs/ja/tools/instances-and-properties.md +0 -104
  148. package/docs/ja/tools/overview.md +0 -277
  149. package/docs/ja/tools/playtest.md +0 -140
  150. package/docs/ja/tools/scripting.md +0 -66
  151. package/docs/ja/tools/system-and-debugging.md +0 -93
  152. package/docs/ja/tools/world-and-environment.md +0 -102
  153. package/docs/ko/README.md +0 -206
  154. package/docs/ko/dashboard/changelog.md +0 -114
  155. package/docs/ko/dashboard/connection.md +0 -77
  156. package/docs/ko/dashboard/overview.md +0 -95
  157. package/docs/ko/dashboard/playtest.md +0 -61
  158. package/docs/ko/dashboard/settings.md +0 -60
  159. package/docs/ko/dashboard/sync.md +0 -68
  160. package/docs/ko/dashboard/tools.md +0 -69
  161. package/docs/ko/installation/README.md +0 -95
  162. package/docs/ko/installation/ai-apps/antigravity.md +0 -88
  163. package/docs/ko/installation/ai-apps/claude-app.md +0 -78
  164. package/docs/ko/installation/ai-apps/claude-code.md +0 -104
  165. package/docs/ko/installation/ai-apps/codex-app.md +0 -56
  166. package/docs/ko/installation/ai-apps/codex-cli.md +0 -67
  167. package/docs/ko/installation/ai-apps/cursor.md +0 -77
  168. package/docs/ko/installation/ai-apps/gemini-cli.md +0 -120
  169. package/docs/ko/installation/roblox-explorer.md +0 -68
  170. package/docs/ko/installation/roblox-plugin.md +0 -96
  171. package/docs/ko/pro-upgrade.md +0 -96
  172. package/docs/ko/sync/luau-lsp.md +0 -41
  173. package/docs/ko/sync/overview.md +0 -153
  174. package/docs/ko/tools/assets-and-effects.md +0 -104
  175. package/docs/ko/tools/instances-and-properties.md +0 -104
  176. package/docs/ko/tools/overview.md +0 -277
  177. package/docs/ko/tools/playtest.md +0 -134
  178. package/docs/ko/tools/scripting.md +0 -66
  179. package/docs/ko/tools/system-and-debugging.md +0 -93
  180. package/docs/ko/tools/world-and-environment.md +0 -102
  181. package/docs/pt-br/README.md +0 -208
  182. package/docs/pt-br/dashboard/changelog.md +0 -114
  183. package/docs/pt-br/dashboard/connection.md +0 -77
  184. package/docs/pt-br/dashboard/overview.md +0 -95
  185. package/docs/pt-br/dashboard/playtest.md +0 -61
  186. package/docs/pt-br/dashboard/settings.md +0 -60
  187. package/docs/pt-br/dashboard/sync.md +0 -68
  188. package/docs/pt-br/dashboard/tools.md +0 -69
  189. package/docs/pt-br/installation/README.md +0 -93
  190. package/docs/pt-br/installation/ai-apps/antigravity.md +0 -89
  191. package/docs/pt-br/installation/ai-apps/claude-app.md +0 -78
  192. package/docs/pt-br/installation/ai-apps/claude-code.md +0 -104
  193. package/docs/pt-br/installation/ai-apps/codex-app.md +0 -56
  194. package/docs/pt-br/installation/ai-apps/codex-cli.md +0 -67
  195. package/docs/pt-br/installation/ai-apps/cursor.md +0 -77
  196. package/docs/pt-br/installation/ai-apps/gemini-cli.md +0 -120
  197. package/docs/pt-br/installation/roblox-explorer.md +0 -58
  198. package/docs/pt-br/installation/roblox-plugin.md +0 -85
  199. package/docs/pt-br/pro-upgrade.md +0 -96
  200. package/docs/pt-br/sync/luau-lsp.md +0 -41
  201. package/docs/pt-br/sync/overview.md +0 -153
  202. package/docs/pt-br/tools/assets-and-effects.md +0 -104
  203. package/docs/pt-br/tools/instances-and-properties.md +0 -104
  204. package/docs/pt-br/tools/overview.md +0 -277
  205. package/docs/pt-br/tools/playtest.md +0 -140
  206. package/docs/pt-br/tools/scripting.md +0 -66
  207. package/docs/pt-br/tools/system-and-debugging.md +0 -93
  208. package/docs/pt-br/tools/world-and-environment.md +0 -102
  209. package/docs/troubleshooting.md +0 -47
  210. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SettingsPage-D2ZBQ2KF.js +0 -1
  211. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/TierComparison-BwKqP_4s.js +0 -1
  212. 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
- [![Demo — AI membuat game Roblox secara real-time](https://img.youtube.com/vi/puQB4u1VlMw/maxresdefault.jpg)](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
- ![Alur Sync — Studio dan file lokal tersinkron secara real time](../assets/screenshots/plugin/sync/sync-overview.png)
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
- ![WEPPY Playtest Dashboard — riwayat tes dan laporan detail](../assets/screenshots/dashboard/dashboard_playtest.png)
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
- ![WEPPY WEPPY Dashboard Overview — status server, perubahan terbaru, ringkasan sesi](../assets/screenshots/dashboard/dashboard_overview.png)
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
- ![WEPPY Roblox Explorer — pohon instance Studio ditampilkan di sidebar VSCode](../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
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
- [![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)
205
-
206
- [![Roblox MCP on Glama](https://glama.ai/mcp/servers/hope1026/roblox-mcp/badges/card.svg)](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
- ![Changelog — daftar kartu perubahan per sesi](../../assets/screenshots/dashboard/dashboard_changelog1.png)
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
- ![Tampilan detail Changelog — ringkasan perubahan, timeline, Before & After](../../assets/screenshots/dashboard/dashboard_changelog2.png)
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
- ![Connection — status server, agen AI, informasi koneksi plugin](../../assets/screenshots/dashboard/dashboard_connection.png)
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
- ![WEPPY Dashboard Overview — status server, perubahan terbaru, dan ringkasan sesi dalam satu tampilan](../../assets/screenshots/dashboard/dashboard_overview.png)
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
- ![Playtest — status playtest dan riwayat pengujian](../../assets/screenshots/dashboard/dashboard_playtest.png)
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)