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

Command	Description
/viperx	Opens the main menu for operators; non-operators are sent to the public links menu
/vx	Alias for /viperx

Permissions

Permission	Description	Default
viperx.menu.*	Grants access to all ViperX menus	op
viperx.mainMenu	Opens the main menu	op
viperx.settings	Opens the settings menu	op
viperx.pending	Opens the pending clears menu	op
viperx.links	Opens the public links menu	true
viperx.banMenu	Opens the ban duration menu	op

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