TokenShop
![]()
Description
TokenShop allows server owners to create the server of their dreams without the having to pay for custom plugins. A plugin started that only handled voting; now leveling the playing field everywhere! This allows your players to vote, and then be rewarded for their effort, whats that? You're tired of giving players the same thing over and over and a boring thank you message? Your players mean more to you than that, so prove it! TokenShop allows you to create custom shops, with interfaces, for them to spend their 'Tokens' from voting in powered by Votifier, or turn that off and use your own! Now these aren't any old boring shop, your imagination is your limit! This allows you to customize every little bit of the shop! Here's a few for example: Shop size, shop names, item names, item colors, item lore, commands on purchase, broadcast messages, private messages! Literately anything you can imagine! And even within your customization there is more customization!!! But how do they access these wonderful stores? Simple, signs and commands; and even the signs are totally customizable because your sever is special and different not just another! Oh and did I mention there can be technically infinite shops? Because limits are dumb! Speaking of limits what if I told you these wonderful features also can hook into vault and allow you to create admin shops!? Yes, your economy plugin totally compatible! Why using boring admin shop signs when you could make an amazing store with interfaces?!
Now because you shouldn't be limited on what you can do, there is even the world's easiest kit system built in. Less time typing in long boring codes for kits and more time making your server the best it can be! The kit system has a cool down system built in and all kits can persist through a server shut down or restart, so no worries there. And of course not that you'd need to ask by now but the players can purchase kits in the stores with their tokens or even buy permissions for new ones; whatever you feel you need to do!
Ever seen a server where they have those fancy items that allow you to teleport from lobby to lobby? Or navigate menus? Yup, you have that now too, except yours is more customizable and its free! And of course you also could just use this system to navigate through shops because you're just cool like that. Or because you can do them both... twice!
Now I bet you're thinking: What about all the permissions and crazy config files!? Don't worry permissions are all simple and very dynamic meaning they are tailored to how you setup your shops, making life easier for everyone! And configs? Each shop has its own config file, generated by you and you only have to put in what you want, lets not waste your precious time. And the main config? Fill it out once and good to go! And in case you ever feel lost, there is a readMe included to help even more!
There is too many features to go over here! But I will quickly mention there is also a server broadcaster, a donation and voter assistant command!
Commands
- /givetok [PlayerName] [#OfTokens] - Gives PlayerName NumberOfTokens
- /tokens - Tells player how many tokens they have.
- /token - Tells player how many tokens they have.
- /enchantcode - Gives you the EnchantCode for the item in your hand.
- /openshop [ShopName] - Opens up GUI for ShopName
- /market [MarketName] - Opens up GUI for MarketName
- /createkit [KitName] [KitCoolDownTimer] - Creates a kit with a cool down of CoolDownTimer
- /kits - Displays all the kits you have access to.
- /kit [kitname] - Gives player KitName, if not on cooldown and has permission.
- /vote - Displays the Voting websites for the server.
- /donate - Displays the website for donating to the server.
- /regenconfig - Will regen the config file. Must have permission.
- /deletekit [KitName] - Deletes kit KitName.
- /editkit [KitName] [CoolDown/kit] <Time in seconds for cool down> - Edits either kits contents or kits cool down timer.
- /ConfigReload - Reloads the config file.
- /ReloadShop [ShopName] - Reloads shop file for [ShopName].
- /ReloadMarket [MarketName] - Reloads market file for [MarketName].
- /shop - Will open the default shop, if supported.
- /store - Same as /shop.
Creating your shops
I've made a compilation of pages to help you easily find the topic you are looking for! Just go to the top of the page and click on the tab 'Pages' and just look under Shop Creation for all your needs! Or here's the link: http://dev.bukkit.org/bukkit-plugins/tokenshop/pages/
Config
After you've put the plugin on your server, in the TokenShop folder there will be a readMe.yml which goes deep into explanation of how to use the simple config file. If you can't find what you need check the pages tab on this page! If you still need help feel free to send me a PM!
Permissions
- OP will have all permissions by default.
- tokenShop.admin - Contains permissions openShop, createShop, and createKit and use the /givetok, /regenconfig commands.
- tokenShop.openShop - Permission for a player to use the /openshop command.
- tokenShop.createShop - Permission for a player to create shop signs.
- tokenShop.createKit - Permissions to create and edit kits.
- UseShop.[shopName] - Permission for a player to access shop [ShopName].
- tokenShopKits.[kitName] - Permission for a player to use kit [KitName].
- UseShopVault.[shopName] - Permissions for a player to access VaultShop [ShopName].
- NOTE: tokenShop.openShop still requires a player to have permission to use a shop! Doesn't override UseShop.[shopName]!
Get Latest Builds
- If you want the latest versions use the links below! (Jenkins will be posted soon!)
- Stable:
- DevStable(May be buggy!):
Extra Notes
- I would like to thank @45zeldafan for helping me bug test.
- This plugin was originally created for: Empire Craft - play.empire-craft.com
- Need to get a hold of me? Use that wonderful PM system or leave a comment below!
Buy Me A Pizza or Soda
I do always appreciate donations! They help me have more time to work on plugin creation or updates!
PLEASE READ
TokenShop is currently going under some major renovations to make it much more useful to not only server owners but also fellow programmers who want more out of their plugins! Please be patient with the next few versions as much change is coming!

-
View User Profile
-
Send Message
Posted Dec 14, 2013Is it just me, or is the plugin not working? I cannot launch it on my server. It says it cannot load plugins/tokenshop.jar in folder 'plugins'
-
View User Profile
-
Send Message
Posted Dec 13, 2013I'm using Essentials kits and put:
UseBuiltInKitSystem: false
But /kit still goes to your plugin instead of Essentials and replies "/kit [kitname] /kit [kit] [player]"
Anyway to disable the kit command from your plugin so the Essentials one will work for me?
This is the last tweak I need to have everything working right.
Thanks again for the excellent plugin.
Misty
-
View User Profile
-
Send Message
Posted Dec 12, 2013@Warreo
Oke thx man i realy need that feature for my server :D
-
View User Profile
-
Send Message
Posted Dec 12, 2013@MerijnRaaij
Already implemented for the next update :)
-
View User Profile
-
Send Message
Posted Dec 11, 2013wow great plugin but can you maby make a option that you can create a shop villager(that if you click on the villager, a shopmenu opens) like in the hive Server
-
View User Profile
-
Send Message
Posted Dec 6, 2013@tibbpow
I will look into the error, but I can't say that anything will fix it since you are using spigot, which I can't/won't make sure is compatible. But I will look into the problem. :)
-
View User Profile
-
Send Message
Posted Dec 5, 2013Getting an error with the latest dev build of spigot #1170 (I disabled votifier in the config also):
http://pastebin.com/P4ErquGE
-
View User Profile
-
Send Message
Posted Dec 5, 2013@tibbpow
I'll get right on it broski! :)
-
View User Profile
-
Send Message
Posted Dec 5, 2013You would set custom lore for example in a vault shop, and that lore would not show up on the item itself in the shop.
-
View User Profile
-
Send Message
Posted Dec 5, 2013@tibbpow
Haha it's all good. And what do you mean that the lore doesn't work, I need more detail there is lot's to do with lore in the plugin. xD
And I'm still baffled that permissionsEX doesn't do that. Anyway, hopefully it will be in the next update for TokenShop. :)
-
View User Profile
-
Send Message
Posted Dec 5, 2013@Warreo
Yeah sorry about the kit thing, I'm retarded.
However, LORE FOR SURE DOES NOT WORK.
So there you go, something to fix!
And yes, timed permissions would be amazing. At the moment I'm forced to set players to timed groups, which pex handles correctly through restarts (god knows why timed permissions for pex don't last through restarts)
-
View User Profile
-
Send Message
Posted Dec 4, 2013@CloudKidZ
I handle timers more mathematically then I do with actual timers, therefore they create little to no lag. I'm working on some tests for the timers as we speak just making sure that they will be easy to use. :)
Also, I'm very happy you enjoy the plugin :)
-
View User Profile
-
Send Message
Posted Dec 4, 2013@Warreo
Thanks Warreo!
If it helps you with ideas for programming the feature:
I did find a plugin that handles delayed commands called "Ontime" but it requires a complicated work-around of creating them as 'rewards' before executing them. It is also a pretty big plugin with lots of features and I'm trying to keep lag down.
I think the plugin schedules the delayed commands based on the server time, and also adds them to a queue that is checked when a player logs on or the server is started in case the server was down when the correct time was reached.
Hope that helps.
What I like best about your plugin is the chest-view with icons for the token shop. It makes it look much better and so much more player friendly than ones based on buy signs.
Thanks!
Misty
-
View User Profile
-
Send Message
Posted Dec 3, 2013@CloudKidZ
I didn't know Pex didn't have the ability to make timers work through a shutdown/restart, I will get right on adding this feature and will hopefully get it in the next release! :)
-
View User Profile
-
Send Message
Posted Dec 3, 2013@Slappygilmore
I'm trying to do the same thing - allow players to buy a permission for a length of time with tokens.
Pex does offer a timed permission, but it is measured in seconds.
pex user <user> timed add <permission> <lifetime in seconds> [world]
I tested it and found a problem. If the server restarts - that timing is lost.
Best to use it only for short times - minutes or hours, not days.
I'm not sure on the coding, but I'm guessing the removal event isn't scheduled based on server time, but instead some kind of countdown starts, which is reset on reload of server.
So to be robust, a timed command would need to handle server restarts and players being offline.
Would be awesome if Warreo adds this feature!
Thanks again for the great plugin.
Misty
-
View User Profile
-
Send Message
Posted Dec 3, 2013@Lostcraft
First and foremost, I will have a update coming out tomorrow or approximately 12-16 hours. The reason there hasn't been an update to fix the right click bug is I've been out of town for about 2 weeks. :P
Secondly, there's already a fix for the /kit and /kits, please look in the config file, just turn off the built in kits.
-
View User Profile
-
Send Message
Posted Dec 1, 20131.7.2 released. Get that error out of here!
Also, you should add a permission to /kit,/kits so that we can stop it from conflicting with essentials kits.
-
View User Profile
-
Send Message
Posted Nov 27, 2013@ProjectHyrule
I believe with permissionsex there is a command that allows you to put a certain time limit on the time they can have the rank for. Just search for the command :)
-
View User Profile
-
Send Message
Posted Nov 24, 2013Hello. Quick question here =)
If i where to use TokenShop and make a purchase option that puts a user in a different User Group (I use permissionsEx), would I be able to have the plugin remove them back to the Default Group after, lets say, 1 month? I want to create Timed packages that my players can purchase. :)
-
View User Profile
-
Send Message
Posted Nov 21, 2013Add some pictures, maybe a video!