Instalação

Esta página aborda o que o Verité precisa para funcionar, os plugins opcionais com que pode trabalhar em conjunto e o que acontece na primeira vez que arranca. Para os passos de transferência e uma breve visão geral, consulte a página inicial. O material aqui aprofunda os requisitos, as dependências e o comportamento no primeiro arranque.

Requisitos

O Verité destina-se a servidores Minecraft modernos e aos seus forks comuns.

O Verité não fornece uma compilação separada por plataforma para além da versão apropriada para o seu servidor. Instale o ficheiro correto para a sua versão de Minecraft e software de servidor, coloque-o no diretório plugins/ e reinicie.

Em qualquer versão do Minecraft fora do intervalo suportado, o Verité desativa-se no arranque e regista a versão em execução juntamente com o intervalo suportado. O Verité 1.2.8 é a última versão para o Minecraft 1.19 até 1.21.5.

Biblioteca de runtime

O Verité armazena os seus dados numa base de dados H2 incorporada. O H2 é declarado como uma biblioteca de plugin no plugin.yml:

libraries:
  - com.h2database:h2:2.4.240

O seu servidor resolve e transfere esta biblioteca automaticamente no carregamento, para um carregador de classes de biblioteca isolado. Não é necessária qualquer transferência manual. Se a biblioteca não puder ser resolvida, o Verité desativa-se em vez de funcionar sem armazenamento, por isso vigie a consola no primeiro arranque.

A base de dados funciona em modo de ficheiro incorporado, sem socket de rede. É descrita mais detalhadamente na página Privacidade e dados.

Dependências opcionais

O Verité declara quatro dependências opcionais:

softdepend: [floodgate, PlaceholderAPI, LuckPerms, Skript]

Uma dependência opcional nunca é obrigatória. Quando um destes plugins está presente, o servidor carrega-o antes do Verité para que a funcionalidade correspondente possa ativar-se. Quando está ausente, o Verité funciona normalmente e a funcionalidade simplesmente não existe.

Primeiro arranque

Na primeira vez que o Verité carrega, prepara a sua própria pasta de dados em plugins/Verite/. Durante este primeiro arranque irá:

• Criar a pasta de dados do plugin.
• Abrir a base de dados H2 incorporada (verite.mv.db) nessa pasta, criando-a se estiver ausente.
• Escrever o config.yml predefinido.
• Implantar os recursos do filtro de chat numa subpasta filter/.
• Registar comandos, ouvintes e integrações para quaisquer dependências opcionais instaladas.

Vigie a consola durante este primeiro arranque. Confirme que o Verité carrega e que não aparecem avisos ou erros que apontem para um problema de configuração ou de compatibilidade.

Saída da consola

O Verité colore as suas mensagens de consola para que as falhas se destaquem das linhas de arranque habituais. Os erros aparecem a vermelho, os sucessos a verde e as contagens na cor da marca Verité. Todas as mensagens têm o prefixo [Verité].

A cor só é adicionada quando a consola a consegue apresentar. O Verité verifica, por esta ordem:

Quando a cor está desativada, as mensagens são escritas como texto simples, sem deixar códigos de escape, para que os ficheiros de registo continuem legíveis.

Duas propriedades de sistema substituem a deteção, caso precise de forçar um resultado:

-Dverite.console.colour=false
-Dverite.console.truecolour=false

A primeira desliga (ou liga) a cor por completo. A segunda mantém a cor mas desce de 24 bits para a paleta básica de 16 cores, o que vale a pena experimentar se a sua consola mostrar caracteres estranhos em vez de cor.

Módulos

O Verité é construído a partir de três módulos, cada um alternado independentemente no config.yml. Os três estão ativados por predefinição. Desative um módulo definindo a sua flag enabled como false; o resto do plugin continua a funcionar.

chat.filter:
  enabled: true

moderation:
  enabled: true

vanish:
  enabled: true

Atualização automática da configuração

Quando o Verité atualiza, pode acrescentar novas chaves ao seu config.yml existente para que não perca as suas definições. Isto é controlado na secção general:

general:
  auto.update.config: true

Com isto ativado, as novas chaves de configuração adicionadas numa versão posterior são fundidas no seu ficheiro automaticamente. Isto não ignora as atualizações do tokenizer, que são tratadas separadamente.

Os ficheiros de recursos do filtro de chat (os ficheiros .eve) têm o seu próprio alternador, que está desativado por predefinição:

chat.filter:
  auto.update.eve: false