Redeem+
Support Server – https://discord.gg/DRxwt8Qg2W
Redeem+ lets server owners run giveaways, starter rewards, events, and promotions using redeemable codes. Players enter codes through an in-game UI, while admins manage codes, limits, rewards, console commands, and Discord logging through an admin interface.
Each code supports configurable usage limits, one-time redemption per player, item rewards, optional console commands executed as the server, and automatic Discord webhook logs for every redemption. All data is persisted to JSON, making Redeem+ safe across restarts and updates.
FEATURES
Core
- Code redemption system – Players redeem codes via a clean in-game UI
- Admin code management – Create, edit, and delete codes through an admin UI
- Usage limits – Set codes to single-use, limited-use, or unlimited
- One-time per player – Each player can redeem a specific code only once
- Item rewards – Give any Hytale item with configurable quantities
- Console commands – Optional commands executed as console on redemption
- Persistent storage – Codes, usage counts, and player tracking saved to JSON
- Discord logging – Optional webhook logging for redeemed codes
Player
- Simple redemption UI – Enter a code and claim rewards instantly
- Clear feedback – Success and error messages for all redemption outcomes
Admin
- Admin UI – Manage codes without editing files
- Update-safe – Editing a code preserves existing redemption counts
- Permission-based access – Admin features protected by permission nodes
COMMANDS
/redeem
Open the redemption UI
Permission: none
/redeem admin
Open the admin code manager UI
Permission: redeem.admin
PERMISSIONS
redeem.admin
Required to access the admin UI and to create, edit, or delete redemption codes.
PLAYER USAGE
-
Run /redeem
-
Enter a redemption code (case-insensitive)
-
Click REDEEM
-
Rewards are added to your inventory
-
An error message is shown if the code is invalid or unavailable
ADMIN USAGE – CODE MANAGEMENT
Run /redeem admin
Create or update a code
Code
The exact string players must enter (stored in uppercase)
Max redemptions
Total number of times the code can be redeemed
Use 0 for unlimited
Rewards
Semicolon-separated format
ItemId:Quantity; ItemId2:Quantity
Examples
Ingredient_Bar_Adamantite:1; Ingredient_Bar_Mithril:2
Ingredient_Bar_Adamantite:1; Ingredient_Bar_Mithril:2; Ingredient_Bar_Cobalt:3
If a code already exists, it will be updated while preserving existing redemption counts and player data.
CONSOLE COMMANDS (OPTIONAL)
Admins may define console commands that execute when a code is redeemed.
- Commands are semicolon-separated
- Commands execute as console (admin privileges)
Placeholders
@p or @s – Player name
<uuid> – Player UUID
Examples
money give @p 1000; say @p redeemed a code!
say @p redeemed a code FOR THE FIRST TIME!
EXISTING CODES LIST
The admin UI displays
- Code name
- Current usage
- Maximum usage
- Number of unique players who redeemed the code
Example
WELCOME — 3/10 uses (3 players)
ERROR MESSAGES
Players
- Invalid or unknown code
- You have already redeemed this code
- This code has reached its redemption limit
- Please enter a code
- Code redeemed, but inventory was full
Admins
- You don't have permission to use admin redemption
- Enter a code
- Max redemptions must be a number (0 = unlimited)
- Add at least one reward or console command
DATA STORAGE
Codes are stored in
/Hyronix_RedeemPlus/codes.json
Configuration is stored in
/Hyronix_RedeemPlus/config.json
Files are automatically created and updated when codes are modified or redeemed.
DISCORD WEBHOOK LOGGING
Redeem+ can send redemption logs to Discord.
Configure your webhook URL in
/Hyronix_RedeemPlus/config.json
Example
{
"discordWebhookUrl": "https://discord.com/api/webhooks/YOUR_WEBHOOK_URL"
}
Logged information
- Player name
- Redeemed code
- Rewards received
If the webhook URL is empty or invalid, redemptions will still function normally.
GUIDELINES
- Use clear, memorable codes
- Avoid spaces (codes are normalized to uppercase)
- Use valid Hytale item IDs for rewards
- Set reasonable redemption limits
- Each player can redeem a code only once
- Updating a code does not reset existing usage data
Distribution Notice:
This mod may not be redistributed or bundled with third-party setups without clear and visible credit to Hyronix Studios and the mod name. Otherwise, redistribution is not permitted.
