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 suggest LWC support so that you cannot make a vault on a locked chest if not done already.
How do I get the auto-conversion to work? I am using a mod that adds actual coin items to the game on Cauldron (yeah I know I won't get much support for it) and it's set that 64 of the copper coin = 1 silver coin. Upon picking up the item, it will not convert.
Is it supposed to do this? If so, can I get it to work the way I need it to?
Does it only work with adding and transactions?
@ebenwert
yeah sure
what do you need ? i have no logs at all concerning this problem
my server is running on MC 1.7.2 i use cauldron so that i can use mods my Gringotts version is 2.2 and AreaShop is version 1.2.1 (worldguard and worldedit 6)
If you need more details tell me
thanks
@silentspectr
Sounds weird. Please message me your server details so I can check it out later this week.
@ebenwert
i just tried and yes the balance changes when i click the sign with the coins not in my hand, my balance deduces the price i just paid but when i drop the coins on the ground and then take them again, my balance increases the amount of the coins supposed to be spent on the rent. And the rent is still valid.
do you think this might come from your plugin or from my coins ?
thanks
@ebenwert
nop i keep all my coins and i can reuse them infinitely like this to rent new regions or so
but when stored in a vault it works perfectly
@silentspectr
So the balance does not change at all when the coins are not in the hand?
@ebenwert
it's a really great plugin my server needed something like that
so i installed AreaShop to couple it with gringotts and rent regions with my item coins
it works really great with the vaults too
only little bug i'm facing is that when i click an AreaShop sign with my coins in hand, the coins are removed from the inventory and the area rented (all normal here) but when i don't have my coins directly in my hand but there are in my inventory, the area is correctly rented but my coins aren't removed from my inventory (not normal)
i asked to the AreaShop dev and the bug don't appear to come from his plugin. maybe it comes from gringotts ?
can you help me with this please ?
i'm using the 2.2 version of gringotts
thanks
@mrelfire
What version of Vault, Gringotts, CraftBukkit are you running? Have you checked that there is only one jar each of Vault and Gringotts in the plugins folder?
@silentspectr
Thank you, makes me smile to hear that! : )
To the person who made this plugin: I'm in love with you thank you for this it's the definition of awesomeness
I manage to have gringoot running but I have this problem with hyper economy
same problem with stats plugins
any suggestions ?
@REMLIK1
Could you open an issue with relevant details, such as what kind of error? Thanks!
There seems to be some issue between Towny 0.89.2.0 and Gringotts 2.4 as every time taxes are applied, it doesn't work and produces an error in the console. I am using Spigot 1.8 and Vault 1.5.3 also. It appears to work when switching to CraftBukkit 1.8. Any solutions?
@Derthmonuter
which version areyou using, I have tryed 2.4 and it is not working ?
Hey,
Love the plugin, its exactly what we needed, but I am struggling to get this to work with QuickShop NotLikeMe. Is this plugin compatable?
@Derthmonuter
You could write a pugin that accesses the Vault or Gringotts API to query the data and write it in a db in certain intervals or so, yes. The APIs aren't very complicated :)
@ebenwert
I see! Would there be any way for me to accomplish what I'm trying to do through databases then? I've never worked with Vault before...how would I access the data? I'd feel confident writing my own plugin to log it to a database if I knew how to access it. :)
Thanks.
@Derthmonuter
The actual data is ingame, in the player's vaults :) Gringotts doesn't synchronize it with the db or anything. The cents column is only used for fractional amounts and certain overflows.
@ebenwert
Oops, never actually tagged you for the below post. Doing so now.