Docs · mod build 5.8

Ban Manager

Every active ban, bans by GUID, unbans, limits and sharing.

The Ban Manager shows every active ban on your server, lets you ban anyone by GUID (even after they've left), unban, and share bans with your other servers.

The bans are real bans on Bohemia's ban list for your server, the same list the #ban command uses. They survive restarts, and they include bans made any other way.

Active bans

The list comes straight from Bohemia's ban list, 25 to a page. Each ban shows:

  • the player's name, and the name they were banned under if it's changed
  • the reason
  • when they were banned and who by. Bohemia's list doesn't store that, so Reforgedmin keeps its own copy of every ban it makes. Bans made another way say "not through Reforgedmin".
  • when it ends, or Permanent in red
  • their GUID

Search by part of a name to narrow it down. Unban takes a second click to confirm.

Banning someone

Put in their GUID (it's on their Player Record), a reason, and how long: 1 hour, 1 day, 3 days, 7 days, 30 days, Permanent, or a custom number of hours. Click Ban twice to confirm.

This works whether they're online or not. If they're on the server, they're removed straight away. You can't ban staff ranked the same as you or higher.

On a player's record, Ban... opens the Ban Manager with their GUID already filled in.

Ban limits

The server owner sets the longest ban each rank can give, under Ban limits on this tab. Only owners see that card.

Rank Starts at
Moderators 72 hours (3 days)
Admins No limit
Owners Never limited

0 means no limit, permanent bans included. The same limits apply to Ban on Online Players. Anyone who goes over is told what their limit is.

Sharing bans with your other servers

  1. On the server with the bans, press Export. It writes every ban made through Reforgedmin that's still running to Bans/export.json.
  2. Copy that file to the other server's Bans folder and rename it import.json.
  3. On the other server, press Import (twice to confirm).

Import skips anyone already banned there and any ban that has run out. Timed bans keep the time they had left, so a 7 day ban exported after 2 days imports as 5 days. Imported bans say who made them, with "(imported)" after the name.

Local test servers

A server started from Workbench isn't on Bohemia's backend, so there's no ban list. The tab says so, and bans there only last until a restart.

Permissions

Permission What it allows Starts with
view_bans Open the Ban Manager and see the list Moderators and up
ban Ban, from here and from Online Players Admins and up
unban Unban, and export or import bans Admins and up

Every ban and unban goes in the admin log, on the player's record, and to Discord's Admin used an action event.

The files are in Bans/: settings.json (the limits), bans.json (Reforgedmin's own copy), and export.json / import.json when you share. See Config files.