Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
BaseAssistant
An autonomous assistant for your Valheim base. Automatically repairs structures, fuels kilns, collects items from the ground, and organizes your chests with strict sorting rules.
| Last updated | 5 hours ago |
| Total downloads | 131 |
| Total rating | 5 |
| Categories | Mods Misc NPCs AI Generated |
| Dependency string | Singularity_Dot-BaseAssistant-0.1.3 |
| Dependants | 0 other packages depend on this package |
This mod requires the following mods to function
denikson-BepInExPack_Valheim
BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.
Preferred version: 5.4.2202ValheimModding-Jotunn
Jötunn (/ˈjɔːtʊn/, 'giant'), the Valheim Library was created with the goal of making the lives of mod developers easier. It enables you to create mods for Valheim using an abstracted API so you can focus on the actual content creation.
Preferred version: 2.29.1README
Valheim Base Assistant
Um mod para Valheim que adiciona um NPC "Dverger" autônomo focado em logística e manutenção da base.
🛠️ Estado Atual (Versão Finalizada da Sessão)
O Assistente já é capaz de navegar pela base, reparar estruturas quebradas em área, coletar itens caídos e armazená-los em baús, além de reabastecer fornalhas ativamente.
Funcionalidades Implementadas:
- Radar e Área de Atuação: O assistente orbita uma "Cama do Assistente" num raio padrão de 30 metros. A cama possui um toggle (Interagir) que cria uma cúpula visual para exibir a área de cobertura.
- Sistema de Configuração em Tempo Real (Live Reloading): Integração com
BepInEx.Configuration. As distâncias e lógicas podem ser ajustadas no Thunderstore (viacom.singularitydot.baseassistant.cfg) e são atualizadas no jogo a cada 5 segundos sem necessidade de reiniciar. - Reparo em Área (AoE): Quando o NPC detecta uma peça danificada, ele anda até uma distância segura e invoca um conserto que repara todas as estruturas num raio configurável (Padrão: 10m).
- Logística de Cadeia (Chain Pickup): O assistente vasculha o chão em busca de itens acumuláveis. Se pegar um item, ele procura itens similares próximos para encher as mãos antes de ir guardar, economizando viagens.
- Abastecimento Inteligente (Fundição Universal): O assistente verifica todas as fornalhas e fundições da base (incluindo mods). Ele lê ativamente o que a máquina aceita e abastece com carvão/madeira e minérios disponíveis.
- Limites de Produção e Reserva Segura: O assistente pausa a produção automaticamente se um certo limite de minério ou carvão já foi produzido. Além disso, ele nunca esvazia os baús de matérias-primas, preservando uma quantidade de reserva (
LeaveWoodAmount,LeaveCoalAmount,LeaveOreAmount). - Sistema de Desatolamento (Geodata Bypass v2): O cálculo de distâncias agora é feito mapeando a Borda (Bounding Box) dos objetos.
- Nomes nos Baús: O jogador pode renomear os baús e o assistente usará o nome (baseado na tradução local) para armazenar metais e ligas sem causar problemas de diferença entre maiúsculas/minúsculas.
- Sistema Anti-Duplicação e Reserva Global: O assistente utiliza um HashSet estático de ZDOIDs para garantir que múltiplos assistentes não tentem pegar o mesmo item no chão simultaneamente, evitando duplicações (clonagem).
- Recuperação Elegante de Tarefas (Stuck Recovery): Se o assistente ficar travado tentando buscar um item no chão, a punição foi reduzida (5s) para que ele ou outros assistentes tentem novamente mais rápido. Se o alvo for um baú, ele desiste e tenta mais tarde, limpando sempre as reservas pendentes sem vazamentos.
⚙️ Variáveis de Configuração (BepInEx)
O arquivo com.singularitydot.baseassistant.cfg permite customizar:
RaioDeTrabalho: Tamanho da área de cobertura (Padrão: 30m).VidaParaReparo: Limiar para consertar (Padrão: 0.8 / 80%).RaioReparoEmArea: Tamanho do domo de reparo AoE (Padrão: 10m).DistanciaFornalha: Distância para jogar itens na fornalha (Padrão: 4.0m).DistanciaBau/DistanciaItemChao: Distâncias mais curtas de interação física (Padrão: 2.5m e 2.0m).LeaveWoodAmount,LeaveCoalAmount,LeaveOreAmount: Quantidade mínima de itens a serem preservados no baú.MaxCoalAmount,MaxSmeltedMetal: Limites globais máximos de produção de carvão e metais.
📝 Próximos Passos
- Novas Integrações Industriais: Moinhos, rodas de fiar e fornos de pão.
- Organização Total de Estoque: Refinar ainda mais as pontuações do baú baseado em tipos específicos (Ex: guardar resina com madeira).