DonationPoints
DonationPoints v1.9.0
What is 'DonationPoints'
DonationPoints came from a Bukkit request thread. I was already working on a similar plugin for my own server, so I decided to make it public. This will allow you the admin to give a player points (essentially for anything - but mainly for donating). From there, the player can use these points on 'perks' in-game. You can make the perks whatever you want.
What are Points?
Points are more of a virtual currency. Similar to how iConomy works, but it is more oriented toward donations and using your points to earn perks in-game. The idea behind the plugin is: Player Donates > Player Receives Points > Player Spends points on whatever / whenever. At the moment, the plugin only supplies a method for you giving the points to someone and them spending it, it will not* automatically give them points when they donate. I recommend another plugin, such as BuyCraft, to give a player points automatically. The Server Admin (or anyone with permission) can create packages in the config, and create signs for the packages to purchased on. Please refer to the signs setup guide linked below.
Features
- Define packages in the config file with custom prices that your players can spend their points on.
- Your packages contain a list of commands that will be executed from the console. For in-depth package creation, see the packages page listed below.
- MySQL storage for balances. This allows easy management of points for the server admin while keeping balances secure.
- Commands to give / take points from players if you need to.
- Checks for DonationPoints accounts when a player creates a new one to prevent duplicates.
- Commands and Permissions support.
- Metrics support.
- Set packages to expire after an amount of time.
- Limit the amount of times a user may buy a package, to prevent waste of points.
- Limits / Expiration can be defined on a per package basis.
- Easy to follow config. Run commands that are player specific using variables in the commands lists. See package setup for more information.
- All messages are configurable and neat. Plugin wont spam the player with ugly messages. They all follow the same scheme / colors.
Additional Pages
Dev Builds
I have already begun pushing Dev Builds for v1.6 of the plugin. You can find the latest dev build at the Upcoming Features link right above. Will always be up to date with the changes listed on the page.
Contact
If you have a suggestion for the plugin, or a concern, please open a ticket. The ticket tracker provided by Bukkit allows me to manage feature requests and bugs in an effective manner as well as communicate back as progress goes on.
Developer?
This project is available on GitHub. If you find something that needs fixing, feel free to make a pull request. If you're interested in continuing to develop the plugin, feel free to let me know and we can discuss adding you as a contributor. Click the image below to be taken to the repo.
Official Plugins
The following plugins were made with DonationPoints in mind and rely on the DonationPoints API. This means that you must have this plugin installed to use any of the plugins listed below.
DPEnchant - Users can purchase enchantments for their items using DonationPoints.
Is it possible to run 2 copies on this plugin, both other currency and balances, so a player can have 10 VP, while they have 26DP, which they can spend on the DP or VP signs without the plugin conflicting?
This would be awesome.
Sincerely, Mike4898
@FuZeEclipse
This is doable in a bit of a complex way through limits + prerequisites. If you wanted a rank hierarchy type deal, you could just use the prerequisite feature to require that a previous rank be purchased before ranking up.
I've not been able to think of a nice way to implement cumulative packages. It's been requested since like 1.2
Add cumulative packages! (After spending an x ammount of points you get a special reward/permission/rank)
@hybridphreak85
If SpecificPermissions is set to true in your config, make sure they have the permission node: donationpoints.sign.use.<PackageName>
Also make sure they have donationpoints.sign.use. This will have to given regardless of SpecificPermissions being set to true or false. 1.7.1 is working fine on my servers.
Hey MistPhizzle, I've been using DonationPoints for about a month now with no issues, but since the new update (1.7.1) I have been unable to allow players to make purchases from the signs. They can left click for the info, but when right click it say they do not have permission to do this.
I have tested myself as an Op - works fine, And as a non op with all correct permissions - Not working fine,
I checked the site, and bypassed the new node "donationpoints.user" and used all seperate original ones with still to no success.
I can provide further info upon request, as any advice on this would be much appreciated!
Thank you :) for Epic plugin :) Allows us to give players and donors a little more in the way of rewards. Endless fun with this one :)
@AssRealm
Just assign each permission node until this is fixed.
@MistPhizzle
For some reason, i give my users the permission donationpoints.user, but they still are unable to type /dp packages. Im using pex.
@Nightiky
I personally like the consistency of dp_transactions and dp_players. Although it wont hurt to allow custom table names.
Column names would make it too complicated though.
Hello, any chance to be able to set in config own table and collums names for mysql?
Thanks!
@Nikfection I'm thoroughly surprised I didn't catch that bug when I was testing the release. I usually thoroughly test these bugs. Anywho, just uploaded v1.7.1 which contains this fix + a Config Fix.
Also fixed some issues with the Config Checker and such.
Thanks for pointing this issue out and thanks for using my plugin! You can download the new version as soon as Bukkit approves it.
Seems like the latest release isnt recognizing the packages that I have in the config. i mean it will list them, but nothing doing when i try to interact with them. With signs, or with the commands. Just doesnt return any prompts, etc. Switching back to 1.6.4. Great plugin btw!
v1.7.0 has been uploaded (Like 10 hours ago) and Bukkit hasn't approved it yet. You can download it once they do eventually approve it. Features Include:
All features are better explained on the changelog page itself.
I need suggestions for the plugin now! Report any bugs / suggestions via the Ticket System or comment.
@lANTHONYl
Will update the commands / permissions / config pages shortly. I like to keep the config file relatively clean. Usually these pages are only updated on large changes (1.X) but since there have been a lot since 1.6, I should definitely do some updating.
Also, a CI server would be awesome. Definitely PM me on that one or contact me via Skype (Username: shawnandstuff)
Also, i have a Jenkins server if you are interested in having a continuous integration option for development.
Can you update the plugin.yml file to include the new permissions such as donationpoints.package.list and any others that i'm not aware of :)
@MCLegendServer
/points is a valid alias for the command. You can use any of the commands with: /donationpoints /dp /points
This is exactly what I needed! I just started to "play" with this plugin and I find it more and more amazing. Mysql, timed packages with expiration, oh my... Cant wait a day, when I put it onto our servers! I will surely donate and support to keep it going when our players start to spend some money.
All thanks to author
Thx Mist! I look forward to start using your plugin!
I also have a suggestion for the plugin: When you type /points help, you get many diffrent commands, like: "/dp x" Is it possible that you can use the alias in the help text as well? Example: If I type /dp help, i get a "/dp x" command list. If i type /points help, i get a "/points x" command list.
I want this because i use the point system to make a vote shop, and some users dont understand why there comes like "/dp". Its not so important, but it had been very useful for me! :)
@MCLegendServer
I've fixed this plus one other bug in 1.6.4. You will be able to download it as soon as Bukkit approves it.
Thx for checking this up @MistPhizzle ! Here is my config: http://pastie.org/7821830