GlitnirRanking

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

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

BepInEx/plugins/

• Use exatamente a mesma DLL no servidor e em todos os jogadores.
• Inicie primeiro o servidor para gerar os arquivos de configuração e o banco de dados.
• 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 p