PvPIndex MCBans icon

PvPIndex MCBans -----

Refactored fork for Global Ban Management




  • VPN detection - AntVPN WebSocket integration (wss://api.antivpn.io/connect). Configured via antivpn.yml (disabled by default). Supports WARN, KICK, and BAN actions on detection. BAN action stores a local ban record. Exponential backoff reconnect (1 s to 30 s cap). mcbans.vpn.bypass permission (default: op) lets trusted players skip the check.
  • Legacy ban import - On player join the plugin queries mcbans.com/api/v2/player/{uuid} and caches any found ban as an is_legacy local record. Subsequent joins skip the network call. Controlled by the new pvpindex.legacy config section (enabled, check-on-join, include-in-bans - all default true).
  • Public kicks - New pvpindex.kicks.public config flag (default false). When enabled, every /kick is posted to the PvPIndex API and shown on bans.pvpindex.com.
Development changes
  • KickRecord and KickRequest DTOs in pvpindex-mcbans-api - other plugins using the JitPack client can now retrieve and submit kicks.
  • Config bumped to ConfigVersion: 4; upgrading servers get their old config backed up automatically.
----------, May 8, 2026

Added
  • Customizable kick messages - kick-message section in config.yml with per-type templates (global, local, temp, failsafe). Supports {reason}, {admin}, {expires}, and {appeal_url} placeholders plus an optional appeal-url appended automatically.
  • Reason presets - reason-presets section in config.yml. Use #key in any ban command to expand to a full reason string (/ban <player> #hacks). Extended form supports a default-duration for use with /tban <player> #preset. Tab-completion suggests preset keys.
  • Preset startup validation - invalid or misconfigured presets (missing reason field, bad duration format) are logged as warnings on load/reload.
  • Case-insensitive preset keys - #Hacks, #HACKS, and #hacks all resolve to the same preset.
  • Improved tab-completion for ban commands - preset #key suggestions appear at the reason position even on empty input (no need to type # first); sorted alphabetically; filtered case-insensitively.
  • /mcbans presets command - lists all configured presets with their reason text and default duration at a glance. Requires mcbans.ban.local.
  • Config bumped to ConfigVersion: 3; upgrading servers get their old config backed up automatically.
----------, May 7, 2026

Resource Information
Author:
----------
Total Downloads: 17
First Release: May 6, 2026
Last Update: May 8, 2026
Category: ---------------
All-Time Rating:
0 ratings
Find more info at docs.pvpindex.com...
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings