Glitnir Ranking

Glitnir Ranking é um sistema completo de classificação para servidores Valheim. As ações dos jogadores são convertidas em pontos, estatísticas e conquistas persistentes, formando uma competição contínua durante cada temporada.

O servidor controla as regras e mantém o banco de dados oficial. Os clientes recebem os dados sincronizados e acessam todas as informações pelo HUD do Ranking.

Recursos principais

• Ranking geral com Top configurável.
• Perfil individual com pontos e estatísticas.
• Pontos por criaturas e bosses derrotados.
• Pontos por peixes realmente pescados.
• Pontos por itens produzidos.
• Jackpots de agricultura por quantidade colhida.
• Jackpots únicos de crafting.
• Recompensas por marcos de skills.
• Pontos por exploração do mapa.
• Pontuação por quests do Marketplace, quando a integração estiver disponível.
• Penalidades configuráveis por morte.
• Recompensas sazonais para os primeiros colocados.
• Broadcasts de conquistas e mudanças importantes.
• Integração opcional com webhook do Discord.
• Proteções contra formas comuns de exploração de pontos.

Requisitos

Obrigatórios

• Valheim.
• BepInExPack Valheim 5.4.2333 ou compatível.
• A mesma versão do GlitnirRanking.dll no servidor e em todos os clientes.

Marketplace — necessário somente para pontos de quests

O Marketplace não é obrigatório para utilizar o Glitnir Ranking.

Entretanto, para utilizar a função Pontos de Quests, o mod Marketplace and Server NPCs deve estar instalado no servidor e nos clientes.

• Com Marketplace: as quests configuradas podem conceder pontos normalmente.
• Sem Marketplace: todo o restante do Ranking continua funcionando, mas novos pontos de quests não são concedidos.
• Quando a integração não estiver disponível, a área de quests do HUD será exibida como indisponível.
• O histórico de quests e os pontos já registrados no banco de dados não são apagados.

Essa integração é opcional e não cria uma dependência obrigatória para os demais sistemas do Ranking.

Instalação

1. Instale o BepInExPack no servidor e nos clientes.
2. Coloque GlitnirRanking.dll em:

BepInEx/plugins/

1. Use exatamente a mesma DLL no servidor e em todos os jogadores.
2. Inicie primeiro o servidor para gerar os arquivos de configuração e o banco de dados.
3. Reinicie o servidor depois de editar as regras.

Para habilitar pontos por quests, instale também o Marketplace no servidor e nos clientes antes de iniciar o jogo.

Acesso ao Ranking

O HUD é aberto pelo ícone do Glitnir Ranking exibido na interface do jogo.

O mod não utiliza tecla de atalho global. Isso evita conflitos com atalhos de outros mods e mantém o acesso centralizado no ícone.

No HUD, o jogador pode consultar:

• classificação geral;
• perfil e posição atual;
• guia de pontuação;
• regras e penalidades;
• recompensas disponíveis;
• alterações recentes do Ranking.

Sistemas de pontuação

Combate

Cada criatura configurada pode conceder uma quantidade específica de pontos. O servidor valida a morte e identifica o jogador responsável pelo crédito.

Criaturas domesticadas podem ser ignoradas para evitar farming artificial.

Bosses

Bosses e minibosses possuem uma tabela própria de pontuação. O servidor pode permitir pontos repetidos ou registrar a recompensa apenas uma vez por jogador.

Para um ranking competitivo, recomenda-se manter a repetição de bosses desativada.

Pesca

Somente o peixe obtido por uma captura legítima concede pontos. Peixes coletados do chão não contam como uma nova pescaria.

O sistema também possui proteções adicionais contra exploração envolvendo drop de peixes e recipientes usados para reproduzir capturas artificialmente.

Crafting

Itens configurados podem conceder pontos sempre que forem produzidos legitimamente. Regras separadas permitem criar jackpots únicos para itens importantes.

Agricultura

A agricultura utiliza marcos de quantidade. Ao alcançar a quantidade configurada para determinada colheita, o jogador recebe o jackpot correspondente.

Skills

O jogador pode receber pontos ao alcançar níveis específicos de habilidade. Cada marco é controlado pelas regras do servidor.

Exploração

O Ranking acompanha o percentual revelado do mapa e pode conceder jackpots quando o jogador alcança os marcos configurados.

Quests do Marketplace

O Ranking observa a conclusão legítima das quests configuradas no Marketplace e envia o evento ao servidor para validação.

Cada regra relaciona a identificação da quest com sua pontuação. O crédito único fica registrado no banco para impedir que a mesma conquista seja pontuada novamente pelo mesmo jogador.

Esta categoria exige o Marketplace instalado no servidor e nos clientes. Sem ele, a categoria fica indisponível e nenhum novo ponto de quest é concedido.

Penalidade por morte

A penalidade pode utilizar uma tabela progressiva ou um multiplicador por quantidade de mortes. O recurso pode ser desativado para servidores casuais.

Recompensas e temporadas

O servidor pode configurar recompensas para Top 1, Top 2 e Top 3, incluindo:

• item pelo nome interno do prefab;
• quantidade;
• pontuação mínima;
• descrição apresentada no HUD.

O campo RewardClaimCycleId identifica a temporada atual. Ao iniciar uma nova temporada, utilize um novo identificador, como:

temporada_002

Não reutilize um identificador antigo se desejar liberar um novo ciclo de resgates.

Configuração

As regras principais de pontuação são geradas em:

BepInEx/config/glitnir.ranking.rules.cfg

As opções sincronizadas do plugin são geradas em:

BepInEx/config/com.glitnir.ranking.cfg

As configurações do servidor são a autoridade para pontuação, recompensas e penalidades. Com o bloqueio de configuração ativado, os clientes recebem os valores definidos pelo servidor.

Exemplos de regras:

CraftPoints.Rules=MeadHealthMinor:20;ArrowNeedle:2
FarmJackpots.Rules=Carrot:200:1000
UniqueCraftJackpots.Rules=IronSword:1:800

Utilize o nome interno correto do prefab. Nas listas de produção e jackpots, separe múltiplas regras com ponto e vírgula.

Para quests do Marketplace:

EnableMarketplaceQuestPoints=true

[MarketplaceQuestPoints]
QuestPointMap=ccq_b21:450,ccq_b22:150

Ativar EnableMarketplaceQuestPoints não instala o Marketplace. A integração somente ficará operacional quando o Marketplace também estiver presente no servidor e nos clientes.

Banco de dados e progresso

O progresso oficial é armazenado pelo servidor em um banco LiteDB:

BepInEx/config/GlitnirRanking/SavedData/DB.db

O banco pode conter:

• jogadores e pontuação total;
• estatísticas de combate, pesca, produção, agricultura e exploração;
• conquistas únicas;
• créditos de quests do Marketplace;
• penalidades por morte;
• recompensas já resgatadas;
• dados necessários para reconstruir o Ranking.

Atualizações

Não apague o arquivo DB.db ao atualizar o mod. Substitua somente a DLL e mantenha o banco existente para preservar todo o progresso.

Antes de qualquer atualização importante, faça uma cópia de segurança da pasta:

BepInEx/config/GlitnirRanking/SavedData/

Os dados locais dos clientes não substituem nem alteram o banco oficial do servidor.

Proteções contra exploração

O Glitnir Ranking aplica validações específicas conforme a categoria:

• autoridade de pontuação mantida pelo servidor;
• identificação do jogador pelo remetente da conexão;
• bloqueio de créditos repetidos em conquistas únicas;
• opção para ignorar criaturas domesticadas;
• validação de bosses repetidos;
• validação de peixes realmente pescados;
• proteção contra farming por drop ou recipiente com peixes;
• validação das regras e valores de quests no servidor;
• marcos únicos de skills, agricultura, crafting e exploração.

Essas proteções reduzem abusos, mas as regras devem ser balanceadas de acordo com os demais mods utilizados pelo servidor.

Administração e boas práticas

• Faça backup do banco antes de atualizar o servidor.
• Mantenha servidor e clientes na mesma versão.
• Teste novas regras em um perfil separado.
• Não altere o banco enquanto o servidor estiver em execução.
• Utilize prefabs válidos nas regras de itens e criaturas.
• Evite valores extremos antes de testar o impacto na temporada.
• Ative logs de depuração somente durante diagnósticos.
• Ao usar quests, confirme que a versão do Marketplace contém o sistema de quests compatível.

Atualização segura

1. Encerre o servidor.
2. Faça backup de BepInEx/config/GlitnirRanking/SavedData/.
3. Substitua GlitnirRanking.dll no servidor.
4. Distribua a mesma DLL para todos os clientes.
5. Preserve os arquivos de configuração e o banco de dados.
6. Inicie o servidor e confira o console do BepInEx.
7. Entre com um cliente de testes e valide o HUD e as categorias utilizadas.

Suporte

Comunidade Glitnir: Discord oficial

Glitnir Ranking — honra, feitos e recompensas registrados em cada temporada.