VBServerTempBan
A lightweight mod for temporary bans on Valheim servers. Works alongside the standard ban system without affecting permanent bans added by administrators.
模組介紹 作者原文
Русский
Описание
Легкий мод для временных банов на сервере 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
安裝與使用 安裝:BepInEx 外掛
- 本站下載的壓縮包就是模組本體,通常是 BepInEx 外掛(解壓後得到 .dll 或外掛資料夾)。
- 建議流程:用社群模組管理器(如 r2modman)選中本遊戲後匯入該模組,管理器會自動裝好 BepInEx 前置並處理依賴。
- 手動流程:先在遊戲目錄裝好 BepInEx 載入器,再把解壓出的 .dll 或外掛資料夾放進 BepInEx/plugins/。
- 啟動遊戲,BepInEx 控制台會列印載入日誌;確認這個模組出現在日誌裡即為安裝成功。
帶「前置依賴」的模組需要一併安裝,否則不會載入。功能開關通常在遊戲內或外掛自帶的設定檔裡調整。 多人連線時,主機與所有用戶端需要安裝一致的模組。
下面這些內容需要先安裝,否則該模組不會生效: