GoldBank
GoldBank – Banks, ATMs, wallets, and more!
Development Status
I will no longer be releasing updates for this plugin. While GoldBank, being the second plugin I've ever made, holds a special place in my heart, it's time to move on. Because the truth is, it's a huge pile of messy, tangled code written by a developer just beginning to learn the ropes of Java and OO programming. I don't even remember writing a lot of the code still in the latest version, and it may hold nasty bugs that I'm not even aware of. Since I don't plan to release any further updates (well... I might release a 3.0.2 that's been sitting on Github for a while, but then that's it for real), I strongly advise against using it and instead opting for a cleaner and better-maintained economy plugin. With that being said, so long and thanks for all the fish!
Overview
I've never really seen the point of virtual economies. I prefer an economy with tangible items. So, I created this plugin. It's essentially the basis for a gold-based economy system. The basic function is the ability to create GoldBank signs, which players can then buy/claim to put their gold in. Once a week, they will receive interest. Additionally, admins can create ATM signs, which allow players to access their bank signs remotely. And furthermore, players and admins may create personalized shops which other players may use to buy and sell items. If you need to expand your inventory, this plugin can do that for you. Just craft a wallet (made with leather in a boat shape), and instantly you'll have a mini-inventory within your regular one (inventory-ception?). But be careful, because if you drop it, another player can steal it from you! Mobs have a nasty habit of losing their wallets, and will often drop gold nuggets when killed. If a player is lucky, they might receive something with a bit more value than mere nuggets.
Features
- Creates and registers a virtual inventory to a [GoldBank] sign when a player right clicks it.
- Automatically distributes interest between inventories weekly
- Signs are automatically protected from access and destruction by other players, pistons, creepers, and TNT
- Specify tiers of signs with different fees and sizes (Define fees and sizes in the config, and define tiers on the second line of each [GoldBank] sign
- Create a master sign, which everyone may claim, by setting the last line as "Master"
- Admins can create [GoldATM] signs, which allow players to access their gold inventory remotely, for a configurable fee
- Mobs drop a random number of gold nuggets, the maximum being a number defined in the config
- Mobs may drop rare golden items at a configurable rate
- Players and admins can create shop signs, which other players may buy from and sell to (see below for sign syntax)
- Players can craft wallets (crafted with leather in a boat or minecart shape), which act as portable virtual inventories
- Type "/gb reload" to reload the plugin
- Full UUID support. Note: this means that the plugin connects to Mojang's UUID API.
Bank Signs
Creation
To create a GoldBank as an admin, simply create a sign resembling this:
———————
[GoldBank]
Tier 1
(blank)
(Master)
———————
The first line is static, the second controls the tier (defined in the config), the third is blank, and the fourth, if set to "Master", will allow everyone to register and access their bank account through it, but will not change its text. A regular sign will only allow one player to register through it.
Registration
To register a bank with a GoldBank sign, a player need only right-click it. If a fee is set for the given bank tier, the player will be required to pay that fee in golden ingots in order to register.
Access
To access a GoldBank, right-click the sign to open its virtual inventory. Once the player is finished editing, the inventory will be automagically saved to disk.
Destruction
To unregister a GoldBank, a player must left-click it. This will cause the sign to revert back to an unregistered state (assuming if it is not a Master sign), and its inventory to spill onto the floor in front of the player.
ATM Signs
Usage
ATM signs are a powerful tool which allow players to access their GoldBank account from anywhere on the map. When a player right-clicks one, their bank account will open, and they are free to edit it as long as they'd like. If a fee is defined in the config for ATM signs, the player will be required to hold a sufficient amount of gold in their inventory for the sign to charge in order to use it.
Creation
Creation of ATM signs couldn't be simpler! Just create a sign and type "[GoldATM]" as the top line (case-insensitive).
Shop Signs
If AngryNerd1 creates this sign:
———————
[Diamond]
1;4
1;2
(blank)
———————
the plugin will replace it with this sign:
———————
[Diamond]
Buy 1 for 4g
Sell 1 for 2g
AngryNerd1
———————
To create an admin (infinite) sign, simply replace the last line with "Admin", and it will convert to "Admin"
Note: All lines are case-insensitive, spaces may be used in place of underscores, and the item ID may be used in placed of the item name. Additionally, shops which sell the buyer's head can be created, using PlayerHead as the item name.
Wallets
GoldBank has a wallet feature, where players may craft wallets to carry with them. They allow players to store anything, or just gold, if the server owner desires.
Creation
To create a wallet, place 5 leather in the shape of a boat in a crafting table. A wallet will appear in the result slot with the player's name branded on it.
Usage
To use a wallet, a player must place it in their hand and right-click. A virtual inventory with a config-defined number of slots will be opened, and they are free to edit it. If the config allows for it, they may add any item they wish. If not, they will be limited to forms of gold (gold tools excluded). When they are done editing, they may hit the escape key to resume gameplay.
Commands
- /gb reload - Reloads the plugin
- /gb view {player} - Opens a specified player's GoldBank inventory. Note that, if the player argument is missing, it will open the player's own GoldBank inventory.
- /wire [player] [amount] - Transfers a specified amount of gold in nuggets from your GoldBank to a specified player's. A fee may apply, which is set in the config.
Changelog
Latest Version (3.0.1)
- Fix GoldBank hanging the main thread while doing UUID lookups
Version 3.0
- Convert plugin to use UUIDs in place of usernames
- Add code to convert existing data to use UUIDs
- Minor bug fixes
Click here to view the changelogs for all versions
To-do
- Make GoldShops more user-friendly (i.e. allow players to use aliases in place of the actual item name (and damage value))
Click here to view older items
Known Bugs
- Players in very rare cases receive change in the form of an ItemStack with strange properties when using blocks to buy from a sign with a different gold type defined. This ItemStack behaves very oddly, but is effectively the same as the ItemStack that should have been received, and can be manipulated into such
- Players in creative mode may put their wallet inside their wallet, effectively destroying it (though it may be spawned back in via command)
- The /gb wallet spawn command has no default group set, so it must be manually specified even for operators
Click here to view older items
Permissions
Note: Permissions will only work if you have version 1.4 or later of the plugin
Bleeding-edge Builds
Development builds of this project can be acquired at the provided continuous integration (Jenkins) server. These builds have not been approved by the BukkitDev staff. Use them at your own risk. Additionally, these builds often undergo little to no testing, so there is no guarantee they will function properly.
Plugin Metrics
This plugin collects anonymous usage statistics. Here's a list detailing data collected, and here's a graph of and link to them:
Source Code
Vídeo Tutorial em Português (Video Tutorial in Portuguese)
http://www.youtube.com/watch?v=36mH_i62Ghc
Logo by Zombiemold
Sponsor
Special thanks to HostHorde for supporting GoldBank! Make sure to check them out!
@Mon3y13ankeR
I'm not going to implement this, simply because it would require a complete code rewrite and would likely at least double the size of the plugin. Sorry. :(
I would love if you could customize currency Item with this Plugin. Let's say I don't want Gold but instead I want to add Enderpearls as a currency (yes I know its a lot more easy to farm enderperls but thats not the point). This would also allow most Mods to hook into the Plugin with their Items.
@Xxswordcross
You'll need to be much more specific, or I won't be able to help you. I'll send you the information I need via PM.
The money that is currently in my player's banks, wont transfer over with the new update. Plus the size of banks was left out of the config. Do we have to add that manually?
@Xxswordcross I'm not sure exactly what you're asking. What are you transferring the banks from?
@sean326 I'm still learning how Vault works internally, but I will definitely add support for it in the near future. Just hang in there. :)
@baronjm Hmm... I hadn't thought about that. I'm certain that Bukkit will add an event for when a hopper is used when 1.5 is released, so it should be relatively simple to protect the shops. However, I won't be able to do anything until the first 1.5 dev build of Bukkit is released, which should be within a couple of days, give or take, of the update.
This plugin is awesome! Great currency and features.
I was wondering if you have addressed shop protection from the upcoming hoppers?
I'm sure I'm not asking a small feat of you but can we get vault support so my players can use gold to create factions and anything else needed [on my server it costs $2000 will change it to 200 gold to create a faction, the idea is they will have to form at least a small team ahead of time and work together for the funds to create the faction as opposed to a ton of 1 man factions.] but right now I'm forced to make it free with no other means of them paying since this is the new standard currency.
some personal thoughts on the plugin so far:
- wallet idea is awesome just wish i could only put gold in it not other items as an additional vault i could take around
- display drops on your todo has me real excited
- gives my players reason to try some other activities and explore areas they otherwise would not have, this introduces so much more i have players planning to build traps and forts in caves where you would start looking for gold,bandits are lurking around the next corner,and some are working to be successfully rich in our minecraft world! it has brought a great twist to what we already have and we all love it.
http://dev.bukkit.org/server-mods/factions/
How can I transfer current banks over with the new configs? So far they pretty much have to remake their bank
Absolutely :) Would love to help any way I can. Keep me posted on the news if you would. I'd love to hear about its progress. Just send a PM or something. ;)
@LKTServer
Alright, I'll see what I can do. Thanks a ton for the input; it really helps me to make the plugin better. :)
I'd recommend collaborating with the developers of towny and other plugins to get this plugin some support and compatibility. Because your economy system is so unique and well developed that as soon as it got support with other plugins I imagine its popularity would skyrocket. A surprising amount of my users prefer tangible items for economy rather than some virtualized system.
@caseif
Towny - http://dev.bukkit.org/server-mods/towny-advanced/
Towny is a plugin where you can create nations and towns on a server and charge things like rent for plots and stuff, you can even charge players to create towns and nations themselves. For now i'll probably use something like BOSEconomy for purchasing land until you got support up for those types of plugins, if you decide to. I'll most likely create and exchange rate like 10 currency per 1 gold bar.
@LKTServer
Thanks for the kind words. :3 I've no idea what Towny does, though I've heard of it. I suppose I could look into adding support for it.
It'd be nice though to add support for this plugin with things like Towny.
Wow! This plugin is EXCELLENT! I'd love to see this thrive, I personally don't really like BOSEconomy and this is much more realistic for something like a RPG server. I'd recommend adding a donation box, I'd love to donate to this project.
I updated Java, thanks, it works like a charm now!
@Xxswordcross
Resolved. @Xxswordcross was using Java 6 rather than Java 7. The next build will be compiled with Java 6 so as to prevent this issue from happening in the future.
Sent the issue to you in PM, thanks for responding!
For some reason none of it is working at the moment. This is a plugin I have really really been looking for. I dropped in the plugins file, started, shutdown and started the server, but nothing works. The commands don't work, and the shops won't create.
@93Creeper
Hmm...
Send me a copy of your chestdata.db (in the data folder). I'll PM you with my email.
EDIT: Never mind, I think I've figured out the problem. I'll upload a patch (2.1.1) tonight, though it will take a while for the BukkitDev staff to approve it. You'll be able to download it from my site first here.