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 there!! Man i just love this plugin and it is sad to see it fade away like this.This is and great RPG experience, and i wish you guys would keep updating it!I first saw it on Spigot ,, from a guy that did an update there and i was led back to you guys at Bukkit.I hope you will reconsider updating it again, although i saw that you "team" has not been online for a long tine :(
There is a need of an urgent update for the MassiveCore/Faction support ! :((( I've already spoke to the Massive Craft team and they sayd that i should come here and talk to you about it...You are my last hope.Im on spigot 1.8.8 and 2.8.4 Massive Core/Faction.
@ebenwert Thanks for the great RPG plugin experience , and i hope that i would see this one one day coming back to life!
Thanks in advance and Cheers!!
@ebenwert
Thanks alot man!
@Shidosh1
Ah, have a looka t the old version of the config instructions then: https://github.com/MinecraftWars/Gringotts/blob/15779f53270746ce6515cc0c3fe147777b8799c7/doc/configuration.md#example-denomination-setup-with-fractional-values-and-items-with-data-values
@ebenwert
I need to use the version that is compatible with 1.7.10 though. So that format does not work.
This is a forge mod im using, so I need to be able to use the meta id of it. As there are 4 different ones needed to be used. I know its working cause another server has it working im just unsure how. This is what I need.
http://pastebin.com/vDmMy5YE
@Shidosh1
Have a look at the ocnfiguration examples. There is a new config format that covers this.
How can I add meta ids to the denominations?
so I want this: denominations: 4096: 1 4096:2 64
It does not work no matter how I put it.
@Enterprise12
This is exactly was Gringotts was made for and does already. Gringotts allows small amounts of virtual currency to avoid some issues with fractional amounts, but that's it.
Modded ids *should* work. Can you describe how using them fails?
Have a request. Using factions with this, but it doesnt work well.
I dont like that you can have virtual $ like any other $ earning plugin. Say somebody claims land for 1 emerald, but if you want to reimburse them for unclaiming land - It gives them $1 back but virtually, it would be great if it gave them an emerald back.
The reason is, it would work amazingly with factions for raiding and stealing $. I use this on my modpack server, but because of this i cannot use it.
I tried adding modded ids to make currecny as well, that didnt work. Adding these two things would make this plugin perfect
@Liger_XT5
That version doesn't really do anmything else there, I think. I'll have a look this weekend or so.
The version of Gringotts on Spigotmc.org allows damage values in such a way. Any way it's possible to implement that into Gringotts?
@Liger_XT5
I'm not :) I just set the example values to use the same relation they have in crafting anyway.
@ebenwert
In your config example, how are you stopping people from crafting the gringott emeralds to emerald blocks?
@Liger_XT5
Oh I see. There might be a plugin that can disable crafting for specific items.
@ebenwert
I haven't tested it with lore, have I have tried with display names. I'm able to take the nuggets with custom name and craft them into normal gold bars with no custom name.
@Liger_XT5
Using damage value for these item types might just not work. For your goals, using displayname and/or lore should do the job.
@ebenwert Config: http://pastebin.com/XF66Yz6W
Error:
@Liger_XT5
Try with smaller damage values. You definitely can't use anything above 32767 (Bukkit/Minecraft limitation)
@ebenwert
I'm changing the damage value to prevent players from using the items in crafting. But still use the normal items for normal purposes. At this time, this is just testing and plan to add in custom items, based on other item's but with different damage values, with a custom resource pack.
Currently, without the damage value, someone could take the gold_nuggets, with a display name, and make an ingot, but shows as a normal gold ingot, which in turn means the player has the same amount of money, but made a normal item out of thin air.
@Liger_XT5
Can you explain how it fails (error message), and what you are expecting, or why you are setting these damage values? Usually non-use items will only have specific valid values.
The "damage" value is used to differenciate between different types of item with the same material id (for instance ink sack and lapis lazuli).
Setting the displayname means only items with a changed name will be counted as currency.
I'm presuming I'm doing something wrong, but when I attempt to add the "damage: 1" or any number under my currencies, just like "displayname:", it fails. All other attributes work so far. If I have Damage, the plugin fails to start.
Test config: