Um papel assimétrico pode dar mais espaço para o jogador se expressar em um protótipo de jogo de cartas colecionáveis, mas também pode afetar a montagem de baralhos, o acesso às cartas, a sequência dos turnos, o equilíbrio das partidas e os dados salvos. Comece registrando as regras atuais. Adicione uma opção visível de papel por meio de uma camada de dados de escopo limitado e compare o novo papel com o existente, sem alterar por padrão o conjunto compartilhado de cartas nem o mecanismo de resolução.

Este guia trata de como dar continuidade a um protótipo existente. Os papéis, as cartas, as regras das habilidades, as partidas de exemplo e seus resultados são inventados. Não havia código-fonte, build, lista de cartas ou sessão de teste disponível. Cada teste abaixo é uma verificação proposta, sem comprovar o comportamento de um jogo real.
Registre as regras atuais dos baralhos e das partidas
Faça um commit limpo ou duplique o projeto antes de editar. Registre como os baralhos são montados e validados, como se compra a mão inicial, como avançam os turnos, como os efeitos das cartas são resolvidos e quais dados são salvos. Anote se o protótipo já tem classes de jogador ou restrições por papel. Se não for possível inspecionar esses sistemas, declare essa limitação em vez de presumir que o jogo segue uma arquitetura padrão.
Anote o que deve permanecer igual para o jogador com o papel original. Isso pode incluir as cartas permitidas no baralho, os custos das cartas, as regras de compra, o mulligan, o momento de resolução dos efeitos, a curva de recursos e as condições de vitória da partida. Use a implementação atual do jogo como referência: um guia ou um mockup gerado não pode confirmar a ordem exata em que o projeto aplica suas regras.
| Sistema | O que registrar como referência | O que preservar por padrão |
|---|---|---|
| Montagem de baralhos | Cartas permitidas, limites de cópias e validação | Regras atuais para baralhos válidos |
| Catálogo de cartas | IDs estáveis das cartas, custos e efeitos | Definições compartilhadas das cartas |
| Sequência do turno | Compra, jogada, resposta e fim do turno | Mecanismo central de resolução e ordem dos eventos |
| Dados da partida | Papel, baralho, posição do jogador e chaves de salvamento | Compatibilidade com o protótipo existente |
Peça à IA que inspecione somente os arquivos fornecidos e apresente um plano breve, arquivo por arquivo, antes de escrever código. Exija uma lista dos sistemas que ela deixará intactos. Se a IA propuser editar todas as cartas para dar identidade ao papel, pergunte se uma habilidade própria do papel pode criar a decisão desejada com menos risco.
Defina a assimetria como uma decisão com limites claros
Um papel deve mudar a forma como o jogador toma uma decisão, sem esconder uma vantagem numérica. Entre as opções estão uma escolha entre dois modos uma vez por partida, uma janela limitada de reação, um recurso inicial diferente ou uma opção visível de seleção de cartas. Defina o gatilho, o alvo, o limite, o custo, o momento de uso e as possibilidades de resposta do adversário. Evite bônus que sejam sempre melhores ou efeitos que contornem a estrutura de turnos compartilhada.
No protótipo fictício Glass Orchard, o Arquivista pode, uma vez por partida, mudar a ordem de duas cartas no fundo do baralho. Já o Guardião pode, uma vez por partida, proteger uma unidade contra um único efeito de status. Ambos usam o mesmo conjunto de cartas e a sequência padrão de turnos. Essas habilidades inventadas servem apenas para ilustrar o escopo. Elas não passaram por testes de equilíbrio, e os valores usados não são recomendações.

Mantenha a habilidade visível para os dois lados. Os jogadores devem conseguir prever quando o papel pode agir e o que a habilidade pode afetar. Se uma habilidade mudar quais cartas podem entrar no baralho, informe isso antes que os jogadores façam a montagem. A escolha do papel não deve invalidar, sem aviso, um baralho que era permitido no protótipo original.
Separe a configuração do papel das definições das cartas
Mantenha os IDs dos papéis e as configurações aceitas separados do catálogo de cartas. A camada que define o papel pode especificar seu nome, sua apresentação e os IDs das habilidades permitidas. O jogo deve continuar resolvendo a habilidade por caminhos de código já conhecidos. Evite armazenar trechos de script executável nos dados editáveis do papel. Rejeite IDs sem suporte e exiba uma mensagem de erro clara quando um papel salvo usar uma habilidade que a build atual não reconhece.
A documentação da versão estável do Godot descreve Resource como uma classe serializável da própria engine que serve principalmente como contêiner de dados e pode ser salva em disco. Isso indica uma maneira nativa do Godot de representar os dados, sem implicar uma recomendação universal de esquema para os papéis de um jogo de cartas. Siga a convenção de dados do projeto, seja ela baseada em Resources, JSON ou outro formato.
Se os dados do papel forem salvos ou compartilhados, adicione uma versão somente quando necessário e defina como lidar com arquivos antigos. Mantenha os dados apresentados aos jogadores em formato declarativo e valide-os antes de iniciar a partida. Uma propriedade desconhecida do papel não deve acabar acionando um efeito de carta nem alterando uma regra global.
Mantenha estáveis o conjunto compartilhado de cartas e as regras competitivas
Na primeira implementação de ponta a ponta, adicione uma definição de papel e um ponto de acionamento da habilidade à configuração de partida existente. Preserve o tamanho do baralho, o limite de cópias, a lista de cartas, o tamanho da mão, a quantidade de cartas compradas e a ordem dos turnos, a menos que o produto exija alguma mudança específica. Se o papel precisar afetar a montagem de baralhos, crie uma regra explícita que o validador possa explicar antes da busca por adversários ou do início do jogo.
Deixe explícito no estado da partida a quem pertence cada papel. A habilidade deve pertencer ao jogador que a selecionou, ser restaurada no momento documentado e jamais ser copiada por engano para o adversário. Decida se ela deve persistir em uma revanche, ao salvar e carregar a partida ou ao iniciar um novo jogo. Se o protótipo atual não salva os papéis, não aproveite essa mudança para fazer uma migração ampla dos dados salvos.
A documentação de RandomNumberGenerator do Godot afirma que uma determinada semente produz uma sequência pseudoaleatória reproduzível no contexto da engine. Isso não comprova que o protótipo em questão usa essa API nem que uma partida inteira possa ser reproduzida de forma idêntica entre versões. Se o projeto tiver uma infraestrutura de testes com aleatoriedade, registre qual gerador é realmente usado e sua versão. Caso contrário, use dados de teste fixos para repetir os testes dos papéis.
Planeje a menor mudança possível e como revertê-la
Peça à IA que proponha uma lista do que pode ser alterado, por exemplo: um arquivo de dados do papel, um ponto da interface de seleção ou configuração da partida, um tratador específico para a habilidade e testes focados. Mantenha fora da mudança as definições das cartas, o mecanismo compartilhado de resolução, as regras atuais dos baralhos, o papel original, o fluxo da campanha e o código do ranking, a menos que a inspeção do projeto revele uma dependência. Exija o diff completo e uma justificativa para cada arquivo modificado.
Antes de aplicar o patch, guarde um commit de referência e uma cópia dos dados de papéis ou baralhos. Se a habilidade exigir uma grande refatoração do mecanismo de resolução, separe esse trabalho em uma tarefa com revisão própria. Deve ser possível remover o novo papel revertendo o commit do recurso, sem precisar migrar todo o banco de dados ou alterar todas as cartas.
| Parte da mudança proposta | Possível adição | O que preservar |
|---|---|---|
| Seleção de papel | Um ID de papel na configuração da partida | Fluxo atual de seleção do baralho |
| Dados da habilidade | Uma habilidade reconhecida e seu limite | Catálogo de cartas e texto dos efeitos |
| Resolução | Um ponto de acionamento validado em um momento já previsto nas regras | Mecanismo compartilhado de resolução dos turnos |
| Dados salvos | Campo opcional para o papel, com comportamento padrão quando ausente | Formatos atuais dos dados salvos e dos baralhos |
| Testes | Casos de troca de papéis e de limite de uso | Comportamento de referência do jogador com o papel original |
Teste os papéis em condições iguais
Compare os papéis usando o mesmo baralho de teste, a mesma ordem das cartas, as mesmas regras da partida e a mesma posição de jogador. Alterne qual papel joga primeiro e qual jogador fica com cada papel. Teste a habilidade no momento permitido, depois de já ter sido usada, contra um alvo inválido e após ser restaurada. Verifique se o adversário vê as mesmas informações públicas e se ambos os papéis continuam sujeitos às regras normais das cartas.

| Verificação proposta | Ação | O que registrar |
|---|---|---|
| Regressão no papel original | Jogar com um baralho conhecido e o papel original | Build, baralho, sequência de ações dos turnos e resultado |
| Troca de papéis | Trocar os papéis entre as posições dos jogadores | Posição, mão inicial e momento de uso da habilidade |
| Limite da habilidade | Tentar usar a habilidade pela segunda vez na mesma partida | Bloqueio esperado e indicação visível ao jogador |
| Validação do baralho | Carregar um baralho com cartas restritas | Resultado da validação (permitido ou não) e explicação |
| Salvar e carregar | Abrir uma partida antiga ou uma cópia de um baralho antigo | Comportamento alternativo e dados preservados |
| Reversão | Restaurar o commit de referência | Se ainda é possível jogar com o papel original |
Este é um plano de testes. As verificações ainda não foram executadas. Registre a versão do projeto, o ID do papel, o baralho de teste, a posição do jogador, os dados usados para controlar a aleatoriedade, se disponíveis, a ação, o resultado esperado, o resultado observado e eventuais divergências. Uma única partida inventada ou execução com semente definida não comprova que a disputa é justa, sobretudo se o jogo tiver compras de cartas ocultas ou efeitos específicos para cada adversário.
Avalie a clareza e o equilíbrio separadamente
O funcionamento correto da mecânica e o equilíbrio competitivo são questões distintas. Primeiro, verifique se o papel é acionado no momento certo e se a resolução dos efeitos das cartas continua funcionando. Depois, use dados de partidas reais ou sessões de teste estruturadas para estudar a distribuição dos confrontos, as interações e as possibilidades de resposta do adversário. Não descreva uma habilidade como justa ou equilibrada com base em uma revisão de código, uma simulação de interface ou um pequeno exemplo inventado.
Para explorar uma ideia independente de jogo de cartas colecionáveis, experimente o SEELE AI Game Maker. É uma ferramenta para criar conceitos de jogos, sem a função de editar projetos existentes.
Perguntas frequentes
O que torna um papel assimétrico em um jogo de cartas?
Um papel deve oferecer uma decisão diferente e fácil de entender por meio de uma habilidade com limites claros, um recurso inicial ou uma escolha que só pode ser feita uma vez por partida. Sempre que possível, mantenha o mesmo conjunto de cartas e a mesma sequência de turnos para todos. Evite regras ocultas que deixem o papel mais forte sem um custo claro, uma possibilidade de resposta do adversário ou uma explicação visível.
O papel deve mudar quais cartas o jogador pode usar para montar um baralho?
Só altere o acesso às cartas se o jogo já tiver regras que determinem quais cartas são permitidas para cada papel ou se o novo recurso exigir isso explicitamente. Por padrão, preserve a validação atual dos baralhos. Se o acesso mudar, informe a regra antes da montagem e teste baralhos antigos, listas inválidas e dados de baralhos salvos.
Como testar dois papéis assimétricos em condições justas?
Use a mesma lista de cartas, a mesma configuração de partida e as mesmas condições de teste, alternando a ordem dos jogadores e quem fica com cada papel. Registre o uso da habilidade e o resultado da partida, sem tirar conclusões de uma única vitória. Uma matriz de testes planejada ou uma partida de exemplo inventada não comprova que os papéis são equilibrados ou que a disputa é justa.
Como armazenar as habilidades dos papéis em um protótipo existente?
Mantenha os identificadores dos papéis e os valores aceitos separados das definições das cartas e do mecanismo de resolução da partida. Use o formato de dados que o projeto já carrega, adicione uma versão ao esquema somente quando a compatibilidade exigir e rejeite habilidades desconhecidas. Evite armazenar scripts executáveis em formato de texto nos dados dos papéis apresentados aos jogadores.
A IA pode adicionar um papel ao meu jogo de cartas colecionáveis existente?
A IA pode inspecionar os arquivos fornecidos, esboçar uma mudança de escopo limitado e propor casos de teste de regressão que alternem os papéis. Ela não pode verificar o funcionamento do protótipo nem seu equilíbrio competitivo sem acesso ao projeto real e sem que os testes sejam executados. Forneça uma lista de arquivos permitidos, um baralho de referência, as regras esperadas para a habilidade e um commit ao qual seja possível voltar. Depois, revise o diff completo.
Adicione um papel sem desestabilizar as regras compartilhadas
Registre as regras atuais de baralho e partida, defina uma habilidade visível e mantenha os dados do papel separados das cartas compartilhadas e da resolução dos turnos. Adicione o papel com um patch de escopo limitado, teste-o com os mesmos dados de teste, alternando a ordem dos jogadores, e preserve um ponto seguro de reversão. Considere o equilíbrio e a compatibilidade como não verificados até que o protótipo real seja testado.


