You are viewing a potentially older version of this package. View all versions.
Landoria-ModSentry-1.0.16 icon

ModSentry

Validates required and optional client mods before joining a Valheim server.

Date uploaded 2 weeks ago
Version 1.0.16
Download link Landoria-ModSentry-1.0.16.zip
Downloads 55
Dependency string Landoria-ModSentry-1.0.16

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2350 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2350

README

Landoria ModSentry

ModSentry verifies that the mods installed on each client match the mods expected by the server. This lets every player use the same mods and play under the same conditions.

Features

  • Checks that players have the required mods and only use approved files and versions.
  • Rejects connections with extra, missing, or outdated mods and explains what needs fixing.
  • Detects known cheat tools and lets the server kick or ban the player (kick by default).
  • Prevents players from reusing an old mod check response when connecting again. (Nonce-based server challenge.)

ModSentry is not a complete anti-cheat solution. It helps players use the correct mods and versions and includes client-side checks for known cheat tools. These checks can be bypassed by a determined cheater. If stronger anti-cheat protection is important for your server, use a complementary server-side mod.

Installation

Most of Landoria mods need to be installed also on the dedicated server, we show you in this video how to do it on windows:

Setup a Valheim Modded dedicated server on Windows

Crossplay support Steam network support
Yes No
Client required Dedicated server required Player-hosted server
Yes Yes Not supported

Server configuration

Configure the client mod policy with these folders on the server:

Folder Purpose
BepInEx/config/ModSentry_Required Contains every mod and library DLL required on clients. Include Landoria.ModSentry.dll here.
BepInEx/config/ModSentry_Optional Contains mods and library DLLs that clients may use but do not need.

Copy the approved client DLLs into the appropriate folder. ModSentry compares their plugin identifier, version, and SHA-256 hash with each connecting client. Any client DLL listed in neither folder is rejected.

Server-only mods stay in BepInEx/plugins and are not copied into either policy folder.

Configure known cheat detection with these dedicated server arguments:

Server argument Action
--modsentry-known-cheat-protection true or false (default: true).
--modsentry-known-cheat-action kick or ban (default: kick).

Contact

Report bugs through GitHub Issues. For questions and feedback, use GitHub Discussions.

All Landoria mods are used on the Landoria Valheim public servers.

CHANGELOG

Changelog

1.0.19

  • Automatically create the ModSentry_Required and ModSentry_Optional folders at startup.

1.0.18

  • Migration to Valheim 1.0.x.

1.0.14

  • Detect known cheat tools, with server-configurable kick or ban (kick by default).
  • Prevent reuse of an old mod check response when connecting again.

1.0.13

  • Updated documentation

1.0.12

  • Updated README.

1.0.11

  • Documentation

1.0.10

  • Kick rejected pre-spawn clients and preserve the custom rejection message without forcing a local logout.

1.0.9

  • Remember whether a connection sent an approved plugin list.

1.0.8

  • Accept non-BepInEx DLLs when explicitly listed in optional or required policy entries.

1.0.7

  • Emphasize identical mod setups and playing conditions for every player.

1.0.6

  • Add unit tests.

1.0.5

  • Disconnect rejected pre-admission connections directly so clients return to the main menu instead of remaining on a black screen.

1.0.4

  • Return rejected clients to the main menu and display the server's rejection reason.

1.0.3

  • Document Valheim version compatibility

1.0.2

  • Update thunderstore readme

1.0.1

  • Shorten ModSentry rejection messages.
  • Deliver ModSentry rejection details reliably.

1.0.0

  • Initial version.
  • Read plugin metadata from the plugin class when validating server policy files.
  • Confirm delivery of rejection details before disconnecting incompatible clients.
  • Explain which mod failed validation and which version the server expects.