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.
@ebenwert
Then I wish i knew even a single thing about programming a plugin. or knew someone who did. I don't know where to even begin searching for that kind of feature, so i guess ill have to wait for now, at least till 1.9 where apparently i can assign texture to item damages, maybe even ones that dont exist. (when i put a damage to the firework star in the config it gives me a untextured mess)
@Excalibous
Oh my, more complexity. Let's say I'll accept pull requests for this feature, if you (make someone) get it to work :)
@ebenwert
Then that is my problem. Firework stars DO in fact work differently. their colors are defined by an NBT tag, not a damage value like dye does. Hmm guess I'll have to either just use normal fireworks stars or find something else. Thanks though, sorry to put you through any trouble. Though i do suggest maybe looking into adding a way to define NBT tags on items as well to increase customization.
@Excalibous
Unless firework stars work differently from any other minecraft item, the color is defined by the damage value, probably the same way dyes are. I don't know what you use to make custom fireworks and don't have time to play around with it, sorry.
@ebenwert
I think we're talking about two different things here. I think you're seeing it as every firework star has a different damage value as if you were to type minecraft:firework_charge {damage:2} where this is not the case. to make a custom firework star like i have done you have to do {explosion:{type:3,color:[(whatever the color value is)]}} so would I just type that into the damage value line? or are we talking about two different things?
@Excalibous There's examples in the configuration documentation. You just need to find the right damage values for the colors you want to use, or experiment around with them. I don't have them at hand, sorry.
@ebenwert
Would i do this as if i were making a command out of it? i understand the damage value is the variation of the item. but i'm not sure how i would go about changing the data value on its line. if you could give me an example (preferably using a custom color) so i could see more of what you mean.
@Excalibous
The display name is a custom name. You probably want to adjust the damage aka durability aka data value to select a specific color of firework star.
a quick question. i want to use different colored fireworks stars as sudo coins. how would i go about defining these if its at all possible?
EDIT: nevermind, i read through the configuration guide very thoroughly and found the displayname tag so i can just name them what i want and it will count them. Great plugin if it includes such customization as that!
EDIT 2: So I tried out the display name option for it and it doesnt seem to allow me to have custom colored ones which is unfortunate as i was really hoping i would be able to have them be told apart easier. is there anyway to set it so that it will do it with a specific colored firework star?
@Gergthegog
Make sure you're u sing the latest version of Gringotts and have only one Gringotts jar in your plugin folder
Still no luck :(
@Gregory46
Try deleting your gringotts config file, start server, and see if it works then.
@ebenwert
You may want to fix that, it was the default config. Thanks!
EDIT: New config, still didn't load. Only change was what you told me
EDIT#2: Now I am getting an internal error when I try to reload it.
EDIT#3: Yamllint says my yaml is ok, Gringotts is now red in the plugin list and gets no feedback on any of the commands.
EDIT#4: Changed my config to this, Gringotts got enabled again. but my config still isnt loading. Yaml lint also gave me this error again.
YAMLERROR: (<unknown>): did not find expected key while parsing a block mapping at line 4 column 1
@Gregory46
Looks like the error is actually here:
The correct format is:
@ebenwert
I'm having some trouble with the config, getting this error:
[Server] INFO at org.gestern.gringotts.Commands$GringottsCmd.onCommand(Commands.java:255) [Gringotts-2.7.jar:?] 27.01 17:30:01 [Server] INFO at org.gestern.gringotts.Gringotts.reloadConfig(Gringotts.java:186) [Gringotts-2.7.jar:?]
here is my config:
I used a yaml parser and it say the error is in the line 4
language: custom
but that's funny because I never changed that line .-.
Anyways, I'm stuck with the default options because it says [Gringotts Reloaded!] in the server but in the console it says unable to reload /plugins/gringotts/config.yml error in line 4,
Please help!
Edit: The config isn;'t exactly as its shown, the comment has messed it up. Here is the pastebin. http://pastebin.com/4h1tGE8M
@Space_m0nkey
IT sounds like you are not using the current version of Gringotts (v2.7) from this site. It should be compatible with current Factions.
@ebenwert
Here are the tickets that i have opened there,
https://github.com/MassiveCraft/Factions/issues/1009
and
https://github.com/MassiveCraft/Factions/issues/1007
Thanks again!
<<reply 2710165="">>
@ebenwert
Yes they did change the API, they told me that you are using really outdated one, like an year old...
And yes there are errors..., well enough of them.From the all kind of /f c /o /s to the auto-disband and few more.I can send you the tickets that i have opened there at the Massive Craft team, about this.
Btw right now i em using this version...
www.spigotmc.org/resources/1-8-7-gringotts-unofficial-release.3473/
@Space_m0nkey
So, is there actually any errors or issues using Gringotts 2.7 with Factions 2.8.4?
@Space_m0nkey
Eh, did they change their API again? I'll have a look.