Automotive Blog

Coupons - The Most Efficient Voucher Plugin





Here is more details about www.autoblog.com

Coupons - The Most Efficient Voucher Plugin 3.0.0-LEGACY-1

Tested Minecraft Versions:

1.7

1.8

1.9

1.10

1.11

Contributors: Finity - Artwork

Coupons is a very simple, easy to use and efficient Voucher plugin that has a multitude of different features. The configuration is very easy to understand, and allows the creation of unlimited Coupons with unique aspects tied to each. Coupons is one of the best Voucher plugins freely available and is the only one on Spigot (at least, that I know of) that has great server version detection and fully supports the off-hand. Once a Coupon is redeemed, you can do a ton of different things using our Action based reward system, that comes with over 10 unique Actions!

Coupons uses 1 deprecated method. Support for lower versions will be dropped when Spigot removes them. I do not plan on ever adding support for lower versions. Either update or use the version pertaining to that of your server!

Wow, that sounds amazing, what are some of your Features?

Glad you asked! With Coupons, you are almost 100% able to customize the entire plugin to your liking! Below you can find a list and a brief description of what our plugin offers!

- Unlimited Coupon creation! We have developed a system that allows you to truly create an unlimited amount of Coupons (not 999!). This was added just to test my capability, I doubt anyone would have more than 999 Coupons, anyway. But, if you want to be that one person, you can!

- Complete item customizability! You can define a unique item (Material, Data, Name, Lore and Enchantments [even adding the Enchantment Glow) for each Coupon! Our ItemStack creator returns the item as it is created in the configuration, and does NOT use any NBT data! That means you can add your Coupon to your virtual chest from another plugin, and it will still work when you take it out!

- Advanced limiting system! You have the option to define whether or not you would like to use a limit, and if you choose to, you can even define the limit per Coupon! Whilst this is very simple to use, it is advanced because of the way it is coded. We had maximum efficiency in mind when creating this feature, and have devised a very efficient way! Your server will NOT lag, even if 100 or more players try and redeem a Coupon at the exact same time!

- Amazing Action system! When a player redeems a Coupon, you can use a multitude of different Actions (defined below), rather than just executing console based commands. Every Action has a placeholder for the Coupon ID and the player who redeemed its name.

Wow, that's amazing! I can't wait to get started! What commands do you have?

I had originally planned to add 2 extra commands. Who knows, they may get added in the future! Anyways.

- /coupons - Executing this command will simply return a customizable message explaining to the executor what the other commands are, what they each do. The permission to execute this command is coupons.commands.help .

- /coupons reload - Executing this command will save every single configuration file inside of the Coupons data folder (config.yml, and data.yml). It will then update all the internals and load any new changes without ever restarting or reloading your entire server. Due to the nature of the plugin, I would advise restarting whereever possible as reloading may cause some issues. The permission to execute this command is coupons.commands.reload .

- /coupons list - Executing this command will return a non-customizable message informing you how many unique Coupons have been created and what each of their IDs are. This is useful for the give or giveall commands, as you will not have to go and look at your configuration file in order to find their IDs. The permission to execute this command is coupons.commands.list .

- /coupons give %player% %coupon% %amount% - Executing this command will give the specified player (%player%) a certain amount (%amount%) of Coupons (%coupon%), if the specified Coupon exists. The permission to execute this command is coupons.commands.give .

- /coupons giveall %coupon% %amount% - Executing this command will give everyone online a certain amount (%amount%) of Coupons (%coupon%), if the specified Coupon exists. The permission to execute this command is coupons.commands.giveall .

In order for players to be able to attempt to redeem a Coupon, they need the permission coupons.redeem.%coupon% . where %coupon% is replaced with the Coupon ID in question.

Aside from using /coupons . the following aliases are also available: /coupon .

Great! I've got the commands and permissions noted! Just how easy is the configuration?

Coupons was developed with ease of use in mind! That means the configuration file is very easy to use, even for the newest of server owners!

When you first load up Coupons on your Minecraft server, it will generate a data folder with 2 YML/YAML files. Inside of the config.yml file, you will be able to define, edit and remove your Coupons. Inside of the data.yml file, you will be able to view how many times a player has redeemed a specific Coupon. You can edit the values in there, but it is NOT recommended, as a simple spacing error can corrupt the whole file and cause you to lose all redeems.

SpoilerTarget"> Spoiler: config.yml

coupons: 'example': item: type: "PAPER" data: 0 name: "&e&lExample Voucher &r&7(Right Click)" lore: - "&fRight click me to redeem the" - "&e&lExample Voucher" enchanted: true enchantments: - "DAMAGE_ALL;5" settings: useLimit: true limit: 3 actions: - "[message] &f[&bCoupons&f] &eYou have redeemed the Example Coupon!" - "[broadcast] &e%player% has redeemed the Example Coupon!" - "[player] me redeemed the Example Coupon!" - "[console] msg %player% You have redeemed the Example Coupon!" - "[op] gamemode 1" - "[sound] BLOCK_ANVIL_USE;10;1" - "[soundbc] ENTITY_CAT_PURR;10;1" - "[item] DIRT;0;10" - "[xp] 20" - "[potion] ABSORPTION;1;20" - "[teleport] world;0;150;0;0;0" - "[title] 2;5;2;&cYou have redeemed the; &c&lExample Coupon"


Read more Look at this site

messages: noPermission: "&cYou do not have the required permissions to perform this action!" noPermissionCoupon: "&cYou do not have the required permissions to redeem the %coupon% Coupon!" noCouponFound: "&cA Coupon with the name %coupon% does not exist!" notANumber: "&c%number% is not a number!" playerNotOnline: "&cThat player (%player%) is offline!" atRedeemLimit: "&cYou have reached the redeem limit of %limit% for the Coupon %coupon% (Redeems: %used%)!" argumentError: "&cYou have specified an incorrect argument!" reloadSuccess: "&aSuccessfully reloaded the plugin!" receivedCoupon: "&aYou have received %amount% of the %coupon% Coupon from %sender%!" gaveAllCoupon: "&aYou gave everyone online %amount% of the %coupon% Coupons!" gaveCoupon: "&aYou gave %player% %amount% of the %coupon% Coupons!" help: - " " - "&bCoupons &lv%version% &7- &6By GiansCode" - " " - "&a/coupons &f- &cReceive this message" - "&a/coupons list &f- &cList all of the created Coupons" - "&a/coupons reload &f- &cReload the configuration file" - "&a/coupons give %player% %coupon% %amount% &f- &cGive %player% %amount% of the %coupon% Coupon" - "&a/coupons giveall %coupon% %amount% &f- &cGive everyone online %amount% of the %coupon% Coupon" - " "

SpoilerTarget"> Spoiler: data.yml

Empty upon first startup. This file is used purely to store data. MySQL support will be coming in the near future.

Please put your configuration into a YAML Parser before running it on your server. If you've made a YAML error, the config will erase itself and you will have to start again. Backing up the files after altering them but before restarting or reloading your server is highly recommended.

Awesome! I've got the hang of it! You said you had multiple Actions, what are they?

Just a heads up, you can use each Action as many times as you'd like to in each Coupon! There is no hard coded message sent to the player when they redeem a Coupon, as you can send as many as you'd like to using one of our Actions! Remember, there is a player variable (%player%) as well as a Coupon ID variable (%coupon%)!

[message] - Sends a message to the player

[broadcast] - Broadcasts a message to the entire server

[player] - Executes a command as the player

[console] - Executes a command as the console

[op] - Executes a command as the player as if they were OPd

[sound] - Plays a sound for the player

[soundbc] - Plays a sound for everyone online

[item] - Gives the player an item

[xp] - Gives the player some XP

[potion] - Gives the player a potion effect

[teleport] - Teleports the player to a different location

[title] - Sends a title and subtitle to the player

When adding an Action, please ensure you have a space after the identifier !

Coupons - The Most Efficient Voucher Plugin places to get my oil change near me

Sounds are added in the following way SOUND;VOLUME;PITCH

Items are added in the following way MATERIAL;DATA;AMOUNT

Potion Effects are given in the following way EFFECT;LEVEL;DURATION

Teleports are added in the following way WORLD;X;Y;Z;PITCH;YAW

Titles are added in the following way FADEIN;STAY;FADEOUT;TITLE;SUBTITLE

What happens if I find a bug or 2?

As version 3 is still in it's first LEGACY stage, there may be a few bugs. If you do happen to find a bug, please report it and i nclude all steps to recreate it, your configuration file, the version of Coupons you are using, and any stacktraces if any . I will NOT look at your request if the above is not included.

What's to come in the future?

Glad you asked! Currently, I have plans to add the following:

An [actionbar] Action (with support for lower versions)

A [json] Action (with support for lower versions)

A chance system, so, each Action can have a certain chance

A delay system, so, each Action can have a set delay

Permission based rewards, so, players with a unique permission will execute different actions.

WorldGuard region support, so players can only redeem a certain Coupon in set regions

World support, so players can only redeem a certain Coupon in set worlds

Vault support, so we can charge players for redeeming a certain Coupon

TokenEnchant support, so we can charge players for redeeming a certain Coupon

XP support, so we can charge players for redeeming a certain Coupon

A simple API system to make getting Coupon data a lot easier

If you have any ideas, be sure to let me know!

Wow! This is an amazing plugin for server owners! Did you forget about us developers?

Coupons was made to be as Developer friendly as possible! We have various different things you can obtain and use in your plugin!

First off, we have a Custom Event that you can listen to. This event is called AFTER a player has SUCCESSFULLY redeemed a Coupon.

Upon listening for this Event, you can obtain the RedeemedCoupon object, which allows you to get the following:

- The Player who redeemed the Coupon. Returned as a Player Object .

- The item pertaining to the Coupon. Returned as an ItemStack .

- Whether or not there was a redeem limit. Returned as a Boolean .

Coupons - The Most Efficient Voucher Plugin oil change and tire rotation coupons

- If there was a redeemed limit, what it was. Returned as an Integer .

- How many times the player has redeemed this Coupon. Returned as an Integer .

If you do not need to listen to the Event, you can create a Coupon Object whereever possible.

You can define which Coupon you want to obtain information from using the following:

- String - This will be the Coupon ID defined in the configuration.

You can get the following data from the Coupon Object :

- The item pertaining to the Coupon. Returned as an ItemStack .

- Whether or not there was a redeem limit. Returned as a Boolean .

- If there was a redeemed limit, what it was. Returned as an Integer .

In the future, you will be able to create new Coupons from within your plugin!

Coupons - The Most Efficient Voucher Plugin oil chane

Sick plugin! And, it's FREE. How can I support you?

Please note, supporting is 100% OPTIONAL . I will continue to update the plugin and provide support to the best of my ability. However, if you are willing to support me, you can do so in the following ways:

- By purchasing one of my Premium plugins - This is the preferred way. You may not have a need for the plugin now, but, who knows, in the future you might.

- By donating directly to me via PayPal - This can be done very easily via my PayPal.me !

Thanks for checking out my resource! Be sure to give it a good rating if you found it useful! ​