Estrutura de Diálogo - Histórico de revisão

Rodrigogml: /* Resumo de Regras Importantes */

2025-04-06T17:34:17Z

Resumo de Regras Importantes

← Edição anterior		Edição das 17h34min de 6 de abril de 2025
Linha 233:		Linha 233:
	* O campo <code>estilo</code> é opcional e só deve ser usado quando a intenção do tom for relevante.		* O campo <code>estilo</code> é opcional e só deve ser usado quando a intenção do tom for relevante.
	* Todas as IDs devem ser únicas dentro do mesmo diálogo.		* Todas as IDs devem ser únicas dentro do mesmo diálogo.
			* Não deixe linhas em branco dentro dos blocos <code>Fala</code>.

	= Condições de Ativação de Diálogo =		= Condições de Ativação de Diálogo =

Rodrigogml: /* Exemplo Completo */

2025-04-06T17:33:45Z

Exemplo Completo

← Edição anterior		Edição das 17h33min de 6 de abril de 2025
Linha 177:		Linha 177:
	\|resposta=Sou aquele que cuida das passagens. Mas só revela o caminho quem está pronto para vê-lo.		\|resposta=Sou aquele que cuida das passagens. Mas só revela o caminho quem está pronto para vê-lo.
	\|subfalas=		\|subfalas=

	{{Fala		{{Fala
	\|id=2		\|id=2
Linha 183:		Linha 182:
	\|resposta=Essa é uma interpretação possível. Mas há quem me veja como guia, outros como obstáculo.		\|resposta=Essa é uma interpretação possível. Mas há quem me veja como guia, outros como obstáculo.
	\|subfalas=		\|subfalas=

	{{Fala		{{Fala
	\|id=3		\|id=3
Linha 189:		Linha 187:
	\|resposta=Prefiro ser aquele que respeita a escolha de quem passa.		\|resposta=Prefiro ser aquele que respeita a escolha de quem passa.
	}}		}}

	{{Fala		{{Fala
	\|id=4		\|id=4
Linha 197:		Linha 194:
	}}		}}
	}}		}}

	{{Fala		{{Fala
	\|id=5		\|id=5
Linha 208:		Linha 204:
	\|falha_comandos=[Inserir Marcador; TENTOU_PASSAGEM]		\|falha_comandos=[Inserir Marcador; TENTOU_PASSAGEM]
	\|sucesso_subfalas=		\|sucesso_subfalas=

	{{Fala		{{Fala
	\|id=6		\|id=6
Linha 215:		Linha 210:
	\|valor=Honra		\|valor=Honra
	}}		}}

	\|falha_subfalas=		\|falha_subfalas=

	{{Fala		{{Fala
	\|id=7		\|id=7
Linha 223:		Linha 216:
	\|resposta=Testes são reflexos. Não são meus, são seus. Tente de novo quando souber o que busca.		\|resposta=Testes são reflexos. Não são meus, são seus. Tente de novo quando souber o que busca.
	}}		}}

	{{Fala		{{Fala
	\|id=8		\|id=8

Rodrigogml: /* Documentação do Diálogo */

2025-04-06T17:32:36Z

Documentação do Diálogo

Mostrar alterações

Rodrigogml: /* Condições Obrigatórias */

2025-04-06T17:15:53Z

Condições Obrigatórias

← Edição anterior		Edição das 17h15min de 6 de abril de 2025
Linha 275:		Linha 275:


	== Condições ~~Obrigatórias~~ ==		== Condições Automáticas ==

	~~Além das expressões booleanas livres definidas pelo autor do diálogo, existem algumas~~ condições ~~que~~ devem ser ~~obrigatoriamente verificadas em qualquer bloco de~~ diálogo~~, garantindo coerência narrativa e integridade lógica do jogo~~.		Algumas condições já são consideradas por padrão em todos os diálogos e não devem ser escritas na condição do diálogo. São elas:
			* Todo diálogo só será exibido para o jogador se ele ainda não tiver acontecido. Para isso o sistema verifica automaticamente se ele '''não tem o 'Marco do Diálogo'''';
	~~=== NPC deve estar ouvindo ===~~		* Todo diálogo só é exibido quando o jogador está próximo ou em conversa com o NPC presente na ficha do diálogo, assim não é necessário condiconar se o NPC está ouvindo ou presente.

	Todo diálogo ~~é iniciado com um personagem não-jogador (NPC) e, portanto,~~ só ~~deve estar disponível se o NPC estiver presente no ambiente e em posição de ouvir~~ o jogador. Para isso~~, toda condição de ativação de diálogo deve conter a verificação:~~

	~~<pre>~~
	~~isNPCListening("NOME_DO_NPC")~~
	~~</pre>~~

	~~Substitua~~ '''~~NOME_DO_NPC~~''' ~~pelo nome do personagem correspondente. Essa função garante que~~ o ~~NPC esteja fisicamente presente no ambiente e que esteja atento ao~~ jogador ~~— excluindo situações~~ em ~~que~~ o NPC ~~esteja morto, inconsciente, ausente ou em fuga.~~

	~~'''Exemplo válido de condição de~~ diálogo~~:'''~~
	~~<pre>~~
	~~@condição: isNPCListening("Lenhador") && hasMilestone("OUVIU_SOBRE_FANTASMAS")~~
	~~</pre>~~

	~~A ausência dessa verificação pode causar situações incoerentes~~, ~~como diálogos sendo ativados com personagens que~~ não ~~estão disponíveis,~~ o ~~que pode quebrar a imersão~~ ou ~~gerar erros lógicos no jogo.~~

	~~Outras condições obrigatórias poderão ser adicionadas conforme a evolução das mecânicas de narrativa ou do sistema de ambientação~~.

	= Exemplos =		= Exemplos =

Rodrigogml: /* Composição do Bloco */

2025-04-06T16:36:46Z

Composição do Bloco

← Edição anterior		Edição das 16h36min de 6 de abril de 2025
Linha 158:		Linha 158:
	Além dos campos de controle do fluxo do diálogo, a predefinição também pode conter:		Além dos campos de controle do fluxo do diálogo, a predefinição também pode conter:
	* <code>id</code>: Identificador único da fala, deve se úncio por diálogo. Sua função é estritamente ajudar a identificar o bloco de fala durante sua criação, nao tem efeito na mecânica do jogo.		* <code>id</code>: Identificador único da fala, deve se úncio por diálogo. Sua função é estritamente ajudar a identificar o bloco de fala durante sua criação, nao tem efeito na mecânica do jogo.
	* <code>estilo</code>: Estilo de fala do jogador (Conforme definido na tabela [[Estilos_de_Fala_e_Valoração#Tabela_de_Estilos\|Tabela de Estilos de Fala]]). Opcional. Quando não ~~preenchido e assumido o~~ estilo 'neutro'.		* <code>estilo</code>: Estilo de fala do jogador (Conforme definido na tabela [[Estilos_de_Fala_e_Valoração#Tabela_de_Estilos\|Tabela de Estilos de Fala]]). Opcional. Normalmente não é definido. Só dee ser definido quando se deseja adicionar um tom especial de fala. Quando não definido é considerao um estilo 'neutro'.
	* <code>valor</code>: Valor moral ou princípio transmitido pela fala. Opcional. O valor só deve ser ~~preenchido~~ quando a frase tem um sentido que ~~demostre o~~ valor de caráter compatível com as definições da [[Estilos_de_Fala_e_Valoração#Tabela_de_Valoração\|Tabela de Valoração]].		* <code>valor</code>: Valor moral ou princípio transmitido pela fala. Opcional. O valor quase nunca é definido, só deve ser definido quando a frase tem um sentido que demostra um alto valor de caráter. O valor deve ser compatível com as definições da [[Estilos_de_Fala_e_Valoração#Tabela_de_Valoração\|Tabela de Valoração]].
	* <code>subfalas</code>: Bloco de falas-filhas que seguem a linha principal. Opcional.		* <code>subfalas</code>: Bloco de falas-filhas que seguem a linha principal. Opcional.
	* <code>sucesso_subfalas</code> e <code>falha_subfalas</code>: Blocos de falas-filhas condicionadas ao resultado do teste.		* <code>sucesso_subfalas</code> e <code>falha_subfalas</code>: Blocos de falas-filhas condicionadas ao resultado do teste.

Rodrigogml: /* Documentação do Diálogo */

2025-04-06T13:32:59Z

Documentação do Diálogo

← Edição anterior		Edição das 13h32min de 6 de abril de 2025
Linha 115:		Linha 115:
	Esses comandos são processados automaticamente após a fala correspondente. Em falas com testes, os comandos são separados para os casos de '''sucesso''' e '''falha''', permitindo efeitos distintos dependendo do resultado.		Esses comandos são processados automaticamente após a fala correspondente. Em falas com testes, os comandos são separados para os casos de '''sucesso''' e '''falha''', permitindo efeitos distintos dependendo do resultado.



			= Criação do Diálogo =
			Para criar um diálogo:
			* comece completando o [[Modelo de Ficha de Diálogo]], ela dará os primeiros passos de como o diálogo será e objetivos que precisam ser atingidos;
			* crie a condição
			* após a ficha criada, defina uma ou mais trilhas que atingem tantos os objetivos principais, quando os objetivos secundários, com todos os testes necessários;
			* crie trilhas adicionais para melhor imersão, com mais desafios, testes e modificações de relacionamento com o NPC, falas com valores, etc..
			* adicione trilhas em que os objetivos secundários não são atingidos.
			* valide se todas as trilhas tem o objetivo principal completo, se os caminhos de falas são coerentes e se não há uma grande variação dentro de cada trilha do humor.

Rodrigogml: /* Composição do Bloco */

2025-04-05T22:08:09Z

Composição do Bloco

← Edição anterior		Edição das 22h08min de 5 de abril de 2025
Linha 148:		Linha 148:
	Além dos campos de controle do fluxo do diálogo, a predefinição também pode conter:		Além dos campos de controle do fluxo do diálogo, a predefinição também pode conter:
	* <code>id</code>: Identificador único da fala, deve se úncio por diálogo. Sua função é estritamente ajudar a identificar o bloco de fala durante sua criação, nao tem efeito na mecânica do jogo.		* <code>id</code>: Identificador único da fala, deve se úncio por diálogo. Sua função é estritamente ajudar a identificar o bloco de fala durante sua criação, nao tem efeito na mecânica do jogo.
	* <code>estilo</code>: Estilo de fala do jogador (~~ex: Direto, Persuasivo~~). Opcional. Quando não preenchido e assumido o estilo 'neutro'.		* <code>estilo</code>: Estilo de fala do jogador (Conforme definido na tabela [[Estilos_de_Fala_e_Valoração#Tabela_de_Estilos\|Tabela de Estilos de Fala]]). Opcional. Quando não preenchido e assumido o estilo 'neutro'.
	* <code>valor</code>: Valor moral ou princípio transmitido pela fala. Opcional.		* <code>valor</code>: Valor moral ou princípio transmitido pela fala. Opcional. O valor só deve ser preenchido quando a frase tem um sentido que demostre o valor de caráter compatível com as definições da [[Estilos_de_Fala_e_Valoração#Tabela_de_Valoração\|Tabela de Valoração]].
	* <code>subfalas</code>: Bloco de falas-filhas que seguem a linha principal. Opcional.		* <code>subfalas</code>: Bloco de falas-filhas que seguem a linha principal. Opcional.
	* <code>sucesso_subfalas</code> e <code>falha_subfalas</code>: Blocos de falas-filhas condicionadas ao resultado do teste.		* <code>sucesso_subfalas</code> e <code>falha_subfalas</code>: Blocos de falas-filhas condicionadas ao resultado do teste.

Rodrigogml: /* Estilos de Fala */

2025-04-05T22:06:21Z

Estilos de Fala

← Edição anterior		Edição das 22h06min de 5 de abril de 2025
Linha 52:		Linha 52:
	Estilos não são apenas variações cosméticas, mas afetam a mecânica do diálogo, desbloqueiam respostas diferentes, e podem alterar o relacionamento com personagens.		Estilos não são apenas variações cosméticas, mas afetam a mecânica do diálogo, desbloqueiam respostas diferentes, e podem alterar o relacionamento com personagens.

	Para uma descrição completa dos estilos disponíveis, suas implicações mecânicas e exemplos práticos, consulte a página:		Para uma descrição completa dos estilos disponíveis, suas implicações mecânicas e exemplos práticos, consulte a página [[Estilos_de_Fala_e_Valoração\|Estilos de Fala e Valoração]].
	~~<pre>~~[[Estilos_de_Fala_e_Valoração\|Estilos de Fala e Valoração]]~~</pre>~~

	== Testes de Fala ==		== Testes de Fala ==

Rodrigogml: /* Estilos de Fala */

2025-04-05T18:09:59Z

Estilos de Fala

@@ Linha 47: / Linha 47: @@
 == Estilos de Fala ==
-O estilo '''neutro''' é considerado padrão e não precisa ser explicitado, a menos que haja múltiplas variações estilizadas para a mesma fala.
+Os '''estilos de fala''' representam a abordagem escolhida pelo jogador ao interagir com um NPC — podendo ser direta, persuasiva, agressiva, mentirosa, entre outras. Eles influenciam o tom da fala, o comportamento do NPC, e determinam o tipo de teste aplicado (quando houver).
 == Testes de Fala ==

Rodrigogml: /* Composição do Bloco */

2025-04-05T17:48:21Z

Composição do Bloco

← Edição anterior		Edição das 17h48min de 5 de abril de 2025
Linha 169:		Linha 169:
	:* Os seguintes campos são '''proibidos''':		:* Os seguintes campos são '''proibidos''':
	::* <code>resposta</code>: Não pode ser utilizado, pois a resposta varia com o resultado do teste.		::* <code>resposta</code>: Não pode ser utilizado, pois a resposta varia com o resultado do teste.
	::* ~~<code>comandos</code>: Não pode ser usado diretamente —~~ comandos devem ser definidos separadamente para sucesso e falha, nos campos <code>sucesso_comandos</code> e <code>falha_comandos</code>.		:* Os comandos devem ser definidos separadamente para sucesso e falha, nos campos <code>sucesso_comandos</code> e <code>falha_comandos</code>. Mas são opcionais.

	* Quando o campo <code>teste</code> '''não está presente''', entende-se que a fala não exige rolagem, e o comportamento será fixo. Nesse caso:		* Quando o campo <code>teste</code> '''não está presente''', entende-se que a fala não exige rolagem, e o comportamento será fixo. Nesse caso:
	:* Os seguintes campos são '''obrigatórios''':		:* Os seguintes campos são '''obrigatórios''':
	::* <code>resposta</code>: Resposta padrão do NPC à fala do jogador.		::* <code>resposta</code>: Resposta padrão do NPC à fala do jogador.
	::* <code>comandos</code>: Lista de ações executadas imediatamente após a fala. Cada comando deve ter seu comando e argumentos separados por ';' e escrito entre colchetes. Quando houver mais de um comando eles devem ser separados por vírgulas: `[Comando; Arg1], [OutroComando; Arg2]`.
	:* Os seguintes campos são '''proibidos''':		:* Os seguintes campos são '''proibidos''':
	::* <code>teste</code>, <code>dificuldade</code>, <code>sucesso_resposta</code>, <code>falha_resposta</code>, <code>sucesso_comandos</code>, <code>falha_comandos</code>: nenhum deles deve estar presente.		::* <code>teste</code>, <code>dificuldade</code>, <code>sucesso_resposta</code>, <code>falha_resposta</code>, <code>sucesso_comandos</code>, <code>falha_comandos</code>: nenhum deles deve estar presente.
			:* Os comandos devem ser escritos no atributo <code>comandos</code>, mas é opcional.


			{{nota\|Se houver comandos, eles devem ser definidos no campo <code>comandos</code> e separados por vírgulas: [Comando; Arg1], [OutroComando; Arg2].}}


Linha 185:		Linha 188:
	* <code>subfalas</code>: Bloco de falas-filhas que seguem a linha principal. Opcional.		* <code>subfalas</code>: Bloco de falas-filhas que seguem a linha principal. Opcional.
	* <code>sucesso_subfalas</code> e <code>falha_subfalas</code>: Blocos de falas-filhas condicionadas ao resultado do teste.		* <code>sucesso_subfalas</code> e <code>falha_subfalas</code>: Blocos de falas-filhas condicionadas ao resultado do teste.


	== Regras de Formatação ==		== Regras de Formatação ==