Bukkit

Sign Bank

Version 2.0.3 is out now!

(Download may be delayed due to approval time)

Dependencies [Vault]

Sign Bank is a Money and EXP Bank plug-in that allows you to store money/experience all fully automated through sign interaction.

Money Banks
The Money Bank system is all pretty straight forward, deposit money in, withdraw money out, interest is not implemented yet, but will be soon hopefully. To make a money bank, simply put, money bank on the first line of a sign, and it will auto create. Right clicking on the sign will access the bank and right clicks after that cycle through the Withdraw and Deposit. To withdraw/Deposit, simply enter the amount in chat and it will automatically make the transaction.

XP Banks
The Xp Bank system is a bit more complex than the Money Banks. To create, simply put, xp bank, on the first line of a sign and it will auto create. The Xp Bank system uses an algorithm to calculate exact amounts back and forth, mimicking Minecrafts actual Exp formulas so that very little(if any) exp is lost while depositing/withdrawing. The balance displayed on the sign for exp is total amount of exp as a value, not levels. Upon first accessing a Xp Bank, the Bank will inform you the max amount of levels you can withdraw from the bank at your current level. Be assured that virtually no exp is lost when using the bank but keep in mind that the Bank only works with depositing/withdrawing levels, not the exact amount of exp, because the amount of exp needed between levels fluxes, and my algorithm accounts for this. This is to avoid players from getting 10 levels, depositing, get 10 levels, depositing, etc etc get levels much easier and then just withdrawing the tons of levels.

ATM's
The ATM's are simply just signs that link to your money accounts, but only carry the Withdraw option. To create, simply put ATM on the first line of a sign, and the plugin will do the rest. These are more for random locations in your server for people to get money from the bank "On-The-Go". More of a real life simulation.

Current Features

• Configurable Interest System!
  
• Transfer System for money banks to wire money to other players Bank accounts!
  
• Auto currency name detection.
  
• "/" commands to check current interest and current money/xp in Bank account.
  
• Placing a sign with Money Bank on the first line will create a Money Bank and placing a sign with XP Bank on the first line will create an Xp Bank.
  
• Right-Clicking an unoccupied Bank will automatically turn on, and display your current Balance in the Bank.
  
• Right-Clicking once the Bank is open will cycle through the Withdrawal, Deposit, and Transfer options.
  
• Entering an amount into chat will automatically Withdraw/Deposit that amount from/to your Bank.
  
• If the Bank is already in-use, it will not allow another player to interact with the Bank.
  
• To leave a Bank, all you have to do is walk away and the Bank will automatically close for you!
  
• Bank Balance will automatically update upon making a Withdrawal/Deposit.
  
• Breaking a Bank Sign, will destroy the Bank.
  
• Permissions for creating/destroying Banks.
  
• Configurable Interest System.
  
• Configurable Max Amounts Features.
  
• /sb see <playername> to see how much players have in their Banks.
  
• Unlimited number of Banks!

Planned Features

• Code Cleanup.
  
• ATM's
  
• Money Transfer System.
  
• Currency name detection.
  
• Max Bank Amount.
  
• Possible Loan System.
  
• Suggestions from players.
  
• Adding Permissions.
  
• Adding Interest System for Money Banks.

Commands

• /sb interest - This displays information on the Interest. Next disbursal, interval, and amounts.
  
• /sb interest disburse - This command forces an automatic interest disbursal.
  
• /sb balance - This displays the users current balance in the bank, for both money and EXP.
  
• /sb see <PlayerName> - This displays the balance of the specified player. #Requires Permission
  
• /sb set <PlayerName> <Amount> - This sets the players balance to the amount. #Requires Permission
  
• /sb give <PlayerName> <Amount> - This gives amount to players account. #Requires Permission
  
• /sb take <PlayerName> <Amount> - This takes amount from players account. #Requires Permission

Change Log

Version 2.0.1: 12/6/2012

• Fix for decimalFormat Exceptions on xp Bank Depositing.
  
• Added another safety check for those not using logging and Log loading throwing Exception.

Version 2.0: 12/5/2012

• Full Code Rewrites to the File I/O and the Interest System. THIS WILL REQUIRE YOU TO REMAKE YOUR BANKS OR THE PLUGIN WILL BREAK!
  Steps:
  1. Turn off server.
  2. Delete banks.yml
  3. Start server with new SignBank.jar.
  4. Remake Banks.
  
• FIXED! Interest System should now fully work in the sense of interest disbursion, max bank cap bypass, etc.
  
• ADDED! New Command! Players with the “sb.admin” permission can use the new “/sb interest disburse” command to force a bank disbursion immediately!
  
• FIXED! The long known PlayerMoveEvent Bug should now FINALLY be fixed, pending confirmation!
  
• More minor fixes, etc, can't think of them right now!

Version 1.7: 11/7/2012

• ADDED! Added 3 new commands. These commands allow you to “take”, “give”, and “set” money amounts directly to players accounts. The permission node to edit accounts is “sb.accounts.edit”.
  - /sb set <PlayerName> <Amount> Sets the players balance to the amount.
  - /sb give <PlayerName> <Amount> Gives amount to players account.
  - /sb take <PlayerName> <Amount> Takes amount from players account.
  
• FIXED! Fixed the display for XP Banks, they no longer display Money Bank messages, but have their own display! Also adjusted some chat colors when using the /sb balance command, to make the values more apparent.
  
• FIXED! Hopefully fixed the issue with the max bank cap bypass not working properly and causing other issues to occur on rare occassion.
  
• ADDED! You can now Log all User transactions to a Logs.yml file. Toggleable through config. Default: true.
  
• CHANGE! Changed the permission node for bypassing max bank cap to “sb.account.bypass”.
  
• Updated to CB 1.4.2 - R 0.2.

Version 1.6: 8/7/2012

• Updated PlayerChatEvent to AsyncPlayerChatEvent.
  
• Updated all the exp algorithms to match the new internal experience algorithms for 1.3.1. This was not fun to convert!
  - NOTE: EXP is not being reset for this and you may see a flux in your players exp from old algorithms to new. If you want to just start fresh, delete your xpAccounts.yml before starting your server back up.
  
• Added a check for NPE's being thrown for interest disbursion on start ups involving Null worlds.
  
• Fixed issue when Interest would disburse improperly for players with bypass node when the Server ran through multiple cycles without a restart.
  
• Updated to CB 1.3.1 - R 1.0.

Version 1.5: 7/5/2012

• Added a new bypass permission node for Max Bank Amounts.
  - sb.bypass.maxbankamount
  
• Fixed a bug with the Interest System not respecting the Max Bank Amount values.
  
• Fixed a save bug with Max Bank Value not properly storing when SignBank loaded.

Version 1.4 : 6/6/2012

• Moved around some listener classes to better accommodate priority.
  
• Added in new classes to manage Plugin Hooks.
  
• Fixed any remaining bugs that should be stopping some servers signs' to not function properly.

Version 1.3.1 : 6/5/2012

• Latest Beta Build, to ensure all signs are functioning.
  
• Modified /sb to once again navigate a bit smoother to the help menu.

Version 1.3 : 6/4/2012

• *NEW* Added in a Max Bank Amount that can be configured in the config.yml. This will allow you to limit the amount a player can store in a Money Bank at any given time.
  
• *REMODELED* Completely redid the Interest System. Now the Interest System will better keep track of the last disbursion of interest and disburse accordingly. So now if you r server is restarted, or goes down for any reason, Sign Banks will take this into account and will disburse interest upon start up or wait the remaining time till next disburse, then continue on its normal timer.
  
• /sb interest will now also display the amount of time until the next interest disbursal.
  
• /sb see <playername> command is no longer case-sensitive.
  
• Added more precise coloring to some of the /sb commands.
  
• Updated to 1.2.5-R3.0

Version 1.2.2 : 5/12/2012

• Added command /sb ? to better help navigate the Sign Bank commands available to you.
  
• Added command /sb see <playername> . This command will allow players to see the amount of money a certain player has in the Bank. This command is cap sensitive. Defaults OP.
  
• Added permission node for using the new /sb see command.
  - sb.see

Version 1.2.1 : 5/9/2012

• Fixed a bug where players could use colors to makeshift their own bank signs.
  
• Fixed a bug where opening banks of other types would cause the first sign to become frozen.
  
• Code cleanup as usual.

Version 1.2 : 4/28/2012

• *New* Added ATM Signs. Create them by simply writing ATM on the first line of a sign.
  
• Added permission nodes for using each type of Bank.
  - sb.use.money
  - sb.use.xp
  - sb.use.atm
  
• Removed a few lingering debugging messages.
  
• Removed bug where XP Bank would show Transfer options.
  
• Code Clean Up as always.

Version 1.1.0: 4/5/2012

• *New* Added Transfer feature to the money banks. Typing in a players name followed by the amount will send that amount to that players bank! (Warning, this feature is cap sensitive)
  
• Added feature so your currency name will now be found and displayed via SignBank messages.
  
• Added "/" commands to check interest info and bank balances.
  -/signbank will display Version and Author. =)
  - /signbank interest will display interest percent and disbursion time.
  - /signbank balance will display current money and max level withdrawl.
  
• Added "sb" alias to "/" commands.
  
• Adjusted interest control to better shut down when plugins are reloaded.
  
• Code Clean Up as always.

Permissions!

• sb.admin - This permission gives power to create and destroy Banks. Defaults Op
  
• sb.create - This permission gives power to create Banks. Defaults Op
  
• sb.use.money - This permission gives power to use Money Banks. Defaults Op
  
• sb.use.xp - This permission gives power to use Xp Banks. Defaults Op
  
• sb.use.atm - This permission gives power to use ATMs. Defaults Op
  
• sb.destroy - This permission gives power to destroy Banks. Defaults Op
  
• sb.see - This permission gives access to the /sb see command. Defaults Op
  
• sb.account.bypass - Bypass the Max Bank Cap Amount.
  
• sb.account.edit- This permission gives power to edit Bank Accounts. Defaults Op

Reporting Bugs/Issues

When Reporting An Issue, Please Do The Following

• Your Craftbukkit version.
  
• Current version of Sign Bank.
  
• Describe the exact situation in which the issue occured (listing all applicable info, names, what sign reads, etc etc)
  
• Copy/Paste the error from the Console Log.

Installation and Help

• Drop SignBank.jar into /plugins directory.
  
• Enjoy!
  
• Wiki Page Coming Soon!

Donations

Happy with my work? Want to help out? Want to encourage more Sign Based plugins?

Feel Free To Donate!