Glitnir Admin Command Center

Glitnir Admin Command Center adiciona ao Valheim uma central administrativa completa, segura e imersiva, construída em Unity para controlar o servidor sem depender do console.

Recursos

• HUD administrativo nativo em Unity, aberto pela tecla F6;
• acesso restrito ao host e aos jogadores autorizados na adminlist.txt;
• diretório persistente de jogadores conhecidos, identificado por Nick e Steam ID;
• identificação visual de jogadores online, offline e administradores;
• pesquisa e seleção de jogadores com lista preparada para servidores com muitos registros;
• inclusão e remoção segura da whitelist oficial do Valheim;
• banimento com contagem regressiva, motivo opcional e mensagens especiais;
• desbanimento e expulsão de jogadores conectados;
• envio de qualquer item pelo nome exato do prefab;
• envio de doações em Glitnir Coin;
• entrega imediata para jogadores online ou entrega automática no próximo login;
• fila persistente de entregas para jogadores offline;
• validação de espaço antes da entrega para impedir itens parciais ou duplicados;
• aviso persistente quando o inventário não comporta a entrega;
• cancelamento administrativo de entregas pendentes;
• broadcast global com posição, cor, estilo, tamanho, emoji e duração configuráveis;
• confirmação obrigatória antes de ações administrativas importantes;
• limpeza automática dos campos depois de cada ação concluída;
• bloqueio dos comandos quando faltam Steam ID, quantidade, prefab ou mensagem;
• relatório persistente de itens, moedas, banimentos, desbanimentos e expulsões;
• registro do estado de cada entrega: pendente, recusada, cancelada ou recebida;
• edição organizada dos arquivos oficiais permittedlist.txt, bannedlist.txt e adminlist.txt;
• observações gravadas como comentário acima da Steam ID, sem arquivos auxiliares de notas;
• ServerSync do blaxxun incorporado diretamente ao mod;
• asset bundle do HUD incorporado na própria DLL;
• funcionamento independente, sem Jotunn.

Segurança administrativa

O HUD não abre para jogadores que não estejam autorizados na lista administrativa do servidor. Todas as ações são novamente validadas no servidor antes de serem executadas; a interface do cliente não possui autoridade para alterar listas, expulsar jogadores ou registrar entregas sozinha.

As ações críticas exibem uma janela de confirmação com o jogador e a Steam ID selecionados. Depois da confirmação, os campos utilizados são limpos para evitar a repetição acidental de pagamentos, itens ou punições.

Jogadores online e offline

O servidor mantém um diretório persistente conforme os jogadores entram. O painel informa quem está online ou offline e destaca os administradores. Assim, um jogador pode ser adicionado à whitelist, banido ou receber itens mesmo quando não está conectado.

Itens e moedas enviados para um jogador offline permanecem em uma fila do servidor. No próximo login, o cliente valida o inventário antes de confirmar a entrega. Se não houver espaço suficiente para toda a remessa, nada é entregue e o aviso permanece na tela até que o jogador libere espaço ou um administrador cancele a entrega. Esse processo evita recebimento parcial e duplicação após reconectar.

Relatório de atividades

O painel Relatório de Envios apresenta o histórico por jogador e registra:

• itens e quantidades solicitadas;
• doações em Glitnir Coin;
• estado e confirmação das entregas;
• cancelamentos administrativos;
• banimentos e desbanimentos;
• expulsões do servidor.

O histórico é salvo junto aos arquivos oficiais do mundo para permanecer disponível depois de reiniciar o servidor.

Broadcast global

A área de broadcast permite preparar mensagens globais com:

• posição na tela;
• cor predefinida ou hexadecimal personalizada;
• texto normal, negrito, itálico ou combinado;
• tamanho da fonte;
• símbolos e emojis temáticos;
• duração da mensagem;
• opção de adicionar a mensagem ao histórico.

Instalação

Instale GlitnirAdminCommandCenter.dll em BepInEx/plugins no servidor e nos clientes.

Em servidor dedicado, reinicie o servidor depois de instalar ou atualizar a DLL. Todos os jogadores devem utilizar a mesma versão para receber broadcasts, entregas e mensagens do sistema corretamente.

Uso

1. adicione a Steam ID do administrador ao arquivo adminlist.txt do servidor;
2. inicie ou reinicie o servidor;
3. entre no mundo com um personagem autorizado;
4. pressione F6 para abrir ou fechar a central administrativa;
5. escolha a ação desejada e confirme os dados exibidos na janela de segurança.

Quando o HUD está aberto, os controles e atalhos conflitantes do Valheim são bloqueados para impedir a abertura acidental do mapa, gestos, inventário ou outros painéis enquanto o administrador digita.

Arquivos utilizados

O mod trabalha diretamente com os arquivos oficiais do servidor:

• adminlist.txt — administradores autorizados;
• bannedlist.txt — jogadores banidos;
• permittedlist.txt — jogadores autorizados na whitelist;
• arquivo de diretório — histórico de jogadores conhecidos e último acesso;
• arquivo de entregas — remessas pendentes para jogadores offline;
• arquivo de relatório — histórico administrativo e confirmação de recebimentos.

Nos três arquivos oficiais de lista, uma observação opcional é gravada neste formato:

//Apelido ou observação
76561198000000000

Ao remover um registro, a lista é reorganizada sem sobrescrever ou apagar as demais Steam IDs.

Configuração do servidor

O arquivo glitnir.lists.unified.cfg contém apenas opções funcionais:

• SaveDirPath: pasta que contém os arquivos oficiais do servidor;
• CreateListFilesOnStartup: cria os arquivos ausentes quando necessário;
• CoinPrefabName: nome do prefab utilizado nas doações de Glitnir Coin;
• RestrictHudAccessToAdminWhitelist: restringe a abertura do painel aos administradores;
• LockServerSettings: bloqueia no servidor as configurações sincronizadas.

Layout, fontes, texturas, cores, animações e dimensões pertencem ao asset bundle Unity e não geram configurações externas.

English details

Adds a complete Unity-based administration command center for Valheim with protected admin access, persistent online/offline player directory, whitelist and ban management, kicks, safe offline item and coin deliveries, inventory capacity validation, global broadcasts, confirmations and persistent activity reports. ServerSync and the UI asset bundle are embedded in the DLL; Jotunn is not required.

Support

Discord: https://discord.gg/g-l-i-t-n-i-r-848339987174785054