DupeUtility

SecVers Dupe Utils

A comprehensive and configurable dupe management plugin for Minecraft servers

Paper 1.21+ | BSD-3 License | Version 2.1

v3.0.0 Release Highlights

What's new in Version 3:

• ✅ Permissions-based dupes across supported methods
• ✅ Multi-language support (English, German, Russian, Chinese, Korean, Japanese)
• ✅ Anti-Illegal system with whitelist items and MBT removals
• ✅ EconomyFix integration (admin abuse items removal, stats, E-Chest support)
• ✅ Crafter dupe support with particle/animation foundations
• ✅ Clean shulker bundle support and event key improvements

Coming Next:

• ⏳ Death dupe rework
• ⏳ TNT hopper dupe
• ⏳ Particle effects options for Item Frame and Grindstone
• ⏳ Additional translations (French, Portuguese, Turkish, Dutch, Czech, Italian)
• ⏳ Plugin name spoof

🌟 FEATURES

6+ Dupe Methods Available:

• Item Frame Dupe - Duplicate items using item frames
• Glow Item Frame Dupe - Enhanced duplication with glow frames
• Donkey Dupe - Kill the Donkey in the given time Frame to dupe the items
• Grindstone Dupe - Grindstone-based item duplication
• Crafter Dupe - Crafter block duplication
• Death Dupe - Duplicate items on death
• ...and more coming soon!

Advanced Configuration System:

• 🎲 Probability System - Set success rates for each dupe method
• ⏱️ Timing Controls - Adjust delay windows for dupes
• 🔧 Per-Dupe Settings - Independent configuration for each method
• 📊 Real-time Adjustments - Changes apply without server restart
• Translations - Add you own Translations!

Professional Features:
✅ Permission-Based UI Access - Fine-grained control over who can use what

🔄 Live Reload - Update configs without restarting

📝 Telemetry System - Optional usage statistics

🔔 Update Checker - Stay informed about new versions

📥 DOWNLOAD & SUPPORT

Official Download:
secvers.org/plugins/dupe-utility

Support Development:
secvers.org/info/donate

Dupe FAQ:
secvers.org/plugins/dupe-utility

🎮 COMMANDS

/dupe\
Description: Show help menu\
Permission: dupeutils.command

/dupe reload\
Description: Reload configuration\
Permission: dupeutils.reload

/dupe config\
Description: Open configuration GUI\
Permission: dupeutils.configdupes

🔐 PERMISSIONS

• dupeutils.command - Base permission to use /dupe
• dupeutils.reload - Permission to reload configs
• dupeutils.configdupes - Permission to open config GUI

⚙️ CONFIGURATION EXAMPLE

Telemetry

We will collect only the current Version, OS, Server Name.

telemetry:
enabled: true # set to false to opt-out
send_interval_seconds: 3600 # optional for repeated sends

Check for Update

checkUpdate: true

FrameDupe:
Enabled: true
Probability-percentage: 100
Multiplier: 1
Ranks:
vip:
Permission: "dupeutils.framedupe.vip"
Multiplier: 2
Probability-percentage: 25
premium:
Permission: "dupeutils.framedupe.premium"
Multiplier: 3
Probability-percentage: 50
admin:
Permission: "dupeutils.framedupe.admin"
Multiplier: 5
Probability-percentage: 100

GLOW_FrameDupe:
Enabled: true
Probability-percentage: 100
Multiplier: 1
Ranks:
vip:
Permission: "dupeutils.framedupe.vip"
Multiplier: 2
Probability-percentage: 25
premium:
Permission: "dupeutils.framedupe.premium"
Multiplier: 3
Probability-percentage: 50
admin:
Permission: "dupeutils.framedupe.admin"
Multiplier: 5
Probability-percentage: 100

Settings:
EnableItemCheck: true
DisableIllegalItem: true

Detailed illegal item detection settings

IllegalItemDetection:

Check for items with Unbreakable tag

CheckUnbreakable: true

Check for stacked items beyond normal stack size

CheckOverstacked: true

Check for enchantments beyond vanilla limits

CheckIllegalEnchantments: true

Check for items not obtainable in survival

CheckUnobtainableItems: true

Allow custom names and lore (for plugins like EssentialsX, etc.)

AllowCustomNames: true
AllowCustomLore: true

Action to take on illegal items

Options: REMOVE, RESET, LOG_ONLY

Action: REMOVE

Automatically fix enchantments instead of removing

AutoFixEnchantments: true

Log illegal items to console

LogIllegalItems: true

Whitelist for specific items that should bypass checks

Whitelist:

• "BARRIER" # Example: Allow barriers even though not survival obtainable
• "COMMAND_BLOCK"

OtherDupes:
GrindStone:
Enabled: false
MinTiming: 1200 # Minimum in ms
MaxTiming: 2200 # Maximum in ms
dropNaturally: true
addToInventory: false
DonkeyDupe:
Enabled: false
MinTiming: 100 # Minimum in ms
MaxTiming: 5000 # Maximum in ms
CrafterDupe:
Enabled: false
MinTiming: 100 # Minimum in ms
MaxTiming: 1000 # Maximum in ms
destroyCrafter: true # Destroys the Crafter after Dupe
dropOriginals: false # Golden Apple, Netherite Block, Torches drop
DropperDupe:
Enabled: false
Multiplier: 2
DeathDupe:
Enabled: false

ItemBlacklist:

• Namespace: "minecraft"

Key: "tnt"
Names: []

• Namespace: "minecraft"

Key: "stone"
Names: []

• Namespace: "exampleplugin"

Key: "specialtype"
Names:

• "test_item"
• "extra_item"

Translation:

Enable translation system

enabled: true

Auto-detect language based on player IP

ipbased: false

Default language (fallback)

default: "English"

Available translations (auto-updated on server start)

translations:

• "English"
• "German"

SecVerse Dupe Utils - Community Translations

How to Create a Translation

1. Copy english.json as a template
2. Rename it to your language (e.g., french.json, spanish.json)
3. Edit the metadata section:

• language: English name of the language
• nativeName: Name in the native language (e.g., "Français", "Español")
• version: Start with "1.0.0"
• author: Your name or username
• description: Brief description
• countryCodes: List of ISO country codes (e.g., ["FR", "BE", "CH"])

1. Translate all strings in the translations section
2. Keep color codes (§a, §c, etc.) and placeholders ({0}, {1}, etc.) unchanged
3. Test your translation in-game
4. Share your translation file!

Supported Color Codes

• §a = Green (success)
• §c = Red (error)
• §e = Yellow (info/value)
• §7 = Gray (description)
• §6 = Gold
• §r = Reset

Placeholders

• {0}, {1}, etc. = Dynamic values that will be replaced
• Example: "Value set to {0}" → "Wert gesetzt auf {0}"

File Format

• UTF-8 encoding
• JSON format
• File name: languagename.json (lowercase)

Contributing

Share your translations on our Discord or GitHub!

🎮 GUI CONFIGURATION

Use /dupe config in-game for easy configuration:

• Left Click - Toggle dupe on/off
• Right Click - Open detailed settings
• Adjust Values - Click concrete blocks to increase/decrease
• Live Updates - Changes apply immediately

🤝 CREDITS & ACKNOWLEDGMENTS

Special Thanks:
@HackThePyramids
Massive help with development, code architecture, and feature
implementation. This plugin wouldn't be where it is without your
contributions! 🙏

Development:\
SecVers Team - Plugin development and maintenance\
Community - Bug reports and feature suggestions

📊 STATISTICS

• 6+ Dupe Methods - More than most premium plugins\
• 100% Free - No paywalls, no limitations\
• Active Development - Regular updates and new features\
• In-Game GUI - No need to edit config files

🐛 BUG REPORTS & FEATURE REQUESTS

Found a bug or have an idea?

1. Check existing issues on GitHub first
2. Create a new issue with:

• Clear description
• Steps to reproduce (for bugs)
• Server version & plugin version
• Any error messages

GitHub Issues: github.com/bunbunconmeow/SecVersDupeUtils/issues

📜 LICENSE

This project is licensed under the BSD-3 License.

⚠️ DISCLAIMER

This plugin is designed for anarchy, creative, or testing servers.\
Use at your own discretion. The developers are not responsible for any
damage to your server economy or gameplay balance.

💬 SUPPORT

Official Website: secvers.org

Plugin Page: secvers.org/plugins/dupe-utility

Donate: secvers.org/info/donate

Email: support@secvers.org

⭐ SHOW YOUR SUPPORT

If you like this plugin, please consider:\
⭐ Starring the GitHub repository\
🐛 Reporting bugs\
💡 Suggesting features\
📣 Sharing with others\
❤️ Donating to support development

Made with ❤️ by SecVers

Download: secvers.org/plugins/dupe-utility
Donate: secvers.org/info/donate

Want to contribute? Check out our Contributing Guidelines!