Whitelist Remove

Whitelist Remove

Whitelist Remove creates a file lastseen.json in BepInEx/config/WhitelistRemove to track the date of each player’s last connection. If a player does not reconnect and the maximum allowed time since their last connection is reached, their ID is automatically removed from the whitelist and an entry is added to a log file.

SERVER ONLY

This mod must be installed ONLY on the server. Clients DO NOT need this mod installed.

This is a 100% server-side mod and works exclusively on the server.

Available Settings

This configuration file allows you to control how the automatic whitelist inactivity cleaner works. All options are generated automatically after the mod is run for the first time on the server.

[01 – General]

Enable
Enables or disables the automatic whitelist cleanup system.

• true: the mod runs normally and performs periodic checks.
• false: the mod is completely disabled.

[02 – Whitelist]

WhitelistFileName
Defines the name of the whitelist file used by the server. By default, Valheim uses the permittedlist.txt file. Change this only if your server uses a custom whitelist file.

[03 – Scan]

ScanIntervalSeconds
Defines how often (in seconds) the mod checks the whitelist to identify inactive players. Lower values result in more frequent checks, while higher values reduce the number of scans.

InactiveThresholdSeconds
Defines the maximum allowed inactivity time (in seconds). If a SteamID on the whitelist does not connect to the server for longer than this period, it will be removed automatically.

[04 – Bypass]

BypassSteamIds
List of SteamIDs (comma separated) that will never be removed from the whitelist, regardless of inactivity time. Ideal for server owners, moderators, or special accounts.

BypassAdmins
If enabled, SteamIDs that are server administrators will never be removed from the whitelist.

• true: administrators are always preserved.
• false: administrators can also be removed due to inactivity.