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

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: