# Personagens

> Fichas de personagens e níveis, as relações criadas à mão, identidade de facção, mudanças por capítulo e como as aparições são realmente contadas.

Source: https://loomworld.ai/pt-br/docs/module-characters

## O que o módulo de personagens contém

O módulo de personagens é o elenco e o mapa de relações de toda a sua história. Ele reúne três elementos: um dossiê por personagem (nível, identidade, facção, arco, retrato); relações que você mesmo constrói, para que a tela mostre quem divide cenas com quem; e alterações por capítulo de idade, ocupação, facção e estado de fase, cada qual com um valor inicial evidente e o capítulo em que a mudança ocorre.

Ele não determina quem deve aparecer nem se alguém teve tempo de cena suficiente. As contagens de aparições e falas são calculadas a partir do rascunho que você escreveu, evidenciando a distribuição dos papéis. Nada emite alertas de que um personagem ficou fora de cena por tempo excessivo, e nada altera um dossiê sem a sua autorização.

## Onde abrir: tela, duas barras e barra lateral direita

Abra Personagens no menu de navegação à esquerda. Quatro áreas, cada uma com uma função:

- Tela: cartões de personagens e linhas de relações. Role para dar zoom (20%–200%), arraste para mover a visualização e solte um cartão onde preferir.
- Ilha superior: apenas ícones—Ver tudo, Reorganizar, Organizar automaticamente, Salvar layout, Linhas de coaparição.
- Console inferior esquerdo: alternador entre Relações estáticas / Recortes dinâmicos e Filtro. Em Recortes dinâmicos, botões de capítulo surgem acima do console para você analisar a rede de relações de um capítulo específico.
- Barra lateral direita: Lista de relações no topo, Lista de personagens abaixo (agrupada por facção / hierarquia / densidade de relações).

Clique duas vezes em um cartão para abrir a gaveta Editar personagem à direita. Ela não é modal: você pode continuar ajustando o zoom e movendo a tela ao lado, e a lista no extremo direito permanece visível.

## Criar uma ficha: do cartão em branco ao dossiê

- **Solte um cartão**Clique com o botão direito em uma área vazia da tela e escolha Novo personagem. O cartão aparece próximo de onde você clicou. Não há botão permanente de adição no canto.

- **Preencha o dossiê**Clique duas vezes no cartão. De cima para baixo: Nome do personagem, Retrato do personagem, Nível do personagem, Facção, Apelidos, Gênero, Idade, Ocupação / Identidade, Estado nesta fase, Arco do personagem, Notas visuais. Nome e notas são textos clicáveis para edição—sem contorno cinza até você passar o mouse.

- **Salve**O botão inferior exibe Salvar e, em seguida, Salvando. O cartão se atualiza na hora e estará disponível quando você reabrir o projeto.

Campos vazios recorrem a textos padrão: “Personagem sem nome”, “Ainda não há arcos de personagens”, “Dados de identidade não preenchidos”. A exclusão exige dois cliques: Excluir na gaveta e, em seguida, confirmar em “Excluir este personagem? Esta ação não pode ser desfeita.”. Excluir uma pessoa também remove as linhas de relações conectadas a ela.

Nada na gaveta passa a existir de fato antes de você clicar em Salvar. Fechar a gaveta ou trocar de projeto não grava automaticamente por você, e você nunca terá uma edição que parecia salva desaparecer.

## Nascido do manuscrito: a linha de fala registra um personagem

Na maioria das vezes você não cadastra os personagens antes para escrever depois—as pessoas surgem enquanto você escreve. A regra é direta: uma linha de locutor é a porta de entrada para o elenco.

- **Marque uma linha como locutor**Pressione `Tab` em uma linha e escolha o tipo de personagem. As linhas de diálogo subsequentes vinculam-se a ela.

- **Confirme o nome**Pressione Enter, desloque o cursor para outra linha ou deixe o editor perder o foco—qualquer uma dessas ações confirma o nome. O Loomworld compara o nome com o elenco: tanto o nome formal quanto os apelidos contam, desconsiderando maiúsculas e espaços laterais.

- **Correspondência vincula; ausência cria ficha**Uma correspondência apenas vincula—sem cartão duplicado. A ausência cria uma ficha na hora, classificada no nível Menor por padrão, deixando os demais campos para você preencher.

Nomes digitados pela metade nunca chegam ao elenco. Digitar “Lin” a caminho de “Lin Chong” não cria um personagem chamado Lin; apenas o momento confirmado é comparado.

A direção oposta também importa: um nome mencionado em uma linha de descrição não é um link para o dossiê. Conectar um trecho a uma pessoa pelo menu do botão direito “Conectar a…” deixa um fio condutor para o leitor; contagens de aparições, linhas de coaparição e o mapa de calor consideram apenas os capítulos em que essa pessoa fala como linha de locutor (consulte “Linhas de coaparição e contagem de aparições”). O funcionamento das referências está em [Menções a entidades e @](https://loomworld.ai/pt-br/docs/references).

## Cinco níveis e como o tamanho do cartão varia

O nível é um controle deslizante segmentado: Protagonista, Coadjuvante, Menor, De passagem, Figurante. Ele determina o tamanho do cartão e quanto conteúdo ele exibe:

- Protagonista / Coadjuvante: cartão na proporção 3:4, nome primeiro, depois “gênero · idade · ocupação” e o arco do personagem na parte inferior (limitado a poucas linhas). Sem contagem de cenas ou falas.
- Menor: mantém as duas etiquetas de contagem “N cenas / M falas” e a linha de identidade.
- De passagem: sem contagens—apenas “gênero · idade · ocupação”.
- Figurante: cartão quadrado de texto com o nome e uma etiqueta “Figurante”, com cerca de metade do tamanho do cartão de Protagonista.

O controle do nível é seu. Ao lado do controle deslizante há uma sugestão, por exemplo “Sugestão: coadjuvante; base: 12 cenas / 31 falas / 3 relações”. Ela apenas calcula o que consta no manuscrito; nunca sobrescreve o nível que você salvou. Sem dados no manuscrito, exibe “Sugestão: coadjuvante; base: sem dados do manuscrito”.

## Facções: renomear mantém a identidade

Uma facção é uma ficha do mundo, e essa ficha é a fonte única da verdade para o nome, apelidos e identidade da facção. Um personagem armazena a identidade da facção, não um texto simples: renomeie a ficha e as etiquetas em todos os personagens, os grupos do elenco, as contagens de membros, os rankings e a leitura do agente se atualizam juntos. Nada de localizar e substituir.

O campo de facção é uma caixa de busca na qual você pode digitar diretamente. Tanto o nome formal quanto os apelidos trazem resultados:

- Uma correspondência exata—pressione Enter e reutilize essa ficha.
- Nenhuma correspondência—apenas nesse caso a opção “Criar facção…” é exibida.

Optar por criar uma facção ainda é um rascunho na gaveta. A ficha e a filiação só passam a existir quando você salva o personagem. Digitar, clicar fora, cancelar ou fechar a gaveta não deixa fichas avulsas perdidas. Um personagem pode pertencer a várias facções simultaneamente; remover uma etiqueta desvincula apenas essa pessoa.

## Campos dinâmicos: quem eles são até o capítulo um

Quatro campos podem se transformar capítulo a capítulo: idade, ocupação, facção, estado nesta fase. O ativador é o seletor “Atividade” ao lado do campo; o histórico registrado recebe o nome de Evolução Dinâmica.

- **Ative a opção**O campo continua editando o valor inicial—como as coisas eram no começo—e uma trilha de capítulos aparece abaixo: “Inicial” à esquerda, um ponto para cada capítulo.

- **Clique em um ponto de capítulo**Um ponto comum indica “: Clique para adicionar um ponto de alteração”; um ponto destacado permite visualizar, editar ou excluir a alteração. As setas navegam entre os capítulos, e a trilha desliza lateralmente em projetos longos.

- **Preencha o novo valor e clique em Concluído**A janela do capítulo guarda o valor que vigora a partir daquele capítulo. Concluído edita apenas o rascunho; o botão Salvar da gaveta grava tudo de uma só vez.

As regras são claras: uma alteração se mantém até o próximo ponto de mudança; excluir um ponto faz o valor retornar à etapa anterior ou ao início; um valor idêntico ao da etapa anterior é recusado (“O novo valor coincide com a etapa anterior; nenhum ponto de alteração é necessário.”); e deixar o campo em branco não significa “nenhum”.

Dois bloqueios explicam-se por si mesmos: sem capítulos criados, surge o aviso “Crie um capítulo primeiro antes de adicionar pontos de alteração.”; para registrar explicitamente um estado vazio, utilize “Definir como nenhum”, em vez de deixar a caixa sem preenchimento.

Uma trilha sem pontos de alteração continua sendo salva, permitindo abrir o canal agora e preenchê-lo depois. Fechar uma trilha que já contém alterações informa quantas serão excluídas antes de pedir sua confirmação.

## Relações: uma linha, duas formas de descrever

Existe uma única forma de criar uma relação: clique em “Relação” em um cartão (dica Adicionar relação), a tela informa “Clique em outro cartão de personagem para estabelecer uma relação bidirecional”, clique na segunda pessoa e a gaveta Editar relação se abre. Cancelar desfaz a ação. Esse botão surge apenas no cartão selecionado ou enquanto você conecta um vínculo, mantendo a tela limpa.

Dois personagens compartilham uma única linha, e a cápsula branca sobre ela pode se expressar de duas maneiras:

- Uma palavra compartilhada: com o alternador Perspectiva dos dois lados desativado, a cápsula traz um rótulo único—amantes, pai e filho, aliados.
- Uma palavra para cada lado: ative Perspectiva dos dois lados e a cápsula se divide em duas—para traição, mal-entendido, amor não correspondido. De A para B “investigando”, de B para A “irmão”.

Os Indicadores da relação ficam ativados por padrão: um pequeno círculo em cada lado do texto, com nomes que você mesmo define (“devoção” para amantes, “confiança” e “lealdade” para um líder e seu ministro), recorrendo a “Intensidade” caso o nome fique em branco. Desativar os indicadores apenas oculta os círculos; os valores preenchidos retornam quando você os reativar. A cápsula comporta apenas o texto descritivo—materiais mais extensos pertencem a Evidências na trama: Notas da relação e à lista de Cenas em comum.

Uma linha sem texto, sem nota e sem indicadores não é desenhada, impedindo linhas vazias; limpar o formulário e salvar equivale a excluir a relação (confirmando em “Excluir esta relação? Esta ação não pode ser desfeita.”). Clique duas vezes na cápsula ou na linha para editar; um clique simples apenas seleciona.

## Linhas de coaparição e contagem de aparições

O alternador Linhas de coaparição na ilha superior (desativado por padrão) insere uma camada tracejada mais discreta sob a tela: dois personagens que dividem o palco em uma mesma cena recebem uma linha tracejada, e a cápsula no meio mostra em quantas cenas isso ocorreu. É uma pista, não uma relação formal—ela nunca entra na lista de relações e nunca inventa termos. Clique nessa cápsula e a mesma janela Editar relação se abrirá; somente após você preencher algo e salvar ela vira uma relação manual. As linhas de coaparição ficam sempre abaixo das linhas manuais, sobre as quais esse alternador não interfere.

As contagens se baseiam no rascunho, mas consideram aparições apenas como locutor: as etiquetas “N cenas / M falas” no cartão Menor, os mesmos números na lista abaixo e as contagens de coaparição medem cenas em que essa pessoa fala, além das linhas de diálogo decorrentes. Portanto, “eles nitidamente estavam nesta cena, mas a contagem está 0” não é um erro—o personagem simplesmente não falou nela.

A Lista de relações contém somente as relações que você criou: uma linha por par, “pessoa —texto— pessoa”, com os dois círculos de indicadores; antes de haver relações, ela exibe “Ainda não há relações”. A Lista de personagens organiza por facção / hierarquia / densidade de relações: a visão por facção agrupa personagens não filiados em “Sem grupo” e exibe um personagem com múltiplas facções em cada um de seus grupos; a visão por relações classifica as pessoas em Alta densidade, Média densidade, Baixa densidade e Nenhuma pela quantidade de relações que possuem. A lista sempre exibe todos os personagens—filtros de tela nunca ocultam ninguém dela.

## Deixe o agente organizar os dossiês

Diga coisas como “adicione uma testemunha a esta cena”, “mude o disfarce dela para oficial reformado da cavalaria”, “este figurante é peso morto, exclua-o”. O agente analisa o elenco e o rascunho primeiro e devolve um cartão de confirmação—é você quem decide a aplicação final. Nesse cartão ele pode:

- Criar um personagem: um nome no mínimo, além dos demais campos caso existam.
- Alterar campos: nome, apelidos, gênero, idade, ocupação/identidade, arco do personagem, notas visuais, estado nesta fase, nível, facção.
- Excluir um personagem: o cartão discrimina tudo o que a exclusão afeta (aparições, linhas de relações e afins) antes da sua confirmação.
- Criar uma relação: quais são as duas pessoas, uma palavra compartilhada ou duas direcionadas, mais uma nota opcional.

As facções recebem cuidado redobrado: o cartão detalha tanto “estas fichas de facção serão criadas” quanto “este personagem passará a pertencer a…”. Se um nome for ambíguo ou uma ficha tiver mudado nesse intervalo, o cartão é rejeitado por inteiro em vez de esvaziar silenciosamente a lista de membros.

Um único cartão comporta até 8 operações e as aplica em uma confirmação conjunta; após confirmar, o cartão inteiro entra na pilha de desfazer do projeto, de modo que um único comando desfaz tudo. Duas coisas nunca vêm por proposta: o retrato, que você mesmo envia ou gera em “✦ Gerar imagem”, e os pontos de alteração de capítulos, que continuam exclusivamente sob seu controle. O escopo e o mecanismo de confirmação são tratados em [Visão geral da colaboração com IA](https://loomworld.ai/pt-br/docs/ai-overview) e [Vínculos entre módulos](https://loomworld.ai/pt-br/docs/cross-sync).

## Limites e solução de problemas

- Layout: um cartão arrastado fica onde você o soltar—nada o puxa de volta. Reorganizar posiciona apenas os cartões que nunca foram alinhados; Organizar automaticamente desconsidera o layout atual e reorganiza tudo, sobrescrevendo o posicionamento manual. Salvar layout preserva a sua organização.
- Retrato: passe o mouse sobre a área da imagem no cartão ou na gaveta e clique no ícone da câmera para enviar ou substituir. Sem retrato, o cartão assume um tom sutil derivado do seu nível. Um arquivo com falha informa “Não foi possível processar o retrato”; “✦ Gerar imagem” requer login na conta, prepara o prompt primeiro (“Preparando o prompt…”), permite editá-lo e oferece Usar ou Gerar de novo.
- Menos cartões do que o esperado: o painel de Filtro abre a partir do console e permite ocultar níveis, filtrar por facção ou “Ocultar figurantes e personagens de passagem” com um clique. Os filtros alteram apenas a exibição na tela, nunca os dossiês.
- Contagens travadas em zero: confirme se o personagem consta como locutor naquela cena. Um nome apenas mencionado em uma linha de descrição não conta como aparição.

A integração entre os módulos está detalhada em [Visão geral dos módulos de referência](https://loomworld.ai/pt-br/docs/modules-overview).
