ViperX

ViperX

ViperX is a Simple Minecraft Server Plugin for Clearing Player Inventory When Banned.

Overview

ViperX helps server automatically clear certain NBT data when banned such as goods in the inventory obtained via unfair means or a custom NBT tag, handling of which is powered by NBTAPI.

Features

• Clears player inventory data when a ban is applied
• Supports AdvancedBan and LiteBans as well as Vanilla ban system
• Removes custom NBT tags from player data
• Supports custom ban durations and duration presets
• Tracks pending clears
• Provides operator-only configuration menus

Commands

Permissions

Requirements

• Bukkit/Spigot/Paper server
• NBTAPI

Installation

1. Download the latest ViperX release JAR.
2. Place it in your server's plugins/ folder.
3. Install NBTAPI if it is not already present.
4. Start or restart the server.

Configuration

After the first startup, ViperX generates its config files. The current default config includes offline-mode warnings, ban duration presets, playerdata paths, and NBT tags to clear.

# False: Does not warn the currently logged-in admin if the server is in offline mode
# True: Warns the currently logged-in admin if the server is in offline mode
offline-mode-warning: true

global:
  ban-durations:
    # The amount of time the ban duration is allowed to be off by in milliseconds
    grace-period: 100
    # Exact durations that can be matched for inventory clearing
    duration:
      - "1s"
      - "1h"
      - "1d"
      - "1w"
      - "1y"
  # Relative paths to playerdata folders inside each world directory
  playerdata-path:
    - "playerdata"
    - "players/data"

  # NBT tags that are removed from player data
  NBT-Tags:
    - "Inventory"
    - "EnderItems"

Changelog

See CHANGELOG.md for release notes and version history.

Authors

• NotNightSky