# DupeDetection - Version Compatibility & Changelog ## 🚀 Current Version: v1.0.1 ### Universal JAR Support **Single JAR works across all supported versions with automatic detection** --- ## 📋 Supported Minecraft Versions ### ✅ **Fully Supported (Paper & Forks)** #### Minecraft 1.21.x Series - **1.21.8** - Latest Paper build *(Recommended)* - **1.21.7** - Paper build - **1.21.6** - Paper build - **1.21.5** - Paper build - **1.21.4** - Paper build - **1.21.3** - Paper build *(Primary test version)* - **1.21.2** - Paper build - **1.21.1** - Paper build - **1.21** - Paper build #### Minecraft 1.20.x Series - **1.20.6** - Paper build - **1.20.5** - Paper build - **1.20.4** - Paper build - **1.20.3** - Paper build - **1.20.2** - Paper build - **1.20.1** - Paper build - **1.20** - Paper build #### Minecraft 1.19.x Series - **1.19.4** - Paper build - **1.19.3** - Paper build - **1.19.2** - Paper build - **1.19** - Paper build #### Minecraft 1.18.x Series - **1.18.2** - Paper build *(Minimum supported)* - **1.18.1** - Paper build --- ## 🖥️ Supported Server Software ### 🟢 **Full Feature Support** | Platform | Versions | Features | |----------|----------|----------| | **Paper** | 1.18.2 - 1.21.8+ | ✅ All features | | **Purpur** | 1.18.2 - 1.21.8+ | ✅ All features | | **Pufferfish** | 1.18.2 - 1.21.8+ | ✅ All features | ### 🟡 **Limited Support** | Platform | Versions | Features | |----------|----------|----------| | **Spigot** | 1.18.2 - 1.21.8+ | ⚠️ Core features only | ### ❌ **Not Supported** - Fabric servers - Forge servers - Vanilla servers - Bukkit (legacy) --- ## 🔄 Version History ### **v1.0.1** *(Current)* - 🆕 Universal JAR support - 🆕 Automatic server detection - 🆕 Runtime compatibility checking - 🔧 Fixed version detection issues - ✨ Single JAR for all supported versions - 📊 Enhanced build system with 35+ version targets ### **v1.0.0** *(Initial Release)* - 🆕 Large stack detection system - 🆕 NBT duplicate detection - 🆕 Discord webhook integration - 🆕 Exception management system - 🆕 Multi-container support - 🆕 Per-item configuration --- ## 🎯 Feature Compatibility Matrix | Feature | Paper | Purpur | Pufferfish | Spigot | |---------|--------|---------|------------|---------| | **Large Stack Detection** | ✅ | ✅ | ✅ | ✅ | | **NBT Duplicate Detection** | ✅ | ✅ | ✅ | ⚠️ | | **Discord Webhooks** | ✅ | ✅ | ✅ | ✅ | | **Exception System** | ✅ | ✅ | ✅ | ✅ | | **Container Detection** | ✅ | ✅ | ✅ | ⚠️ | | **Advanced NBT Checking** | ✅ | ✅ | ✅ | ❌ | | **Real-time Detection** | ✅ | ✅ | ✅ | ⚠️ | **Notes:** - Limited NBT support on Spigot - Basic container support only - Advanced NBT features disabled - Reduced performance on Spigot

# 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 ```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 - **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