@weppy/roblox-mcp 0.1.7 → 0.1.9

package/docs/pt-br/tools/overview.md

@@ -1,238 +1,95 @@
-# Ferramentas do Roblox MCP
+# Funcionalidades do Roblox MCP
 
-Para parametros detalhados das ferramentas MCP, consulte diretamente as definicoes das ferramentas MCP.
+Conecte a IA ao Roblox Studio e automatize diversas tarefas. Veja o que voce pode fazer por categoria.
 
 ---
 
-## Ferramentas Basic (68)
-
-### Instance (Instancia) - 13
-
-| Ferramenta | Descricao |
-|------------|-----------|
-| `create_instance` | Criar nova instancia |
-| `create_instance_with_properties` | Criar instancia com propriedades |
-| `clone_instance` | Clonar instancia existente |
-| `delete_instance` | Excluir instancia |
-| `move_instance` | Mover instancia para novo pai |
-| `rename_instance` | Renomear instancia |
-| `get_instance` | Obter informacoes da instancia |
-| `get_instance_children` | Obter lista de filhos da instancia |
-| `find_first_child` | Encontrar primeiro filho por nome |
-| `find_first_descendant` | Encontrar primeiro descendente por nome |
-| `get_class_info` | Obter informacoes da classe |
-| `wait_for_child` | Aguardar ate que o filho apareca |
-| `pivot_to` | Definir Pivot CFrame |
-
-### Property (Propriedade) - 10
-
-| Ferramenta | Descricao |
-|------------|-----------|
-| `get_property` | Obter valor da propriedade |
-| `set_property` | Definir valor da propriedade |
-| `get_all_properties` | Obter todas as propriedades |
-| `set_multiple_properties` | Definir multiplas propriedades simultaneamente |
-| `set_calculated_property` | Definir propriedade com valor calculado |
-| `set_relative_property` | Definir propriedade com valor relativo |
-| `get_attribute` | Obter valor do atributo |
-| `set_attribute` | Definir valor do atributo |
-| `get_all_attributes` | Obter todos os atributos |
-| `delete_attribute` | Excluir atributo |
-
-### Script - 9
-
-| Ferramenta | Descricao |
-|------------|-----------|
-| `create_script` | Criar novo script |
-| `get_script_source` | Obter codigo fonte do script |
-| `set_script_source` | Atualizar codigo fonte do script |
-| `delete_script` | Excluir script |
-| `edit_script_lines` | Editar linhas especificas |
-| `insert_script_lines` | Inserir linhas |
-| `delete_script_lines` | Excluir linhas |
-| `search_in_scripts` | Pesquisar em scripts |
-| `get_script_dependencies` | Obter dependencias |
-
-### Selection (Selecao) - 12
-
-| Ferramenta | Descricao |
-|------------|-----------|
-| `get_selection` | Obter instancias selecionadas atualmente |
-| `get_selection_context` | Obter selecao com contexto |
-| `get_selection_details` | Obter detalhes da selecao |
-| `set_selection` | Definir selecao de instancias |
-| `clear_selection` | Limpar selecao |
-| `add_to_selection` | Adicionar a selecao |
-| `remove_from_selection` | Remover da selecao |
-| `get_place_info` | Obter informacoes do Place |
-| `get_services` | Obter lista de servicos do jogo |
-| `get_studio_settings` | Obter configuracoes do Studio |
-| `run_command` | Executar comando do Studio |
-| `watch_selection` | Monitorar alteracoes de selecao |
-
-### Search (Pesquisa) - 2
-
-| Ferramenta | Descricao |
-|------------|-----------|
-| `search_by_name` | Pesquisar instancias por nome |
-| `search_by_class` | Pesquisar instancias por classe |
-
-### Tag - 5
-
-| Ferramenta | Descricao |
-|------------|-----------|
-| `add_tag` | Adicionar tag a instancia |
-| `remove_tag` | Remover tag da instancia |
-| `get_tags` | Obter lista de tags da instancia |
-| `get_tagged` | Obter lista de instancias com tag |
-| `has_tag` | Verificar se instancia possui tag |
-
-### Camera - 4
-
-| Ferramenta | Descricao |
-|------------|-----------|
-| `get_camera_info` | Obter informacoes da camera |
-| `get_suggested_camera_view` | Obter visualizacao de camera sugerida |
-| `focus_camera_path` | Focar camera em instancia por caminho |
-| `focus_camera_position` | Focar camera em posicao do mundo |
-
-### Log - 3
-
-| Ferramenta | Descricao |
-|------------|-----------|
-| `get_output_logs` | Obter logs de saida |
-| `clear_output_logs` | Limpar logs de saida |
-| `get_recent_errors` | Obter erros recentes |
-
-### Connection (Conexao) - 2
-
-| Ferramenta | Descricao |
-|------------|-----------|
-| `get_connection_info` | Obter status da conexao |
-| `get_usage_status` | Obter status de uso/cota |
+## Basic (Gratuito)
+
+### Gerenciamento de Objetos
+
+Crie, clone, delete e mova objetos do jogo como partes, modelos e pastas. Tarefas como "Crie uma parte vermelha" ou "Clone este modelo e coloque ao lado" sao possiveis.
+
+### Propriedades
+
+Leia e altere todas as propriedades dos objetos como tamanho, cor, posicao e material. Voce pode alterar varias propriedades de uma vez ou ajustar relativamente com base nos valores atuais.
+
+### Scripts
+
+Crie novos scripts, leia o codigo existente e modifique. Voce pode editar linhas especificas, buscar texto dentro de scripts ou identificar dependencias para ver quais modulos sao referenciados.
+
+### Selecao
+
+Verifique os objetos selecionados, altere a selecao e limpe a selecao. Essencial para entender e controlar com o que voce esta trabalhando no Studio.
+
+### Busca
+
+Encontre objetos no jogo por nome ou classe (tipo).
+
+### Tags
+
+Adicione ou remova tags de objetos e encontre todos os objetos com uma tag especifica de uma vez. Util para gerenciar grupos de objetos semelhantes.
+
+### Camera
+
+Mova a camera para objetos ou posicoes especificas. Conveniente para verificar rapidamente a area em que voce esta trabalhando.
+
+### Logs
+
+Confira logs de saida e erros que ocorreram durante a execucao do jogo. Ajuda a encontrar e corrigir bugs.
+
+### Conexao
+
+Verifique o status de conexao e uso entre o servidor MCP e o Roblox Studio.
 
 ---
 
-## Ferramentas Pro (+72)
-👉 [Guia de Upgrade para Pro](pro-upgrade.md)
-
-### Script - 2
-
-| Ferramenta | Descricao |
-|------------|-----------|
-| `replace_in_scripts` | Substituir conteudo em scripts em massa |
-| `execute_script` | Executar codigo Luau diretamente |
-
-### Search (Pesquisa) - 6
-
-| Ferramenta | Descricao |
-|------------|-----------|
-| `get_file_tree` | Obter arvore de arquivos |
-| `get_project_structure` | Obter arvore de estrutura do projeto |
-| `search_by_property` | Pesquisar por propriedade |
-| `search_by_tag` | Pesquisar por tag |
-| `get_descendants` | Obter todos os descendentes |
-| `get_ancestors` | Obter ancestrais |
-
-### Bulk (Operacoes em Massa) - 8
-
-| Ferramenta | Descricao |
-|------------|-----------|
-| `mass_create_instances` | Criar instancias em massa |
-| `mass_delete_instances` | Excluir instancias em massa |
-| `mass_set_property` | Definir propriedades em massa |
-| `mass_get_property` | Obter propriedades em massa |
-| `mass_duplicate` | Duplicar instancias em massa |
-| `smart_duplicate` | Duplicacao inteligente com offset |
-| `batch_execute` | Executar multiplos comandos em lote |
-| `modify_children` | Modificar todos os filhos |
-
-### Asset (Ativo) - 7
-
-| Ferramenta | Descricao |
-|------------|-----------|
-| `insert_model` | Inserir modelo da Creator Store |
-| `get_asset_info` | Obter informacoes do ativo |
-| `search_creator_store` | Pesquisar ativos na Creator Store |
-| `search_and_insert_model` | Pesquisar e inserir modelo |
-| `insert_free_model` | Inserir modelo gratuito |
-| `insert_package` | Inserir pacote |
-| `export_selection` | Exportar selecao |
-
-### Environment (Ambiente) - 5
-
-| Ferramenta | Descricao |
-|------------|-----------|
-| `set_lighting` | Definir propriedades de iluminacao |
-| `set_atmosphere` | Definir propriedades de Atmosphere |
-| `set_sky` | Definir propriedades de Sky |
-| `set_terrain` | Definir propriedades de Terrain |
-| `set_time_of_day` | Definir hora do dia |
-
-### State (Estado) - 9
-
-| Ferramenta | Descricao |
-|------------|-----------|
-| `sync_workspace_state` | Sincronizar estado do Workspace |
-| `get_workspace_snapshot` | Obter snapshot do Workspace |
-| `get_recent_changes` | Obter alteracoes recentes |
-| `clear_change_history` | Limpar historico de alteracoes |
-| `get_viewport_info` | Obter informacoes do viewport |
-| `get_workspace_metadata` | Obter metadados do Workspace |
-| `get_script_list` | Obter lista de scripts |
-| `get_selection_info` | Obter informacoes de selecao |
-| `clear_state_cache` | Limpar cache de estado |
-
-### Spatial (Espacial) - 5
-
-| Ferramenta | Descricao |
-|------------|-----------|
-| `get_spatial_map` | Obter mapa espacial da area |
-| `find_empty_space` | Encontrar espaco vazio na area |
-| `get_bounds` | Obter bounding box da instancia |
-| `snap_to_grid` | Ajustar posicao a grade |
-| `check_collision` | Verificar colisao entre instancias |
-
-### Raycast - 8
-
-| Ferramenta | Descricao |
-|------------|-----------|
-| `raycast` | Executar raycast e obter informacoes de colisao |
-| `find_ground` | Encontrar posicao do solo naquele ponto |
-| `check_placement` | Verificar se objeto pode ser colocado |
-| `multi_raycast` | Executar multiplos raycasts |
-| `scan_area` | Escanear area e gerar mapa de altura |
-| `find_flat_areas` | Encontrar areas planas para colocacao |
-| `find_spawn_positions` | Encontrar posicoes de spawn validas |
-| `analyze_walkable_area` | Analisar area transitavel |
-
-### Terrain (Terreno) - 14
-
-| Ferramenta | Descricao |
-|------------|-----------|
-| `terrain_fill_block` | Preencher terreno em forma de bloco |
-| `terrain_fill_ball` | Preencher terreno em forma de esfera |
-| `terrain_fill_cylinder` | Preencher terreno em forma de cilindro |
-| `terrain_fill_wedge` | Preencher terreno em forma de cunha |
-| `terrain_clear` | Limpar terreno (usando objeto Region) |
-| `terrain_clear_region` | Limpar terreno (usando coordenadas min/max) |
-| `terrain_replace_material` | Substituir material do terreno |
-| `terrain_get_material_color` | Obter cor do material do terreno |
-| `terrain_set_material_color` | Definir cor do material do terreno |
-| `terrain_read_voxel` | Ler voxel unico |
-| `terrain_read_voxels` | Ler dados de voxels |
-| `terrain_write_voxels` | Escrever dados de voxels |
-| `terrain_generate` | Gerar terreno proceduralmente |
-| `terrain_smooth` | Suavizar terreno |
-
-### Visualization (Visualizacao) - 7
-
-| Ferramenta | Descricao |
-|------------|-----------|
-| `visualization_create_area` | Criar visualizacao de area |
-| `visualization_create_marker` | Criar visualizacao de marcador (com preview) |
-| `visualization_create_line` | Criar visualizacao de linha |
-| `visualization_remove` | Remover visualizacao |
-| `visualization_clear` | Remover todas as visualizacoes |
-| `visualization_get_status` | Obter status da visualizacao |
-| `visualization_focus` | Focar camera em item de visualizacao |
+## Pro
+
+Se voce precisa de funcionalidades mais poderosas, pode fazer upgrade para o Pro.
+
+### Selecao Avancada
+
+Obtenha o contexto detalhado da selecao com propriedades e codigo-fonte, explore a hierarquia de selecao, adicione/remova itens da selecao, e consulte informacoes do Place e servicos do jogo. Util para fluxos de trabalho avancados e automacao.
+
+### Scripts Avancados
+
+Substitua conteudo em multiplos scripts de uma vez ou execute codigo Luau instantaneamente. Util para modificacoes repetitivas de codigo ou testes rapidos.
+
+### Busca Avancada
+
+Explore a arvore de arquivos completa ou busque objetos por propriedade ou tag. Tenha uma visao completa da estrutura do projeto e consulte todos os descendentes ou ancestrais de objetos especificos.
+
+### Operacoes em Massa
+
+Crie, delete, modifique ou duplique centenas de objetos de uma vez. Lide rapidamente com tarefas em grande escala como plantar arvores no mapa, mudar a cor de todas as partes ou posicionar objetos segundo padroes.
+
+### Assets
+
+Busque modelos gratuitos no Roblox Creator Store e insira instantaneamente. Adicione assets por conversa como "Procure um modelo de castelo medieval" ou "Insira um modelo de arma".
+
+### Ambiente
+
+Configure iluminacao, ceu, nevoa, propriedades do terreno e hora do dia com linguagem natural. Solicitacoes como "Mude para clima de por do sol" ou "Coloque meia-noite" sao possiveis.
+
+### Gerenciamento de Estado
+
+Salve o estado atual do Workspace como snapshot e consulte mudancas recentes e o estado do viewport. Ajuda a entender o estado atual durante tarefas complexas.
+
+### Analise Espacial
+
+Determine com precisao o tamanho e posicao de objetos, encontre espacos vazios e verifique colisoes. Voce tambem pode alinhar objetos a uma grade.
+
+### Raycast
+
+Lance raios invisiveis para encontrar pontos de colisao com terreno ou objetos. Essencial para design de niveis: encontrar posicoes do chao, verificar se objetos podem ser colocados, buscar locais de spawn e analisar areas caminhaveis.
+
+### Terreno
+
+Preencha, escave e suavize terreno com diversas formas como blocos, esferas, cilindros e cunhas. Altere materiais e cores, ou gere proceduralmente terreno natural com montanhas e rios.
+
+### Visualizacao
+
+Exiba areas, marcadores e linhas na tela para confirmar visualmente o espaco de trabalho. Util para debugging e revisao de design de niveis.
+
+👉 [Guia de Upgrade para Pro](../pro-upgrade.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weppy/roblox-mcp",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "MCP (Model Context Protocol) server for Roblox Studio integration - enables AI coding agents to interact with Roblox Studio in real-time",
   "main": "plugins/weppy-roblox-mcp/dist/index.js",
   "type": "module",

package/plugins/weppy-roblox-mcp/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "weppy-roblox-mcp",
   "description": "MCP server for Roblox Studio integration - 130+ tools for AI-powered game development with specialized agents and skills",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "author": {
     "name": "hope1026"
   },

package/plugins/weppy-roblox-mcp/dist/index.js

@@ -145,7 +145,7 @@ Basic tier users cannot use Pro tools - they will receive a friendly message sug
   Stack: ${e.stack}`;if(typeof e=="object")try{return`
   `+JSON.stringify(e,null,2).replace(/\n/g,`
   `)}catch{return`
-  [Circular or non-serializable object]`}return` ${String(e)}`}static log(e,r,n){if(!this.shouldLog(e))return;let i=this.getTimestamp(),a=up[e],o=this.formatData(n),s=`${up.gray}[${i}]${up.reset} ${a}[${e.toUpperCase()}]${up.reset} ${r}${o}`;console.error(s)}static debug(e,r){this.log("debug",e,r)}static info(e,r){this.log("info",e,r)}static warn(e,r){this.log("warn",e,r)}static error(e,r){this.log("error",e,r)}},S=ox;var RB=new Set(["ping","echo","get_info","get_usage_status","create_instance","delete_instance","clone_instance","move_instance","get_instance","get_instance_children","rename_instance","find_first_child","find_first_descendant","create_instance_with_properties","get_class_info","wait_for_child","pivot_to","create_script","get_script_source","set_script_source","read_script","update_script","delete_script","edit_script_lines","insert_script_lines","delete_script_lines","search_in_scripts","get_script_dependencies","get_property","set_property","get_properties","set_properties","get_all_properties","set_multiple_properties","set_calculated_property","set_relative_property","get_attribute","set_attribute","get_all_attributes","delete_attribute","find_by_name","search_by_name","search_by_class","get_selection","get_selection_context","get_selection_details","set_selection","clear_selection","add_to_selection","remove_from_selection","get_place_info","get_services","get_studio_settings","run_command","watch_selection","add_tag","remove_tag","get_tags","get_tagged","has_tag","get_camera_info","get_suggested_camera_view","focus_camera_path","focus_camera_position","get_output_logs","clear_output_logs","get_recent_errors"]),CB=60*1e3,lp=null;function pp(t){return RB.has(t)?"basic":"pro"}function zP(t){lp={...t,timestamp:Date.now()}}function DB(){return!lp||Date.now()-lp.timestamp>CB?null:lp}function TP(t){if(pp(t)==="basic")return{allowed:!0,tier:"basic"};let r=DB();if(!r)return{allowed:!0,tier:"pro"};if(r.tier==="pro")return{allowed:!0,tier:"pro"};if(r.remaining<=0){let n=Math.floor(r.resetIn/3600),i=Math.floor(r.resetIn%3600/60);return{allowed:!1,tier:"pro",remaining:0,error:`Pro tool quota exhausted (${r.used}/${r.limit}). Resets in ${n}h ${i}m. Use basic alternatives or upgrade to Pro.`}}return{allowed:!0,tier:"pro",remaining:r.remaining}}var At="0.1.7";var lx=class{app;server=null;config;commandQueue=new Map;pendingCommands=new Map;globalPendingCommands=[];sseClients=new Set;startTime=Date.now();requestCounts=new Map;cachedSelection=null;isClientMode=!1;baseUrl="";instanceId=Rr();sessionId="";pluginClients=new Map;mcpInstances=new Map;totalCommandsProcessed=0;historyManager=null;constructor(e){this.config=e,this.app=(0,ux.default)(),this.baseUrl=`http://${e.httpHost}:${e.httpPort}`,this.sessionId=this.generateSessionId(),this.setupMiddleware(),this.setupRoutes()}generateSessionId(){let e=this.instanceId.replace(/-/g,"").substring(0,8).toUpperCase();return`${e.substring(0,4)}-${e.substring(4,8)}`}getSessionId(){return this.sessionId}setupMiddleware(){this.app.use(ux.default.json()),this.app.use((e,r,n)=>{r.setHeader("Access-Control-Allow-Origin","http://localhost:3002"),r.setHeader("Access-Control-Allow-Methods","GET, POST, OPTIONS"),r.setHeader("Access-Control-Allow-Headers","Content-Type"),n()}),this.app.use((e,r,n)=>{if(!this.checkRateLimit(e.ip||"unknown")){r.status(429).json({error:"Rate limit exceeded",limit:this.config.maxRequestsPerMinute});return}n()}),this.app.use((e,r,n)=>{S.debug(`${e.method} ${e.path}`,{ip:e.ip}),n()})}checkRateLimit(e){let r=Date.now(),n=r-6e4,i=this.requestCounts.get(e)||[];return i=i.filter(a=>a>n),i.length>=this.config.maxRequestsPerMinute?!1:(i.push(r),this.requestCounts.set(e,i),!0)}setupRoutes(){this.app.get("/events",(e,r)=>this.handleSSEConnection(e,r)),this.app.get("/commands",(e,r)=>this.handleCommandsPoll(e,r)),this.app.post("/result",(e,r)=>this.handleResult(e,r)),this.app.post("/selection-update",(e,r)=>this.handleSelectionUpdate(e,r)),this.app.post("/execute",(e,r)=>this.handleExecute(e,r)),this.app.get("/cached-selection",(e,r)=>this.handleCachedSelectionRequest(e,r)),this.app.post("/register-plugin",(e,r)=>this.handleRegisterPlugin(e,r)),this.app.post("/unregister-plugin",(e,r)=>this.handleUnregisterPlugin(e,r)),this.app.post("/register-mcp",(e,r)=>this.handleRegisterMCP(e,r)),this.app.post("/unregister-mcp",(e,r)=>this.handleUnregisterMCP(e,r)),this.app.get("/connection-info",(e,r)=>this.handleConnectionInfo(r)),this.app.post("/logs",(e,r)=>this.handleLogs(e,r)),this.app.post("/quota-status",(e,r)=>this.handleQuotaStatus(e,r)),this.app.get("/status",(e,r)=>this.handleStatus(r)),this.app.post("/shutdown",(e,r)=>this.handleShutdown(e,r)),this.app.options("*",(e,r)=>{r.sendStatus(200)})}setHistoryManager(e){this.historyManager=e}handleSSEConnection(e,r){S.info("Plugin connected via SSE"),r.setHeader("Content-Type","text/event-stream"),r.setHeader("Cache-Control","no-cache"),r.setHeader("Connection","keep-alive"),this.sseClients.add(r),this.sendSSEEvent(r,{event:"command",id:Rr(),data:{action:"connected",requestId:Rr(),params:{serverVersion:At,timestamp:Date.now()}}});let n=setInterval(()=>{this.sendSSEEvent(r,{event:"command",id:Rr(),data:{action:"keepalive",requestId:Rr(),params:{timestamp:Date.now()}}})},3e4);r.on("close",()=>{S.info("Plugin disconnected from SSE"),clearInterval(n),this.sseClients.delete(r)})}sendSSEEvent(e,r){let n=JSON.stringify(r.data);e.write(`event: ${r.event}
+  [Circular or non-serializable object]`}return` ${String(e)}`}static log(e,r,n){if(!this.shouldLog(e))return;let i=this.getTimestamp(),a=up[e],o=this.formatData(n),s=`${up.gray}[${i}]${up.reset} ${a}[${e.toUpperCase()}]${up.reset} ${r}${o}`;console.error(s)}static debug(e,r){this.log("debug",e,r)}static info(e,r){this.log("info",e,r)}static warn(e,r){this.log("warn",e,r)}static error(e,r){this.log("error",e,r)}},S=ox;var RB=new Set(["get_selection_context","get_selection_details","add_to_selection","remove_from_selection","watch_selection","get_place_info","get_services","get_studio_settings","run_command","replace_in_scripts","execute_script","get_file_tree","get_project_structure","search_by_property","search_by_tag","get_descendants","get_ancestors","mass_create_instances","mass_delete_instances","mass_set_property","mass_get_property","mass_duplicate","smart_duplicate","batch_execute","modify_children","insert_model","get_asset_info","search_creator_store","search_and_insert_model","insert_free_model","insert_package","export_selection","set_lighting","set_atmosphere","set_sky","set_terrain","set_time_of_day","sync_workspace_state","get_workspace_snapshot","get_recent_changes","get_viewport_info","get_spatial_map","find_empty_space","get_bounds","snap_to_grid","check_collision","raycast","find_ground","check_placement","multi_raycast","scan_area","find_flat_areas","find_spawn_positions","analyze_walkable_area","terrain_fill_block","terrain_fill_ball","terrain_fill_cylinder","terrain_fill_wedge","terrain_clear","terrain_clear_region","terrain_replace_material","terrain_get_material_color","terrain_set_material_color","terrain_read_voxel","terrain_read_voxels","terrain_write_voxels","terrain_generate","terrain_smooth","visualization_create_area","visualization_create_marker","visualization_create_line","visualization_remove","visualization_clear","visualization_get_status","visualization_focus"]),CB=60*1e3,lp=null;function pp(t){return RB.has(t)?"pro":"basic"}function zP(t){lp={...t,timestamp:Date.now()}}function DB(){return!lp||Date.now()-lp.timestamp>CB?null:lp}function TP(t){if(pp(t)==="basic")return{allowed:!0,tier:"basic"};let r=DB();if(!r)return{allowed:!0,tier:"pro"};if(r.tier==="pro")return{allowed:!0,tier:"pro"};if(r.remaining<=0){let n=Math.floor(r.resetIn/3600),i=Math.floor(r.resetIn%3600/60);return{allowed:!1,tier:"pro",remaining:0,error:`Pro tool quota exhausted (${r.used}/${r.limit}). Resets in ${n}h ${i}m. Use basic alternatives or upgrade to Pro.`}}return{allowed:!0,tier:"pro",remaining:r.remaining}}var At="0.1.9";var lx=class{app;server=null;config;commandQueue=new Map;pendingCommands=new Map;globalPendingCommands=[];sseClients=new Set;startTime=Date.now();requestCounts=new Map;cachedSelection=null;isClientMode=!1;baseUrl="";instanceId=Rr();sessionId="";pluginClients=new Map;mcpInstances=new Map;totalCommandsProcessed=0;historyManager=null;constructor(e){this.config=e,this.app=(0,ux.default)(),this.baseUrl=`http://${e.httpHost}:${e.httpPort}`,this.sessionId=this.generateSessionId(),this.setupMiddleware(),this.setupRoutes()}generateSessionId(){let e=this.instanceId.replace(/-/g,"").substring(0,8).toUpperCase();return`${e.substring(0,4)}-${e.substring(4,8)}`}getSessionId(){return this.sessionId}setupMiddleware(){this.app.use(ux.default.json()),this.app.use((e,r,n)=>{r.setHeader("Access-Control-Allow-Origin","http://localhost:3002"),r.setHeader("Access-Control-Allow-Methods","GET, POST, OPTIONS"),r.setHeader("Access-Control-Allow-Headers","Content-Type"),n()}),this.app.use((e,r,n)=>{if(!this.checkRateLimit(e.ip||"unknown")){r.status(429).json({error:"Rate limit exceeded",limit:this.config.maxRequestsPerMinute});return}n()}),this.app.use((e,r,n)=>{S.debug(`${e.method} ${e.path}`,{ip:e.ip}),n()})}checkRateLimit(e){let r=Date.now(),n=r-6e4,i=this.requestCounts.get(e)||[];return i=i.filter(a=>a>n),i.length>=this.config.maxRequestsPerMinute?!1:(i.push(r),this.requestCounts.set(e,i),!0)}setupRoutes(){this.app.get("/events",(e,r)=>this.handleSSEConnection(e,r)),this.app.get("/commands",(e,r)=>this.handleCommandsPoll(e,r)),this.app.post("/result",(e,r)=>this.handleResult(e,r)),this.app.post("/selection-update",(e,r)=>this.handleSelectionUpdate(e,r)),this.app.post("/execute",(e,r)=>this.handleExecute(e,r)),this.app.get("/cached-selection",(e,r)=>this.handleCachedSelectionRequest(e,r)),this.app.post("/register-plugin",(e,r)=>this.handleRegisterPlugin(e,r)),this.app.post("/unregister-plugin",(e,r)=>this.handleUnregisterPlugin(e,r)),this.app.post("/register-mcp",(e,r)=>this.handleRegisterMCP(e,r)),this.app.post("/unregister-mcp",(e,r)=>this.handleUnregisterMCP(e,r)),this.app.get("/connection-info",(e,r)=>this.handleConnectionInfo(r)),this.app.post("/logs",(e,r)=>this.handleLogs(e,r)),this.app.post("/quota-status",(e,r)=>this.handleQuotaStatus(e,r)),this.app.get("/status",(e,r)=>this.handleStatus(r)),this.app.post("/shutdown",(e,r)=>this.handleShutdown(e,r)),this.app.options("*",(e,r)=>{r.sendStatus(200)})}setHistoryManager(e){this.historyManager=e}handleSSEConnection(e,r){S.info("Plugin connected via SSE"),r.setHeader("Content-Type","text/event-stream"),r.setHeader("Cache-Control","no-cache"),r.setHeader("Connection","keep-alive"),this.sseClients.add(r),this.sendSSEEvent(r,{event:"command",id:Rr(),data:{action:"connected",requestId:Rr(),params:{serverVersion:At,timestamp:Date.now()}}});let n=setInterval(()=>{this.sendSSEEvent(r,{event:"command",id:Rr(),data:{action:"keepalive",requestId:Rr(),params:{timestamp:Date.now()}}})},3e4);r.on("close",()=>{S.info("Plugin disconnected from SSE"),clearInterval(n),this.sseClients.delete(r)})}sendSSEEvent(e,r){let n=JSON.stringify(r.data);e.write(`event: ${r.event}
 `),e.write(`id: ${r.id}
 `),e.write(`data: ${n}
 

package/plugins/weppy-roblox-mcp/skills/roblox-game-dev/references/mcp-tools.md

@@ -51,22 +51,27 @@ For detailed parameters, check MCP tool definitions directly.
 | `get_script_dependencies` | Get dependencies |
 | `execute_script` | Execute script |
 
-## Selection
+## Selection (Basic)
 
 | Tool | Description |
 |------|-------------|
 | `get_selection` | Get currently selected instances |
-| `get_selection_context` | Get selection with context |
-| `get_selection_details` | Get detailed selection info |
 | `set_selection` | Set selection to instances |
 | `clear_selection` | Clear selection |
+
+## Selection (Pro)
+
+| Tool | Description |
+|------|-------------|
+| `get_selection_context` | Get selection with context |
+| `get_selection_details` | Get detailed selection info |
 | `add_to_selection` | Add to selection |
 | `remove_from_selection` | Remove from selection |
+| `watch_selection` | Watch selection changes |
 | `get_place_info` | Get place information |
 | `get_services` | Get game services |
 | `get_studio_settings` | Get Studio settings |
 | `run_command` | Run Studio command |
-| `watch_selection` | Watch selection changes |
 | `get_cached_selection` | Get cached selection state |
 
 ## Search