Anti-Dupe 3.3

Anti-Dupe is an advanced anti-duplication and inventory-integrity plugin for Paper Minecraft servers.

It combines transaction tracking, UUID protection, inventory scanning, recovery backups, trusted-plugin compatibility, cross-inventory verification, and server security controls while trying to preserve normal vanilla gameplay.

Features

• Transaction ledger and item accounting
• Unique-item UUID tracking
• Stack-safe duplicate detection
• Cross-inventory scanning
• Deep scans and automatic chunk scans
• Trusted shop/plugin compatibility
• Crafting and workstation protection
• Bundle-aware item accounting
• Plugin-managed vault protection
• Custom transfer command monitoring
• Inventory rollback snapshots
• Safe duplicate recovery
• Discord webhook alerts
• Daily rotating logs
• Configurable console verbosity
• SQLite / MySQL / MariaDB / PostgreSQL support
• Velocity / Bungee network support
• World-specific rules
• Exploit fingerprint detection
• OP protection
• Creative Mode protection
• 28 supported locale variants
• bStats support

---

Trusted Plugins

Anti-Dupe can recognize legitimate item transactions from explicitly trusted plugins.

A trusted custom inventory must match both:

1. An approved inventory title.
2. A plugin listed under trusted-plugins.

compatibility:
  external-plugin-inventories:
    enabled: true
    grace-delay-ticks: 4

    trusted-plugins:
      - UltimateShop

    title-patterns:
      - shop
      - store
      - market

⚠️ Trusted Plugin Warning

A trusted plugin becomes part of Anti-Dupe's trust boundary.

If that plugin contains an item duplication or transaction bug, Anti-Dupe may treat the resulting items as legitimate.

Only whitelist plugins you trust and keep the list as small as possible.

---

Vanilla Transaction Protection

Anti-Dupe has dedicated handling for common vanilla item systems, including:

• Player crafting
• Crafting Tables
• Anvils
• Grindstones
• Smithing Tables
• Stonecutters
• Cartography Tables
• Looms
• Villager Trading
• Furnaces
• Blast Furnaces
• Smokers
• Brewing Stands
• Crafters
• Bundles

This helps distinguish legitimate item transformations from actual item creation.

---

Bundle Protection

Items inside vanilla bundles are included in Anti-Dupe's inventory accounting.

Moving arrows from:

Bundle → Cursor → Inventory

does not count as new item creation.

transaction-handlers:
  bundles:
    enabled: true
    delay-ticks: 2
    include-contained-items-in-accounting: true
    recursive-content-check: true

Real bundle duplication that increases the combined quantity can still be detected.

---

Cross-Inventory Protection

Anti-Dupe can compare unique items across:

• Player inventories
• Ender Chests
• Chests
• Barrels
• Shulker Boxes
• Hoppers
• Furnaces
• Minecarts
• Other loaded inventories

High-speed movement protection helps prevent stale container observations during:

• Elytra travel
• Nether travel
• Portals
• Teleports
• World changes
• Fast chunk loading

Suspicious cross-inventory duplicates can require a second live confirmation before quarantine.

---

Safe Recovery

Before removing a confirmed duplicate, Anti-Dupe backs up the complete ItemStack.

plugins/Anti-Dupe/recovery.yml

Commands:

/antidupe recovery list
/antidupe recovery player <player>
/antidupe recovery restore <id>
/antidupe recovery restore <id> <player>

If the backup fails, the item is not removed.

---

Inventory Rollbacks

Anti-Dupe can also save complete inventory snapshots.

/antidupe rollback list [player]
/antidupe rollback snapshot
/antidupe rollback restore <id> [player]

---

Security Guards

Anti-Dupe can optionally restrict OP and Creative Mode access by UUID.

security:
  enabled: false

  op-protection:
    enabled: true
    allowed-uuids: []

  creative-protection:
    enabled: true
    allowed-uuids: []
    fallback-gamemode: SURVIVAL

Manage them in-game:

/antidupe opprot add <player>
/antidupe opprot remove <player>
/antidupe opprot list

/antidupe creativeprot add <player>
/antidupe creativeprot remove <player>
/antidupe creativeprot list

⚠️ Add your administrator UUIDs before enabling security.

An enabled OP whitelist with no UUIDs means nobody is authorized to remain OP.

---

Scanner

Default scan schedule:

Scan	Default
Player Inventories	5 min
Ender Chests	10 min
Loaded Containers	15 min
UUID Cross-Check	15 min
Ledger Audit	30 min

Manual scans:

/antidupe scan all
/antidupe scan players
/antidupe scan ender
/antidupe scan containers
/antidupe scan chunk

---

Discord & Logging

Anti-Dupe supports:

• Discord webhook alerts
• Daily rotating logs
• In-game administrator warnings
• Configurable console verbosity

warnings:
  console: true
  console-verbosity: low

Levels:

off
low
med
high

Changing console verbosity does not disable Discord alerts, recovery records, or daily logs.

---

Database & Network Support

Supported databases:

• SQLite
• MySQL
• MariaDB
• PostgreSQL

Anti-Dupe also includes support for multi-server environments using Velocity/Bungee-style networks, including shared ledger and player-transfer protection.

---

Languages

Anti-Dupe supports 28 locale variants:

🇺🇸 en_US — English
🇩🇪 de_DE — German
🇪🇸 es_ES — Spanish
🇨🇦 fr_CA — French (Canada)
🇫🇷 fr_FR — French (France)
🇮🇹 it_IT — Italian
🇯🇵 ja_JP — Japanese
🇵🇱 pl_PL — Polish
🇧🇷 pt_BR — Portuguese (Brazil)
🇷🇺 ru_RU — Russian
🇹🇷 tr_TR — Turkish
🇺🇦 uk_UA — Ukrainian
🇨🇳 zh_CN — Simplified Chinese
🇰🇷 ko_KR — Korean
🇳🇱 nl_NL — Dutch
🇨🇿 cs_CZ — Czech
🇮🇩 id_ID — Indonesian
🇹🇼 zh_TW — Traditional Chinese
🇸🇪 sv_SE — Swedish
🇳🇴 no_NO — Norwegian
🇩🇰 da_DK — Danish
🇫🇮 fi_FI — Finnish
🇷🇴 ro_RO — Romanian
🇭🇺 hu_HU — Hungarian
🇬🇷 el_GR — Greek
🇸🇦 ar_SA — Arabic
🇮🇱 he_IL — Hebrew
🇮🇳 hi_IN — Hindi

---

Permissions

antidupe.admin
antidupe.notify
antidupe.whitelist
antidupe.recovery
antidupe.rollback
antidupe.security
antidupe.dupe
antidupe.bypass

---

Recommended Setup

Start with:

mode: AUDIT

Test normal server gameplay, especially:

• Crafting
• Shops
• Hoppers
• Bundles
• Ender Chests
• Shulker Boxes
• Vault plugins
• Elytra travel
• Portals
• Teleports
• Custom inventories

Then switch to:

mode: QUARANTINE

when you're confident the server is behaving normally.