@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,114 +0,0 @@
1
- # Changelog
2
-
3
- > Registra todas as alteracoes realizadas pela IA no Roblox Studio por sessao, fornecendo resumo de alteracoes/timeline/Before & After.
4
-
5
- ![Changelog — lista de cards de alteracoes por sessao](../../assets/screenshots/dashboard/dashboard_changelog1.png)
6
-
7
- ## Visao geral
8
-
9
- O Changelog e a pagina que rastreia o historico de alteracoes do jogo realizadas pelo agente de IA no Studio. As alteracoes sao agrupadas por sessao, permitindo visualizar rapidamente quantas alteracoes de cada tipo ocorreram em cada sessao.
10
-
11
- ## Lista de cards de sessao
12
-
13
- A tela inicial do Changelog exibe uma lista de cards por sessao.
14
-
15
- ### Status da sessao
16
-
17
- Cada card de sessao exibe um status:
18
-
19
- | Status | Significado |
20
- |--------|-------------|
21
- | **Active** | Sessao em andamento (atualizacao em tempo real) |
22
- | **Completed** | Sessao concluida |
23
- | **Bootstrap** | Sessao de sincronizacao inicial |
24
-
25
- ### Resumo da sessao
26
-
27
- Cada card exibe um resumo da quantidade de alteracoes por categoria na respectiva sessao:
28
-
29
- - Script — quantidade de scripts criados/modificados
30
- - Instance — quantidade de instancias criadas/excluidas/movidas
31
- - Property — quantidade de propriedades alteradas
32
- - Lighting — quantidade de alteracoes de iluminacao/ambiente
33
- - Terrain — quantidade de alteracoes de terreno
34
- - Asset — quantidade de assets inseridos
35
-
36
- ### Abas de filtro
37
-
38
- Voce pode filtrar as sessoes pelas abas superiores:
39
- - **All** — Todas as sessoes
40
- - **Active** — Apenas sessoes em andamento
41
- - **Completed** — Apenas sessoes concluidas
42
-
43
- ## Visualizacao detalhada da sessao
44
-
45
- Clique em um card de sessao para acessar a visualizacao detalhada.
46
-
47
- ![Visualizacao detalhada do Changelog — resumo de alteracoes, timeline, Before & After](../../assets/screenshots/dashboard/dashboard_changelog2.png)
48
-
49
- ### Change Summary
50
-
51
- Visualiza as alteracoes da sessao em 6 cards de categoria:
52
-
53
- | Categoria | Icone | Descricao |
54
- |-----------|-------|-----------|
55
- | Scripts | Script | Quantidade de scripts criados/modificados |
56
- | Instances | Instancia | Quantidade de instancias criadas/excluidas/movidas |
57
- | Properties | Propriedade | Quantidade de propriedades alteradas |
58
- | Lighting | Iluminacao | Quantidade de alteracoes de iluminacao/ambiente |
59
- | Terrain | Terreno | Quantidade de alteracoes de terreno |
60
- | Assets | Asset | Quantidade de assets inseridos |
61
-
62
- ### Change Timeline
63
-
64
- Lista todas as alteracoes da sessao em ordem cronologica.
65
-
66
- - Cada item exibe timestamp, tag de categoria da alteracao e caminho do alvo
67
- - O dropdown **Category** permite filtrar por uma categoria especifica
68
- - Ao clicar em um item, a visualizacao comparativa Before & After e expandida
69
-
70
- ### Before & After
71
-
72
- Compara os dados antes e depois da alteracao. Fornece diferentes niveis de informacao conforme o tipo de alteracao:
73
-
74
- | Confiabilidade | Significado | Exemplo |
75
- |----------------|-------------|---------|
76
- | **exact** | Valores antes e depois registrados com precisao | Alteracao de propriedade, modificacao de script |
77
- | **partial** | Apenas parte das informacoes registrada | Alteracoes compostas |
78
- | **after-only** | Apenas o valor posterior existe | Criacao de nova instancia |
79
- | **intent-only** | Apenas a intencao registrada | Exclusao, etc. |
80
-
81
- ## Casos de uso
82
-
83
- ### Verificacao de trabalho
84
-
85
- ```
86
- "Quero verificar quais scripts a IA acabou de modificar"
87
- ```
88
-
89
- Filtre a categoria Script da sessao Active no Changelog para comparar a lista de scripts modificados e o codigo antes e depois.
90
-
91
- ### Rastreamento de alteracoes
92
-
93
- ```
94
- "Quero rever como o Lighting foi configurado na sessao de ontem"
95
- ```
96
-
97
- Encontre a sessao na aba Completed e filtre pela categoria Lighting para verificar o historico de alteracoes e os valores configurados.
98
-
99
- ### Depuracao de problemas
100
-
101
- ```
102
- "Preciso descobrir em que momento uma determinada instancia foi excluida"
103
- ```
104
-
105
- Filtre a categoria Instance na timeline e rastreie as alteracoes do tipo delete em ordem cronologica.
106
-
107
- ## Documentos relacionados
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
- > Monitore o status de conexao do servidor, agentes de IA e plugin em um so lugar.
4
-
5
- ![Connection — status do servidor, agentes de IA, informacoes de conexao do plugin](../../assets/screenshots/dashboard/dashboard_connection.png)
6
-
7
- ## Visao geral
8
-
9
- A pagina Connection monitora todos os status de conexao do sistema MCP em um unico local. Esta sempre acessivel quando o dashboard esta em estado **Servidor conectado** ou **Studio conectado**.
10
-
11
- ## Server Status
12
-
13
- Exibe as informacoes essenciais do servidor:
14
-
15
- | Item | Descricao |
16
- |------|-----------|
17
- | Status | Badge de status de conexao (Online/Offline) |
18
- | Version | Versao do servidor MCP |
19
- | PID | ID do processo do servidor |
20
- | Uptime | Tempo de atividade do servidor |
21
- | Session ID | Identificador da sessao atual |
22
- | Exec Path | Caminho de execucao do servidor |
23
-
24
- ## AI Agents
25
-
26
- Exibe em tabela a lista de agentes de IA conectados atualmente:
27
-
28
- | Coluna | Descricao |
29
- |--------|-----------|
30
- | Name | Nome do agente (ex.: Claude Code) |
31
- | PID | ID do processo do agente |
32
- | Working Dir | Diretorio de trabalho do agente |
33
- | Connected | Tempo decorrido desde a conexao |
34
-
35
- Quando varios agentes estao conectados simultaneamente, todos sao exibidos.
36
-
37
- ## Plugins
38
-
39
- Exibe a lista de plugins do Roblox Studio conectados:
40
-
41
- | Coluna | Descricao |
42
- |--------|-----------|
43
- | Place | Nome do Place |
44
- | Client ID | Identificador do cliente do plugin |
45
- | Last Seen | Horario da ultima comunicacao |
46
- | Version | Versao do plugin |
47
-
48
- ## Connection Log
49
-
50
- Exibe eventos relacionados a conexao em tempo real. Eventos de conexao/desconexao de agentes/plugins sao adicionados automaticamente via SSE.
51
-
52
- ## Casos de uso
53
-
54
- ### Diagnostico de problemas de conexao
55
-
56
- ```
57
- "Parece que a IA nao esta conseguindo se conectar ao Studio"
58
- ```
59
-
60
- Verifique se o Server Status esta Online e se o plugin aparece na tabela Plugins. Voce pode rastrear eventos de conexao/desconexao no Connection Log.
61
-
62
- ### Verificacao de agentes
63
-
64
- ```
65
- "Quero verificar qual IA esta conectada agora"
66
- ```
67
-
68
- Confira o nome, PID e diretorio de trabalho do agente conectado na tabela AI Agents.
69
-
70
- ## Documentos relacionados
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
- > Monitore e gerencie em tempo real o status, conexoes, sincronizacao, historico de execucao de ferramentas e historico de alteracoes do jogo do servidor MCP diretamente no navegador.
4
-
5
- ![WEPPY Dashboard Overview — status do servidor, alteracoes recentes e resumo da sessao em uma unica tela](../../assets/screenshots/dashboard/dashboard_overview.png)
6
-
7
- ## O que e o Dashboard?
8
-
9
- O Dashboard e uma interface de monitoramento baseada na web fornecida pelo servidor MCP. Ele abre automaticamente no navegador quando o servidor MCP e iniciado, permitindo acompanhar em tempo real todas as operacoes que o agente de IA realiza no Roblox Studio.
10
-
11
- - Visualize o status de forma grafica sem precisar vasculhar logs do terminal
12
- - Acompanhe o que a IA alterou no Studio atraves do historico de alteracoes
13
- - Verifique status de sincronizacao, conexao e estatisticas de execucao de ferramentas em um so lugar
14
-
15
- ## Estrutura das paginas
16
-
17
- | Pagina | Descricao | Guia detalhado |
18
- |--------|-----------|----------------|
19
- | [Overview](#overview) | Cards de status do servidor/plugin/agente/Sync, feed de alteracoes recentes | Este documento |
20
- | [Changelog](changelog.md) | Historico de alteracoes do jogo — cards por sessao, resumo de alteracoes, timeline, Before & After | [Guia detalhado](changelog.md) |
21
- | [Connection](connection.md) | Status do servidor, lista de agentes de IA, informacoes de conexao do plugin | [Guia detalhado](connection.md) |
22
- | [Sync](sync.md) | Status de sincronizacao, configuracao de direcao, logs | [Guia detalhado](sync.md) |
23
- | [Playtest](playtest.md) | Status do playtest, historico de testes | [Guia detalhado](playtest.md) |
24
- | [Tools](tools.md) | Historico de execucao de ferramentas, estatisticas, distribuicao por tier | [Guia detalhado](tools.md) |
25
- | [Settings](settings.md) | Licenca, nivel de log, idioma | [Guia detalhado](settings.md) |
26
-
27
- ## Como acessar
28
-
29
- Quando o servidor MCP e iniciado, o Dashboard abre automaticamente no navegador. Para acessar manualmente:
30
-
31
- ```
32
- http://localhost:3002
33
- ```
34
-
35
- > Defina `DASHBOARD_AUTO_OPEN=false` para desativar a abertura automatica (consulte a pagina [Settings](settings.md)).
36
-
37
- ## Estados de conexao
38
-
39
- O Dashboard oferece funcionalidades diferentes de acordo com o status da conexao:
40
-
41
- | Estado | Condicao | Paginas disponiveis |
42
- |--------|----------|---------------------|
43
- | **Servidor desconectado** | Servidor desconectado | Exibe apenas a tela de aguardando reconexao |
44
- | **Servidor conectado** | Servidor conectado, plugin desconectado | Connection, Tools, Settings |
45
- | **Studio conectado** | Servidor + plugin ambos conectados | Todas as paginas |
46
-
47
- Quando o dashboard esta em estado **Servidor conectado**, as paginas Overview, Changelog, Sync e Playtest nao ficam acessiveis.
48
-
49
- ## Overview
50
-
51
- A pagina Overview e a tela inicial do Dashboard e mostra o status geral do sistema em uma unica visualizacao.
52
-
53
- ### Cards de status
54
-
55
- | Card | Informacao exibida |
56
- |------|--------------------|
57
- | **Server** | Status de conexao do servidor (Online/Offline) |
58
- | **Plugin** | Status de conexao do plugin, informacoes do Place |
59
- | **Agent** | Nome do agente de IA conectado atualmente |
60
- | **Sync** | Status de sincronizacao (Idle/Syncing/Error) |
61
-
62
- ### Alteracoes recentes do jogo (Recent Game Changes)
63
-
64
- Exibe em tempo real as alteracoes recentes realizadas pela IA no Studio (maximo 20). Cada item e exibido com um icone de categoria de alteracao e, ao clicar, voce e direcionado para a visualizacao detalhada no [Changelog](changelog.md).
65
-
66
- Icones de categoria:
67
- - Script — criacao/modificacao de scripts
68
- - Instance — criacao/exclusao/movimentacao de instancias
69
- - Property — alteracao de propriedades
70
- - Lighting — configuracoes de iluminacao/ambiente
71
- - Terrain — alteracoes de terreno
72
- - Asset — insercao de assets
73
-
74
- ### Resumo de alteracoes da sessao (Session Change Summary)
75
-
76
- Mostra as estatisticas de alteracoes da sessao atual agregadas por categoria (ex.: "4 scripts · 3 properties").
77
-
78
- ## Atualizacoes em tempo real
79
-
80
- O Dashboard utiliza SSE (Server-Sent Events) para atualizar dados em tempo real:
81
-
82
- - Status do servidor: polling a cada 5 segundos
83
- - Feed de alteracoes, eventos de conexao: streaming em tempo real via SSE
84
- - Desconexao do SSE: reconexao automatica apos 3 segundos
85
-
86
- ## Documentos relacionados
87
-
88
- - [Changelog](changelog.md) — Rastreamento do historico de alteracoes do jogo
89
- - [Connection](connection.md) — Status de conexao do servidor/agente/plugin
90
- - [Sync](sync.md) — Monitoramento do status de sincronizacao
91
- - [Playtest](playtest.md) — Historico de playtest
92
- - [Tools](tools.md) — Historico/estatisticas de execucao de ferramentas
93
- - [Settings](settings.md) — Licenca, configuracoes do servidor, idioma
94
- - [Lista completa de Tools](../tools/overview.md)
95
- - [Guia detalhado de Sync](../sync/overview.md)
@@ -1,61 +0,0 @@
1
- # Playtest
2
-
3
- > Verifique o status e os resultados dos playtests executados pela IA.
4
-
5
- ![Playtest — status do playtest e historico de testes](../../assets/screenshots/dashboard/dashboard_playtest.png)
6
-
7
- ## Visao geral
8
-
9
- A pagina Playtest exibe o status e os resultados dos playtests executados pela IA. So fica acessivel quando o dashboard esta em estado **Studio conectado**.
10
-
11
- ## Playtest Status
12
-
13
- Exibe o status atual do playtest:
14
-
15
- | Status | Significado |
16
- |--------|-------------|
17
- | **NotRunning** | Playtest nao iniciado |
18
- | **Running** | Playtest em execucao |
19
- | **Paused** | Playtest pausado (modo Run) |
20
-
21
- ## Test History
22
-
23
- Lista em ordem cronologica os resultados dos testes executados pela IA com a acao `run_test`:
24
-
25
- | Item | Descricao |
26
- |------|-----------|
27
- | Timestamp | Horario de execucao do teste |
28
- | Test Report | Link para o relatorio do teste |
29
- | Mode | Modo de execucao (play/run) |
30
- | Duration | Duracao do teste |
31
- | Status | Resultado (Passed/Failed) |
32
-
33
- Ao clicar no relatorio de teste, voce pode visualizar o relatorio detalhado em formato markdown e os logs.
34
-
35
- ## Casos de uso
36
-
37
- ### Analise de falha em testes
38
-
39
- ```
40
- "Quero encontrar a causa da falha no teste automatizado que acabei de executar"
41
- ```
42
-
43
- Encontre o teste com status Failed no Test History e clique em Test Report para verificar os logs detalhados e a causa da falha.
44
-
45
- ### Verificacao do historico de testes
46
-
47
- ```
48
- "Quero ver o panorama de sucesso/falha dos testes executados hoje"
49
- ```
50
-
51
- Verifique o timestamp e o Status no Test History para acompanhar a tendencia dos resultados dos testes.
52
-
53
- ## Documentos relacionados
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 e testes automatizados (ferramentas)](../tools/playtest.md)
@@ -1,60 +0,0 @@
1
- # Settings
2
-
3
- > Verifique e gerencie informacoes de licenca, configuracoes do servidor e idioma.
4
-
5
- ## Visao geral
6
-
7
- Na pagina Settings, voce pode verificar as informacoes de licenca e as configuracoes do servidor, alem de alterar algumas delas. Esta sempre acessivel quando o dashboard esta em estado **Servidor conectado** ou **Studio conectado**.
8
-
9
- ## License (somente leitura)
10
-
11
- Exibe o status atual da licenca:
12
-
13
- | Item | Descricao |
14
- |------|-----------|
15
- | Status | Badge de status (Active/Inactive) |
16
- | Tier | Tier atual (Basic/Pro) |
17
- | License Key | Chave de licenca mascarada |
18
- | Provider | Informacoes do provedor da licenca |
19
-
20
- ## General
21
-
22
- | Configuracao | Descricao |
23
- |--------------|-----------|
24
- | Log Level | Nivel de saida de logs |
25
- | History Recording | Se o historico de execucao de ferramentas e salvo |
26
- | Stats Collection | Se as estatisticas de ferramentas sao coletadas |
27
- | Request Timeout | Timeout de requisicao (segundos) |
28
-
29
- ## Server Environment (somente leitura)
30
-
31
- Exibe as configuracoes do servidor definidas por variaveis de ambiente:
32
-
33
- | Variavel de ambiente | Descricao | Valor padrao |
34
- |---------------------|-----------|--------------|
35
- | `HTTP_PORT` | Porta HTTP | 3002 |
36
- | `HTTP_HOST` | Host HTTP | 127.0.0.1 |
37
- | `DASHBOARD_AUTO_OPEN` | Abertura automatica do Dashboard | true |
38
-
39
- ## Language
40
-
41
- Altere o idioma da interface do Dashboard. Suporta 6 idiomas + Auto (deteccao automatica do idioma do navegador).
42
-
43
- | Opcao | Idioma |
44
- |-------|--------|
45
- | Auto | Deteccao automatica do idioma do navegador |
46
- | English | Ingles |
47
- | 한국어 | Coreano |
48
- | 日本語 | Japones |
49
- | Español | Espanhol |
50
- | Português | Portugues |
51
- | Bahasa Indonesia | Indonesio |
52
-
53
- ## Documentos relacionados
54
-
55
- - [WEPPY Dashboard Overview](overview.md)
56
- - [Changelog](changelog.md)
57
- - [Connection](connection.md)
58
- - [Sync](sync.md)
59
- - [Playtest](playtest.md)
60
- - [Tools](tools.md)
@@ -1,68 +0,0 @@
1
- # Sync
2
-
3
- > Monitore o status atual, configuracao de direcao e logs da sincronizacao Studio <-> arquivos locais.
4
-
5
- ![Sync — status de sincronizacao, configuracao de direcao, logs](../../assets/screenshots/dashboard/dashboard_sync.png)
6
-
7
- > Para o guia detalhado da funcionalidade Sync em si, consulte o [Guia detalhado de Sync](../sync/overview.md).
8
-
9
- ## Visao geral
10
-
11
- A pagina Sync exibe visualmente o status atual e as configuracoes da sincronizacao Studio <-> arquivos locais. So fica acessivel quando o dashboard esta em estado **Studio conectado**.
12
-
13
- ## Sync Status
14
-
15
- Exibe o status atual da sincronizacao:
16
-
17
- | Status | Significado |
18
- |--------|-------------|
19
- | **Idle** | Aguardando sincronizacao |
20
- | **Initializing** | Sincronizacao inicial em andamento |
21
- | **Syncing** | Sincronizacao incremental em andamento |
22
- | **Error** | Erro de sincronizacao ocorrido |
23
-
24
- O card de status tambem exibe o caminho de sincronizacao, a quantidade de instancias sincronizadas e o modo de aplicacao atual (Auto/Manual).
25
-
26
- ## Sync Directions
27
-
28
- Exibe em tabela a direcao de sincronizacao por tipo:
29
-
30
- | Coluna | Descricao |
31
- |--------|-----------|
32
- | Type | Tipo do alvo de sincronizacao (Scripts, Values, Instances, Data, Services) |
33
- | Direction | Direcao da sincronizacao (Local -> Studio, Studio -> Local) |
34
- | Apply Mode | Modo de aplicacao (Auto/Manual) |
35
-
36
- Verifique a direcao de sincronizacao de cada tipo para entender em qual sentido as alteracoes sao refletidas.
37
-
38
- ## Sync Log
39
-
40
- Exibe os eventos de sincronizacao em ordem cronologica. Cada entrada de log inclui uma tag de tipo de alteracao (create, update, delete, etc.) e o caminho do alvo.
41
-
42
- ## Casos de uso
43
-
44
- ### Verificacao do status de sincronizacao
45
-
46
- ```
47
- "Quero verificar se o Sync esta funcionando corretamente"
48
- ```
49
-
50
- Confirme se o Sync Status esta Idle e verifique no Sync Log se as alteracoes recentes foram registradas normalmente.
51
-
52
- ### Identificacao da direcao de sincronizacao
53
-
54
- ```
55
- "Quero saber em qual direcao as alteracoes de script sao sincronizadas"
56
- ```
57
-
58
- Verifique a Direction do tipo Scripts na tabela Sync Directions.
59
-
60
- ## Documentos relacionados
61
-
62
- - [WEPPY Dashboard Overview](overview.md)
63
- - [Changelog](changelog.md)
64
- - [Connection](connection.md)
65
- - [Playtest](playtest.md)
66
- - [Tools](tools.md)
67
- - [Settings](settings.md)
68
- - [Guia detalhado de Sync](../sync/overview.md)
@@ -1,69 +0,0 @@
1
- # Tools
2
-
3
- > Verifique o historico e as estatisticas das ferramentas MCP executadas pela IA.
4
-
5
- ![Tools — historico de execucao e estatisticas das ferramentas](../../assets/screenshots/dashboard/dashboard_tools.png)
6
-
7
- ## Visao geral
8
-
9
- A pagina Tools fornece o historico e as estatisticas das ferramentas MCP executadas pela IA. E composta por duas sub-abas: **History** e **Statistics**. Esta sempre acessivel quando o dashboard esta em estado **Servidor conectado** ou **Studio conectado**.
10
-
11
- ## Aba History
12
-
13
- Exibe o historico de execucao das ferramentas em tabela cronologica:
14
-
15
- | Coluna | Descricao |
16
- |--------|-----------|
17
- | Time | Horario de execucao |
18
- | Tool.Action | Ferramenta e acao executadas (ex.: `query_instances.get_instance`) |
19
- | Duration | Tempo de execucao |
20
- | Status | Status do resultado (OK/Error) |
21
- | Tier | Tier utilizado (Basic/Pro) |
22
-
23
- Funcionalidades:
24
- - Dropdown **Tool filter** para filtrar uma ferramenta especifica
25
- - Paginacao para navegar por grandes volumes de registros
26
- - Adicao de novos registros de execucao em tempo real
27
-
28
- ## Aba Statistics
29
-
30
- Analisa visualmente as estatisticas de uso das ferramentas:
31
-
32
- - **Distribuicao por tier** — Proporcao de uso de ferramentas Basic/Pro
33
- - **Estatisticas por ferramenta** — Quantidade de chamadas e tempo medio de resposta de cada ferramenta
34
- - **Analise por acao** — Estatisticas detalhadas por acao dentro de cada ferramenta
35
-
36
- ## Funcionalidades exclusivas do tier Basic
37
-
38
- Para usuarios do tier Basic, uma UI adicional e exibida:
39
-
40
- - **Tier Usage Progress** — Barra de progresso de uso
41
- - **Modal comparativo Basic vs Pro** — Apresenta as funcionalidades adicionais do tier Pro
42
-
43
- ## Casos de uso
44
-
45
- ### Analise de desempenho de ferramentas
46
-
47
- ```
48
- "Quero saber qual ferramenta demora mais"
49
- ```
50
-
51
- Verifique o tempo medio de resposta por ferramenta na aba Statistics.
52
-
53
- ### Rastreamento de erros
54
-
55
- ```
56
- "Quero saber por que a ferramenta que acabei de executar falhou"
57
- ```
58
-
59
- Encontre o item com Status Error na aba History para verificar as informacoes detalhadas.
60
-
61
- ## Documentos relacionados
62
-
63
- - [WEPPY Dashboard Overview](overview.md)
64
- - [Changelog](changelog.md)
65
- - [Connection](connection.md)
66
- - [Sync](sync.md)
67
- - [Playtest](playtest.md)
68
- - [Settings](settings.md)
69
- - [Lista completa de Tools](../tools/overview.md)
@@ -1,93 +0,0 @@
1
- # Guia de Instalação
2
-
3
- Para usar o Roblox MCP você precisa instalar **duas coisas**.
4
-
5
- ```
6
- App de IA (Claude, Codex, Gemini, etc.)
7
-
8
- Servidor MCP ← Aqui os comandos da IA são convertidos para o formato do Roblox
9
-
10
- Plugin Roblox Studio ← Executa os comandos dentro do Studio
11
- ```
12
-
13
- Quando o app de IA diz "cria uma parte azul", o servidor MCP converte o pedido e o plugin do Roblox Studio cria a parte de verdade.
14
-
15
- ---
16
-
17
- ## Instalação em um comando (Recomendado)
18
-
19
- Instale tudo com um único comando:
20
-
21
- **macOS / Linux**
22
-
23
- ```bash
24
- curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
25
- ```
26
-
27
- **Windows (PowerShell)**
28
-
29
- ```powershell
30
- irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
31
- ```
32
-
33
- Reinicie o Roblox Studio — pronto!
34
-
35
- O registro automático de MCP suporta **Claude Code, Claude Desktop, Cursor, Codex CLI/App, Gemini CLI e Antigravity**.
36
-
37
- Se a execução do PowerShell estiver bloqueada no Windows, siga a instalação manual abaixo. Se estiver usando o pacote ZIP, você também pode executar `setup-plugin.bat` e `setup-mcp.bat`.
38
-
39
- ---
40
-
41
- ## Instalação manual
42
-
43
- Se a instalacao em um comando nao funcionar, ou quando a instalacao automatica nao puder ser usada no seu ambiente, use a instalacao manual abaixo como alternativa.
44
-
45
- ### Passo 1: Instalar plugin do Roblox Studio
46
-
47
- Baixe o arquivo do plugin no GitHub e coloque na pasta Plugins do Roblox Studio.
48
-
49
- 👉 [Guia de instalação do plugin](https://weppyai.com/en/install#plugin)
50
-
51
- ---
52
-
53
- ### Passo 2: Registrar servidor MCP no app de IA
54
-
55
- Registre o servidor MCP no seu app de IA. Funciona com qualquer app que suporte MCP.
56
-
57
- | App de IA | Guia de Instalação |
58
- |-----------|-------------------|
59
- | Claude Code | [Como Configurar](ai-apps/claude-code.md) |
60
- | Claude Desktop | [Como Configurar](ai-apps/claude-app.md) |
61
- | Cursor | [Como Configurar](ai-apps/cursor.md) |
62
- | Codex CLI | [Como Configurar](ai-apps/codex-cli.md) |
63
- | Codex Desktop | [Como Configurar](ai-apps/codex-app.md) |
64
- | Gemini CLI | [Como Configurar](ai-apps/gemini-cli.md) |
65
- | Antigravity | [Como Configurar](ai-apps/antigravity.md) |
66
-
67
- > Apps de IA que não estão na lista também funcionam se suportarem MCP. O comando do servidor MCP é `npx -y @weppy/roblox-mcp`.
68
-
69
- ---
70
-
71
- ## Opcional: Instalar WEPPY Roblox Explorer (Extensão VSCode)
72
-
73
- Navegue pelas árvores de instâncias sincronizadas dentro do VSCode com ícones de classes Roblox.
74
- Esta extensao opcional exige que a instalacao do Roblox MCP acima ja esteja concluida, porque o Explorer le os dados de Sync em `weppy-project-sync` dentro da raiz do projeto.
75
-
76
- 👉 [Guia de instalação do WEPPY Roblox Explorer](https://weppyai.com/en/install#explorer)
77
-
78
- Instalação direta:
79
- - [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
80
- - [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
81
-
82
- ---
83
-
84
- ## Depois da instalação
85
-
86
- 1. Abra o **Roblox Studio** e na aba Plugins clique em **WEPPY** → **Connect**
87
- 2. No **app de IA** teste assim:
88
-
89
- ```
90
- Crie uma parte azul no Roblox Studio
91
- ```
92
-
93
- Se a parte aparecer, a instalação está completa!