MineCoupon
MineCoupon
MineCoupon allow you to issue coupons. For each coupon, a code is generated that can be passed to one or more users. The user can simply enter the code and then the plugin executes the specified command.
System Requirements
- MineCoupon is ready for CraftBukkit 1.5.2 R1.0.
- MySQL Database (recommended)
Installation
- Copy MineCoupon.jar in your plugin directory
- Resart your server
- If needed: edit or replace config.yml to change the language
- Select the database type (sqlite or mysql)
- Fill in the accessdata for your MySQL database if selected
- If you don't want to install PluginMetrics set allowpluginmetrics: false
- Restart your server
Permissions
Type InGame: /coupon to get help.
- Allows users to redeem their coupon: minecoupon.use
- Allows users to list all coupons: minecoupons.list
- Allows users to create coupons: minecoupon.create
- Allows users to remove coupons: minecoupon.remove
- Check for Updates during join: minecoupon.checkupdate
(minecoupon.checkupdate is for Admins or OP's. The players with this permission will check for Updates when they join. Update won't be downloaded. It only gives a message.)
Commands
Type InGame: /coupon to get help.
- Apply Coupon: /coupon <couponcode>
- Create Coupon: /coupon create <applications> <valid_trough> <command> <multible_use>
- List Coupons: /coupon list
- Remove Coupon: /coupon remove <couponcode>
- <applications> ... How many times the coupon can be used. (use -1 for ∞)
- <valid_trough> .... Timeto make the coupon invalid (use second, minute, hour, day, week, month - e.g: 2week)
- <command> ....... Command that should be executed when redeeming. (instead of SPACE use ?)
- <multible_use> ....... Let the same player use the coupon multible times (parameter can be: true, false)
- To get playername in command use %player%
- To set more commands use ; - e.g: money?give?%player%100;op?%player%
e.g: /coupon create 1 1week deop?noch false This creates a coupon that can be used once. If the code is entered before 1 week after generation the command "deop noch" will be executed.
Information MineAdmin Collects
In order to offer some comfort features the plugin needs to collect data. In this part we will disclose all types of information collected by MineAdmin.
Check for Updates feature
Every time a permitted user enters the server MineAdmin checks if a newer version is available.
- Collected information: Pluginversion
- Information gets transmitted to: inapp.xtrsource.com
- The Webapp generates an answer (a simple string) that is read by the plugin. Nothing of the transmitted information is stored on our servers.
- To disable this function remove the permission (minecoupon.checkupdate) or set allowcheck_update: false in the config file.
Plugin Metrics
MineAdmin uses PluginMetrics in order to let us operate effectively and provide you the best plugins, services and experiences we can.
- PluginMetrics is a standard library that is also used by many other plugins. It collects anonymus data and transmitts it to mcstats.org.
- The collected data is displayed under: http://mcstats.org/plugin/MineCoupon
- To disable this library visit the PluginMetrics folder and set opt-out: true in the config file. (setting allowpluginmetrics to false in MineCoupon config. will prevent MineCoupon of creating a PluginMetrics folder and using the library if there are no other plugins - e.g. Essentials, LWC, dynmap, Vault, AuthMe, ChestShop, LogBlock - using PluginMetrics installed.)
Where do I get help?
- Create a ticket here at Bukkit (I'm looking forward to give you more options)
Languagefiles
- German: Download
- Spanish: Download (translated by yNeolh)
- Dutch: Download (translated by smeagleee)
- Simplified Chinese: Download (translated by zestybaby)
- Romanian: Download (translated by Florinmohican)
ToDo List
- Make create command more userfriendly
IMPORTANT
The old command /mc isn't used any more. Now it is /coupon.
@Btpatton
Fixed it by saving the config while the server was off. You can't reload the plugin for the config to update, it'll simply revert to the previous config.
Is anyone having issues with the config reverting back to its previous state after a server restart?
@PunJedi
The plugin checks only the first string after /mc. If this dosn't match with create, remove or list it interprets this string as coupon code. So if you type reloaf (which is not required) the plugin wants to use reloaf as couponcode.
Ok I see that it would actually be /mc create 1 1day give?%player%?bread?3
but where do I create the coupon code from? doing /mc reloaf just says invalid coupon code as I haven't set it yet. do I set it in the /mc create ?
Thank you
I am being a bit crazy and live testing this on our large server :) So before I mangle something while everything looks good. I want to make my first coupon.
I want it to be available to everyone, and to give out 3 bread one time...
Am I right in thinking it would be....
/mc reloaf then do /mc create 1 1day give?bread?3?%player%
??
Hi, please solve my ticket: http://dev.bukkit.org/server-mods/minecoupon/tickets/2-cannot-startup/ . Thanks
@yNeolh
Thank you! That's a great help!
@thomasraith
Excelent! Yeah it's what I mean! Thanks! Very Great Plugin! Here I give you an Spanish Translation, It have some modifications but you know what is the translation:
@yNeolh
Thank you for the information. Bug is fixed. (Version 1.4)
The plugin is great, but there is a crazy bug. The commands are executed by the player... And it should be executed by console. Because then there is not reason to get a coupon.
Thanks for all. Waiting for an update!
@Tombikos
Added. You can use %player%. (Version 1.2)
And yeah, another would be great: some variable representating name of the player who used the coupon (for example iConomy i will create /mc create 20 1d money?give?%player%?5000). Thx
Cool, thanks!
@Tombikos
I've added this function. Simply download v1.1!
it would be great if the user can reedem the coupon just once.