VitByr-VBServerTempBan icon

VBServerTempBan

A lightweight mod for temporary bans on Valheim servers. Works alongside the standard ban system without affecting permanent bans added by administrators.

Last updated 13 hours ago
Total downloads 3
Total rating 0 
Categories Server-side AI Generated
Dependency string VitByr-VBServerTempBan-0.1.0
Dependants 0 other packages depend on this package

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2333 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.2333

README

Русский

Описание

Легкий мод для временных банов на сервере Valheim. Работает параллельно со стандартной системой банов, не трогая постоянные баны, добавленные администратором.

Особенности

  • Временные баны — указывайте точное время разбана в UTC
  • Автоматический разбан — при истечении времени SteamID автоматически удаляется из bannedlist.txt
  • Hot Reload — редактируйте файл без перезапуска сервера, изменения применяются мгновенно
  • Безопасность — мод управляет только временными банами, постоянные остаются нетронутыми
  • Минимализм — простой текстовый формат, никаких лишних зависимостей

Формат файла

Файл расположения: BepInEx/config/VitByr/VBServerTempBan/bantime_list.txt

Формат записи (разделитель — вертикальная черта |):

SteamID64 | UnbanTimeUTC | Причина

Пример:

76564498100122500 | 2026-03-16 15:00:00 | Griefing

Как это работает

  1. Мод читает bantime_list.txt
  2. Добавляет SteamID в bannedlist.txt игры
  3. Каждые 30 секунд проверяет истекшие баны
  4. При истечении времени — удаляет SteamID из bannedlist.txt
  5. Постоянные баны, добавленные через консоль, не удаляются

Конфигурация

В BepInEx/config/VitByr.VBServerTempBan.cfg можно настроить:

  • Check Interval — частота проверки истекших банов (по умолчанию 30 секунд)

Установка

  1. Скачайте архив
  2. Распакуйте в папку BepInEx/plugins/
  3. Запустите сервер — пример файла создастся автоматически
  4. Отредактируйте 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

  1. Mod reads bantime_list.txt
  2. Adds SteamID to the game's bannedlist.txt
  3. Checks for expired bans every 30 seconds
  4. When time expires — removes SteamID from bannedlist.txt
  5. 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

  1. Download the archive
  2. Extract to BepInEx/plugins/ folder
  3. Start the server — example file will be created automatically
  4. 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