RedpixCC

RedpixCC - Premium Code Redemption System

A complete and professional code system for Minecraft Folia/Paper servers that allows administrators to create a flexible reward system with redeemable codes.

🎯 Key Features

Code Management

• Code Creation: Authorized players can create random 5-digit codes
• One-Time Redemption: Each code can only be redeemed once per player
• Auto-Expiration: Codes automatically expire after 7 days
• Permission System: Only admin-authorized players can create codes

Reward System

• Flexible Rewards: Any items can be configured as rewards
• Probability-Based: Each reward has an individual chance (1-100%)
• Random Selection: Players receive 3 random rewards when redeeming
• Weighted Distribution: Items with higher probability appear more often

Intuitive GUIs

• Code Management GUI: Clear overview of all authorized players
• Reward GUI: Easy adding, editing, and removing of rewards
• Drag & Drop: Simply drag items into GUI to add rewards
• Live Editing: Adjust probabilities directly in the GUI

📝 Commands

Admin Commands (/code)

• /code allowcode <Player> - Grant code creation permission
• /code remove <Player> - Revoke code creation permission
• /code check <Player> - View all codes from a player with statistics
• /code delete <Player> - Permanently delete all codes from a player
• /code gui - Open the management GUI
• /code reload - Reload configuration (no restart required)

Player Commands

• /mycode create - Create a new redeemable code (authorized players only)
• /vcode <Code> - Redeem a code and receive rewards

✨ Highlights

Smart Code Management

• Automatic cleanup of expired codes
• Self-redemption protection (players can't redeem own codes)
• Tracking: Who redeemed which code and when
• Statistics: View redemptions per code

Reward GUI Features

• Right Click: Manually enter probability (1-100%)
• Middle Click / Q: Cycle through preset values (10% → 25% → 50% → 75% → 100%)
• Shift + Left Click: Remove reward and return to inventory
• Persistent Items: Rewards stay saved and don't disappear

Player-Friendly

• Clear, color-coded messages
• Helpful error messages
• Clean code display
• Visual confirmation on successful redemption

Server Performance

• Folia-Compatible: Optimized for modern multi-threaded servers
• Efficient YAML data storage
• No database required
• Minimal server load

🎮 Use Cases

For Content Creators / YouTubers

Create codes for your community containing exclusive items, resources, or special rewards. Perfect for giveaways!

For Event Servers

Distribute codes during events that participants can redeem for prizes.

For Network Servers

Reward players with special codes for achievements, survey participation, or as compensation.

For Marketing / Promotion

Distribute codes via social media, Discord, or other platforms to attract new players.

🔧 Technical Details

• Minecraft Version: 1.21.4
• Server Software: Folia
• API Version: 1.21
• Java Version: 21
• Dependencies: None (standalone)

📦 Installation

1. Download RedpixCC.jar
2. Copy the JAR to your server's plugins/ folder
3. Restart the server
4. Configure rewards via /code gui
5. Grant permissions with /code allowcode <Name>

🛡️ Security

• Protection against duplicate codes
• Prevents multiple redemptions by the same player
• OP permission required for admin commands
• Secure data storage with UUID tracking

🚀 Performance

• Asynchronous data management
• Optimized code generation
• Efficient caching
• Minimal RAM usage

🌐 Languages

Default language: English

---

Perfect for servers of any size - From small community servers to large networks!

📸 Screenshots

🐛 Bug Reports & Support

Found a bug or need help? Create a Ticket on Discord Redpix.net!

⭐ Support the Project

If you like this plugin, please leave a star and share it with others!