Valheim Mod Manager

Gerenciador de Mods Valheim

Visão geral

Aplicativo de linha de comando simples para gerenciar mods para Valheim de Thunderstore.io.

• Gerencia mods instalados localmente para teste
• Fornece exportação ZIP para jogadores
• Implanta mods no servidor automaticamente após a publicação

Vídeo de demonstração do gerenciador de mod Valheim

Requisitos

(com pip)

pip3 install packaging python-magic paramiko

(com pacotes nativos)

sudo apt install python3-packaging python3-magic python3-paramiko

Python3 e os pacotes [packaging, python-magic, paramiko]. Testado no Ubuntu 22.04 e Debian 12 com Python 3.11

Configuração

Copie config.yml.DEFAULT para config.yml e ajuste conforme necessário.

depurar

Defina o sinalizador de depuração como true para saída de depuração

gamedir

Defina o local de sua instalação local do Valheim

prefixo de exportação

Defina o nome do arquivo a ser exportado, útil para preceder o nome do servidor ou algo significativo.

exportdir

Diretório para exportar mods agrupados e alterar informações, fique à vontade para definir um diretório gerenciado pelo Nextcloud para implantação automática para seus usuários!

dias atualizados

Defina o número de dias para pacotes "atualizados", definindo como '14' exportará qualquer plugin atualizado nos últimos 14 dias na exportação de pacotes "atualizados"

sftp_host

Defina o IP ou nome do host para implantar automaticamente plug-ins de "servidor" durante a exportação. se vazio, esta lógica é ignorada

sftp_user

Nome de usuário para conexão via SSH (somente autenticação baseada em chave)

caminho_sftp

Caminho no servidor dedicado onde Valheim está instalado (para implantação automática)

override_server

Lista de plug-ins separados por vírgula para forçar a implantação do servidor Normalmente, apenas mods sinalizados com a tag "servidor" são implantados, mas às vezes os desenvolvedores de mods não incluem isso.

Usando

Execute ./cli.py para executar o script interativo.

Valheim Mod Manager

1: List Mods Installed
2: Install New Mod
3: Check For Updates
4: Uninstall Mod
5: Revert Modifications
6: Export/Package Mods
Q: Quit Application

Enter 1-6:

O fluxo de trabalho geral para usar este script: execute o script para carregar seus mods de jogo atuais no gerenciador. Talvez seja necessário selecionar qual autor o mod deve usar (alguns mods são publicados por autores diferentes, mas têm o mesmo nome).

1. Listar Mods Instalados

Listar os mods instalados é autoexplicativo; ele lista os mods e versões que você instalou atualmente.

2. Instale novo

A instalação de um novo mod pode ser feita pesquisando o nome do mod ou o URL do Thunderstore. Será apresentada a você a opção de qual versão instalar (o padrão é a versão mais recente). As dependências são tratadas automaticamente.

3. Verifique se há atualizações

Depois de carregado, você pode atualizar seus mods locais por meio de Check For Updates . Isso fornecerá a você a capacidade de atualizar rapidamente qualquer/todos os mods instalados.

4. Desinstalar mod

A remoção de mods é realizada por meio de Uninstall Mod , embora para pacotes de exportação de usuários seja importante informar aos usuários quais mods foram removidos, pois eles precisarão removê-los manualmente após a atualização. (Infelizmente, os arquivos ZIP não suportam a opção "excluir este diretório".)

Seu cliente de jogo local é atualizado automaticamente quando mods são instalados, removidos ou atualizados. Isso permite que você teste um mod antes da implantação. (Observe que isso é importante! Alguns mods danificarão seu jogo/personagem!) Para mods que se comportam mal, eles podem ser revertidos através de Revert Modifications . Isso reverterá um mod ao seu status original de implantação (removido completamente ou redefinido para uma versão específica).

Por último, Export/Package Mods criará uma variedade de arquivos para seus usuários. Uma exportação completa conterá todos os mods e BepInEx, um zip de atualização que contém apenas mods atualizados nos últimos (por padrão) 14 dias, um CHANGELOG que pode ser publicado contendo todas as alterações e um arquivo MODS que contém todos os mods atualmente instalados e seus versões.

Modificações de servidor

Para mods marcados com o sinalizador Server-side , eles também são copiados em .cache/server para implantação em seu servidor privado.

Se as opções sftp_ estiverem configuradas, a biblioteca enviará automaticamente esses mods para o servidor do jogo ao lançar um novo pacote.

Para implantações manuais, basta copiar esses arquivos para o servidor do jogo quando estiver pronto.

Notas Técnicas

Este aplicativo faz uso intenso de cache de arquivos. A lista completa de pacotes do Thunderstore.io é baixada apenas uma vez por hora (por padrão) e os pacotes mod são armazenados em .cache/packages , portanto, instalações repetidas do mesmo pacote não precisam ser baixadas do site novamente.