banned-ips.json

IP addresses banned from the server. BDS refuses any incoming connection from an address on this list. Endstone's ban-ip command writes and reloads the file in place; the file is created on demand when the first IP is banned.

Use the ban-ip command instead of editing by hand when possible.

Sample

[
  {
    "ip": "192.168.1.100",
    "created": "2026-01-15T12:00:00+00:00",
    "source": "Server",
    "expires": "forever",
    "reason": "spam"
  }
]

Fields

Field	Type	Required	Description
`ip`	`string`	Yes	The IPv4 or IPv6 address to ban.
`created`	`string`	No	ISO 8601 timestamp with timezone offset (`%FT%T%Ez`). When the entry was added.
`source`	`string`	No	Who issued the ban (e.g. `Server`, an operator's name, or a plugin name).
`expires`	`string`	No	ISO 8601 timestamp, or `"forever"` for a permanent ban. Expired entries are pruned on the next ban-list read.
`reason`	`string`	No	Shown to the banned client and written to the server log.

Server commands

Command	Description
`ban-ip <ip> [reason]`	Ban an IP.
`pardon-ip <ip>`	Lift a ban.
`banlist ips`	List banned IPs.

Sample

Fields

Server commands

On this page