Pistas por etapas

Documentação · English · Relógios de progresso

Pistas acompanham descobertas com os mesmos escopos de campanha e cena dos relógios de progresso. O mestre pode preparar uma descoberta, registrar notas privadas e revelá-la imediatamente ou após várias etapas. A mesa e o gerenciador usam as mesmas pistas salvas, independentemente do sistema da campanha.

Preparar uma pista

Abra Pistas pelo ícone no dock inferior da mesa ou selecione Pistas em Gerenciar campanha. Um mestre da campanha pode criar e editar estes campos:

Use um segmento para uma descoberta que deve aparecer em uma única etapa. Use vários para uma investigação que exige múltiplas descobertas. Uma campanha pode conter até 128 pistas. Notas do mestre são separadas do Conteúdo: continuam privadas mesmo após a revelação da pista. Nomes, conteúdo e notas autorais preservam sua redação ao trocar o idioma da interface.

Selecionar uma cena no gerenciamento prepara essa cena sem mudar a transmissão da mesa, a navegação privada ou a presença. Uma pista de cena só fica disponível nessa cena. Excluir a cena também remove as pistas vinculadas a ela.

Descoberta e visibilidade

Jogadores e espectadores recebem uma pista apenas quando as duas condições são atendidas: seu progresso está completo e sua visibilidade é Revelar ao descobrir. Antes disso, o servidor omite o registro, incluindo nome, conteúdo, identificador e progresso incompleto. Não envia espaços reservados nem uma contagem de pistas desconhecidas. Notas do mestre são omitidas de toda projeção para jogadores e espectadores.

Apenas mestres da campanha podem configurar pistas ou mudar seu progresso diretamente. Jogadores e espectadores podem abrir descobertas permitidas em modo somente leitura. A fixação segue as mesmas verificações de descoberta e visibilidade da lista completa.

O mestre pode clicar com o botão esquerdo na barra de progresso para avançar uma etapa ou com o direito para recuar uma. Foque a barra e use Direita/Cima para avançar ou Esquerda/Baixo para recuar; os controles + e − continuam na lista completa e no gerenciador. Isso funciona no gerenciador, na lista da mesa e na exibição fixada, com os mesmos limites de segmentos, revisão e operação pendente. Jogadores e espectadores não podem alterar o progresso por esses gestos.

Reduzir uma pista completa para menos que o progresso necessário remove sua exibição para jogadores até que ela esteja completa novamente. Ocultar remove sua apresentação atual; participantes podem lembrar conteúdo já descoberto. Fechar uma janela não exclui pistas salvas. Recarregar restaura a configuração e o progresso persistidos.

Dê dois cliques no nome da pista ou foque-o e pressione Enter ou Espaço. O mestre abre o editor nativo. Jogadores e espectadores abrem uma modal simples somente de leitura, usando o Conteúdo da descoberta como descrição, sem notas do mestre. As regras atuais de descoberta e visibilidade continuam valendo ao abrir ou atualizar a modal. Pistas não recebem outro campo de descrição.

Organizar pistas fixadas

Os cards e etapas vazias têm fundo transparente. Pistas fixadas mostram somente nome e barra de progresso; use o nome para abrir o editor ou a descrição. Cada pista fixada na mesa pode ser movida independentemente ao arrastar seu título. Foque o título e use as setas para mover um pixel, ou Shift com uma seta para mover dez. Escape cancela um arraste ativo. Redimensionar o navegador mantém os indicadores na área visível.

As posições de cada conta são salvas por campanha e indicador no navegador atual e restauradas ao recarregar. Telas largas e estreitas mantêm posições separadas, restaurando cada layout quando você retorna ao tamanho anterior. Mover um indicador não envia comando de posição ou transmissão, não altera dados de campanha/cena/progresso e preserva os layouts dos demais participantes. Jogadores e espectadores podem organizar localmente suas descobertas permitidas, enquanto conteúdo e progresso continuam somente leitura. Fixação e visibilidade permanecem configurações compartilhadas do mestre; o servidor continua omitindo pistas não descobertas.

Mecanismos do MapBuilder

Use Controlar pista no Blueprint de um Objeto Inteligente para ligar uma interação do mapa a avançar, recuar, definir, reiniciar, revelar ou ocultar. Uma conexão numérica em Quantidade substitui a quantidade configurada para avançar, recuar e definir. Reiniciar, revelar e ocultar ignoram Quantidade.

Um vínculo criado pelo mestre autoriza essa operação específica quando um participante interage com o mecanismo. Ele não concede controles gerais de pistas nem expõe conteúdo desconhecido ou notas do mestre. A execução exige um mestre ativo na campanha e preserva as restrições de campanha e cena da pista.

Simular descreve a ação planejada sem alterar pistas salvas. Testar comportamento usa o motor do servidor, apresenta os valores antes e depois e reverte pistas e recibos junto com o ensaio. Durante o jogo, operações confirmadas atualizam as mesmas pistas salvas e suas exibições permitidas na mesa.

Consulte Controlar pistas no MapBuilder para conexões, limites de quantidade e a diferença entre gerar e atualizar uma cena.

Sincronização, backups e atualização

A mesa recebe alterações confirmadas pela conexão de tempo real existente. O gerenciamento atualiza sua projeção por HTTP sem entrar na mesa nem criar presença. Edições concorrentes exigem a revisão inteira atual; após um conflito, revise a pista atualizada antes de enviar outra operação. Novas tentativas da mesma operação reutilizam seu UUID de requisição para aplicar o progresso uma vez.

Exportações, snapshots, restaurações e clones da campanha preservam configuração, conteúdo, notas do mestre, progresso e escopo das pistas. Opções de clone podem omitir pistas com clues: false. Omitir cenas com scenes: false também omite pistas dessas cenas, preservando as pistas da campanha incluídas. Vínculos de Blueprint incluídos passam a apontar para as pistas copiadas; alvos omitidos ficam indisponíveis em vez de controlar a pista da campanha original.

Este recurso adiciona a migração 0004_progress_clue de gravewright_table. Aplique migrações pendentes antes de reiniciar uma instalação existente:

uv run --locked python manage.py migrate

Extensões podem usar o domínio clues da API pública. A API aplica as mesmas verificações de descoberta, privacidade, escopo e função da interface nativa.