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
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