Visão geral

Aguardando aprovação v1.0

Plataformas

Paper, Purpur, Folia

Minecraft

1.21.11 ou 26.2

Java

21

Obrigatório

Nenhum

Opcional

PlaceholderAPI, MariaDB or MySQL

O VelorJourney guia os jogadores novos pelo seu servidor e mostra quantos deles voltam. É um sistema independente de integração e retenção: toda integração é opcional.

Requisitos: Java 21 e um servidor Paper, Purpur ou Folia com Minecraft 1.21.11 ou 26.2. PlaceholderAPI e um servidor MariaDB ou MySQL são opcionais.

Primeira inicialização #

1. Coloque o jar do VelorJourney na pasta plugins do servidor.
2. Inicie o servidor uma vez.
3. Edite plugins/VelorJourney/config.yml, os arquivos de idioma e os arquivos de journeys/.
4. Execute /journey validate para verificar suas edições e depois /journey reload para aplicá-las.
5. Execute /journey doctor para verificar o armazenamento.

/journey validate lê os arquivos do disco exatamente como uma recarga faria e informa o arquivo e o problema quando algo está errado. Ele não altera nada. /journey reload é tudo ou nada: se algum arquivo for inválido, ele é recusado e a configuração em execução continua em serviço.

Os títulos, os textos e os materiais dos ícones da GUI são configuráveis. O painel usa um fundo consistente, lore explicativo, taxas de conclusão e estados explícitos de "sem dados", em vez de expor chaves internas de mensagens.

Armazenamento #

O SQLite fica pronto sem configuração e é o padrão. Para compartilhar dados entre servidores, defina storage.type: MYSQL e preencha a seção storage.mysql. Funciona com MariaDB (testado com a 11.8) e com servidores compatíveis com MySQL. A conta do banco de dados só precisa criar tabelas e ler, inserir, atualizar e excluir linhas no próprio banco de dados. As alterações de armazenamento exigem reinicialização; as alterações comuns de configuração, idioma e jornadas são recarregadas ao vivo.

O acesso ao banco de dados roda em uma thread própria. Uma tentativa de conexão desiste após 5 segundos e uma consulta após 15, então um banco de dados inacessível não consegue travar o servidor. O progresso que não pôde ser salvo permanece na memória e é gravado de novo quando o banco de dados responde, incluindo o progresso de jogadores que saíram nesse meio-tempo. Se o próprio servidor for parado enquanto o banco de dados ainda estiver inacessível, o progresso que ainda não foi gravado é perdido.

Se o banco de dados não puder ser alcançado quando o servidor iniciar, ou o login for recusado, o VelorJourney registra o motivo e permanece desativado até a próxima reinicialização. Nada é gravado na sua configuração nem nos seus dados.

Defina journeys.enabled: false para executar o VelorJourney como uma instalação somente de análise. O acompanhamento de tempo ativo, de jogadores e de retenção continua, enquanto a inscrição automática, os sinais de progresso e os menus de jornada dos jogadores param. O progresso existente é mantido e retomado quando as jornadas são ativadas de novo.

No jogo #