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!
@caseif
vault support would be awesome. My server is a gold based inventory and the ATM signs plugin stoped working a long time ago so now we need to use signshops. One nugget +1 dollar. Works out great... If you were to support Vault It could make everything much easier.
Thanks for update Maxim, I'll test it now.
Seems to check out. Great work!
@Deseart27
Er... I don't have localization set up right now. I'll probably set it up after a couple more updates, as it can slow the update process down when each language needs new messages translated. But after I set it up, yes, feel free to translate it.
@caseif
Thank ! :) Can I translate your plugin in french please ?
@Deseart27
Prices for GoldBank tiers can be defined in the config. To craft a wallet, simply craft leather in the shape of a boat.
Hello ! Very nice plugin, really ! But there is not, nowhere, tutorials.. :/ Can I create salabes bank accounts ? (Like : A player will pay 300$ for have an account) How to make a wallet please ?
Cordialy :)
@Rin_KagaMINE
I think I see what you're getting at. It could be really tricky to implement, though (it took me a week just to get master signs working :P). But, I will try to add it ASAP.
Pertaining to Vault support, I think I have it working, but I don't have much of a way of testing it. If all goes well, though, I'll fully implement it and include it in 2.5.
Remember the comment I posted earlier? Well, I have another suggestion.
So the thing is, there is limited space in the GoldBank. For a prison server one bank may not hold enough to rank up. So my suggestion is:
When you right-click on the sign, the item would come DIRECTLY out of the GoldBank sign. Left-clicking would put a gold nugget IN the bank. Also there would have to be someway to put a stack in all at once without clicking 64 times (maybe sneak-clicking). Same with putting in the nuggets.
So the Bank would have UNLIMITED space in it (however the wallet would still have an inventory). Perhaps these suggestions could be toggled on/off in the Config. I really want to use this plugin, but without this suggestion it might not work for me.
@Xxswordcross
Oh, you're kidding...
I have no idea how I missed this. I'll upload a patch soon.
@ Maxim If I use gold ingots on a shop sign that requires nuggets, it will take the trade, will NOT take the ingots, and still spawn 4 gold nuggets in the chest. Same with gold blocks and it may be the same with other types too.
@Rin_KagaMINE
The easiest way to do this would be to add Vault support so that you could install a separate plugin which would change the ranks by hooking into Vault. But, I've been really busy, so I haven't read up on supporting Vault yet. I will do it as soon as possible, however.
Suggestion: I am thinking about making a prison server. I was wondering if you could add in a feature that will allow players to buy ranks. Maybe it could be compatible with another rank plugin like PermissionsX or PermissionsBukkit or something. Other than that this looks like an AWESOME plugin! And if you add in a ranks feature I might use it on my server!
I don't even use your plugin but I was tempted to donate just because waffles :D
@MaximRoncace
re #83
Thank you for considering it. I hope its something you can support. I'm sure I'm not the only one who would love for GoldBank to support custom items.
@Barnsey3017
No problem :)
@caseif
OK. No harm done, I have done that before :) I shall update now. As I said before, it is a great plugin though.
@PobenIII
Shoot, my bad. When I was rearranging the code that handles commands, I forgot to change a couple a values, which resulted in it checking if the first argument was bank, then immediately checking if the first argument was view, which would have been impossible. I've just pushed 2.3.3, which fixes this issue. Also, the command is /gb bank view, rather than /gb view.
@Barnsey3017
To change the size of wallets, you'll need to change the value "wallet-size" in the config to a different multiple of 9. As for selling wallets, the plugin doesn't support that as of now. I may add on a config option that automatically charges players when they craft a wallet, however.
@PobenIII
thank you dude :) and yeah same problem with me for your problem
again thank you how do you make next size wallets or let people buy them if you know
The /gb view command doesn't seem to work for me. It just says Invalid argument! etc
Anyone else having the same issue, or is it just me? Good plugin overall though :D
@Barnsey3017
Just put 1, 2 or 3 on the second line of the GoldBank sign, like so:
-
[GoldBank]
3
-
how do you make it go from tier 1 2 3