🌌 UniRedeem

The Ultimate Universal Redeem Code Plugin for Minecraft networks. Developed with ❤️ by the Univolve team.

UniRedeem is a modern, high-performance, multi-platform redeem code solution. It is built from the ground up to support Spigot, Paper, Purpur, Folia, BungeeCord, and Velocity networks concurrently using a single Universal Jar supporting Minecraft 1.13 through 26.2+ (Chaos Cubed).

---

✨ Features

• ⚡ Multi-Platform (Universal Jar): Single .jar file that runs seamlessly on Spigot, Paper, Purpur, Folia, BungeeCord, and Velocity.
• 🌟 Verified Minecraft 26.2 Support: Built with forward-compatible abstractions verified on Minecraft 26.2 (Chaos Cubed) and older versions down to 1.13.
• 🎮 In-Game Admin GUI: Interactive 54-slot chest interface (/uniredeemadmin gui) to view, manage, and revoke active codes with one click.
• 📦 Batch / Bulk Code Generator: Generate dozens of unique giveaway keys in one command with /uniredeemadmin generatebatch.
• ⌨️ Intelligent Tab-Completion: Full auto-completion for all player and administrative commands across all platforms.
• 🛡️ Anti-Spam & Rate Limiting: Built-in cooldowns (general.cooldown-seconds) to prevent brute-force code guessing.
• 🔒 Anti-Alt & IP Protection: Optional IP address validation to block players from claiming one-time codes on alternate accounts.
• 🌐 Discord Webhooks: Real-time Discord notifications and embeds for redemptions and admin actions.
• 🔊 Audio & Visual Feedback: Configurable sound effects (ENTITY_PLAYER_LEVELUP) and on-screen Titles/ActionBars.
• 💾 Dual-Storage Engine: SQLite (local zero-setup) and MySQL/MariaDB (network synchronization) powered by high-performance HikariCP connection pooling.
• 🔑 Limitation & Expiry System:
  • Max Global Uses: Limit how many times a code can be claimed globally.
  • Max Uses Per Player: Restrict claims per user (e.g. one-time use codes).
  • Expiration (Time-Limits): Expiry dates or countdown durations from code generation.
  • Permission Node Requirement: Require players to hold specific permissions to claim a code.
• ⚙️ Multicontext Multi-Command Rewards: Run multiple commands per code across different execution contexts:
  • [CONSOLE] - Executed by console on the local server.
  • [PLAYER] - Executed by the player redeeming the code.
  • [PROXY] - Forwarded via Plugin Messaging and executed on the Proxy console (BungeeCord/Velocity).
• 🌐 Embedded HTTP REST API Server: Connect your website, Discord bot, or store portal using a secure Bearer token JSON API.
• 🧩 Extensive Placeholders: Supports local placeholders and registers natively with PlaceholderAPI (on Bukkit/Paper).

---

🛠️ Commands & Permissions

Command	Description	Permission	Platform
/redeem <code>	Redeem a code and claim rewards.	None (default)	Bukkit, Bungee, Velocity
/redeem help	View player help menu.	None (default)	Bukkit, Bungee, Velocity
/redeem reload	Reloads plugin configs and database.	uniredeem.admin	Bukkit, Bungee, Velocity
/uniredeemadmin gui	Open interactive in-game code management GUI.	uniredeem.admin	Bukkit, Paper, Purpur
/uniredeemadmin list	List all active codes, uses, and expiration dates.	uniredeem.admin	Bukkit, Bungee, Velocity
/uniredeemadmin generate <args>	Generate a custom redeem code.	uniredeem.admin	Bukkit, Bungee, Velocity
/uniredeemadmin generatebatch <args>	Generate bulk random codes with a shared reward.	uniredeem.admin	Bukkit, Bungee, Velocity
/uniredeemadmin revoke <code>	Deletes/revokes a redeem code.	uniredeem.admin	Bukkit, Bungee, Velocity
/uniredeemadmin reload	Reloads plugin configs and database.	uniredeem.admin	Bukkit, Bungee, Velocity

Generation Examples:

1. Single Code:

/uniredeemadmin generate VIP 50 1 86400 none [CONSOLE] lp user %player_name% parent add vip; [CONSOLE] msg %player_name% Enjoy VIP!

(Generates code VIP with 50 global uses, max 1 use per player, 24-hour expiry, no permission requirement, executing multiple console commands separated by ;)

2. Bulk Giveaway Batch:

/uniredeemadmin generatebatch 20 PROMO 1 1 604800 none [CONSOLE] give %player_name% diamond 10

(Generates 20 unique random keys with prefix PROMO-, 1 global use each, 7-day expiry)

---

🌐 Embedded REST API

Boots an embedded JSON web server on the port defined in config.yml. Secured using Bearer Token authorization header: Authorization: Bearer <secret-token>

Endpoints

• POST /api/generate - Generate code.

  {
    "code": "SUMMER2026",
    "maxGlobalUses": 100,
    "maxUsesPerPlayer": 1,
    "durationSeconds": 604800,
    "permission": "uniredeem.claim",
    "commands": [
      "[CONSOLE] give %player_name% gold_ingot 10",
      "[PLAYER] say I just claimed a Summer Code!"
    ]
  }
  

• GET /api/status/{code} - Retrieve code validity, remaining uses, and expiry details.
• DELETE /api/revoke/{code} - Manually revoke a code.

---

🧩 Placeholders

Use these variables in commands, messages, or through PlaceholderAPI integration:

• Player Related: %player_name%, %player_uuid%, %player_ip%, %player_ping%
• Code Related: %redeem_code%, %code_remaining_uses%, %code_max_uses%, %code_expiry_date%
• Server Related: %server_time%, %server_date%, %server_name%

---

🌟 Support & Dev Credits

UniRedeem is maintained and developed by the Univolve team. Please check our channels for updates, contributions, and bug reports.