Back to mods
Master Server Re-Auth project artwork

Vintage Story Mod DB · Vintage Story mod

Master Server Re-Auth

MasterServerReAuth Vintage Story server mod that retries master server registration when the initial registration attempt fails, instead of requiring a server restart. The bug Vanilla registration logic lives in Vintagestory.Server.ServerSystemHeartbeat (in

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Master Server Re-Auth release should I use?

Updated last month
Latest stable file 1.0.0
Game version 1.22.0, 1.22.1, 1.22.2
Loader Built-in Vintage Story mod system

Master Server Re-Auth 1.0.0 targets 1.22.0, 1.22.1, 1.22.2. Do not install it on the client. It must be installed on the dedicated server. No extra mods listed for this file.

Where it goes

Is Master Server Re-Auth required on the client, server, or both?

Do not install it on the client. It must be installed on the dedicated server.

Client Not supported
Dedicated server Required
Loader for this release Built-in Vintage Story mod system
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

This Vintage Story file is marked server-only.

What else does Master Server Re-Auth 1.0.0 need?

1.0.0. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add Master Server Re-Auth without breaking your instance.

Built for Master Server Re-Auth 1.0.0. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 1.0.0. It targets 1.22.0, 1.22.1, 1.22.2; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    Do not install it on the client. It must be installed on the dedicated server.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 1.0.0. It opens that exact file at the source.

About this project

What does Master Server Re-Auth add?

MasterServerReAuth

Vintage Story server mod that retries master server registration when the initial registration attempt fails, instead of requiring a server restart.

The bug

Vanilla registration logic lives in Vintagestory.Server.ServerSystemHeartbeat (inside VintagestoryLib.dll):

  • SendHeartbeat() only triggers a re-registration (SendRegister()) when the heartbeat request comes back with status "invalid" or "timeout". The heartbeat request requires an existing token, i.e. the server must already be registered for this path to run at all.
  • SendRegister() itself can also time out (e.g. HttpClient.Timeout of 10s elapsing). When that happens, its callback only special-cases the "blacklisted" and "ok" statuses — a "timeout" status falls through to the generic else branch, which just logs "Could not register to master server..." and does nothing else.
  • Since the registration failed, token is never set. SendHeartbeat() no-ops whenever token is null/empty, so the heartbeat loop (which ticks every 2 minutes) keeps running forever without ever attempting to register again.

Net effect: a single timed-out registration request permanently drops the server off the public server list until it is restarted (or AdvertiseServer is manually toggled off/on in the config).

Project description from Vintage Story Mod DB.

Pick your setup

Master Server Re-Auth releases for each Vintage Story version.

Choose the version and loader you play, then open the matching release.

8 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Master Server Re-Auth versions and loaders

1 of 1 releases match

Looking for an older file? The official Vintage Story Mod DB project page is in Resources.