QuickServerConnect

QuickServerConnect

By Dedryx

Double-click a Valheim server to connect and securely remember its password.

Features

• Double-clicking a standard Join Game server entry selects it and invokes Valheim's normal Connect action.
• Single-click behavior remains normal selection only.
• Passwordless servers connect through the unchanged vanilla flow.
• First-time password entry uses Valheim's normal password prompt.
• Successfully authenticated passwords can be remembered locally and submitted on later connections.
• A rejected saved password is deleted; the next connection attempt shows the normal password prompt.
• Different servers are keyed by typed join identity rather than display name.

Client-Side Only

QuickServerConnect is entirely client-side. The dedicated server does not need the mod, and other players do not need to install it. The server receives a password only through Valheim's normal authentication path.

Installation

• Gale: import the ZIP as a local mod or install it after publication.
• Mod Manager / r2modman: import the ZIP as a local mod or install it after publication.
• Manual: copy QuickServerConnect.dll into BepInEx/plugins/QuickServerConnect/ in the active Valheim installation or mod-manager profile.

Configuration

BepInEx creates BepInEx/config/dedryx.quickserverconnect.cfg on first launch.

[General]

Enabled = true

DoubleClickInterval = 0.35

AutoSubmitSavedPasswords = true

RememberPasswords = true

DoubleClickInterval accepts 0.1 to 1.0 seconds. Passwords are not exposed through ConfigurationManager.

To delete all remembered credentials, enable Valheim's console, open it with F5, and enter:

quickserverconnect clearpasswords

Password Storage

Encrypted credential data is stored locally in the active profile at:

BepInEx/config/QuickServerConnect/credentials.dat

Server identities are hashed with SHA-256. Dedicated servers use normalized hostname or IP plus port; Steam sessions use the Steam user ID; PlayFab sessions use the remote player ID. Server display names are not used as credential keys.

Passwords are encrypted using Windows DPAPI with DataProtectionScope.CurrentUser and application-specific entropy. The file contains hashed server identities and Base64 representations of DPAPI ciphertext. Base64 is only the ciphertext encoding. Protection is tied to the current Windows user profile; another Windows user cannot normally decrypt it. Passwords necessarily exist briefly in the game process while being entered or submitted, but they are never logged or stored in plaintext by this mod.

If a saved password is rejected with Valheim's explicit password error, QuickServerConnect deletes it from encrypted storage and clears the in-memory candidate. It does not retry automatically. On the next connection attempt, Valheim displays its normal prompt. Unrelated connection failures do not erase credentials.

Compatibility

• Valheim 1.0
• BepInEx 5
• Windows credential storage through DPAPI

Built and checked against Valheim 1.0.12.

Achievements

Valheim 1.0 normally blocks achievements when it detects a modded client. Players who want achievements while using mods may need an achievement-enabler such as Unshamed. It is optional and is not bundled or required by QuickServerConnect.

Issues / Source

Source repository / issue tracker: not yet published.