Quando o dia deixa de avançar em um jogo de gerenciamento, o calendário pode ser apenas o sintoma visível. O relógio pode estar pausado, a condição de encerramento do turno pode não ser acionada ou a data oficial do jogo pode mudar enquanto as tarefas, a folha de pagamento, a interface ou o sistema de salvamento ainda consultam o dia anterior.

Comece acompanhando um dia inteiro, da condição que dá início ao dia até a manhã seguinte. O exemplo abaixo é fictício e não apresenta resultados de testes de projeto, build, folha de pagamento ou calendário. Use as etapas para orientar o diagnóstico no seu próprio jogo.
Diferencie um relógio parado de uma virada de dia travada
Primeiro, determine o que “o dia não avança” significa na build atual. O relógio do jogo para durante o turno? O turno termina e a data continua a mesma? A data muda no log, mas o painel do calendário continua desatualizado? As tarefas e o processamento da folha de pagamento se repetem, deixam de ocorrer ou acontecem na data correta? Cada resposta aponta para um componente responsável diferente.
| Observação | Onde investigar | O que comparar primeiro |
|---|---|---|
| O valor do relógio fica congelado | Temporizador, pausa, escala de tempo ou estado de processamento | Compare o tempo decorrido e os indicadores de pausa |
| O turno termina e a data não muda | Condição de encerramento ou evento de transição | Registre no log o ramo do código que deveria iniciar um novo dia |
| A data muda, mas a interface não | Notificação de mudança de estado ou atualização da exibição | Compare o valor no modelo com o valor recebido pelo rótulo |
| A data muda, mas as tarefas ou a folha de pagamento ficam fora de sincronia | Ordem dos eventos ou consumidores duplicados | Registre o ID do dia recebido por cada sistema |
Evite começar trocando “somar um dia” por “somar dois dias” ou reinicializando todos os sistemas que consultam o calendário. Isso pode esconder a causa e introduzir um segundo bug. Descubra se o estado oficial mudou e acompanhe o valor exato em cada sistema que o recebe.
Rastreie o fluxo que determina a virada do dia
Mapeie o fluxo na ordem em que ele ocorre: início do turno, avanço do tempo, condição de fim de turno, lógica de fechamento do dia, atualização do ID do dia, tarefas agendadas, folha de pagamento, atualização da interface e salvamento. Identifique o componente responsável por cada etapa. Se um sinal conectar vários sistemas, anote quem o emite e verifique se algum consumidor se conecta mais de uma vez após o recarregamento de uma cena.
Adicione logs temporários a uma cópia local. Inclua o ID do dia atual, o motivo da transição, o estado de pausa ou a escala de tempo, se forem relevantes, e se o evento de virada do dia foi emitido. Registre esses dados no emissor e nos consumidores. O rastreamento pode mostrar “turno encerrado, evento emitido, folha de pagamento recebeu o dia 12” mesmo que o painel do calendário ainda exiba o dia 11.
No Godot, a referência oficial de Timer descreve uma contagem regressiva que emite o sinal timeout e observa que as configurações de processamento e Engine.time_scale afetam seu funcionamento. O guia de processamento distingue o processamento ocioso, executado a cada quadro, do processamento de física, executado em intervalos fixos, e explica o delta de tempo. Esses detalhes podem ajudar a investigar um projeto no Godot. Eles não identificam a causa em um jogo que ainda não foi testado nem determinam qual arquitetura de temporização seu jogo precisa.

Verifique o que costuma bloquear a virada do dia
Procure uma condição que nunca é satisfeita. O temporizador do turno pode estar parado, uma tarefa pode ter ficado pendente, uma janela modal pode bloquear a confirmação, um indicador de pausa pode continuar ativo ou uma inscrição em um evento pode ter se perdido na troca de cena. Acompanhe o fluxo com o jogo em execução, pois o nome de uma variável, por si só, não explica o que acontece.
Depois, verifique se a transição é disparada mais de uma vez. Um callback executado em duplicidade pode avançar a data duas vezes, pagar a equipe duas vezes ou agendar as tarefas de amanhã antes que apareça o resumo de hoje. Se houver novas tentativas de processar a virada do dia, garanta que seus efeitos só sejam aplicados uma vez e registre o ID do dia que cada sistema processou.
Se o relógio usa um temporizador, confirme se ele começa no momento previsto, se não é pausado inesperadamente e se usa a escala de tempo esperada. Se o relógio acumula o delta de cada quadro, verifique se o acúmulo está habilitado no estado atual do jogo e se pausar e retomar preserva o valor esperado. Consulte a documentação da versão da engine usada no projeto para conferir as configurações exatas.
Mantenha as tarefas, a folha de pagamento e a exibição em sincronia
As tarefas agendadas e a folha de pagamento devem usar a mesma transição de dia ou uma mesma versão estável do estado do calendário. Evite relógios separados que possam divergir por causa de um quadro, do carregamento de uma cena ou de uma falha no salvamento. Defina a sequência de forma explícita: processe as tarefas de hoje, calcule os pagamentos do período previsto, atualize a data, emita o evento de novo dia e, por fim, atualize a interface e salve o jogo. A ordem efetiva depende das regras do jogo. Registre essa ordem antes de editar o código.
A interface deve consultar o estado oficial do calendário para evitar manter uma segunda cópia da data. Se o modelo avançar e o rótulo continuar desatualizado, atualize a exibição pelo mecanismo de mudança de estado que o projeto já usa. Evite corrigir o rótulo incrementando um número mantido pela própria interface. Isso pode fazer a data parecer correta enquanto as tarefas e os salvamentos continuam incorretos.
Mantenha um registro de depuração simples com o nome do evento, o ID do dia, o horário, o emissor e o destinatário. Remova os logs temporários que geram ruído depois de entender a causa raiz e guarde uma nota de teste junto com a correção. Se você não conseguir observar a transição esperada no projeto real, mantenha a causa registrada como desconhecida.
Peça à IA para corrigir o componente responsável pela transição
Forneça ao assistente o rastreamento, a sequência esperada e os arquivos do projeto que controlam o calendário e os sistemas que o consultam. Peça que identifique o ponto mais específico em que a transição falha antes de alterar o código. Especifique o que deve ser preservado: duração do turno, regras das tarefas, valor e período da folha de pagamento, rótulos do calendário, formato de salvamento e comportamento da pausa.
Peça um plano de alterações por arquivo, um diff pequeno e uma forma de reverter as mudanças. Solicite que o assistente explique se a correção altera o temporizador, a condição de encerramento, a inscrição no evento, o modelo do calendário ou apenas a interface. Se a proposta reescrever todo o agendamento ou duplicar o estado do calendário, peça uma correção menor.
Verifique o ciclo completo a partir de um salvamento limpo
Teste mais de uma virada de dia normal. Os casos abaixo são sugestões de teste. Eles não representam resultados do cenário fictício do escritório.
| Caso | Ação | O que verificar |
|---|---|---|
| Turno normal | Encerre um turno pelo fluxo habitual | Uma única mudança de data e uma única atualização das tarefas e da folha de pagamento |
| Pausa e retomada | Pause perto do fim do turno e depois retome | O relógio e a condição de encerramento seguem as regras previstas |
| Tarefa pendente | Deixe uma tarefa inacabada quando o jogo permitir | A transição aguarda ou prossegue conforme as regras do jogo |
| Disparo repetido | Repita a transição de forma segura em uma cópia de teste | Nenhum pagamento é duplicado e nenhum dia do calendário é pulado |
| Salvamento e recarregamento | Salve perto da virada do dia e recarregue o jogo | A data, as tarefas e a folha de pagamento ficam em sincronia após o carregamento |
| Virada de semana ou mês | Passe de uma semana ou de um mês para o seguinte, se houver suporte | A formatação do calendário e os eventos agendados continuam corretos |
Registre a versão da build, o salvamento usado no teste, as etapas, o resultado esperado e o resultado observado. Verifique separadamente a plataforma de destino e qualquer modo de tempo acelerado. Um calendário simulado ou uma ilustração gerada pode explicar o processo. Para comprovar que o dia avançou corretamente, é preciso observar o que aconteceu no jogo real.

Perguntas frequentes
Por que o calendário de um jogo para de avançar?
O relógio pode estar pausado ou parado, a condição de fim do dia pode nunca ser acionada ou a data pode ser atualizada enquanto a interface consulta um estado desatualizado. Rastreie a transição e os sistemas que recebem seu evento antes de alterar o cálculo da data. Registre se o evento chega ao sistema responsável pela data.
O calendário do jogo deve usar Timer ou o delta de cada quadro?
Use o mecanismo de temporização que corresponda ao funcionamento previsto do jogo. O Godot documenta Timer como uma contagem regressiva com sinal timeout e configurações de escala de tempo e de processamento. O processamento por quadro usa callbacks com comportamento diferente. Em ambos os casos, defina claramente qual componente controla a virada do dia. Confira as configurações exatas e o modo de temporização usado pelo projeto ativo.
Como saber se o problema está na data ou na sua exibição?
Registre o valor oficial do calendário no início do turno, na condição de encerramento, no evento de virada do dia, no salvamento e na atualização da interface. Compare esses valores com o rótulo exibido para descobrir se o estado deixou de mudar ou se apenas a exibição ficou desatualizada. Use o mesmo identificador de dia em todos os registros de depuração.
A folha de pagamento e as tarefas agendadas devem ser atualizadas separadamente?
Faça com que usem o mesmo evento de virada do dia já confirmada ou o mesmo registro do estado do calendário. Relógios separados podem perder a sincronia, gerar cobranças em duplicidade ou pular uma tarefa agendada quando houver uma nova tentativa de processar a transição. Cada consumidor deve processar a mesma virada de dia exatamente uma vez. Assim, a data e os efeitos da transição ficam vinculados a uma única virada de dia confirmada.
O que devo testar depois de corrigir o avanço dos dias?
Teste o encerramento normal de um turno, a pausa e a retomada, o tempo acelerado se houver suporte, uma condição de encerramento bloqueada, o salvamento e recarregamento e as datas de virada que afetam as tarefas e a folha de pagamento. Registre os resultados observados na build de destino. Um cenário simulado não serve como evidência. Vincule a evidência à build e à data testadas.
Mantenha o calendário como fonte de verdade
Rastreie o estado antes de alterar o código, corrija o componente responsável pela transição com falha e faça com que as tarefas, a folha de pagamento, a interface e os salvamentos usem a mesma virada de dia. Depois, verifique na build real os casos de transição normal, pausa, disparo repetido e recarregamento. Uma explicação plausível ajuda a orientar a investigação. O rastreamento observado é o que confirma a correção.
Se você quiser experimentar outra ideia em um protótipo que roda no navegador, experimente o SEELE AI Game Maker. Essa é uma atividade à parte da correção de um jogo de gerenciamento existente.


