Curse

T00thTransaction

T00thTransaction uses the following process to handle donations/payments to your server automatically:

1. Donation/payment is made with a slightly customized paypal button(Customized to transmit username)
2. Paypal sends the information to your paypal IPN(A working ipn below)
3. Ipn will store donation/payment records to a SQL database
4. Every five minutes T00thTransaction reads the database getting the donations/payments from each player
5. T00thTransaction sums up each players donations/payments and does an appropriate promotion based on that.
6. T00thTransaction runs a check on each new donation/payment allowing actions to be done on them as well.

Why T00thTransaction?

Unlike Buycraft, this allows for no extra parties to be involved in your donations or server, the only ones involved are you, the donator and paypal. Rather than allowing an external website to issue commands to your server, a slight security risk, all actions are performed by the server itself. Not to mention it allows for easy tracking of donation totals for both you to check, and for the players themselves to check.

Features

Auto ranks

• Any amount of configurable ranks
• Configurable minimum amount to reach rank
• Configurable Name for ranks
• Configurable(and optional) in-game money reward for reaching ranks
• Custom event called on rankup for custom plugins to do actions on

Donation based actions

• Configurable(and optional) in-game money reward based on dollar donation/payment amounts
• Custom event called on new donations/payments for custom plugins to do actions on

Donation Packages

• Requires v1.4+
• Configurable whether or not to promote on activation and to what rank
• Configurable how many days package lasts
• Configurable whether or not to demote on expire and to what rank
• Configurable economy money bonus on activation
• Configurable up to 36 items to give to a playey(Able to specify multiple enchantmens and damage values)(Checks if player has room for items first, if not, doesn't let them activate package)
• Configurable package names
• Configurable commands on activation and expiration

Commands

• /ttr check USERNAME - Checks a users total
• /ttr check - Checks your own total
• /ttr add PLAYER AMOUNT (MM-DD-YYYY) - Adds a processed donation/payment from PLAYER of AMOUNT on MM-DD-YYY, date optional defaults to current time
• /ttr addnew PLAYER AMOUNT (MM-DD-YYYY) - Adds an unprocessed donation/payment from PLAYER of AMOUNT on MM-DD-YYY, date optional defaults to current time
• /ttr delete ENTRYID - Removes from database, the donation/payment with entry id ENTRYID (Can only be run from console) Has confirm questioner.
• /ttr listcheck PLAYER - Lists individual donations/payments from PLAYER
• /ttr droptable - Wipes entire donation database(Can only be run from console) Has confirm questioner. BE AWARE, once wiped it cannot be re-obtained, you will have to re-enter all previous data manually.
• /ttr updateaccounts - Manually runs donation checks
• /ttr checkall (PAGE) - Returns A list of all donation totals
• /package PACKAGE - Activates PACKAGE if available
• /packages [PLAYER] (PAGE) - Lists available packages

Permissions

• t00thtransaction.admin - Allows full use of plugin, including manually adding donations/payments into database(FOR TRUSTED PEOPLE ONLY)
• t00thtransaction.check - Allows user to check balances of other users.(All users can check their own balance.)

Requirements

• Paypal button on your website
• Knowledge of how to put an IPN on your website and link it to your paypal
• MySQL Database
• A minecraft server.
• Vault(A vault supported permissions plugin, and optionally a vault supported economy plugin)

Instructions for Install

Planned Features

• -Customizable amount of ranks- DONE
• -Uhhh lets say a "see all donation totals" command - DONE
• -Donation "packages" which allow for you to say buy package A and get this, this, and this(Configurable in config) - DONE
• More API methods(GetALLDonationTotals(), getDonationsSince(), ect)
• Way to reset donation count but not delete records, for servers that like to reset all their stuff in intervals i.e. I donate $5 then they reset, my donation is still in database, but not counted from then on.
• Support for non paypal transactions
• Thats really all I can think of, its a pretty versatile and complete plugin already....

For Developers

• Example code for custom event listeners: Example Code
• If you want your plugin to do things that can only be done to online players, you can use T00thTransaction.getOnlineMode() and T00thTransaction.setOnlineMode(boolean) in order to toggle whether or not ranks/donations only update when player is online

• T00thTransaction.getTotal("t00thpick1"); -Returns total cumulative donation of me, T00thpick1!
• T00thTransaction.getAllDonations(); - Returns a hashset of Donation objects which hold the amount, username, time and status of a donation

Donation based actions

1. Write a listener on "DonationEvent"
2. Get the player event.getDonation().getPlayer();
3. Get the amount(returns float) event.getDonation().getAmount()
4. Do your actions

Promotion based actions

1. Write a listener on "DonationPromotionEvent"
2. Get the player event.getPlayer()
3. Get their current total(returns float) event.getTotal()
4. Get the tier they are promoted to(returns integer representing one of the rank tiers) event.getTier()
5. Get the group name they are promoted to event.getRank()
6. Do your actions

Package Activation based actions

1. Write a listener on "PackageActivationEvent"
2. Get the player event.getPlayer()
3. Get the package name event.getPackageoption();
4. Get the unix timestamp of expiration event.getExpire()
5. Get the unix timestamp of activation event.getActivated()
6. Do your actions

Package Expiration based actions

1. Write a listener on "PackageExpiresEvent"
2. Get the player's name event.getPlayer()
3. Get the package name event.getPackageoption();
4. Get the original cost event.getCost()
5. Get the unix timestamp of expiration event.getExpire()
6. Get the unix timestamp of activation event.getActivated()
7. Do your actions

Addon plugins using api

Custom Event Based Plugins

• Your plugin could be here, just file a ticket.

Github Repository

Official T00thTransaction Server

Need help? Either file a ticket, or see if I am in my irc channel: irc.dirkocraft.net/#t00thpick1