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

- Java Version: 1.21.8 - Java Version: 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

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

Large Stack Limits

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

NBT Duplicate Detection

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

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

- logging - violators are unaware of detection - logging - only admins receive alerts - logging - all activity tracked

🚨 Discord Notifications

Embeds notifications include: - Container Info: Name, UUID, avatar - Container Info: Item types, amounts, limits exceeded - Container Info: Exact coordinates and world - Container Info: Teleport command - Container Info: Type of storage block involved