Formatos de Chat com Essentials Chat

A formatação de chat permite controlar como o chat aparece quando alguém fala no jogo. Isso é tipicamente usado para definir nomes de grupos e alterar o formato para destacar jogadores ou grupos.

A formatação de chat no Paper consiste em duas partes: o apelido ou nome de exibição do usuário e as mensagens de chat. O EssentialsX, em combinação com seu plugin

EssentialsX Chat e gerenciadores de permissão como LuckPerms, permite modificar ambos.

Para evitar conflitos com outros plugins, o EssentialsX desabilitará a maioria de seus formatos de chat se você não instalar o componente [EssentialsChat] com [Essentials]. Você pode habilitar a formatação de nome de exibição sem o EssentialsChat editando o arquivo de configuração, no entanto.

Onde encontrar a configuração

A configuração de formatação de chat é encontrada no arquivo de configuração do Essentials.

Você pode acessar este arquivo indo na aba "Arquivos de Configuração" no painel de controle do seu servidor.

Você também pode chegar ao arquivo correto seguindo estes passos:

1. Vá ao Acesso FTP de Arquivos e faça login com a senha do seu Painel de Controle.

2. Clique na pasta "Plugins".

3. Encontre e clique na pasta EssentialsX, e procure o arquivo config.yml.

4. A configuração está localizada na parte inferior do arquivo.

Existem duas maneiras de definir a formatação do chat, você pode definir um estilo de formato que se aplica a todos os grupos, ou pode dar um formato especial para cada grupo.

Exemplos de Formato

Abaixo estão exemplos de configuração de formato como vistos em plugins/essentials/config.yml. Aqui está a seção que você precisará configurar para formatar o chat no jogo.

```yaml

# +------------------------------------------------------+ #

# | EssentialsChat | #

# +------------------------------------------------------+ #

# This section requires EssentialsChat.jar to work.

chat:

radius: 0

format: '&9{DISPLAYNAME}: &7{MESSAGE}'

# format: '&7[{GROUP}]&r {DISPLAYNAME}&7:&r {MESSAGE}'

group-formats:

# Default: '{WORLDNAME} {DISPLAYNAME}&7:&r {MESSAGE}'

# Admins: '{WORLDNAME} &c[{GROUP}]&r {DISPLAYNAME}&7:&c {MESSAGE}'

```

Existem infinitas combinações diferentes para essas configurações baseadas nas suas preferências pessoais. Mostraremos alguns exemplos de formato para que você possa experimentar e configurar o chat ao seu gosto.

Definindo o formato padrão

A seguinte linha mostra como definimos o formato de chat padrão para todos os usuários e grupos.

```yaml

format: '&9{DISPLAYNAME}: &7{MESSAGE}'

```

Agora você pode ver nosso valor após `format:` entre aspas, por exemplo, "'{WORLDNAME}...'", note que qualquer edição deve ser feita dentro dessas aspas, caso contrário você pode quebrar a formatação do chat.

Agora, no valor, você pode ver duas tags básicas: {DISPLAYNAME} e {MESSAGE}. Mais tags podem ser adicionadas, como o grupo ao qual um jogador pertence. Você pode encontrar uma lista de tags adicionais no wiki do Essentials.

Vamos limpar o valor padrão removendo os colchetes angulares esquerdo e direito.

```yaml

format: '{DISPLAYNAME}: {MESSAGE}'

```

Agora devemos definir um padrão para distinguir facilmente os nomes de exibição dos usuários, junto com quaisquer tags adicionais que queiramos adicionar depois. Podemos fazer isso criando uma barreira simples usando dois pontos

": " para separá-los.

```yaml

format: '{DISPLAYNAME}: {MESSAGE}'

```

Adicionando cor ao chat

Agora devemos definir alguma cor para distinguir ainda mais a separação e adicionar apelo estético. Você pode encontrar uma lista de todos os códigos de cor disponíveis no wiki do Essentials, ou executando o comando /kit color enquanto joga no servidor.

Para adicionar cor ou outra formatação, como texto em negrito ou itálico, simplesmente digite o código de formato antes do seu texto. Por exemplo, se você quisesse usar texto azul claro no chat ou no seu formato, colocaria '&9' antes do texto. Códigos de formato podem ser combinados, então você pode usar tanto '&9' quanto '&l' antes do seu texto para torná-lo negrito e azul claro.

```yaml

format: '&9{DISPLAYNAME}: &7{MESSAGE}'

```

Pronto, agora salve suas alterações e reinicie o servidor para que entrem em vigor.

Definindo o formato por grupo

Além de definir um formato padrão para todos os usuários e grupos, também podemos definir o formato para grupos individuais. A seguinte linha mostra um exemplo para os grupos Default e Admin. A lista é sensível a maiúsculas e deve corresponder exatamente ao nome do grupo retornado pelo seu plugin de permissões. Recomendamos usar o LuckPerms, pois é muito fácil de usar e aprender. Para adicionar um novo grupo, simplesmente crie uma nova linha dentro de 'group-formats:' e liste o novo grupo. No nosso exemplo, vamos adicionar um grupo 'Streamer'.

```yaml

group-formats:

# Default: '{WORLDNAME} {DISPLAYNAME}&7:&r {MESSAGE}'

# Admins: '{WORLDNAME} &c[{GROUP}]&r {DISPLAYNAME}&7:&c {MESSAGE}'

# Streamer: ''

```

Agora precisamos ativá-los removendo o "#" do início da linha.

```yaml

group-formats:

Default: '&e{GROUP} &8{DISPLAYNAME}: &7{MESSAGE}'

Admins: '&c{GROUP} &8{DISPLAYNAME}: &7{MESSAGE}'

Streamer: ''

```

Agora podemos formatá-los de maneira semelhante a como formatamos o chat padrão.

```yaml

group-formats:

Default: '&e{GROUP} &8{DISPLAYNAME}: &7{MESSAGE}'

Admins: '&c{GROUP} &8{DISPLAYNAME}: &7{MESSAGE}'

Streamer: '&3{GROUP} &8{DISPLAYNAME}: &7{MESSAGE}'

```

Pronto, agora salve as alterações e reinicie o servidor para que entrem em vigor. Note que se você tiver um formato de grupo em vigor, ele terá prioridade sobre o formato de chat padrão.

Problemas Comuns

1. Recebo o formato de chat genérico no jogo após a configuração:

Isso sugere um erro de sintaxe no formato. Revise o arquivo de configuração e execute-o através de um analisador YAML.

2. Recebo um erro interno ao usar códigos de cor no jogo:

Isso geralmente significa que o arquivo de configuração não pode mais ser lido pelo plugin. A maneira mais rápida e fácil de corrigir isso é excluir o arquivo de configuração e reiniciar o servidor. Um novo será gerado após o servidor terminar de carregar.

3. Adicionando tags de outros plugins como Factions:

O plugin que você deseja adicionar deve fornecer as tags que você precisa usar ao formatar o chat. Se estiver tendo dificuldade em encontrá-las, entre em contato com o autor do plugin ou um agente do LiveChat para ajuda adicional.