Relógios de progresso

Documentação · English · Gerenciamento de campanha

Relógios de progresso acompanham tarefas, ameaças, contagens regressivas e outros objetivos da campanha por meio de segmentos preenchidos. Pertencem à campanha e funcionam com qualquer sistema de jogo. A mesa e o gerenciador do mestre editam os mesmos registros salvos.

Criar e configurar

Na mesa, abra Relógios pelo ícone no dock inferior. Antes de entrar no jogo, abra Gerenciar campanha e selecione Relógios. Um mestre da campanha pode criar um relógio, escolher seu nome e cor e definir o progresso atual. Descrição do relógio guarda texto autoral opcional de até 4.000 caracteres. Somente o mestre o edita; leitores de um relógio público podem ler sua descrição.

Escolha um modelo com 4, 6, 8, 10 ou 12 segmentos ou Personalizado para um número inteiro entre 2 e 24. O progresso permanece entre zero e o número de segmentos. Uma campanha pode conter até 128 relógios.

Escolha o escopo do relógio:

Selecionar um contexto de cena no gerenciador prepara os relógios daquela cena. A seleção preserva a transmissão da mesa, a cena privada de cada participante e a presença na mesa. Entrar na mesa continua sendo uma ação separada. Excluir uma cena também remove os relógios vinculados a ela.

Público e controles

A edição por jogadores altera o progresso. Configuração, visibilidade, escopo de cena, reinício e exclusão continuam sendo operações do mestre. Ocultar um controle é uma escolha de apresentação; o servidor verifica o vínculo atual e a permissão do participante em cada requisição. Relógios privados e relógios de outra cena visualizada são filtrados antes da entrega.

Quando puder editar um relógio, clique com o botão esquerdo no mostrador para avançar um segmento ou com o direito para recuar um. Esses controles funcionam na lista completa, no gerenciador e na exibição fixada da mesa. Foque o mostrador e use Direita/Cima para avançar ou Esquerda/Baixo para recuar; os botões + e − continuam na janela completa e no gerenciador; relógios fixados mostram somente nome e mostrador. O progresso respeita os limites de segmentos, e uma alteração pendente termina antes de outra ação no mostrador ser aceita. O servidor verifica a mesma revisão salva e as permissões dos demais controles.

Use Reiniciar para voltar a zero ou o editor do mestre para revisar a configuração. Fechar a janela mantém os relógios salvos. Recarregar restaura o progresso salvo. Os relógios fixados usam os mesmos registros autorizados da lista completa.

Dê dois cliques no nome ou foque-o e pressione Enter ou Espaço. Para o mestre, isso abre o editor nativo, incluindo a descrição. Jogadores e espectadores veem uma modal simples de descrição somente de leitura. A abertura revalida o acesso; a descrição de um relógio privado nunca chega a esses leitores. O texto autoral mantém sua redação e é exibido como texto, incluindo quebras de linha.

Organizar relógios fixados

Os cards e segmentos vazios têm fundo transparente. Na mesa, cada relógio fixado pode ser movido de forma independente: arraste seu título até a posição desejada. Também é possível focar o título e movê-lo com as setas, um pixel por vez ou dez mantendo Shift pressionado. Escape cancela um arraste ativo. As posições respeitam a área visível do navegador quando seu tamanho muda.

As posições são salvas localmente por conta, campanha e indicador naquele navegador. Recarregar as restaura; o layout de outra pessoa permanece intacto. Telas largas e estreitas mantêm posições separadas, restaurando cada layout quando você retorna ao tamanho anterior. Mover um relógio não envia comando de posição ou transmissão nem altera dados de campanha, cena ou progresso. Mesmo um participante somente de leitura pode organizar os relógios que tem permissão para ver. Fixação e visibilidade continuam configurações compartilhadas do mestre, e mudanças de progresso seguem as permissões acima.

Sincronização e integração

A mesa recebe alterações confirmadas pela conexão de tempo real existente. O gerenciamento de campanha usa HTTP, atualizando ao recuperar o foco e pelo seu ciclo normal de atualização. Atualizar campanha busca o estado atual imediatamente.

Edições concorrentes usam a versão salva. Se um relógio mudar enquanto uma operação estiver pendente, atualize o estado e revise a ação. Cada alteração lógica usa um UUID de requisição novo; repetir exatamente a mesma operação reutiliza seu UUID para que ela seja aplicada uma única vez.

Integrações de navegador usam o domínio clocks da API pública: state, create, update, advance, reset e delete. Alterações em um relógio existente informam seu id e sua version inteira; avançar também informa delta. Criar e atualizar aceitam os campos nativos name, description, segments, value, color, visibility, playersCanEdit, pinned e scopeSceneId. A visibilidade é gm ou players; scopeSceneId: null seleciona o escopo da campanha. O sceneId da requisição informa o contexto atual de visualização. Os relógios retornados mostram seu escopo salvo em clock.sceneId. As integrações mantêm as mesmas verificações de campanha, cena e papel da interface nativa. description tem padrão "" e aceita somente string de até 4.000 caracteres. Omitir esse campo ao atualizar preserva o texto existente.

Os mostradores usam arte SVG nativa. O recurso dispensa módulos de outros VTTs ou pacotes de sistemas de jogo.

Mecanismos do MapBuilder

O nó Controlar relógio dos Objetos Inteligentes conecta um evento do mecanismo a uma operação de avançar, reduzir, definir ou reiniciar. Aceita uma quantidade configurada ou uma entrada numérica conectada. As alterações usam o mesmo relógio salvo e atualizam janelas e exibições fixadas autorizadas após a confirmação.

Um nó autorado pelo mestre autoriza aquela operação específica quando um participante interage com o mecanismo. Isso inclui relógios privados e relógios cuja edição direta por jogadores está desativada. Não concede acesso geral nem expõe nomes e valores privados. O motor exige um mestre ativo na campanha. O escopo do relógio continua limitando qual cena pode executar o vínculo.

Consulte Controlar relógios de progresso no MapBuilder para conexões, limites de quantidade e fluxos seguros de simulação e ensaio.

Backups e atualização

Exportações de campanha, snapshots, restaurações e clones preservam a configuração, o progresso e o escopo de campanha ou cena dos relógios. As opções de clonagem podem omitir todos os relógios com clocks: false. Omitir as cenas com scenes: false também omite os relógios vinculados a cenas, preservando os relógios da campanha quando os relógios forem incluídos.

O recurso acrescenta a migração 0003_progress_clock de gravewright_table; descrições acrescentam 0006_clock_description. Arquivos antigos sem esse campo importam com descrição vazia. Cópias e snapshots preservam o texto autoral exato, inclusive quando contém UUIDs de recursos. Aplique as migrações pendentes antes de reiniciar uma instalação existente:

uv run --locked python manage.py migrate