ModPermChecker
Enables granular per-player mod permissions alongside AzuAntiCheat. Restrict specific mods to specific SteamIDs.
模組介紹 作者原文
ModPermChecker
ModPermChecker is a lightweight server/client verification mod for Valheim. It allows server administrators to enforce granular, per-player mod access control.
Designed to work seamlessly with AzuAntiCheat (AAC), it solves the limitation where AAC can only distinguish between Admins and regular players.
🚀 Features
- Granular Mod Control: Allow specific client-side mods (e.g., building tools, QoL mods) only for designated SteamIDs.
- Auto Disconnect / Kick: Instantly kicks unauthorized players attempting to join with restricted mods.
- AAC Greylist Integration: Works hand-in-hand with AzuAntiCheat without triggering false bans.
- Easy JSON Configuration: Simple, human-readable configuration file.
🛠️ How It Works (with AzuAntiCheat)
- AzuAntiCheat Configuration: Add restricted mods to AAC's Greylist (Optional Mods) so AAC validates the DLL hashes without blocking connections.
- AAC Whitelist: Add ModPermChecker.dll to AAC's Whitelist (Enforced Mods) so every player is required to install this mod.
- ModPermChecker Validation: When a player connects, ModPermChecker reports their loaded mod GUIDs to the server. The server verifies them against CustomModPermissions.json and disconnects unauthorized players.
📦 Installation
Server Side
- Install BepInEx for Valheim.
- Place ModPermChecker.dll into BepInEx/plugins.
- Start the server once to generate the default configuration file: BepInEx/config/CustomModPermissions.json.
- Configure permissions in the JSON file.
Client Side (Players)
- Place ModPermChecker.dll into BepInEx/plugins/ (or install / r2modman).
⚙️ Configuration (CustomModPermissions.json)
The config file is located at BepInEx/config/CustomModPermissions.json.
{
"SpecialMods": [
"com.author.infinityhammer",
"com.author.worldeditcommands"
],
"Permissions": [
{
"SteamID": "76561198012345678",
"AllowedMods": [
"com.author.infinityhammer",
"com.author.worldeditcommands"
]
},
{
"SteamID": "76561198087654321",
"AllowedMods": [
"com.author.infinityhammer"
]
}
]
}
安裝與使用 安裝：BepInEx 外掛
- 本站下載的壓縮包就是模組本體，通常是 BepInEx 外掛（解壓後得到 .dll 或外掛資料夾）。
- 建議流程：用社群模組管理器（如 r2modman）選中本遊戲後匯入該模組，管理器會自動裝好 BepInEx 前置並處理依賴。
- 手動流程：先在遊戲目錄裝好 BepInEx 載入器，再把解壓出的 .dll 或外掛資料夾放進 BepInEx/plugins/。
- 啟動遊戲，BepInEx 控制台會列印載入日誌；確認這個模組出現在日誌裡即為安裝成功。
帶「前置依賴」的模組需要一併安裝，否則不會載入。功能開關通常在遊戲內或外掛自帶的設定檔裡調整。 多人連線時，主機與所有用戶端需要安裝一致的模組。
下面這些內容需要先安裝，否則該模組不會生效：