@weppy/roblox-mcp 2.5.1 → 2.6.1

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 (233) hide show
  1. package/.claude-plugin/marketplace.json +2 -2
  2. package/.github/workflows/install-test.yml +55 -4
  3. package/CHANGELOG.md +27 -0
  4. package/README.md +29 -46
  5. package/SUPPORT.md +4 -6
  6. package/install.ps1 +7 -5
  7. package/install.sh +4 -2
  8. package/llms-full.txt +8 -688
  9. package/llms.txt +3 -13
  10. package/package.json +1 -1
  11. package/plugins/weppy-roblox-mcp/.claude-plugin/plugin.json +1 -1
  12. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ChangelogDetailPage-kwE4pHZd.js +1 -0
  13. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ChangelogPage-BFfSWE_s.js +1 -0
  14. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ConfirmModal-DfdyAPrJ.js → ConfirmModal-CeEegyOx.js} +1 -1
  15. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ConnectionPage-D_mEFudd.css +1 -0
  16. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ConnectionPage-XuHLuNwR.js +1 -0
  17. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/GameChangeDetail-BFTVWFJO.js +6 -0
  18. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{PropertyDiff-Cbx8P1zh.css → GameChangeDetail-Be32PRgR.css} +1 -1
  19. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{InfoLabel-DrK7vhO-.js → InfoLabel-MCIgnb3Z.js} +1 -1
  20. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/OverviewPage-BrWw_dSf.js +1 -0
  21. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{PlaytestPage-CgkzRAqQ.js → PlaytestPage-CxeJXqJZ.js} +2 -2
  22. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SettingsPage-Qd2a2pgi.js +1 -0
  23. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{StatusBadge-hJyzgRAl.js → StatusBadge-Dk0M7zQF.js} +1 -1
  24. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SyncPage-BmMeN4N9.css +1 -0
  25. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SyncPage-Wu2tD8Lb.js +4 -0
  26. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/TierComparison-DsesL0R1.js +1 -0
  27. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ToolsPage-C7ld3BhY.js +1 -0
  28. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/TooltipText-CjH5N6RH.js +1 -0
  29. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/WhatsNewPage-BwWOghgp.js +1 -0
  30. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/index-FDX6EnZH.js +355 -0
  31. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/index-XEVy0XAx.css +1 -0
  32. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{useLiveUptime-BeRNzFBh.js → useLiveUptime-DExWULj9.js} +1 -1
  33. package/plugins/weppy-roblox-mcp/dashboard/dist/index.html +2 -2
  34. package/plugins/weppy-roblox-mcp/dist/index.js +77 -77
  35. package/plugins/weppy-roblox-mcp/roblox-plugin/WeppyRobloxMCP.rbxm +0 -0
  36. package/docs/compatibility.md +0 -44
  37. package/docs/en/dashboard/changelog.md +0 -114
  38. package/docs/en/dashboard/connection.md +0 -77
  39. package/docs/en/dashboard/overview.md +0 -95
  40. package/docs/en/dashboard/playtest.md +0 -61
  41. package/docs/en/dashboard/settings.md +0 -60
  42. package/docs/en/dashboard/sync.md +0 -68
  43. package/docs/en/dashboard/tools.md +0 -69
  44. package/docs/en/explorer/overview.md +0 -104
  45. package/docs/en/installation/README.md +0 -95
  46. package/docs/en/installation/ai-apps/antigravity.md +0 -89
  47. package/docs/en/installation/ai-apps/claude-app.md +0 -78
  48. package/docs/en/installation/ai-apps/claude-code.md +0 -104
  49. package/docs/en/installation/ai-apps/codex-app.md +0 -56
  50. package/docs/en/installation/ai-apps/codex-cli.md +0 -67
  51. package/docs/en/installation/ai-apps/cursor.md +0 -77
  52. package/docs/en/installation/ai-apps/gemini-cli.md +0 -120
  53. package/docs/en/installation/roblox-explorer.md +0 -68
  54. package/docs/en/installation/roblox-plugin.md +0 -96
  55. package/docs/en/pro-upgrade.md +0 -96
  56. package/docs/en/sync/luau-lsp.md +0 -41
  57. package/docs/en/sync/overview.md +0 -153
  58. package/docs/en/tools/assets-and-effects.md +0 -104
  59. package/docs/en/tools/instances-and-properties.md +0 -104
  60. package/docs/en/tools/overview.md +0 -277
  61. package/docs/en/tools/playtest.md +0 -140
  62. package/docs/en/tools/scripting.md +0 -66
  63. package/docs/en/tools/system-and-debugging.md +0 -93
  64. package/docs/en/tools/world-and-environment.md +0 -102
  65. package/docs/es/README.md +0 -209
  66. package/docs/es/dashboard/changelog.md +0 -114
  67. package/docs/es/dashboard/connection.md +0 -77
  68. package/docs/es/dashboard/overview.md +0 -95
  69. package/docs/es/dashboard/playtest.md +0 -61
  70. package/docs/es/dashboard/settings.md +0 -60
  71. package/docs/es/dashboard/sync.md +0 -68
  72. package/docs/es/dashboard/tools.md +0 -69
  73. package/docs/es/explorer/overview.md +0 -104
  74. package/docs/es/installation/README.md +0 -87
  75. package/docs/es/installation/ai-apps/antigravity.md +0 -89
  76. package/docs/es/installation/ai-apps/claude-app.md +0 -78
  77. package/docs/es/installation/ai-apps/claude-code.md +0 -104
  78. package/docs/es/installation/ai-apps/codex-app.md +0 -56
  79. package/docs/es/installation/ai-apps/codex-cli.md +0 -67
  80. package/docs/es/installation/ai-apps/cursor.md +0 -77
  81. package/docs/es/installation/ai-apps/gemini-cli.md +0 -120
  82. package/docs/es/installation/roblox-explorer.md +0 -58
  83. package/docs/es/installation/roblox-plugin.md +0 -85
  84. package/docs/es/pro-upgrade.md +0 -96
  85. package/docs/es/sync/luau-lsp.md +0 -41
  86. package/docs/es/sync/overview.md +0 -153
  87. package/docs/es/tools/assets-and-effects.md +0 -104
  88. package/docs/es/tools/instances-and-properties.md +0 -104
  89. package/docs/es/tools/overview.md +0 -277
  90. package/docs/es/tools/playtest.md +0 -140
  91. package/docs/es/tools/scripting.md +0 -66
  92. package/docs/es/tools/system-and-debugging.md +0 -93
  93. package/docs/es/tools/world-and-environment.md +0 -102
  94. package/docs/id/README.md +0 -209
  95. package/docs/id/dashboard/changelog.md +0 -114
  96. package/docs/id/dashboard/connection.md +0 -77
  97. package/docs/id/dashboard/overview.md +0 -95
  98. package/docs/id/dashboard/playtest.md +0 -61
  99. package/docs/id/dashboard/settings.md +0 -60
  100. package/docs/id/dashboard/sync.md +0 -68
  101. package/docs/id/dashboard/tools.md +0 -69
  102. package/docs/id/explorer/overview.md +0 -104
  103. package/docs/id/installation/README.md +0 -93
  104. package/docs/id/installation/ai-apps/antigravity.md +0 -89
  105. package/docs/id/installation/ai-apps/claude-app.md +0 -78
  106. package/docs/id/installation/ai-apps/claude-code.md +0 -104
  107. package/docs/id/installation/ai-apps/codex-app.md +0 -56
  108. package/docs/id/installation/ai-apps/codex-cli.md +0 -67
  109. package/docs/id/installation/ai-apps/cursor.md +0 -77
  110. package/docs/id/installation/ai-apps/gemini-cli.md +0 -120
  111. package/docs/id/installation/roblox-explorer.md +0 -58
  112. package/docs/id/installation/roblox-plugin.md +0 -85
  113. package/docs/id/pro-upgrade.md +0 -96
  114. package/docs/id/sync/luau-lsp.md +0 -41
  115. package/docs/id/sync/overview.md +0 -153
  116. package/docs/id/tools/assets-and-effects.md +0 -104
  117. package/docs/id/tools/instances-and-properties.md +0 -104
  118. package/docs/id/tools/overview.md +0 -277
  119. package/docs/id/tools/playtest.md +0 -140
  120. package/docs/id/tools/scripting.md +0 -66
  121. package/docs/id/tools/system-and-debugging.md +0 -93
  122. package/docs/id/tools/world-and-environment.md +0 -102
  123. package/docs/installer/assets/index-Bz0amd7x.js +0 -63
  124. package/docs/installer/assets/index-ei4lRUa6.css +0 -1
  125. package/docs/installer/index.html +0 -14
  126. package/docs/installer/manifest.webmanifest +0 -15
  127. package/docs/installer/sw.js +0 -7
  128. package/docs/installer/weppy-icon.png +0 -0
  129. package/docs/ja/README.md +0 -207
  130. package/docs/ja/dashboard/changelog.md +0 -114
  131. package/docs/ja/dashboard/connection.md +0 -77
  132. package/docs/ja/dashboard/overview.md +0 -95
  133. package/docs/ja/dashboard/playtest.md +0 -61
  134. package/docs/ja/dashboard/settings.md +0 -60
  135. package/docs/ja/dashboard/sync.md +0 -68
  136. package/docs/ja/dashboard/tools.md +0 -69
  137. package/docs/ja/explorer/overview.md +0 -104
  138. package/docs/ja/installation/README.md +0 -93
  139. package/docs/ja/installation/ai-apps/antigravity.md +0 -89
  140. package/docs/ja/installation/ai-apps/claude-app.md +0 -78
  141. package/docs/ja/installation/ai-apps/claude-code.md +0 -104
  142. package/docs/ja/installation/ai-apps/codex-app.md +0 -56
  143. package/docs/ja/installation/ai-apps/codex-cli.md +0 -67
  144. package/docs/ja/installation/ai-apps/cursor.md +0 -77
  145. package/docs/ja/installation/ai-apps/gemini-cli.md +0 -120
  146. package/docs/ja/installation/roblox-explorer.md +0 -58
  147. package/docs/ja/installation/roblox-plugin.md +0 -85
  148. package/docs/ja/pro-upgrade.md +0 -96
  149. package/docs/ja/sync/luau-lsp.md +0 -41
  150. package/docs/ja/sync/overview.md +0 -153
  151. package/docs/ja/tools/assets-and-effects.md +0 -104
  152. package/docs/ja/tools/instances-and-properties.md +0 -104
  153. package/docs/ja/tools/overview.md +0 -277
  154. package/docs/ja/tools/playtest.md +0 -140
  155. package/docs/ja/tools/scripting.md +0 -66
  156. package/docs/ja/tools/system-and-debugging.md +0 -93
  157. package/docs/ja/tools/world-and-environment.md +0 -102
  158. package/docs/ko/README.md +0 -207
  159. package/docs/ko/dashboard/changelog.md +0 -114
  160. package/docs/ko/dashboard/connection.md +0 -77
  161. package/docs/ko/dashboard/overview.md +0 -95
  162. package/docs/ko/dashboard/playtest.md +0 -61
  163. package/docs/ko/dashboard/settings.md +0 -60
  164. package/docs/ko/dashboard/sync.md +0 -68
  165. package/docs/ko/dashboard/tools.md +0 -69
  166. package/docs/ko/explorer/overview.md +0 -104
  167. package/docs/ko/installation/README.md +0 -95
  168. package/docs/ko/installation/ai-apps/antigravity.md +0 -88
  169. package/docs/ko/installation/ai-apps/claude-app.md +0 -78
  170. package/docs/ko/installation/ai-apps/claude-code.md +0 -104
  171. package/docs/ko/installation/ai-apps/codex-app.md +0 -56
  172. package/docs/ko/installation/ai-apps/codex-cli.md +0 -67
  173. package/docs/ko/installation/ai-apps/cursor.md +0 -77
  174. package/docs/ko/installation/ai-apps/gemini-cli.md +0 -120
  175. package/docs/ko/installation/roblox-explorer.md +0 -68
  176. package/docs/ko/installation/roblox-plugin.md +0 -96
  177. package/docs/ko/pro-upgrade.md +0 -96
  178. package/docs/ko/sync/luau-lsp.md +0 -41
  179. package/docs/ko/sync/overview.md +0 -153
  180. package/docs/ko/tools/assets-and-effects.md +0 -104
  181. package/docs/ko/tools/instances-and-properties.md +0 -104
  182. package/docs/ko/tools/overview.md +0 -277
  183. package/docs/ko/tools/playtest.md +0 -134
  184. package/docs/ko/tools/scripting.md +0 -66
  185. package/docs/ko/tools/system-and-debugging.md +0 -93
  186. package/docs/ko/tools/world-and-environment.md +0 -102
  187. package/docs/pt-br/README.md +0 -209
  188. package/docs/pt-br/dashboard/changelog.md +0 -114
  189. package/docs/pt-br/dashboard/connection.md +0 -77
  190. package/docs/pt-br/dashboard/overview.md +0 -95
  191. package/docs/pt-br/dashboard/playtest.md +0 -61
  192. package/docs/pt-br/dashboard/settings.md +0 -60
  193. package/docs/pt-br/dashboard/sync.md +0 -68
  194. package/docs/pt-br/dashboard/tools.md +0 -69
  195. package/docs/pt-br/explorer/overview.md +0 -104
  196. package/docs/pt-br/installation/README.md +0 -93
  197. package/docs/pt-br/installation/ai-apps/antigravity.md +0 -89
  198. package/docs/pt-br/installation/ai-apps/claude-app.md +0 -78
  199. package/docs/pt-br/installation/ai-apps/claude-code.md +0 -104
  200. package/docs/pt-br/installation/ai-apps/codex-app.md +0 -56
  201. package/docs/pt-br/installation/ai-apps/codex-cli.md +0 -67
  202. package/docs/pt-br/installation/ai-apps/cursor.md +0 -77
  203. package/docs/pt-br/installation/ai-apps/gemini-cli.md +0 -120
  204. package/docs/pt-br/installation/roblox-explorer.md +0 -58
  205. package/docs/pt-br/installation/roblox-plugin.md +0 -85
  206. package/docs/pt-br/pro-upgrade.md +0 -96
  207. package/docs/pt-br/sync/luau-lsp.md +0 -41
  208. package/docs/pt-br/sync/overview.md +0 -153
  209. package/docs/pt-br/tools/assets-and-effects.md +0 -104
  210. package/docs/pt-br/tools/instances-and-properties.md +0 -104
  211. package/docs/pt-br/tools/overview.md +0 -277
  212. package/docs/pt-br/tools/playtest.md +0 -140
  213. package/docs/pt-br/tools/scripting.md +0 -66
  214. package/docs/pt-br/tools/system-and-debugging.md +0 -93
  215. package/docs/pt-br/tools/world-and-environment.md +0 -102
  216. package/docs/troubleshooting.md +0 -47
  217. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ChangelogDetailPage-DRfFUIvC.js +0 -1
  218. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ChangelogPage-Dgl8dBt6.js +0 -1
  219. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ConnectionPage-9bG71eB1.css +0 -1
  220. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ConnectionPage-LSvSX1_u.js +0 -1
  221. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/OverviewPage-CXsGuoPu.js +0 -1
  222. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/PropertyDiff-Dy3MffNh.js +0 -6
  223. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SettingsPage-D2ZBQ2KF.js +0 -1
  224. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SyncPage-CLt9jxd8.css +0 -1
  225. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SyncPage-eX2Rh-Ct.js +0 -4
  226. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/TierComparison-BwKqP_4s.js +0 -1
  227. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/TierPromo-D5n9OoEm.css +0 -1
  228. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/TierPromo.module-CAoUYgIx.js +0 -1
  229. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/TierPromoProgress-CLAr1gQq.js +0 -1
  230. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/ToolsPage-CqzfCxxH.js +0 -1
  231. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/WhatsNewPage-23o8LmsR.js +0 -1
  232. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/index-BfvSPSNj.js +0 -207
  233. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/index-YfUJSF5s.css +0 -1
@@ -1,56 +0,0 @@
1
- # Configuracion de Codex App
2
-
3
- Como usar Roblox MCP en [OpenAI Codex App](https://openai.com/codex/) (macOS).
4
-
5
- > **Lanzado el 2 de febrero de 2026** - Aplicacion nativa para macOS que soporta flujos de trabajo multi-agente
6
-
7
- ## Requisitos Previos
8
-
9
- - **Codex App** instalado (macOS)
10
- - **Plugin de Roblox Studio** instalado
11
-
12
- ## Registrar el Servidor MCP
13
-
14
- ### Sincronizacion Automatica con Codex CLI
15
-
16
- Si ya configuraste MCP en Codex CLI, puedes usarlo **directamente en la aplicacion sin configuracion adicional**.
17
-
18
- ```
19
- El historial de sesiones y la configuracion del CLI se sincronizan automaticamente con la aplicacion.
20
- ```
21
-
22
- ### Si es una nueva configuracion
23
-
24
- Agrega en **Settings** → **MCP Servers** dentro de la aplicacion:
25
-
26
- ```
27
- Server name: weppy-roblox-mcp
28
- Command: npx -y @weppy/roblox-mcp
29
- ```
30
-
31
- ## Probar la Conexion
32
-
33
- 1. Abre **Roblox Studio** → Pestana Plugins → **WEPPY** → **Connect**
34
- 2. Inicia una nueva conversacion en **Codex App** y prueba:
35
- ```
36
- Dime que esta seleccionado actualmente en Roblox Studio
37
- ```
38
-
39
- ## Solucion de Problemas
40
-
41
- ### El servidor no inicia
42
-
43
- Ejecuta el servidor MCP directamente para ver los errores:
44
- ```bash
45
- npx -y @weppy/roblox-mcp
46
- ```
47
-
48
- ### Fallo de conexion
49
-
50
- - Verifica que el plugin de Roblox Studio este en estado **Connected**
51
- - Verifica que el puerto 3002 no este bloqueado por el firewall
52
-
53
- ## Recursos
54
-
55
- - [Introduccion a Codex App](https://openai.com/index/introducing-the-codex-app/)
56
- - [Documentacion oficial de Codex MCP](https://developers.openai.com/codex/mcp/)
@@ -1,67 +0,0 @@
1
- # Configuracion de Codex CLI
2
-
3
- Como usar Roblox MCP en [OpenAI Codex CLI](https://github.com/openai/codex) (herramienta de codificacion IA basada en terminal).
4
-
5
- ## Requisitos Previos
6
-
7
- - **Node.js** (v18.0.0 o superior)
8
- - **Plugin de Roblox Studio** instalado
9
-
10
- ## Instalacion
11
-
12
- ```bash
13
- npm install -g @openai/codex
14
- ```
15
-
16
- ## Registrar el Servidor MCP
17
-
18
- ### Metodo 1: Comando CLI (Recomendado)
19
-
20
- ```bash
21
- codex mcp add weppy-roblox-mcp -- npx -y @weppy/roblox-mcp
22
- ```
23
-
24
- ### Metodo 2: Editar archivo de configuracion directamente
25
-
26
- Agrega el siguiente contenido al archivo `~/.codex/config.toml`:
27
-
28
- ```toml
29
- [mcp_servers.weppy-roblox-mcp]
30
- command = "npx"
31
- args = ["-y", "@weppy/roblox-mcp"]
32
- ```
33
-
34
- **Ubicacion del archivo de configuracion:**
35
-
36
- | SO | Ruta |
37
- |----|------|
38
- | macOS/Linux | `~/.codex/config.toml` |
39
- | Windows | `%USERPROFILE%\.codex\config.toml` |
40
-
41
- ## Probar la Conexion
42
-
43
- 1. Abre **Roblox Studio** → Pestana Plugins → **WEPPY** → **Connect**
44
- 2. Ejecuta **Codex CLI** e ingresa:
45
- ```
46
- Dime que esta seleccionado actualmente en Roblox Studio
47
- ```
48
-
49
- ## Solucion de Problemas
50
-
51
- ### El servidor no inicia
52
-
53
- Ejecuta el servidor MCP directamente para ver los errores:
54
- ```bash
55
- npx -y @weppy/roblox-mcp
56
- ```
57
-
58
- ### Fallo de conexion
59
-
60
- - Verifica que el plugin de Roblox Studio este en estado **Connected**
61
- - Verifica que el puerto 3002 no este bloqueado por el firewall
62
-
63
- ## Recursos
64
-
65
- - [Codex CLI GitHub](https://github.com/openai/codex)
66
- - [Documentacion oficial de Codex MCP](https://developers.openai.com/codex/mcp/)
67
- - [Referencia de configuracion de Codex](https://developers.openai.com/codex/config-reference/)
@@ -1,77 +0,0 @@
1
- # Configuración de Cursor
2
-
3
- Cómo usar Roblox MCP con [Cursor](https://cursor.com/).
4
-
5
- ## Requisitos previos
6
-
7
- - **Cursor** instalado
8
- - **Node.js** (v18.0.0 o superior)
9
- - **Plugin de Roblox Studio** instalado
10
-
11
- ## Registrar el servidor MCP
12
-
13
- ### Método 1: Configuración del proyecto
14
-
15
- Agrega lo siguiente a `.cursor/mcp.json` dentro de tu proyecto:
16
-
17
- ```json
18
- {
19
- "mcpServers": {
20
- "weppy-roblox-mcp": {
21
- "command": "npx",
22
- "args": ["-y", "@weppy/roblox-mcp"]
23
- }
24
- }
25
- }
26
- ```
27
-
28
- ### Método 2: Configuración global
29
-
30
- Agrega el mismo contenido al archivo de configuración global de Cursor.
31
-
32
- **Ubicaciones del archivo de configuración:**
33
-
34
- | Alcance | Ruta |
35
- |---------|------|
36
- | Proyecto | `<proyecto>/.cursor/mcp.json` |
37
- | Global (macOS/Linux) | `~/.cursor/mcp.json` |
38
- | Global (Windows) | `%USERPROFILE%\\.cursor\\mcp.json` |
39
-
40
- > Si el archivo ya existe, fusiona la entrada `weppy-roblox-mcp` dentro del objeto `mcpServers`.
41
-
42
- ### Aplicar cambios
43
-
44
- Después de editar la configuración, recarga la ventana de Cursor o reinicia la aplicación.
45
-
46
- ## Prueba de conexión
47
-
48
- 1. Abre **Roblox Studio** → pestaña Plugins → **WEPPY** → **Connect**
49
- 2. En **Cursor**, escribe:
50
- ```
51
- Tell me what's currently selected in Roblox Studio
52
- ```
53
-
54
- ## Solución de problemas
55
-
56
- ### El servidor MCP no aparece
57
-
58
- - Verifica que la ruta del archivo de configuración sea correcta
59
- - Comprueba que la sintaxis JSON sea válida
60
- - Recarga Cursor después de editar la configuración
61
-
62
- ### El servidor no inicia
63
-
64
- Ejecuta el servidor MCP directamente para revisar errores:
65
-
66
- ```bash
67
- npx -y @weppy/roblox-mcp
68
- ```
69
-
70
- ### La conexión falla
71
-
72
- - Verifica que el plugin de Roblox Studio esté en estado **Connected**
73
- - Revisa si el puerto 3002 está bloqueado por el firewall
74
-
75
- ## Referencia
76
-
77
- - [Documentación de Cursor MCP](https://docs.cursor.com/context/model-context-protocol)
@@ -1,120 +0,0 @@
1
- # Configuración de Gemini CLI
2
-
3
- Cómo usar Roblox MCP con [Google Gemini CLI](https://github.com/google-gemini/gemini-cli).
4
-
5
- ## Requisitos previos
6
-
7
- 1. **Node.js** (v18.0.0 o superior)
8
- ```bash
9
- node --version
10
- ```
11
-
12
- 2. **Gemini CLI** instalado
13
- ```bash
14
- npm install -g @google/gemini-cli
15
- ```
16
-
17
- 3. **Plugin de Roblox Studio** instalado
18
-
19
- ## Registrar el servidor MCP
20
-
21
- ### Método 1: Comando CLI (Recomendado)
22
-
23
- Puede registrarse con un solo comando en su terminal:
24
-
25
- ```bash
26
- gemini mcp add weppy-roblox-mcp npx --trust -- -y @weppy/roblox-mcp
27
- ```
28
-
29
- > La bandera `--trust` omite las solicitudes de confirmación para cada llamada de herramienta.
30
-
31
- Para registrar globalmente, agregue `-s user`:
32
-
33
- ```bash
34
- gemini mcp add weppy-roblox-mcp npx -s user --trust -- -y @weppy/roblox-mcp
35
- ```
36
-
37
- ### Método 2: Editar archivo de configuración
38
-
39
- Agregue el siguiente contenido al archivo `.gemini/settings.json`:
40
-
41
- ```json
42
- {
43
- "mcpServers": {
44
- "weppy-roblox-mcp": {
45
- "command": "npx",
46
- "args": ["-y", "@weppy/roblox-mcp"]
47
- }
48
- }
49
- }
50
- ```
51
-
52
- **Ubicaciones del archivo de configuración:**
53
- | Ámbito | Ruta |
54
- |--------|------|
55
- | Proyecto | `<proyecto>/.gemini/settings.json` |
56
- | Global | `~/.gemini/settings.json` |
57
-
58
- ### Método 3: Uso de variables de entorno
59
-
60
- Si se necesitan variables de entorno específicas:
61
-
62
- **CLI:**
63
- ```bash
64
- gemini mcp add weppy-roblox-mcp npx --trust -e HTTP_PORT=3002 -- -y @weppy/roblox-mcp
65
- ```
66
-
67
- **Archivo de configuración:**
68
- ```json
69
- {
70
- "mcpServers": {
71
- "weppy-roblox-mcp": {
72
- "command": "npx",
73
- "args": ["-y", "@weppy/roblox-mcp"],
74
- "env": {
75
- "HTTP_PORT": "3002"
76
- }
77
- }
78
- }
79
- }
80
- ```
81
-
82
- ## Prueba de conexión
83
-
84
- 1. Abra **Roblox Studio** → pestaña Plugins → **WEPPY** → **Connect**
85
- 2. Ejecute **Gemini CLI** e ingrese:
86
- ```
87
- Dime qué está seleccionado actualmente en Roblox Studio
88
- ```
89
-
90
- ## Verificar el estado del servidor MCP
91
-
92
- Puede verificar el estado de los servidores conectados con el comando `/mcp` en Gemini CLI:
93
-
94
- ```
95
- /mcp
96
- ```
97
-
98
- ## Solución de problemas
99
-
100
- ### El servidor no se inicia
101
-
102
- Ejecute el servidor MCP directamente para verificar errores:
103
- ```bash
104
- npx -y @weppy/roblox-mcp
105
- ```
106
-
107
- ### Conexión fallida
108
-
109
- - Verifique que el plugin de Roblox Studio esté en estado **Connected**
110
- - Verifique si el puerto 3002 está bloqueado por un firewall
111
- - Verifique el estado del servidor con el comando `/mcp`
112
-
113
- ### Conflictos de herramientas
114
-
115
- Si varios servidores MCP tienen herramientas con el mismo nombre, se les agregará el prefijo con el formato `serverAlias__toolName`.
116
-
117
- ## Referencias
118
-
119
- - [Documentación oficial de Gemini CLI MCP](https://geminicli.com/docs/tools/mcp-server/)
120
- - [Guía de configuración de Gemini CLI](https://geminicli.com/docs/get-started/configuration/)
@@ -1,58 +0,0 @@
1
- # WEPPY Roblox Explorer (Extensión VSCode)
2
-
3
- Vista de árbol de instancias similar al Explorer de Roblox Studio, dentro de VSCode. Navega instancias sincronizadas, abre scripts directamente y consulta el estado de sincronización sin salir del editor.
4
- Esta es una extensión complementaria para WEPPY, no una integración de Roblox independiente.
5
-
6
- ![WEPPY Roblox Explorer](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
7
-
8
- ## Requisitos
9
-
10
- - VSCode 1.85+
11
- - [Roblox MCP](../../../README.md) instalado con Sync habilitado (Basic o Pro)
12
- - Sync ya genero `weppy-project-sync/place_*/.sync-meta.json` dentro de la raiz del proyecto
13
-
14
- ## Instalación
15
-
16
- Busca **WEPPY Roblox Explorer** en la barra lateral de Extensiones de VSCode (`Ctrl+Shift+X` / `Cmd+Shift+X`) y haz clic en **Install**.
17
-
18
- O instala directamente desde estos marketplaces:
19
-
20
- - [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
21
- - [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
22
-
23
- La navegación básica del árbol funciona con los archivos sincronizados en disco. El estado sync en vivo, los indicadores de direction y el reenvío de telemetría del Explorer están disponibles cuando el servidor MCP local es accesible.
24
-
25
- ## Características
26
-
27
- - **Árbol de instancias**: Jerarquía de servicios/instancias idéntica a Roblox Studio
28
- - **Iconos de clases Roblox**: Más de 200 iconos con soporte de tema oscuro/claro
29
- - **Multi-Place**: Raíces de árbol separadas por cada Place sincronizado
30
- - **Abrir al hacer clic**: Abre archivos de respaldo (`.server.luau`, `.client.luau`, `.module.luau`, `.props.json`)
31
- - **Búsqueda de instancias**: Búsqueda QuickPick en todos los servicios
32
- - **Insignias de estado Sync**: Visualiza los estados `modified`, `studio`, `conflict` de un vistazo
33
- - **Actualización automática**: El árbol se actualiza automáticamente cuando cambian los archivos Sync (debounce 500ms)
34
- - **Copiar ruta de instancia**: Clic derecho para copiar rutas tipo `game.Workspace.Part`
35
-
36
- ## Configuración
37
-
38
- | Configuración | Valor por defecto | Descripción |
39
- |---------------|-------------------|-------------|
40
- | `robloxExplorer.syncRoot` | `""` | Ruta absoluta a la raiz de `weppy-project-sync`. Si esta vacia, se detecta automaticamente. WEPPY usa `{projectRoot}/weppy-project-sync`. |
41
- | `robloxExplorer.hidePropsFiles` | `false` | Oculta los archivos de Sync (`.props.json`, `_tree.json`, `.value.json`) en el explorador predeterminado de VSCode. |
42
- | `robloxExplorer.autoRefresh` | `true` | Actualiza automáticamente el árbol cuando cambian los archivos Sync. |
43
- | `robloxExplorer.showSyncStatus` | `true` | Muestra decoraciones de estado Sync en los elementos del árbol. |
44
-
45
- ## Comandos
46
-
47
- | Comando | Descripción |
48
- |---------|-------------|
49
- | `WEPPY Explorer: Refresh` | Actualizar manualmente el árbol de instancias |
50
- | `WEPPY Explorer: Search Instances` | Buscar instancias en todos los servicios |
51
- | `WEPPY Explorer: Open Backing File` | Abrir el archivo de respaldo de una instancia seleccionada |
52
- | `WEPPY Explorer: Copy Instance Path` | Copiar la ruta completa de la instancia (ej. `game.Workspace.Part`) |
53
- | `WEPPY Explorer: Reveal in Explorer` | Mostrar el archivo en el explorador predeterminado de VSCode |
54
-
55
- ## Relacionado
56
-
57
- - [Guía detallada de Sync](../sync/overview.md)
58
- - [Guía de instalación](README.md)
@@ -1,85 +0,0 @@
1
- # Instalacion del Plugin de Roblox
2
-
3
- Instrucciones para instalar el plugin que conecta Roblox Studio con agentes de IA.
4
-
5
- ## 1. Descargar el Plugin
6
-
7
- 1. Abre [GitHub Releases](https://github.com/hope1026/weppy-roblox-mcp/releases/latest)
8
- 2. Descarga `weppy-roblox-mcp-v{version}.zip`
9
- 3. Extrae el ZIP - encontraras `roblox-plugin/WeppyRobloxMCP.rbxm` y guias de instalacion
10
-
11
- Nota:
12
- - Basic usa el mismo paquete del plugin con politica Basic (Studio -> Local, una via)
13
- - Con licencia Pro por suscripcion se habilita sync bidireccional y funciones avanzadas mas amplias
14
-
15
- ## 2. Instalar el Plugin
16
-
17
- 1. Abre **Roblox Studio**
18
- 2. Clic en la pestana **Plugins**
19
- 3. Clic en **Plugins Folder**
20
-
21
- ![Abrir Plugins Folder](../../assets/screenshots/plugin/installation/plugins-menu.png)
22
-
23
- 4. **Copia** `WeppyRobloxMCP.rbxm` a la carpeta abierta de Plugins
24
- 5. **Reinicia Roblox Studio**
25
-
26
- ## 3. Verificar la Instalacion
27
-
28
- Despues de reiniciar, aparecera el boton **WEPPY** en Plugins.
29
-
30
- ![Boton WEPPY](../../assets/screenshots/plugin/installation/toolbar-button.png)
31
-
32
- ## 4. Conectar con el Agente de IA
33
-
34
- ### Requisitos Previos
35
-
36
- El servidor MCP debe estar instalado. Completa primero la guia de tu app de IA:
37
-
38
- | Aplicacion IA | Guia de instalacion |
39
- |---------------|---------------------|
40
- | Claude Code | [Como configurar](ai-apps/claude-code.md) |
41
- | Claude Desktop | [Como configurar](ai-apps/claude-app.md) |
42
- | Cursor | [Como configurar](ai-apps/cursor.md) |
43
- | Codex CLI | [Como configurar](ai-apps/codex-cli.md) |
44
- | Codex Desktop | [Como configurar](ai-apps/codex-app.md) |
45
- | Gemini CLI | [Como configurar](ai-apps/gemini-cli.md) |
46
- | Antigravity | [Como configurar](ai-apps/antigravity.md) |
47
-
48
- ### Conectar
49
-
50
- 1. Abre cualquier proyecto en **Roblox Studio**
51
- 2. Pestaña **Plugins** -> **WEPPY**
52
- 3. Clic en **Connect**
53
- 4. Cuando veas **"Connected"**, listo
54
-
55
- ![Pantalla principal del plugin](../../assets/screenshots/plugin/installation/main-screen.png)
56
-
57
- ## 5. Configuracion (Opcional)
58
-
59
- Usa el boton de configuracion en la esquina superior derecha.
60
-
61
- ![Pantalla de configuracion](../../assets/screenshots/plugin/installation/settings-screen.png)
62
-
63
- - **Conexion automatica**
64
- - **Reconexion automatica**
65
- - **Enfoque automatico de camara**
66
- - **Idioma**
67
-
68
- ## Solucion de Problemas
69
-
70
- ### El plugin no aparece
71
-
72
- - Reinicia Roblox Studio por completo
73
- - Verifica que el archivo fue copiado correctamente
74
- - Verifica que `.rbxm` no este dañado
75
-
76
- ### No se puede conectar
77
-
78
- - Verifica que el servidor MCP esta en ejecucion
79
- - Pulsa **Connect** otra vez
80
- - Verifica conflicto en el puerto 3002
81
-
82
- ### La conexion se corta seguido
83
-
84
- - Activa **Reconexion automatica**
85
- - Reinicia tu app de IA
@@ -1,96 +0,0 @@
1
- # Guia de Actualizacion a Pro
2
-
3
- ## ¿Por qué Pro?
4
-
5
- ### Sync bidireccional para flujos de desarrollo reales
6
-
7
- Pro Sync va más allá del simple export. Edita scripts localmente y súbelos a Studio. Haz cambios en Studio y tráelos de vuelta al disco. Pro mantiene ambos lados sincronizados.
8
-
9
- - **Sync bidireccional** — Los cambios fluyen en ambas direcciones entre Studio y los archivos locales.
10
- - **Direction por tipo** — Configura la dirección de forma independiente para Scripts, Values, Containers, Data y Services.
11
- - **Apply Mode por tipo** — Elige Auto o Manual por tipo para equilibrar velocidad y control.
12
- - **Full Sync / Resync** — Reconstruye el estado limpio del proyecto tras cambios grandes o reconexiones.
13
- - **Historial de cambios** — Rastrea qué cambió, cuándo y en qué dirección antes de aplicar.
14
- - **Sync multi-place** — Sincroniza hasta 3 Roblox Places a la vez, cada uno con almacenamiento aislado e historial de cambios propio.
15
-
16
- ### Ahorra tokens de IA con flujos de alto impacto
17
-
18
- Las acciones masivas y avanzadas reducen las llamadas repetitivas — haz más por cada prompt.
19
-
20
- ### IA que controla los playtests directamente
21
-
22
- La IA puede controlar los playtests de Roblox Studio de forma directa. Puede iniciar y detener Play (F5) o Run (F8), inyectar scripts de prueba, recopilar logs y generar reportes automáticamente.
23
-
24
- - "Inicia un playtest en modo Run y verifica si el NPC llega al objetivo."
25
- - "Escribe un test que compruebe si el SpawnLocation está sobre el suelo y ejecútalo."
26
- - "Valida que el script que acabo de cambiar funciona sin errores en el playtest."
27
-
28
- ### Más funciones exclusivas de Pro
29
-
30
- Pro desbloquea funciones adicionales más allá del flujo de trabajo principal.
31
-
32
- - **Operaciones masivas** — Crear, modificar o eliminar múltiples instancias en una sola solicitud
33
- - **Generación de terreno** — Rellenar con bloque, esfera, cilindro, cuña y reemplazar materiales
34
- - **Búsqueda/inserción de assets** — Buscar en el marketplace de Roblox e insertar assets directamente
35
- - **Análisis espacial** — Raycast, encontrar suelo, búsqueda de área plana, detección de colisiones
36
- - **Control de entorno** — Iluminación, atmósfera, cielo y hora del día
37
- - **Audio/Animación** — Reproducción de sonido y carga/reproducción de animaciones
38
-
39
- ## Compra y activación
40
-
41
- ### Paso 1: Compra una licencia de suscripción Pro en Gumroad
42
-
43
- 1. Ve a [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/faccjs?utm_source=github&utm_medium=repo&utm_campaign=pro_upgrade_md)
44
- 2. Completa la compra de la licencia de suscripción Pro
45
- 3. Copia la clave de licencia que recibes después de la compra
46
-
47
- Solo necesitas activar la licencia una vez, ya sea en el plugin o en el dashboard. Ambas superficies comparten el mismo estado local de licencia del MCP, así que al activarla en un lugar, el mismo estado aparecerá en el otro.
48
-
49
- ### Activar en el plugin
50
-
51
- 1. Abre **WEPPY** en Roblox Studio y conéctalo al servidor MCP.
52
- 2. Abre la sección **Settings > License** del plugin.
53
- 3. Pega la clave comprada en el campo `License key`.
54
- 4. Haz clic en **Activate** para activar la licencia.
55
- 5. Si el estado no se actualiza de inmediato, haz clic en **Refresh**.
56
- 6. Cuando la activación se complete, el estado cambiará de Basic a Pro y las funciones Pro quedarán disponibles.
57
-
58
- ![Pantalla de activación de licencia en el plugin](../assets/screenshots/plugin/license/plugin-license-screen.png)
59
-
60
- ### Activar en el dashboard
61
-
62
- 1. Inicia el servidor MCP y abre **Settings > License** en el dashboard.
63
- 2. Confirma que el proveedor esté configurado como `gumroad`.
64
- 3. Pega la clave comprada en el campo `License Key`.
65
- 4. Haz clic en **Activate License** para activar la licencia.
66
- 5. Si hace falta, usa **Refresh License** para obtener el estado más reciente.
67
-
68
- ![Pantalla de activación de licencia en el dashboard](../assets/screenshots/plugin/license/dashboard-license-screen.png)
69
-
70
- ### Después de activar
71
-
72
- - Si el estado de la licencia aparece como `active` o `grace`, las funciones Pro ya están disponibles.
73
- - El plugin y el dashboard comparten el mismo estado de licencia, así que la activación hecha en uno se refleja en el otro.
74
- - Usa **Refresh** o **Refresh License** cuando quieras volver a comprobar el estado más reciente.
75
-
76
- ## Comparación de Funciones
77
-
78
- | Función | Basic | Pro |
79
- |---------|:-----:|:---:|
80
- | Creación/edición de scripts | ✅ | ✅ |
81
- | Crear/eliminar/mover instancias | ✅ | ✅ + operaciones masivas |
82
- | Leer/modificar propiedades | ✅ | ✅ + cambios masivos |
83
- | Selección, tags, búsqueda | ✅ | ✅ |
84
- | Control de cámara | ✅ | ✅ |
85
- | Monitoreo de logs | ✅ | ✅ |
86
- | Ejecución de código Luau | ✅ | ✅ |
87
- | Sincronización de proyecto | Studio → Local una vía | Bidireccional + dirección/modo por tipo |
88
- | Sync multi-place | — | Hasta 3 Places simultáneamente |
89
- | Historial de cambios | — | Rastreo de cambios antes de aplicar |
90
- | Control de playtest | — | Reproducir / detener / pausar / reanudar + tests automáticos |
91
- | Generación/edición de terreno | — | Bloque, esfera, cilindro, cuña, reemplazo de material |
92
- | Búsqueda/inserción de assets | — | Buscar en marketplace de Roblox e insertar directamente |
93
- | Análisis espacial | — | Raycast, encontrar suelo, detección de colisiones |
94
- | Control de entorno | — | Iluminación, atmósfera, cielo, hora del día |
95
- | Audio / Animación | — | Reproducción de sonido, carga/reproducción de animaciones |
96
- | Eficiencia de tokens IA | Acciones individuales | Menos llamadas con acciones masivas |
@@ -1,41 +0,0 @@
1
- # Usar `luau-lsp` con WEPPY Sync
2
-
3
- WEPPY Sync puede generar automaticamente los archivos sourcemap que necesita `luau-lsp`, para que puedas activar funciones de editor con contexto de Roblox sin preparar un proyecto Rojo aparte.
4
-
5
- ## Que escribe WEPPY
6
-
7
- Despues de que termina Full Sync, WEPPY escribe:
8
-
9
- - Place sourcemap: `weppy-project-sync/place_<id>/sourcemap.json`
10
- - Archivo representante en la raiz: `weppy-project-sync/sourcemap.json`
11
-
12
- Para la mayoria de usuarios, la ruta recomendada es `weppy-project-sync/sourcemap.json`.
13
-
14
- ## Que mejora
15
-
16
- Cuando `luau-lsp` usa el sourcemap de WEPPY, mejora:
17
-
18
- - Autocomplete de `game.*`
19
- - Navegacion entre scripts sincronizados
20
- - Resolucion de `require` entre scripts sincronizados
21
-
22
- ## Configuracion recomendada
23
-
24
- 1. Ejecuta Full Sync una vez para que WEPPY cree `weppy-project-sync/sourcemap.json`.
25
- 2. Haz que la configuracion de sourcemap de `luau-lsp` en tu editor apunte a `weppy-project-sync/sourcemap.json`.
26
- 3. Si tu cliente puede desactivar la generacion automatica con Rojo, establece `luau-lsp.sourcemap.autogenerate` en `false`.
27
-
28
- Ejemplo de configuracion en VSCode:
29
-
30
- ```json
31
- {
32
- "luau-lsp.sourcemap.enabled": true,
33
- "luau-lsp.sourcemap.autogenerate": false,
34
- "luau-lsp.sourcemap.sourcemapFile": "weppy-project-sync/sourcemap.json"
35
- }
36
- ```
37
-
38
- ## Nota sobre Multi-place
39
-
40
- `weppy-project-sync/sourcemap.json` sigue el place representante actual del proyecto.
41
- Si necesitas fijarlo a un place especifico, apunta `luau-lsp` directamente a `weppy-project-sync/place_<id>/sourcemap.json`.