VBServerTempBan
A lightweight mod for temporary bans on Valheim servers. Works alongside the standard ban system without affecting permanent bans added by administrators.
About this mod Author’s original text
Русский
Описание
Легкий мод для временных банов на сервере Valheim. Работает параллельно со стандартной системой банов, не трогая постоянные баны, добавленные администратором.
Особенности
- Временные баны — указывайте точное время разбана в UTC
- Автоматический разбан — при истечении времени SteamID автоматически удаляется из bannedlist.txt
- Hot Reload — редактируйте файл без перезапуска сервера, изменения применяются мгновенно
- Безопасность — мод управляет только временными банами, постоянные остаются нетронутыми
- Минимализм — простой текстовый формат, никаких лишних зависимостей
Формат файла
Файл расположения: BepInEx/config/VitByr/VBServerTempBan/bantime_list.txt
Формат записи (разделитель — вертикальная черта |):
SteamID64 | UnbanTimeUTC | Причина
Пример:
76564498100122500 | 2026-03-16 15:00:00 | Griefing
Как это работает
- Мод читает bantime_list.txt
- Добавляет SteamID в bannedlist.txt игры
- Каждые 30 секунд проверяет истекшие баны
- При истечении времени — удаляет SteamID из bannedlist.txt
- Постоянные баны, добавленные через консоль, не удаляются
Конфигурация
В BepInEx/config/VitByr.VBServerTempBan.cfg можно настроить:
- Check Interval — частота проверки истекших банов (по умолчанию 30 секунд)
Установка
- Скачайте архив
- Распакуйте в папку BepInEx/plugins/
- Запустите сервер — пример файла создастся автоматически
- Отредактируйте bantime_list.txt и добавьте нужные баны
Важно
- Время указывается только в UTC!
- Мод работает только на сервере, клиентам не нужен
- Не удаляет постоянные баны, добавленные вручную
English
Description
A lightweight mod for temporary bans on Valheim servers. Works alongside the standard ban system without affecting permanent bans added by administrators.
Features
- Temporary Bans — set exact unban time in UTC
- Automatic Unban — when time expires, SteamID is automatically removed from bannedlist.txt
- Hot Reload — edit the file without server restart, changes apply instantly
- Safe — mod manages only temporary bans, permanent ones remain untouched
- Minimalistic — simple text format, no unnecessary dependencies
File Format
File location: BepInEx/config/VitByr/VBServerTempBan/bantime_list.txt
Entry format (separator — vertical bar |):
SteamID64 | UnbanTimeUTC | Reason
Example:
76564498100122500 | 2026-03-16 15:00:00 | Griefing
How It Works
- Mod reads bantime_list.txt
- Adds SteamID to the game's bannedlist.txt
- Checks for expired bans every 30 seconds
- When time expires — removes SteamID from bannedlist.txt
- Permanent bans added via console are not removed
Configuration
In BepInEx/config/VitByr.VBServerTempBan.cfg you can adjust:
- Check Interval — how often to check for expired bans (default 30 seconds)
Installation
- Download the archive
- Extract to BepInEx/plugins/ folder
- Start the server — example file will be created automatically
- Edit bantime_list.txt and add your bans
Important
- Time must be specified in UTC only!
- Mod works server-side only, no client installation needed
- Does not remove manually added permanent bans
Install & use Install: BepInEx plugin
- The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
- Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
- Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
- Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.
Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file. In multiplayer, the host and every client need the same mods installed.
Install these first, or the mod will not work: