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!
@Dom05
Same for me, the config codes don't seem to work in the broadcaster section of the config. I am trying to break a line in my messages in the broadcast section, but %NL% doesn't work. If there isn't already a way to create a break in the line for broadcasted messaged, can one be added? Otherwise how would I go about breaking a line in the message?
I'm trying to format my broadcast messages to have bars on the top and bottom:
message
but it doesn't work because I can't break the line.
Quick question: Is it possible to add more than one command to a token shop item? I'd like to give a permission, and then use a second delayed command to remove that permission.
Something like
Command:
- pex user %Player% add permission.test
- delaycommand 1d pex user %Player% remove permission.test
Also for ease of use on a server I would suggest the following commands added for admins:
/token player (Admins could check token totals of other players)
And in addition to /givetoke
/settoke - set token total to a specific amount for a player
/removetoke - remove a specific number of tokens from a player
These would make it easier to troubleshoot and fix problems for server admins.
Thanks for the great plugin.
Misty
The %Player% is not working for in the Broadcaster part of the config. Says in-game "%Player%" blah blah blah. It seems to ignore it. My usage of it though was...
Any idea why it won't generate a directory?
sounds like a lot of great features but no mysql support :(
This plugin conflicts with GlobalMarket because they both use /market, and for some reason disabling /market in TokenShop does not allow compatibility with GlobalMarket. Is there a link to the open source so I can code it to work for my server?
How do I disable features? I have other plugins for extra features like essentials for kits and galistener for voting, I only want the token and shops feature of the plugin. Also, does editing the Readme file make changes to the server? I'm a bit confused. I set UseVotifier to false and UseBuiltInKitSystem to false but when I type /vote this plugin's vote message still comes out and doing /kit this plugin's kit messages comes out as well. I want my other plugins to handle voting and kits
Can you add the source code or add a scoreboard system to list the amount of tokens you have.
Does this work across different servers?
Still pushing for /kit to be fixed. I posted logs and additional info and would kill for a fix for this.
@WsupPanda
You turn off the /shop option and you click a sign that opens the GUI for the shop you want to open. What's the issue?
I love all this, but on my server we have an actual shop you can go to, so I want the awards to be bought through signs rather than a gui.. Its a bit of a limitation haha cos I want to be able to setup my shop through an actual building on my server using signs? Can this be made possible?
It would be awesome to have some SQL integration for the token system (how many tokens players have)
just for safe keeping.Hi! I made my config all nice and stuff and all I want it to do is show the diamond in my shop (called the MediMarket) but it won't do it! Here is my config http://pastebin.com/bVxpaQuy and if you help me please tell me exactly what to do! I'm not sure why it's not working!
The plugin works with my factions server and others that I've seen. I do not have silk spawners so I can't verify that at all. But you are going to need some sort of vistener in order for your voting to work. I used GAListener and all my voting features work. I would add a note to remove the tokens on vote option from Tokenshop config and use GAListener to add them to your players. I had issues with it on and off double rewarding. The vote and donate commands and setting from tokenshop how ever are awesome and I would use them over any other plugin for it. Also, you install galistener like any other plug in and don't be confused by settings in tokenshop. You don't have to set stuff or move folders or destinations or any of that jazz. There are options in tokenshop that can make it sound like you do but you do not.
Hello, for some reason the plugin isn't reading the votes. It loaded the configs fine, I customized it for my server, and yes votifier is set up, connected, and enabled. Is this a problem with a specific voting site? Or did I do something wrong? When a player votes, they just vote. No broadcast or token reward in game at all, as if the plugin didn't even receive it. Please help me get this working :P
Thanks!
adittion: After going through more comments, I read that this is incompatible with silk spawners, which we have. Could this be why it isn't working? Also read somethings about it not working with factions. This server is a factions server. Could there be an issue there? I'm using tokenshop 1.3.3.
Also, heres my most recent log file from a server /reload. Maybe it can help in figuring out the issue with /kit. Latest.log
@MCIcecreamguy2
I don't do video's but if you had a question maybe someone could help. And i deffiniatly feel you on the ReadMe file.
@nathank33
Multiple commands from a single item? What does that even mean? I mean you can have a single item give out an entire kit but not sure if it works as I'm sure it requires "TokenShop Kits" instead of "Essentials Kits" and "Tokenshop Kits" is not a functioning feature of TokenShop right now. So if i had to guess, i would say no.
Is it possible to do multiple commands from a single item?
Could someone make a video on how to set it up? I dont really get it.
This didnt really help me: http://dev.bukkit.org/bukkit-plugins/tokenshop/pages/ And i did read the "ReadMe" file.
@live4redline
Oh yea that does work ok thats a great work around for now until this gets fixed thanks live4redline!
@UtopianMC
Theres a short term work around and you can use with /ekit and /ekits but much like on my server, it looks unprofessional and new users are often confused by it and leave. But for the time being it can be used to get the job done.