RedeemMe

3.1k Downloads

RedeemMe

RedeemMe is a plugin that allows you to create packages which contain items, money, or commands which will be given when the package is redeemed. Packages can be assigned to an individual player or redeemed with a coupon code. Packages can have names, descriptions, creators, embargos, expiry, and be limited to only one server.

Features

  • Create packages which can be redeemed by a single player, or any number of players with a coupon code.
  • Packages can contain money (via vault), items to be given, or commands to be run.
  • Packages can be made only valid after a certain date (embargo), or expire.
  • Packages and coupon codes are redeemed when players want. Your players won't be forced to receive their items when walking over a lava pit.
  • Multi server support. Packages can be made to work on all servers, or be restricted to just one.
  • An API for bukkit plugins is built in. Not coding in java? No problem. You can use PHP or another language to create packages simply by inserting rows into tables. This makes it easy to tie a webstore or similar in.
  • Integration with the strange-weapons plugin for proper item cloning.

Commands

  • /redeem
    • list - shows a list of package ids you can redeem
    • details <id> - shows what you will receive when you redeem a package
    • coupon <code> - redeems a coupon
    • <id> - redeems a package
  • /createpackage - starts a wizard which will walk you through creating a package manually
  • /printcoupon <code> [quantity] - creates a physical item out of a coupon code that can be redeemed by right clicking

Permissions

PermissionDescriptionDefault
redeem.redeemAccess to the /redeem commandtrue
redeem.createpackage.*Grants access to /createpackage with the ability to add money, items, and commands to packages
redeem.createpackage.moneyGrants access to /createpackage with the ability to add money to packages
redeem.createpackage.itemGrants access to /createpackage with the ability to add items to packages
redeem.createpackage.commandGrants access to /createpackage with the ability to add commands to packages
redeem.printcouponGrants access to /printcoupon

Important Note About Permissions

The /createpackage command is a very dangerous command in the hands of the wrong person. Those with the ability to create packages with money will be able to create any amount of money for any player out of thin air. Those with the ability to create packages with items will be able to duplicate any item they have. Those with the ability to create packages with commands will be able to run any command they wish on the server console. Do not grant these permissions to anybody you do not trust. I am going to laugh at you if you gave some random user redeem.createpackage.command and he ops himself and then destroys your server.

Configuration

database:
  url: jdbc:mysql://localhost:3306/database
  username: minecraft
  password: lolololol
  • Set a server-id in your server.properties. This will be how the plugin identifies your server if you are limiting packages to a single server. Max 20 characters.
  • Multiple servers should share the same database.

Requires

  • mySQL. This plugin requires a mysql database. No I do not have plans to add support for storing data in other ways. No I will not help you setup a mysql database. Google is your friend.

Support

Feel free to post a question in the comments, I check this page every so often. Or for faster support, join #kitteh.org at irc.esper.net and ask for Eviltechie. (Or click this link.)

Github: https://github.com/Eviltechie/RedeemMe