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.
Hey guys, just wondering how I would go abouts interacting this with a shop plugin or something, rather than just using it as a bank. Any feedback is good feedback
STT
@Elbie27
You do indeed need v2.0 beta3, and I can confirm it as working with 1.5.2 of CB, as I have it running on my 1.5.2 server.
@ebenwert
I am using the 1.5.2 version of Gringotts, would it be the beta version I would need for this feature, if so is that 1.5.2 CB / Minecraft compatible?
@Elbie27
Are you sure you are using the v2.0 beta3, or are you using v1.5.2 of Gringotts?
Hi, I have installed the latest version. Everything works fine, no errors in console. Running Minecraft 1.5.2 and its CB equivalent.
Trying to make a vault for another. I have permission, and I even tried as OP.
No matter what I try the vault always comes back to being mine.
I have tried looking through the tickets and the github issues but cannot find why it is doing this. It makes no difference if I do this in a non WorldGuard area or not. No difference if I try it anywhere in my map.
Any ideas on what I am doing wrong?
Cheers.
P.s. Great plugin, seriously! Having this plus Shoppkeepers & Rebalance Villagers means I get a fully Emerald based Econ'
Thanks!! :)
@ebenwert
Aha! I had to dig around a bit and found the account name for regions was tracked as world-regionname in Gringotts. As soon as I set the shop owner to world-regionname, it worked! Thank you! :D
EDIT: Scratch that, I thought it worked but it was just me using /moneyadm add 1 world-regionname. :(
EDIT 2: Okay, scratch that again. They were unlimited shops with pay-unlimited-shop-owners set to false. Set that to true and now it works!
@KittyTristy
I see. Currently, Gringotts doesn't support support virtual/fake accounts, so an account needs to be tied to an actual account owning entity. I do plan on supporting this, but I've been really short on free development time the last month or so.
What you could try: Make a worldguard region which is the owner of the account, and tie this account to your admin shops etc. Not sure if that is supported by quickshop..
Okay, I'm using 2.0 beta and it's not working. I have the permissions, and just to be sure, I even made myself OP.
I'm typing the sign as follows:
Line1: [Vault]
Line2:
Line3: OtherPlayer
Line4:
@ebenwert
Oh, I feel dumb. I thought you just changed the version numbering. I'll try it out! :D
@KittyTristy
Hi. The feature is available in the current 2.0 beta. See the release notes in file description for the instruction :)
Will there be an update soon? I'd really like to be able to create vaults for other players, which seems to be missing from the current version, yet I saw it as a couple months old closed enhancement ticket on Github. Is this feature broken or is it just missing from the current version? Thanks! :3
@mkdunham
Did you check your enderchest? By default, Gringotts uses the enderchest as an additional vault if your ivnentory and regular vaults are full.
Also, Gringotts uses a small amount of virtual storage to deal with some edge cases where the full amount can't be added to the inventory as items
Great mod! Just one issue so far. I was doing some testing with the ChestShop mod and vault. If my inventory is full and someone buys one of my items, it increments my balance but the emeralds seem to be destroyed. Right now I have no vaults or emeralds on me but when I do /money it says I have 2.
Am I missing something?
@Aethios
I see, thanks for the update. I hadn't gotten around to trying it myself yet :)
@ebenwert
It seems that the permissions were not working because I did not know that I was supposed to copy the group/user files to each specific world. I had set the permissions properly, but since the permissions were written AFTER the worlds had been generated, they were never applied!
Sorry for wasting your time!
@Aethios
Thanks, I'll look into it.
@ebenwert
Gringotts v1.5.2 (console reports this as 1.5.1a for some reason)
bPermissions v2.10.4
CraftBukkit git-Bukkit-1.5.1-R0.1-21-g49b0699-b2754jnks (API v 1.5.1-R0.2)
I'll attach a copy of the config and permissions files for you to take a look at, as well.
@Aethios
Strange.. could you send me the config files? I'll see if I can reproduce.
For reference, what version of Gringotts, bPermissions and Craftbukkit are you using?
@ebenwert
- ^gringotts.createvault
- ^gringotts.usevault.enderchest
- ^gringotts.transfer
So on, and so forth. I used this method to disable all permissions except usevault and usevault.inventory, but players were still able to transfer money directly to each other using /money pay. Am I doing it wrong?