Gringotts
Gringotts: Item based currency.
Gringotts is an item-based economy (currency) plugin for the Bukkit Minecraft server platform. Unlike earlier economy plugins, all currency value and money transactions are based on actual items in Minecraft, per default emeralds. The goals are to add a greater level of immersion, a generally more Minecraft-like feeling, and in the case of a PvP environment, making the currency itself vulnerable to raiding.
Gringotts was originally created for the Minecraft Wars PvP/survival server.
Features
- Item-backed economy (configurable, default emeralds)
- multiple denominations with automatic conversion (for example, use emeralds and emerald blocks)
- Storage of currency in chests and other containers, player inventory and ender chests (configurable)
- direct account-to-account transfers commands
- optional transaction taxes
- fractional currency values (fixed decimal digits)
- Account support for Factions, Towny and WorldGuard
- Vault integration
Latest changes
To get notified of new versions, please subscribe to file updates.
v2.9
- DEPENDS ON JAVA 8. If your server is not on Java 8 yet, you should upgrade, or ask your service provider to upgrade. Java 7 isn't supported anymore by Oracle.
- Should now work both in regular as well as async context. This means there should be no more "Asynchronous entity world add" errors anymore, and Gringotts is now compatible with Towny in async mode, as well as other plugins that call economy methods asynchronously.
- The maximum virtual money allowed for an account is now equal to the lowest denomination, instead of the highest. I changed this because that behavior was causing lots of confusion.
- fixed other minor bugs
v2.8
- built for Minecraft 1.9 and Factions 2.8. May not be compatible with older Factions versions!
- unsupported versions of Factions should be handled more gracefully now.
- updated to current version of Metrics-Lite. Fixes annoying error messages.
v2.7
- Named denominations: Each denomination can now have its own name, which will be shown in /balance messages and the like. To activate this feature, use the
named-denominations
config setting. By default this will use the denomination's displayname or regular item name, but you can define a custom name as well. See configuration instructions for details. - Balance messages can now be configured to show only regular balance or also vault/inventory balances.
- Now also supports
&
prefix to color codes in messages and item displayname/lore in addition to the default§
prefix. - can now also used Vault-supported item names in denomination config, not only regular Bukkit names. This can make the config a bit more intuitive. (requires Vault)
- lore config for denomination items now also allows a simple string instead of a string list.
- configuration should now always be loaded as UTF8.
- fixed an issue with
/money
commands failing on some servers.
v2.6
- adds display name and lore support for currency items. See configuration instructions on how to configure this. Note you will need a third-party plugin to rename items not created by Gringotts. Thanks to dj5566 for contributing this feature!
startingbalance
config option works again
Planned Features
See: Gringotts open enhancement issues on GitHub. You're welcome to vote on enhancements important to you, but I might not have the time to implement them.
Instructions
Wiki
Check out the Gringotts Wiki for more hints and a troubleshooting guide.
Installation and Configuration
Download Gringotts and place it in your craftbukkit/plugins folder.
Please see the Configuration and Permissions document on how to configure Gringotts.
Usage
For full information on configuration and usage in Gringotts v2.x, please see the configuration page and the usage page respectively.
Storing money in an account requires a Gringotts vault. A vault consists of a container, which can be either chest, dispenser or furnace, and a sign above declaring it as a vault. A player or faction may claim any number of vaults. Vaults are not protected from access through other players. If you would like them to be, you may use additional plugins such as LWC or WorldGuard.
Player vaults
Place a sign above a container block, with [vault]
written on the first line. If it was created correctly, the sign will display your name on the third line and you will receive a message that the vault has been created.
Faction vaults
Place a sign above a container block, with [faction vault]
written on the first line. If it was created correctly, the sign will display your faction's tag on the third line and you will receive a message that the vault has been created.
Towny vaults
- To make a vault for your town: place a sign above a container block, with
[town vault]
written on the first line. - To make a vault for your nation: place a sign above a container block, with
[nation vault]
written on the first line. If it was created correctly, the sign will display your town's or nation's tag on the third line and you will receive a message that the vault has been created.
User commands
/money
Display your account's current balance.
/money pay <amount> <player>
Pay an amount to a player. The transaction will only succeed if your account has at least the given amount plus any taxes that apply, and the receiving account has enough capacity for the amount.
/money withdraw <amount>
/money deposit <amount>
Withdraw an amount from vault storage into inventory, or deposit from inventory to a vault.
Admin commands
/moneyadmin b <account>
Get the balance of a player's account.
/moneyadmin add <amount> <account>
Add an amount of money to a player's account.
/moneyadmin rm <amount>
Remove an amount of money from a player's account.
/gringotts reload
Reload Gringotts config.yml and apply any changed settings.
Need Help?
- First, check the Wiki.
- For support requests, feature requests and bug reports, please open a ticket.
- Drop by the Gitter channel and talk to me (jastice), and I will drop by.
- When your issue is resolved, update the wiki troubleshooting page!
Also, follow me on twitter: @ebenwert
Source and Continuous Integration
Gringotts is open source. View, fork and edit on Github
CI Status: Current Development builds Automatic Release builds
CI Builds have not been review by BukkitDev staff. Install at your own risk, just like anything else from the internet.
@RustyDagger
One issue with your config though is that the lore is a simple string, but it needs to be a list of strings. I will change it to also allow simple strings ...
@RustyDagger
Okay, I also just got around to adding the color code thing, so Gringotts now also supports the & character. Here's a dev version, let me know if it works for you https://www.dropbox.com/s/9u3mgdlxyitz3q1/Gringotts-2.7-SNAPSHOT.jar?dl=1
I haven't been able to reliably track down the unloaded chunks issue though.
@ebenwert
Here you go I just zipped it And dropbox it If i dont zip it it opens as a webpage.... https://dl.dropboxusercontent.com/u/15543708/config.rar
@RustyDagger
Okay, gotcha. Please upload (not paste) your config file, and I will see if I can reproduce on a windows system.
@TheBlackBeltPanda
yea both ways. No luck Fiddled with it for ages.
@RustyDagger
Did you try converting to UTF8 before encoding in UTF8?
DUN DUN DUN I worked out what MY ISSUE IS and AS far as I can tell its not my ISSUE. when i save the CONFIG.yml as UTF-8 we get the errors about the comment lines. When i save it as UTF-8 Without BOM The File Loads FINE BUT we still get the silly Light Blue A Char In The Item name.
Error and Config: http://pastebin.com/Zxy3YLU9 removed the comment lines and Got this: http://pastebin.com/AR80Eifq
I am 100% sure its in UTF-8 Look Direct link: http://i.imgur.com/29oKymJ.png You can also see the UTF-8 without BOM I tried. Saving the config file In plain old UTF-8 Breaks it from loading. and plugin defaults back the the emeralds.
Please dont make me make a video to prove this too you.... I crap you not I change the encoding and the file loads I change it to UTF-8 And it spits silly errors trying to load the config.
@ebenwert
All im trying to do is color some Item Names and text It should not be this Hard. Already I'm having to paste in a stupid symbol Mojang decided would be a good idea.... And whats more Not once have you tried to help me save it in the right format Iv goggled for hours and tried every I can find. It either displays the stupid symbol every time I change color or the file is unable to load and it uses the default config.
Im working On a windows OS. maybe your on a MAC and its easy for you but it sure as hell is not for me I mostly use NP+ + for editing YML because It highlights errors and allows me to collapse sections.
sorry about getting a bit worked up It tends to happen when i get frustrated with silly simple things not working.
Any progress on the Vaults in Unloaded chunks issue ( money not being counted or Usable? )
@BobKyle10
Does it display any stacktrace? Did this only start with Gringotts 2.6?
@ebenwert
Having the same issue when using /money on my server.
In-game it says an internal error occurred, and the following appears on console:
"6:52:31 PM CONSOLE: ERROR]: null 6:52:31 PM CONSOLE: exception executing command 'money' in plugin Gringotts v2.6"
@mmuziek
Can you provide any more detail? Did it just stop working?
well the /money comand is now officialy dead on my server.
spigot 1.8.7 and gringotts 2.6
no errors just no output
@RustyDagger
If you are not using UTF-8 in 2015 then I just don't even. To transition currency items, you can make an item exchanger machine or something. Regarding your demanour: Get nice or get out. Thanks.
@ebenwert
I am unable to do it right apparently I opened it in notepad I selected all file typed clicked on the existing YML file and set it to UTF-8 and my whole config reset on server start.
Iv tried several other ways of saving the stupid thing in this dumb format and none of them work. Why not just do what every other Fing plugin does and write a gdam function. they do it for a reason to make things easy. because we all use different editors. and not all of them support UTF-8 crap. hell iv used some server hosts where you dont even get FTP you have to edit in the browser those people would be screwed.
Any way changing it at this point would Make all my players existing money worth Null and I cant be doing that to them.
@RustyDagger
Okay sorry, correction. Gringotts does create these items when creating money for you directly. I tried the config you gave me and it shows the colors as configured. Did you check whether your file is saved in UTF-8 format?
@RustyDagger
Gringotts does not handle the item renaming in any way. As the config instructions state:
"displayname is a modified item name. Only items with this exact name, including colors, will count as the specified denomination. This does not automatically rename all items of this type, you can use a separate item renaming plugin for this."
I hope that clears up your confusion.
@ebenwert
I use YOUR plugin for the item renaming.... Its in your config. It does the lore and Item name.
Here to refresh your memory. and explain it a little more.
http://pastebin.com/s6Bb9W3v
I also use stackable Items to stack the music disks It has a few issues of its own.
@Zaphinine @RustyDagger
I will have to experiment. What plugin do you use for item renaming and what is the config you use for that?
@Zaphinine
Yep I'm having the exact same issue. I was talking about using the codes in the messages file they work in there. But not in the config. :(
Have you ran into the unloaded chunk issue yet?
@RustyDagger
The color coding does not work in any way or form I try. I have tried using &, §, and codes such as \u00A74. It always leaves that weird symbol in front of it.
Screenshot for reference: http://gyazo.com/89d72e0946e67d583c1bc44ec16f3d2e
Config: http://gyazo.com/77b262cfff7954c2a7e1d66de249e6a3