Modding Lua do GoreBox

Addons GoreBox v16 são scripts Lua no runtime sandbox — não injeções DLL legadas ou packs hack pré-v16. A F²Games publica API GoreBox Modding documentando registro spawn, hooks de input, manipulação de entidades e regras de empacotamento Workshop. Documentação canônica em gorebox-modding.github.io — marque junto ao nosso guia console e ferramenta Command Lookup ao construir primeiro addon.

Addons Lua carregam de Mods no PC em AppData/LocalLow/F2Games/GoreBox/Mods ou assinaturas mod.io sincronizadas. Cada addon expõe script entry executado no load do mapa. Autores registram entidades custom — GoreDolls, armas, props — que aparecem nos menus spawn quando registro succeeds. Scripts falhos logam erros via /openConsole com Creator Mode do nosso guia Creator Mode.

Comece pasta addon com nome claro igual listagem mod.io. Inclua arquivo Lua entry do template oficial — registrando callbacks para load map, spawn jogador e tick updates. Assets — texturas, áudio, bundles — ficam ao lado em subpastas documentadas em gorebox-modding.github.io.

Use funções de registro spawn para adicionar GoreDolls e armas sem sobrescrever IDs vanilla — IDs duplicados conflitam com outros addons do ecossistema Workshop. Hook input com parcimônia; mobile expõe eventos touch diferentes de scan teclado PC. Teste cross-platform se publicar listagens Android no mod.io.

Referencie comportamento vanilla nos catálogos wiki — GoreDolls, armas, veículos — ao espelhar stats oficiais. Interações Reality Crusher podem exigir casos especiais nas seções avançadas da API.

Ative Creator Mode, copie work-in-progress para Mods seguindo guia PC e carregue mapa leve como Legacy. Abra /openConsole imediatamente para exceções load-time — stack traces citam linhas no entry script. Itere editando Lua no VS Code ou Cursor, salvando e reiniciando mapa quando possível sem reboot completo.

Use /navgenerate após spawnar props estáticos custom para GoreDolls patharem — veja todos os commands. Grave reprodução com commands de movimento do guia gravação ao reportar bugs à F²Games ou autores mod.io.

Teste Android exige deploy ZArchiver do guia Android — nunca assuma sucesso só PC implica mobile.

Após testes locais, empacote pasta conforme checklist gorebox-modding.github.io — metadata manifest, previews, tags plataforma. Upload via portal desenvolvedor mod.io linkado aos recursos F²Games. Descreva dependências, requisitos Creator Mode e commands / custom para jogadores na nossa página host e creator.

Atualize listagens após patches GoreBox quebrarem API — assinantes recebem notificação de novas versões. Lance releases com vídeos tutorial nos guias GoreDolls custom ou Map Editor básico quando addon mirar esses fluxos.

Participe Discords comunitários onde moderadores F²Games compartilham notas de API mais rápido que wiki em ciclos patch rápidos. Respeite licenças de assets em texturas terceiras — DMCA no mod.io prejudica ecossistema inteiro.

Versione nomes de pasta em dev — sufixos _v1, _v2 evitam confundir qual build gerou screenshot de bug. Versionamento semântico em release notes mod.io ajuda jogadores a re-assinar após breaking changes em patch major GoreBox.