Suporte a mods orientados a dados

Suporte a mods orientados a dados permite que o FootSim seja expandido por conteúdo sem alterar o código do jogo. Isso inclui novos clubes, jogadores, competições, países, estádios, regras, nomes, atributos, reputações, contratos, finanças iniciais e outros dados representáveis pelo schema.

Esse item é diferente de plugins ou mods de lógica. O foco é permitir customização segura baseada em dados. O FootSim já possui várias peças técnicas para isso: schema extensível, editor, JSON versionado, overlays, datapacks, import/export backend e pacote tático .fsim. Porém, como ecossistema de modding para a comunidade, ainda está no começo: falta mod manager, UI de datapacks de base, validação conectada, documentação unificada, governança e separação clara entre formatos .fsim.

Escopo incluído

• Mods baseados em dados
• Novos clubes
• Novos jogadores
• Novas competições
• Novos países/regiões quando suportado
• Novos estádios
• Alterações de atributos
• Alterações de reputações
• Alterações de finanças iniciais
• Alterações de contratos
• Alterações de regras suportadas
• Datapacks como formato de mod
• Overlays como mecanismo complementar quando aplicável
• Editor como ferramenta de authoring
• Validação de mods
• Importação/exportação
• Documentação para modders
• Metadados do mod
• Compatibilidade com versões
• Separação entre mod e conteúdo oficial
• Aviso ao jogador quando conteúdo modificado estiver ativo

Fora de escopo

• Mods com código executável
• Plugins que alteram o motor de partida
• Plugins que alteram UI com código custom
• Scripts de terceiros rodando dentro do jogo
• Multiplayer modded
• Marketplace completo
• Garantia de compatibilidade entre todos os mods
• Suporte a qualquer alteração arbitrária do banco
• Modding visual completo de skins/temas
• Modding de regras impossíveis de representar pelo schema atual
• Ecossistema público completo enquanto datapacks de base ainda não tiverem UI e política maduras
• Dois formatos .fsim incompatíveis sem distinção clara para modders

Critérios de conclusão

• O jogo aceita conteúdo custom orientado a dados.
• Mods podem ser empacotados como datapacks.
• Mods podem ser validados antes de uso.
• Mods não exigem alteração de código do jogo.
• Modders têm documentação suficiente para começar.
• O jogador entende quando está usando conteúdo modificado.
• Mods incompatíveis são detectados.
• O sistema reduz risco de quebrar saves.
• O suporte a mods expande o jogo sem comprometer estabilidade.
• O ecossistema de mods é seguro o suficiente para crescer gradualmente.
• A experiência de modding deixa de ser apenas capacidade técnica backend e passa a ser utilizável por modders reais.
• O suporte a mods deixa claros os limites entre dados customizáveis e lógica não modificável.