Datapacks `.fsim`

Datapacks .fsim são pacotes de dados que permitem importar, exportar e distribuir conteúdo do FootSim. Eles podem servir para compartilhar bases alternativas, expansões geográficas, competições, clubes, jogadores, correções de dados ou mods criados pela comunidade.

Esse item é o coração técnico do modding baseado em dados. A infraestrutura backend de datapacks já existe para pacotes de base, com import/export, manifest e entidades. Também existe outro uso da extensão .fsim para pacotes táticos. Essa duplicidade precisa ser resolvida, unificada ou documentada para evitar confusão. Além disso, o datapack de base ainda carece de experiência de usuário: preview, import/export na UI, validação chamada antes de aplicar, mensagens de erro claras e política de compatibilidade.

Escopo incluído

• Formato .fsim para datapacks de base
• Formato .fsim tático quando aplicável
• Manifest do pacote
• Metadados do datapack
• Exportação de datapacks
• Exportação por nações quando aplicável
• Importação de datapacks
• Preview de datapack
• Validação de datapacks
• Conteúdo de clubes
• Conteúdo de jogadores
• Conteúdo de competições
• Conteúdo de estádios
• Conteúdo de países/regiões quando aplicável
• Conteúdo de regras quando aplicável
• Extração/importação de imagens quando aplicável
• Compatibilidade com banco mestre
• Compatibilidade com editor
• Processo de empacotamento
• Base para compartilhamento comunitário
• Detecção de conflitos quando aplicável
• Mensagens de erro de importação

Fora de escopo

• Marketplace oficial completo
• Instalação automática de mods online
• Sincronização multiplayer de datapacks
• Garantia de compatibilidade eterna
• Suporte a código executável em mods
• Plugins com lógica customizada
• Mods que alteram o motor do jogo
• Download automático de bases reais
• Curadoria oficial de todos os datapacks comunitários
• Sistema completo de dependências entre mods desde o início
• Considerar datapacks de base prontos como produto enquanto não houver UI de import/export
• Aplicar datapack sem validação quando a validação estiver disponível
• Manter dois formatos incompatíveis com a mesma extensão sem documentação clara

Critérios de conclusão

• O jogo consegue exportar um datapack válido.
• O jogo consegue importar um datapack válido.
• O jogador ou modder consegue pré-visualizar o conteúdo antes de aplicar.
• O formato possui metadados suficientes.
• Datapacks inválidos são recusados com erro claro.
• A validação é executada antes da importação quando aplicável.
• Entidades importadas mantêm relações consistentes.
• O sistema reduz risco de quebrar o banco.
• O formato é documentado o suficiente para uso externo.
• O editor consegue trabalhar com conteúdo que pode virar datapack.
• Datapacks podem ser usados para expansão de conteúdo.
• A relação entre datapacks de base e pacotes táticos .fsim fica clara.
• O sistema fica seguro e compreensível para modders não técnicos.