Dupe Detection

DupeDetection Plugin

A powerful Minecraft Paper plugin designed to detect and prevent item duplication exploits on your server.

Features

Large Stack Detection

- Detects when players have large amounts of items - Configurable limits for each item type (e.g. max 512 diamonds, 8 netherite ingots) - Checks all storage containers: chests, barrels, hoppers, furnaces, etc. - Counts total items across ALL inventory slots

NBT Duplicate Detection

- Identifies suspicious identical items with same enchantments/modifications - Individual configuration per item type - Smart detection: only flags items with special NBT data (duplicate enchants, names, etc.) - Catches duplication of gear & items

Discord Integration

- Discord webhook notifications with embeds - @everyone mentions - Detailed violation reports with player info, location, and teleport commands - Puts multiple violations from same container into single message 

Exception System

- Excempts specific players or UUIDs from all dupe checks - JSON storage for persistent exceptions - Easy management through in-game commands - Tab completion

Requirements

- Minecraft Version: 1.21.8 - Server Software: Paper (or Paper-based forks) - Java Version: 21+

Installation

1. Download the latest release from [Releases](https://github.com/CassidyMabey/dupedetection/releases) 2. Place the JAR file in your server's plugins/ folder 3. Restart your server 4. Configure the plugin in plugins/DupeDetection/config.yml

Configuration

Discord Setup

discord:
  enabled: true
  webhook-url: "YOUR_DISCORD_WEBHOOK_URL"
  mention-everyone: true
  username: "DupeDetection Bot"

Large Stack Limits

large-stack-detection:
  enabled: true
  action: "WARN"  # LOG, WARN, REMOVE_EXCESS, BAN
  limits:
    DIAMOND: 512
    NETHERITE_INGOT: 8
    ELYTRA: 1

NBT Duplicate Detection

nbt-duplicate-detection:
  enabled: true
  items:
    DIAMOND_SWORD:
      minimum-duplicates: 10
      action: "WARN"
      check-nbt: true  # Only check enchanted swords

Commands

| Command | Description | Permission | |---------|-------------|------------| | /dupedetection info | Show plugin information | dupedetection.admin | | /dupedetection reload | Reload configuration | dupedetection.admin | | /dupedetection limits | Show current stack limits | dupedetection.admin | | /dupedetection setlimit <item> <amount> | Set item limit | dupedetection.admin | | /dupedetection check <player> | Manually check player | dupedetection.admin | | /dupedetection exception add <player> | Add exception | dupedetection.admin | | /dupedetection exception remove <player> | Remove exception | dupedetection.admin | | /dupedetection exception list | List exceptions | dupedetection.admin | Aliases: /dd, /dupedect

Permissions

- dupedetection.admin - Full plugin access (default: op) - dupedetection.bypass - Bypass all dupe detection (default: false)

How It Works

Detection Triggers

- Storage Container Close: Chests, barrels, hoppers, furnaces, etc. - Player Inventory Close: When players close their inventory (5-second cooldown)

Detection Process

1. Player closes container/inventory 2. System scans all items in the inventory 3. Checks against configured limits and NBT patterns 4. Sends Discord notification if violations found 5. Notifies online operators

Stealth Operation

- No player notifications - violators are unaware of detection - Silent monitoring - only admins receive alerts - logging - all activity tracked

Discord Notifications

Embeds notifications include: - Player Information: Name, UUID, avatar - Violation Details: Item types, amounts, limits exceeded - Location Data: Exact coordinates and world - Quick Actions: Teleport command - Container Info: Type of storage block involved