Sistema de Marcadores - Histórico de revisão

Rodrigogml: /* Prefixos recomendados */

2025-04-06T17:41:48Z

Prefixos recomendados

← Edição anterior		Edição das 17h41min de 6 de abril de 2025
Linha 36:		Linha 36:
	A nomenclatura dos marcadores deve seguir o formato '''UPPER_SNAKE_CASE''', com nomes descritivos e claros. A padronização facilita sua busca e interpretação durante o design e integração.		A nomenclatura dos marcadores deve seguir o formato '''UPPER_SNAKE_CASE''', com nomes descritivos e claros. A padronização facilita sua busca e interpretação durante o design e integração.

	=== Prefixos ~~recomendados~~ ===		=== Prefixos de Marcadores ===
	* '''SABE_SOBRE_*''': Conhecimentos aprendidos.		Marcadores são utilizados para registrar acontecimentos, descobertas, relações ou estados no progresso do jogador. Para facilitar a organização, manutenção e leitura dos eventos, todos os marcadores seguem uma estrutura com '''prefixos padronizados'''. Esses prefixos indicam o tipo e contexto do marcador.
	* '''VIU_*''': Locais ou eventos ~~vistos.~~
	* '''PEGOU_*''': Itens coletados ou acionados.
	* '''TESTE__SUCESSO / TESTE__FALHA''': Resultado de testes.
	* '''CONCLUIU_*''': Marcos de missão ou narrativa.
	* '''~~DIALOGO_*_ENCERRADO~~'''~~: Fim de interações únicas~~.
	* '''CONQUISTOU_*''': Desbloqueio de conquistas ou badges.

	~~Exemplos:~~
	* ~~`SABE_SOBRE_ORIGEM_DOS_DRACOS`~~		== Prefixos Utilizados ==
	* ~~`VIU_ENTRADA_SECRETA_TORRE_SUL`~~		* '''CONHECE_''' - Prefixo utilizado para indicar que o jogador '''conheceu ou foi apresentado a um personagem, criatura ou entidade específica'''.
	* `TESTE_PERSUASAO_SUCESSO_GUARDA`		:* Exemplo: <code>CONHECE_ELVARINDOSILENCIO</code> — o jogador conheceu Elvarin do Silêncio.
	* ~~`CONCLUIU_MISSAO_LUZ_DO_PANTANO`~~
	* ~~`CONQUISTOU_DOMINIO_DO_MEDO`~~		* '''SABESOBRE_''' - Prefixo utilizado quando o jogador '''descobre, toma ciência ou aprende sobre uma organização, evento, local ou informação relevante'''.
			:* Exemplo: <code>SABESOBRE_ORDEMDOSCAMINHANTESSILENCIOSOS</code> — o jogador agora sabe da existência e natureza da Ordem dos Caminhantes Silenciosos.

	== Registro de Marcadores ==		== Registro de Marcadores ==

Rodrigogml em 18h06min de 5 de abril de 2025

2025-04-05T18:06:59Z

Mostrar alterações

Rodrigogml em 18h04min de 5 de abril de 2025

2025-04-05T18:04:30Z

Mostrar alterações

Rodrigogml: /* Utilização dos Marcadores */

2025-03-30T20:15:17Z

Utilização dos Marcadores

← Edição anterior		Edição das 20h15min de 30 de março de 2025
Linha 41:		Linha 41:
	* Mudança no comportamento ou respostas de NPCs.		* Mudança no comportamento ou respostas de NPCs.
	* Alteração de eventos, armadilhas, encontros e feitiços.		* Alteração de eventos, armadilhas, encontros e feitiços.
	* Gatilhos para entrada automática no [[Diário]] ~~do jogador~~.		* Gatilhos para entrada automática no [[Diário do Jogador]].

	= Registro de Marcadores =		= Registro de Marcadores =

Rodrigogml: Criou página com 'O sistema de '''marcadores''' da engine '''PlayTale''' é um mecanismo fundamental para controlar o progresso narrativo, condições de eventos e desbloqueio de conteúdo dinâmico no jogo. Cada marcador representa um marco individual da jornada do jogador — seja uma descoberta, uma ação realizada, um teste superado (ou falhado) ou uma conversa encerrada. = Conceito de Marcador = Um marcador é um símbolo de que um evento ou conhecimento foi obtido. Não possui va...'

2025-03-30T20:12:25Z

Criou página com 'O sistema de '''marcadores''' da engine '''PlayTale''' é um mecanismo fundamental para controlar o progresso narrativo, condições de eventos e desbloqueio de conteúdo dinâmico no jogo. Cada marcador representa um marco individual da jornada do jogador — seja uma descoberta, uma ação realizada, um teste superado (ou falhado) ou uma conversa encerrada. = Conceito de Marcador = Um marcador é um símbolo de que um evento ou conhecimento foi obtido. Não possui va...'

Página nova

O sistema de '''marcadores''' da engine '''PlayTale''' é um mecanismo fundamental para controlar o progresso narrativo, condições de eventos e desbloqueio de conteúdo dinâmico no jogo. Cada marcador representa um marco individual da jornada do jogador — seja uma descoberta, uma ação realizada, um teste superado (ou falhado) ou uma conversa encerrada.

= Conceito de Marcador =

Um marcador é um símbolo de que um evento ou conhecimento foi obtido. Não possui valor numérico, apenas presença ou ausência. Ou seja, um marcador está:
* '''Presente''': o jogador já obteve essa informação, realizou essa ação ou venceu esse teste.
* '''Não presente''': o jogador ainda não passou por esse evento ou não teve sucesso.

Os marcadores são armazenados diretamente na ficha do jogador e utilizados para verificar condições de desbloqueio em eventos, diálogos, itens, áreas, comportamentos de NPCs, entre outros.

= Nomeação de Marcadores =

Os marcadores devem seguir uma nomenclatura padronizada no formato '''UPPER_SNAKE_CASE''', facilitando leitura, categorização e busca. Recomenda-se sempre utilizar prefixos que identifiquem claramente o tipo de evento registrado. A seguir, os principais padrões:

== Prefixos Recomendados ==
* '''SABE_SOBRE_*''': conhecimento adquirido pelo jogador (história, rumor, teoria, artefato).
* '''VIU_*''': localidade, criatura ou evento visualizado diretamente pelo jogador.
* '''PEGOU_*''': item ou objeto importante que foi coletado.
* '''TESTE_*_SUCESSO''': o jogador passou em um teste relacionado (atributos, perícia, interação).
* '''TESTE_*_FALHA''': o jogador falhou no teste.
* '''DIALOGO_*_ENCERRADO''': marca que uma conversa já ocorreu e não deve ser repetida.

== Composição Recomendada ==

Marcadores devem ser compostos de forma clara e significativa. Recomenda-se usar sempre o formato:

<pre>[PREFIXO]_[DESCRIÇÃO_CLARA]</pre>

Exemplos:
* '''SABE_SOBRE_ORIGEM_DOS_DRACOS'''
* '''VIU_ENTRADA_SECRETA_TORRE_SUL'''
* '''PEGOU_CHAVE_CRISTALINA'''
* '''TESTE_INTIMIDACAO_SUCESSO_GUARDA_PORTAO'''
* '''DIALOGO_FALA_INICIAL_MERCADOR_ENCERRADO'''

= Utilização dos Marcadores =

Os marcadores podem ser utilizados para condicionar qualquer elemento interativo da engine, como:
* Desbloqueio ou ocultação de blocos de diálogo.
* Permissão de entrada em zonas ou ambientes.
* Mudança no comportamento ou respostas de NPCs.
* Alteração de eventos, armadilhas, encontros e feitiços.
* Gatilhos para entrada automática no [[Diário]] do jogador.

= Registro de Marcadores =

* Marcadores são adicionados automaticamente à ficha do jogador ao ocorrerem os eventos que os definem.
* Uma vez presente, um marcador nunca é removido (exceto por efeito narrativo ou mágico específico).
* Sistemas podem consultar diretamente a ficha para checar a presença ou ausência de um marcador.

= Boas Práticas =

* Nomeie os marcadores de forma descritiva e objetiva — evite nomes genéricos ou ambíguos.
* Prefira granularidade: crie marcadores específicos para cada ponto de progresso relevante.
* Evite reutilizar o mesmo marcador em contextos diferentes.
* Documente marcadores importantes com descrição de onde e como são ativados.

{{nota|O uso correto dos marcadores é essencial para garantir uma experiência fluida, coerente e reativa no mundo interativo. Eles são a base do dinamismo da engine PlayTale e devem ser pensados como peças de construção da narrativa viva do jogo.}}