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.
I'd like to see a feature: give some amount of money to a player on server join. So he can, for example, claim a plot right away, without derping around in search of Emeralds or else.
@ebenwert
awesome lol i actually found my answer and then I saw you answered it as well I like this idea and hopefully will be able to get it going on my server soon
@dragonsblud01
Yes. Since a Gringotts vault is just a chest with a sign on it, the same rules as for regular chests apply in regard to raiding.
@Mergedflame
What exactly is the error message? Please open a ticket with any relevant information.
It disables gringotts when i start the plugin plz help i downloaded vault, derby and gringotts
@Captain-Dingo
You mean multiple items of the currency having the same value? I don't think I've tested that explicitly, but it should work fine. Change will probably only given in one of the denominations though.
Before I go and break something, I was just curious, is it okay for there to be multiple currencies that have the exact same denomination?
I'm asking because I run a sort of "harsh survival" world where the currency is food, and the food worths are based on how much hunger they restore (with several foods of course restoring the same amount).
Love this mod, thank you for continued development !
@MrREOM
Yes. Any plugin that supports Vault corretly should also work with Gringotts. If you have trouble with a specific plugin, let me know.
Does this work with auction plugins?
@commandLion
Thanks for the details. The issue doesn't look familiar to me, I'll have to look at what is actually happening.
Hey, was wondering if you have seen something like this before. I can open up a ticket once I head home for the day but in all honesty I am thinking it might have something to do with broker and how its working with vault. Here is the scenario i see when trying to set up an item for sale through the broker plugin, and attempting to buy with another account.
on startup I see both acknowledge eachother
[INFO] [Broker] Enabling Broker v1.6.1
[INFO] [Broker] Hooked in to Gringotts via [Vault]!
once in game i set up the scenario (item set for sale)
[INFO] vedisus issued server command: /bal
[INFO] vedisus issued server command: /broker sell 100
[INFO] vedisus issued server command: /bal
(first attempt to buy. Everything is normal, but it fails right when i press enter on "how many do you want to buy" prompt in the chat bar. Nothing in the logs, and no item or money exchanged. Try it again immediately after and then the DB connection lost message)
[INFO] weakCipher issued server command: /broker buy
[INFO] weakCipher issued server command: /broker buy
[WARNING] [Gringotts] Database connection lost. Reinitialized DB.
(ran a /bal to check funds on the original guy, no money gained or lost since the transaction never happened, but then it goes to a second connection lost triggered by that command - command comes from essentials)
[INFO] vedisus issued server command: /bal
[WARNING] [Gringotts] Database connection lost. Reinitialized DB.
after this last time it clears up but its almost like it gets hung on something and is waiting, then the 2nd time it gives warning. In all honesty i think it might be how broker is passing something back to vault but was just curious if this behavior was seen before as it might be something I overlooked. I can send info later tonight if needed.
@mrelfire
yes.
is Gringotts v2.0-beta3 compatible with 1.4.7 ?
Thank you so much!!
@Mortalsinn
Sorry for your troubles. Here's a bugfix! http://dev.bukkit.org/server-mods/gringotts/files/22-gringotts-v2-0-beta3/
I am so happy there was someone else with this issue that came forward.
This bug is killing the towns on my server right now :(
@commandLion
If I can't reproduce it locally, I'd like to try on your server. Could you message me the details please?
Thanks for your help!
@ebenwert
Towny version 0.82.1.0
Gringotts version 2.0 beta 2 (in this scenario)
I "thought" i tried the 1.5.1a which is why i went up to the beta 2 but I honestly believe I saw the same thing between both. I can try to swap between them and see on the test server.
I was using the recommended build for 1.4.7 1.0 but switched to 1.5 and saw the behavior between both. Let me know if there are any things you want me to test out. Would be glad to help. This plugin really is amazing!
@commandLion
I see. What version of Gringotts and Towny are you using?