https://github.com/minetest-mods/xban2

Extended Ban Mod for Minetest
https://github.com/minetest-mods/xban2

administration ban minetest-mod

Last synced: about 1 month ago
JSON representation

Extended Ban Mod for Minetest

• Host: GitHub
• URL: https://github.com/minetest-mods/xban2
• Owner: minetest-mods
• License: bsd-2-clause
• Created: 2014-05-20T02:24:46.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2023-09-11T18:49:22.000Z (about 1 year ago)
• Last Synced: 2024-09-27T08:43:49.206Z (about 2 months ago)
• Topics: administration, ban, minetest-mod
• Language: Lua
• Size: 33.2 KB
• Stars: 15
• Watchers: 5
• Forks: 22
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        

# Extended Ban Mod for Minetest

This mod attempts to be an improvement to Minetest's ban system.

* It supports normal bans and temporary bans (from 60 seconds up to the end of

  time, with 1 second granularity).

* Records and joins all accounts using the same IP address and several IP

  addresses using the same name into a single record, and can ban/unban them as

  a single user.

* Can ban offline players if you know their IP or username.

* Holds a record of bans for each user, so moderators and administrators can

  consult it to know if a player is a repeat offender.

* Does not modify the default ban database in any way (`ipban.txt').

* Has an API to ban and check the ban database to allows other mods to manage

  users (for example, anticheat mods).

## Chat commands

The mod provides the following chat commands. All commands require the `ban`

privilege.

### `xban`

Bans a player permanently.

**Usage:** `/xban  `

**Example:** `/xban 127.0.0.1 Some reason.`

### `xtempban`

Bans a player temporarily.

**Usage:** `/xtempban   `

The `time` parameter is a string in the format `` where ``

is one of `s` for seconds, `m` for minutes, `h` for hours, `D` for days, `W`

for weeks, `M` for months, or `Y` for years. If the unit is omitted, it is

assumed to mean seconds. For example, `42s` means 42 seconds, `1337m` 1337

minutes, and so on. You can chain more than one such group and they will add

up. For example, `1Y3M3D7h` will ban for 1 year, 3 months, 3 days and 7 hours.

**Example:** `/xtempban Joe 3600 Some reason.`

### `xunban`

Unbans a player.

**Usage:** `/xunban `

**Example:** `/xunban Joe`

### `xban_record`

Shows the ban record on chat.

**Usage:** `/xban_record `

This prints one ban entry per line, with the time the ban came into effect,

the expiration time (if applicable), the reason, and the source of the ban.

The record is printed to chat with one entry per line.

**Example:** `/xban_record Joe`

### `xban_wl`

Manages the whitelist.

**Usage:** `/xban_wl (add|del|get) `

Whitelisted players are allowed on the server even if it's otherwise marked

as banned. This is useful to only allow certain users from shared computers,

for example.

The `add` subcommand adds the player to the whitelist. The `del` subcommand

removes the player from the whitelist. The `get` subcommand checks if the

player is in the whitelist, and prints the status to chat.

**Example:** `/xban_record add Jane`

### `xban_gui`

Shows a form to consult the database interactively.

**Usage:** `/xban_gui`

## Administrator commands

The following commands require the `server` privilege, so they are only

available to server administrators.

### `xban_dbi`

Imports ban entries from other database formats.

**Usage:** `/xban_dbi `

The `importer` argument specifies from which database to import. These are

the supported import plugins at the time of writing:

* `minetest`: Import entries from Minetest's ban list (`ipban.txt`).

* `v1`: Old format used by xban (`players.iplist`).

* `v2`: Old format used by xban (`players.iplist.v2`).

**Example:** `/xban_dbi minetest`

### `xban_cleanup`

Removes all non-banned entries from the xban db.

**Usage:** `/xban_cleanup`