


A BepInEx 5 + Harmony client-side mod for Valheim that enhances the vanilla password dialog shown when joining password-protected servers.
https://github.com/JipZeonGit/ValheimPasswordManager
assembly_guiutils.dll.Run this from the repository root:
.\build.ps1
$env:APPDATA = (Resolve-Path '.appdata').Path
$env:DOTNET_CLI_HOME = (Resolve-Path '.').Path
$env:DOTNET_SKIP_FIRST_TIME_EXPERIENCE = '1'
$env:NUGET_PACKAGES = Join-Path (Resolve-Path '.').Path '.nuget\packages'
dotnet build .\src\ValheimPasswordManager\ValheimPasswordManager.csproj -c Debug --configfile .\.appdata\NuGet\NuGet.Config
Output DLL:
src\ValheimPasswordManager\bin\Debug\ValheimPasswordManager.dllCopy the compiled DLL into the Valheim client:
<Valheim Folder>\BepInEx\plugins\ValheimPasswordManager\ValheimPasswordManager.dllA dedicated subfolder is recommended:
<Valheim Folder>\BepInEx\plugins\ValheimPasswordManager\After running the mod, the saved password list is stored at:
<Valheim Folder>\BepInEx\config\JipZeonGit.Valheim.PasswordManager.jsonIf the file is corrupted, it is backed up automatically as:
JipZeonGit.Valheim.PasswordManager.json.corrupt-timestamp.bakAfter the mod runs once, it generates a BepInEx config file:
<Valheim Folder>\BepInEx\config\JipZeonGit.Valheim.PasswordManager.ScrollSpeed.cfgCurrent UI option:
UI.PasswordListScrollSpeedNotes:
16020 to 400This repository does not commit the game/framework DLL payloads by default, but local compilation still depends on these reference folders:
references\\BepInEx\\corereferences\\Valheim\\ManagedIf you clone this repository on a new machine, prepare those DLLs in the local references folder first, following references/README.md, and then build the project.
Treat the GitHub repository as a source repository, not as a mirror of a local game installation.
Recommended to commit:
src/docs/README.md.gitignorebuild.ps1NuGet.ConfigNot recommended to commit:
references/third_party/bin/, obj/, .appdata/, .dotnet/, and .nuget/Why:
references/Valheim/Managed contains assemblies copied from a local game installation and is not ideal to keep in a public source repository.third_party/ is reference material only and is not required for players to run the mod.Usually, no. It is better not to commit the built DLL to the source branch.
Recommended workflow:
ValheimPasswordManager.dll as a GitHub Releases asset when you want to publish to playersValheimPasswordManager-1.0.1.zip for releasesWhen committing the DLL can still make sense:
release/ folder inside the repositoryFor normal development and collaboration, the better default is:
一个基于 BepInEx 5 + Harmony 的 Valheim 纯客户端 Mod,用来增强“进入有密码的服务器时”的原版密码输入界面。
https://github.com/JipZeonGit/ValheimPasswordManager
assembly_guiutils.dll 可见的语言名称。在仓库根目录运行:
.\build.ps1
$env:APPDATA = (Resolve-Path '.appdata').Path
$env:DOTNET_CLI_HOME = (Resolve-Path '.').Path
$env:DOTNET_SKIP_FIRST_TIME_EXPERIENCE = '1'
$env:NUGET_PACKAGES = Join-Path (Resolve-Path '.').Path '.nuget\packages'
dotnet build .\src\ValheimPasswordManager\ValheimPasswordManager.csproj -c Debug --configfile .\.appdata\NuGet\NuGet.Config
输出 DLL:
src\ValheimPasswordManager\bin\Debug\ValheimPasswordManager.dll把编译出的 DLL 放到 Valheim 客户端:
<Valheim目录>\BepInEx\plugins\ValheimPasswordManager\ValheimPasswordManager.dll建议建一个独立子目录:
<Valheim目录>\BepInEx\plugins\ValheimPasswordManager\运行后,密码列表会保存到:
<Valheim目录>\BepInEx\config\JipZeonGit.Valheim.PasswordManager.json如果文件损坏,会自动备份成:
JipZeonGit.Valheim.PasswordManager.json.corrupt-时间戳.bak运行一次 Mod 后,会生成 BepInEx 配置文件:
<Valheim目录>\BepInEx\config\JipZeonGit.Valheim.PasswordManager.ScrollSpeed.cfg当前可调的 UI 项:
UI.PasswordListScrollSpeed说明:
16020 到 400这个仓库默认不提交游戏和框架 DLL 本体,但源码编译仍然依赖本地引用目录:
references\BepInEx\corereferences\Valheim\Managed如果你是在一台新的机器上克隆这个仓库,需要先按 references/README.md 的说明,把对应 DLL 从本地 Valheim / BepInEx 环境准备到 references 目录,再执行构建。
建议把 GitHub 仓库当作“源码仓库”,而不是“游戏安装目录镜像”。
推荐提交:
src/docs/README.md.gitignorebuild.ps1NuGet.Config不建议提交:
references/ 下的游戏和框架引用副本third_party/ 下的本地参考源码仓库bin/、obj/、.appdata/、.dotnet/、.nuget/ 等构建缓存原因:
references/Valheim/Managed 包含来自游戏安装目录的程序集,不适合直接作为公开仓库内容长期维护。third_party/ 只是本地参考资料,不是这个 mod 运行所必需的发布内容。通常不建议把编译产物 DLL 直接提交到源码分支。
更推荐的做法:
ValheimPasswordManager.dll 作为 GitHub Releases 的附件上传ValheimPasswordManager-1.0.1.zip什么时候可以提交 DLL:
release/ 目录做手工分发如果只是正常开发协作,我建议: