Timeline

Retroactive Import

A Importação Retroativa permite que a Linha do Tempo preencha entradas de Crônicas de arquivos de avanço de jogadores em mundos existentes.

TLDR
  • Executa uma vez na inicialização do servidor (quando habilitado).
  • Verifica world/advancements/*.json.
  • Importações concluídas, avanços visíveis ainda não presentes.
  • Opcionalmente, pode incluir avanços na receita.

Como funciona

Na inicialização do servidor:

  1. A linha do tempo localiza os arquivos JSON de avanço do jogador.
  2. Para cada arquivo do player, verifica os critérios preenchidos.
  3. Ele resolve os avanços exibidos correspondentes.
  4. Ele grava eventos importados no Chronicle SavedData.
  5. Transmite Chronicle + Hall of Fame atualizado se algo foi importado.

Segurança Duplicada

A importação é idempotente por (playerUuid, sourceId):

  • se o par já existir nos dados do Chronicle, ele será ignorado
  • startups repetidas não duplicam as mesmas entradas históricas

Modos de mapeamento diário

retroactiveAdvancementImportMapByRealDays controla o posicionamento da data:

  • true: mapeia a idade de conclusão do relógio de parede para o deslocamento do dia na linha do tempo
  • false: coloca entradas importadas no dia atual da linha do tempo

Manuseio de receitas

retroactiveAdvancementImportIncludeRecipes:

  • false (recomendado): ignora namespace:recipes/*
  • true: inclui avanços na receita, o que pode adicionar muito ruído
DEEP DIVE: fallback de carimbo de data/hora de conclusão

A linha do tempo tenta calcular o tempo de conclusão dos grupos de requisitos de critérios. Se um carimbo de data/hora robusto não puder ser derivado, ele retornará ao horário modificado do arquivo para uma continuidade de importação mais segura.

Fase de execução

A importação retroativa é um pipeline de inicialização. Ele não monitora continuamente os arquivos de avanço durante o tempo de execução.

Apoie este projeto

Gostou desta wiki e destes mods?

Cada apoio ajuda a continuar criando recursos, escrevendo documentacao e lancando atualizacoes.

Voltar ao topo