Hello and welcome to RedeemMe!
What is RedeemMe?
RedeemMe is a plugin which allows you to generate codes which you can give away so your users can get goodies for them. Right now, every code is one-time-use only, but I think about adding a promo-code like feature too.
Features
- Almost fully customizable.
- You can add as many code "types" as you want, easily editable in the config
- Every code is able to execute specific commands when redeemed.
- Not-so-fancy messages (need to fix that ASAP, just wanted to get a working version out)
How to use?
- Download the plugin.
- Download Vault. (I built the plugin against 1.4.1, i don't know if others work too.)
- Place both in your plugins folder.
- Restart your server.
- Add a new type of codes. (More information about that down this post)
- Restart/Reload the server another time.
- do /generateCode <type> and you will receive your code.
- Give the code to a user and see how happy they are
Commands
- Command | Permission-node (<> neccessary | [] optional)
- /generateCode <type> ["mode"]| redeemme.generate
- /removeCode <code> | redeemme.remove
- /removeAllCodes | redeemme.removeAll
- /redeemCode <code> | No permission node right now
Code Types
Here I will tell you how you can make your own code-types.
Let's look at an example config:
Code (Text):
codeLength: 10
useEconomy: true
useServer: true
server:
ip: 127.0.0.1
password: YouWillNeverGetThisPassword
usePassword: true
codeTypes:
op:
commands:
- /op %USERNAME%
- /say %USERNAME% is now OP!
price: 10
diamond:
commands:
- /give %USERNAME% minecraft:diamond 1
As you can see, right now It's pretty simple. Create a new section in codeTypes with the name of the code, add the "commands" section and add any commands you want into a list there. If "price" is not set, it won't charge any money for the generation of the code.
There are also some placeholders (right now, 3) which are %USERNAME%,%CODE% and %TYPE% which, I think, I don't have to explain.
TODO
- Add per-type generation permission nodes (ex. redeemme.generate.diamond)
(Added in RedeemMe 1.1)- Add Vault support so normal players could pay for generating a code. (Added in RedeemMe 1.2)
- Fix the "broken" command validity checking.
Bugs
It will throw errors when you used the command wrong.
License
This plugin is licensed under the WTFPL.
All the source code can be found here: https://github.com/TheFreakLord/RedeemMe
If you really modify my code, please tell me, you don't have to, but I just want to know if my code helped anyone in any way
Changelog
Version 1.4: Promo codes.
Version 1.3.2-dev: Preparation for promo codes and new way of saving.
Version 1.3.1: Hotfix.
Version 1.3: Added HTTP API.
Version 1.2: Added Economy support.
Version 1.1: Added lang.yml and per-type permission nodes.
Version 1.0: Initial Release.

RedeemMe 1.4
Give away codes for goodies!
Recent Updates
- Promo Codes! Jan 21, 2015
- New code saving. Jan 20, 2015
- Hotfix for a problem stated out by @seriosbrad Jan 19, 2015