RedeemableCodes v2025.12

Build 32c Changelog:

Fix: Fixes an NPE error (doesn't affect usage of the command) with the force redeem command.

Build 32b Changelog (config.yml additions required):

Addition: There is now an extra argument for the force redeem command (true/false), whether or not to respect uses per player.

e.g /forceredeem [ID] [PLAYER] [TRUE] will respect the uses per player and will not redeem the code for the player if they have already redeemed it before. (False will not respect that flag and redeem the code either way).

Add to configuration:

Code:

   forceRedeemCodeAlreadyRedeemed:

   - '&8&m----------------------------------------------+'
   - '  &e&l&oRedeemable Codes &7Error:'
   - '   &8» &fYou have already redeemed this code once! (Forced Redeem)'
   - '&8&m----------------------------------------------+'
   forceRedeemCodeAlreadyRedeemedAdmin:
   - '&8&m----------------------------------------------+'
   - '  &e&l&oRedeemable Codes &7Error:'
   - '   &8» &f$player has already redeemed this code!'
   - '   &f(To bypass this set respectUsagePerPlayer to false)'
   - '&8&m----------------------------------------------+'

Build 32 Changelog (config.yml additions at the bottom):

Addition: You can now use "forceredeem [id] [player]" to forcefully (bypasses all traits) run the code's commands for the user (Permission: rc.forceredeem)
Addition: You can now choose to output bulk created coupons in a .txt file. (e.g /rc copy [ID] [LENGTH] [AMOUNT] [TRUE/FALSE])
Fix: Fixed copy command's error message not including all available arguments.
Fix: Fixed duplicate messages showing when using the copy command via console.
Fix: [API] Fixed CodeRedeemEvent.java not being called.

Configuration Additions (careful not to overwrite existing settings):

Code:

messages:
   forceRedeemNotOnline:
   - '&8&m----------------------------------------------+'
   - '  &e&l&oRedeemable Codes &7Error:'
   - '   &8» &fThe player $player is not online!'
   - '&8&m----------------------------------------------+'
   forceRedeemUsage:
   - '&8&m----------------------------------------------+'
   - '  &e&l&oRedeem &7Options:'
   - '   &8» &f/forceredeem [code] [player]'
   - '   &7(Run the codes command for a player,'
   - '   &7bypasses uses, permissions etc.)'
   - '&8&m----------------------------------------------+'
   forceRedeem:
   - '&8&m----------------------------------------------+'
   - '  &e&l&oRedeemable Codes &7Success:'
   - '   &8» &fYou redeemed &e$code&f! (Forced Redeem)'
   - '&8&m----------------------------------------------+'
   forceRedeemAdmin:
   - '&8&m----------------------------------------------+'
   - '  &e&l&oRedeemable Codes &7Success:'
   - '   &8» &fYou forced $code''s rewards for $player!'
   - '&8&m----------------------------------------------+'

XCoupons has been rebranded to RedeemableCodes (Do not update if you have active servers running with an older version of this plugin).

Build 31 Changelog:

Addition: RedeemableCodesAPI.java is now available.
Addition: CodeRedeemEvent.java is now available.
Addition: New command (xcodes.setperm) that allows to set permission for code redemption (/rc setperm [ID] [PERMISSION]).
Change: Messages have been moved to config.yml.
Change: Usage logger will now also monitor: CODE CREATION/DELETION/SECURE/PERM-BASED/PERM/USES/BULK, COMMAND ADDITION/REMOVAL.
Change: The usage logger now has its own folder & creates daily logs instead of one big log.
Change: Bulk creation command now requires an extra length parameter (length of bulk codes generated).
Change: The bulk creation system now displays codes in a cleaner format and not just in the console.
Fix: Bulk creation only mirroring commands and not other attributes (uses, permissions, etc.).
Fix: Inspect command not showing uses/permission-based & permission.
Fix: List command not working through the console.
Fix: List command not working after a codes purge.
Fix: Copy command not working for non-capital codes.
Fix: Perm-Based command not working for non-capital codes.

Build 30 changelog:

• Some saving/reloading changes have been reverted. In order to create custom coupons (e.g "/redeem santa"), your server must not be running when you are editing the coupons file. To tackle this issue, you can now input a string as the argument when creating a new coupon (e.g "/xcp new santa").
• Fixed an issue with "/xcp list" sometimes showing up as empty instead of displaying the no coupons available message.

Build 29 changelog:

• Per request, I have added a new option that lets you disable autosave messages from being sent to the console as it can get spammy.
• Add this to your configuration:
• Code:

  saveToFile:
     time: 5
     informOP: true
     informConsole: false

Build 28 changelog:

• Fixed an issue that would cause "/xcp reload" not to load in manually-created codes.
• Fixed an issue that would sometimes not load in new codes when the autosave happens.
• Placeholders that can be used in commands have been changed (look at the resource page).
• You can no longer edit the message that's being sent when using "/xcp version", instead you will get a more informative message about the version and if any update is out.

Build 27 Changelog:

• If there is an update available it'll send a message to the console as well as a message to opped players when they join the server.
• Add the following code to your messages.yml
• Code:

  versionCheck:
  - ''
  - '&eXCoupons is running on &a&n%version%&r&e!'
  - ''