HeimdallVoice

HeimdallVoice integra zonas do mapa de Valheim com canais de voz no Discord.

Quando um jogador vinculado entra em uma zona configurada, o bridge move esse jogador para a sala de voz correspondente. Quando ele sai da zona, o bridge restaura o canal de voz anterior.

Recursos

• Movimentacao automatica entre salas de voz do Discord por zona do mapa
• Vinculo da conta pelo jogo com voice ou /voice
• Suporte ao Configuration Manager
• Restauracao automatica para o canal anterior ao sair da zona
• Persistencia dos vinculos entre Steam e Discord

Como Funciona

1. O jogador usa voice no console ou /voice no chat.
2. O mod gera um codigo de vinculacao.
3. O jogador usa !link CODIGO no Discord.
4. O bridge salva o vinculo entre Steam e Discord.
5. Quando o jogador entra em uma zona, o mod envia o discordChannelId configurado.
6. O bridge move o usuario para a sala de voz correta.
7. Quando o jogador sai da zona, o bridge restaura o canal anterior.

O Que Voce Precisa

Este projeto tem 2 partes:

1. O plugin BepInEx para Valheim
2. O HeimdallVoice Bridge, um app Node.js que conversa com o Discord

O pacote da Thunderstore entrega o plugin do Valheim. Para o sistema funcionar, o bridge tambem precisa estar rodando.

Instalacao no Valheim

1. Instale BepInExPack Valheim
2. Instale este mod
3. Inicie o jogo ou servidor uma vez para gerar os arquivos de configuracao

Configuracao do Bridge

Dentro da pasta do bridge:

cd HeimdallVoice-Bridge
npm install
node index.js

Antes de iniciar o bridge, preencha:

HeimdallVoice-Bridge/config.json

Exemplo:

{
  "discordToken": "SEU_TOKEN_DO_BOT",
  "guildId": "SEU_ID_DO_SERVIDOR",
  "serverHost": "0.0.0.0",
  "serverPort": 24600
}

Campos obrigatorios:

• discordToken: token do bot do Discord
• guildId: ID do servidor Discord

Se esses campos ainda estiverem com os valores de exemplo, o bot nao inicia.

Configuracao do Plugin

O plugin pode ser configurado pelos arquivos do BepInEx ou diretamente no Configuration Manager dentro do jogo.

URL do Bridge

Defina a URL do bridge em:

• Bridge -> URL Base

Exemplos:

• http://127.0.0.1:24600
• https://seu-tunnel.trycloudflare.com

Se voce estiver usando Cloudflared, coloque a URL gerada pelo tunnel em Bridge -> URL Base.

Configuracoes do Discord

Tambem disponiveis no Configuration Manager:

• Bot do Discord -> Token do Bot
• Servidor do Discord -> ID do Servidor
• Servidor da Bridge -> Host
• Servidor da Bridge -> Porta

Zonas

As zonas podem ser configuradas no Configuration Manager em:

• Zonas -> Quantidade de Zonas
• Zona 1
• Zona 2
• Zona 3
• ...

Cada zona suporta:

• Nome
• Posicao X
• Posicao Z
• Raio
• ID da Sala Discord

O plugin tambem mantem uma copia em:

BepInEx/config/HeimdallVoice/zones.json

Exemplo:

[
  {
    "name": "Global",
    "x": 0,
    "z": 0,
    "radius": 60,
    "discordChannelId": "1250504640488013866"
  },
  {
    "name": "Vila",
    "x": 225,
    "z": 88,
    "radius": 10,
    "discordChannelId": "1478777749895118918"
  }
]

Comandos

No jogo:

• voice
• /voice

No Discord:

• !link CODIGO

Observacoes Importantes

• O bridge mantem apenas um vinculo por conta Discord
• O jogador precisa ja estar conectado a um canal de voz para poder ser movido
• Se o bridge estiver offline ou inacessivel, as trocas de zona nao vao mover o jogador
• Se voce usar um tunnel temporario do Cloudflared, a URL muda toda vez que ele for iniciado

Seguranca

• Nunca compartilhe o token do seu bot
• Se esse token foi exposto, revogue e gere outro imediatamente

Suporte

Se o bot nao iniciar, verifique primeiro o arquivo HeimdallVoice-Bridge/config.json. O bridge se recusa a iniciar enquanto discordToken ou guildId estiverem com os valores de exemplo.