Simple Redeem Code

Simple Redeem Code is a lightweight, clean, and highly flexible reward code plugin designed for modern Paper servers (Tested on Java 25).

---

Features

• Individual File Structure: Every redeem code gets its own .yml file inside the codes/ folder, keeping your main config.yml clean and organized.
• Console Command Rewards: Execute multiple console commands upon redemption with full %player% placeholder support.
• Per-Code Permissions: Restrict specific codes to certain player ranks (e.g., simpleredeemcode.vip) or leave them open for everyone.
• Dual Limit Controls: Set both global server-wide usage limits and per-player redemption limits.
• Smart Tab Completion: Built-in tab completion for all admin commands to manage codes effortlessly.
• Cross-Play Ready: Fully compatible with Java Edition and Bedrock Edition players via GeyserMC & Floodgate.

---

Commands & Permissions

Player Commands

Command	Permission	Description
/redeem <code>	simpleredeemcode.use	Claims a reward using a redeem code. (Default: Everyone)

Alias: /codeclaim <code>

Admin Commands

Command	Permission	Description
/code create <name>	simpleredeemcode.admin	Generates a new code file in codes/<NAME>.yml.
/code delete <name>	simpleredeemcode.admin	Permanently deletes a code file.
/code list	simpleredeemcode.admin	Displays all currently active redeem codes.
/code reload	simpleredeemcode.admin	Reloads config.yml and re-scans the codes/ directory.

---

Configuration Example

codes/Template.yml

# Permission required to redeem (Leave "" or "none" for everyone)
permission: ""

# Total maximum uses across the entire server (-1 = unlimited)
max-uses: 100

# Current total claims made on the server
current-uses: 0

# Maximum claims allowed per player (-1 = unlimited)
max-per-player: 1

# List of console commands executed upon claim
commands:
  - "eco give %player% 1000"
  - "give %player% diamond 5"

# Player UUIDs who claimed this code (Managed automatically)
claimed-players: []