Gringotts

Gringotts Goblin Head

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.6

  • adds display name and lore support for currency items. See configuration instructions on how to configure this.
    Thanks to dj5566 for contributing this feature!
  • startingbalance config option works again

v2.5

  • fix some currency requests causing internet accesses and thus lag spikes. Should fix some problems people have been having with Towny
  • /money now shows money in vaults and money in inventory in addition to total balance

v2.4

  • updates to dependency versions:
    • Bukkit API 1.8.3-R0.1
    • Vault API 1.5
    • Factions / MassiveCore 2.7.5 (incompatible with older Factions versions)
    • Towny 0.89.2.0
    • WorldGuard 6.0 beta
  • minor fixes in message formatting

Planned Features

See: Gringotts open enhancement issues on GitHub. You're welcome to vote on enhancements important to you.

Instructions

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?

  1. First, check the Wiki.
  2. For support requests, feature requests and bug reports, please open a ticket.
  3. When your issue is resolved, update the wiki troubleshooting page!

Also, follow me on twitter: @ebenwert

Source

Gringotts is open source. View, fork and edit on Github

Metrics

We use metrics to collect stats! We only collect basic information such as cpu info, plugin version type, and players online. If you want to see everything, click on the graph.
Go into plugins/PluginMetrics/config.yml to disable stat collecting if you wish.

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of RustyDagger RustyDagger Jul 31, 2015 at 13:53 UTC - 0 likes

    @Zaphinine: Go

    Use the codes you would use in the server MOTD the one in server.properties. Or save the file as Md-5 or something odd cant remember what the dev said but basically use the java escape codes. Works for me.

    @Dev.

    Any way you can support http://dev.bukkit.org/bukkit-plugins/stackableitems/

    I am using Music disks as My money items. The issue I am having is that gringotts puts one item in each slot rather than letting stakabletimes stack the items.

    Also Can we maybe get some Optimize command for the money in the players inventory by this I mean the player has 3x 100 2x50 and 1x 5 adding upto 405 but the plugin failed to merge the 2x 50 into 1x 100 and failed to save an inventory space now weather you can make it do this on the fly or just add a command to compress Im not sure but Players value their inventory space, I have 12 denominations granted they are not likely to often have more than 4 or 5 in their inventory at one time but it does make me worry that they may NEVER get some of the higher values if the plugin does not merge lots of small values into one larger value.

    • Current Job: Taxi Driver.
    • Hobby: OzCraft
  • Avatar of TheBlackBeltPanda TheBlackBeltPanda Jul 31, 2015 at 06:12 UTC - 0 likes

    Getting spammed with "Lag Notice - Slow Economy Response - Request took over #ms!" after installing this on Spigot 1.8.8. Any ideas?

    Also, when money is withdrawn from an Enderchest during a purchase, all of the money in the enderchest is placed into the player's inventory.

    Lastly, it seems my players often have to manually place their money in their vaults before they can use the deposit command.

    Subscribe and become a Pandaling today! youtube.com/theblackbeltpanda

    Owner of PandaCraft

    PandaCraft

  • Avatar of Zaphinine Zaphinine Jul 29, 2015 at 09:56 UTC - 0 likes

    @Zaphinine: Go

    Also color codes in the messages.ymal don't work properly for some reason. They will color the text but will also leave a weird symbol.

    I am using § color codes.

  • Avatar of Zaphinine Zaphinine Jul 29, 2015 at 06:26 UTC - 0 likes

    Is there a way to make a server-wide vault that has an inventory specific to each player? I'd like to use something like the Global Banks plugin but I'm not sure if Gringotts will compatible (probably isn't). I can't test how well it would work right now either.

    Any way this can be implemented into the plugin?

    GlobalBanks: http://dev.bukkit.org/bukkit-plugins/globalbank/

  • Avatar of ebenwert ebenwert Jul 28, 2015 at 20:35 UTC - 0 likes

    @nakkettaja: Go

    Hard to interpret... are you using something other than the builtin SQLite database?

    BFAK:jast,90591661,29dd3c62f13055888a0278b5f523f4707080bdfbae848c19bb40cad45b19d27d My plugins: Gringotts: Item based currency economy system | Shaped Borders: World borders with combinable shapes | EnderPearl Cooldown

  • Avatar of nakkettaja nakkettaja Jul 27, 2015 at 17:38 UTC - 0 likes

    http://pastebin.com/9fjuKdFv

    There it is, there is no typical "15 lines of error" but... it won't just launch the server

  • Avatar of ebenwert ebenwert Jul 27, 2015 at 13:23 UTC - 0 likes

    @nakkettaja: Go

    I'm afraid I can't diagnose the error from those lines, there's no obvious error. Could you paste the complete log into a pastebin or so?

  • Avatar of nakkettaja nakkettaja Jul 27, 2015 at 12:06 UTC - 0 likes

    Gringotts in version 2.5 blocks the start of server. (Really often, not always)

    Console:

    [15:01:32] [Server thread/INFO]: DataSourcePool [Gringotts] autoCommit[false] transIsolation[SERIALIZABLE] min[2] max[20]
    [15:01:32] [Server thread/INFO]: SubClassFactory parent ClassLoader [org.bukkit.plugin.java.PluginClassLoader]
    [15:03:39] [Thread-4/INFO]: Stopping server
    

    If I delete the Gringotts from plugins folder or disable it, server starts immediately. Any solutions?

    I'm not sure is it Gringotts which causes a butt ton of lag to my server but... If it blocks the server's start, it might broke the uptime aswell.

    Last edited Jul 27, 2015 by nakkettaja
  • Avatar of ebenwert ebenwert Jul 24, 2015 at 07:54 UTC - 0 likes

    @dragonfire967: Go

    If the association between town and your vaults somehow got broken, you'll probably have to recreate the vaults, yes. I can't diagnose the problem any better :)

  • Avatar of dragonfire967 dragonfire967 Jul 23, 2015 at 10:35 UTC - 0 likes

    Hey, I had to upload a backup of my towny data back to my server due to a crash (hosting company's fault), and had to reclaim my town (recreate the town, and claim plots). The vaults I had made for the town still exist, with the same town name on the vaults, and money in them, but the money isn't showing up when I do /t to check my town's money. Is there a way to resync my vaults with my town, without having to recreate all the vaults (destroy and replace signs), or am I pretty much forced to do that.

Facts

Date created
Sep 27, 2012
Categories
Last update
Jul 28, 2015
Development stage
Release
Language
  • deDE
  • enUS
License
BSD License
Curse link
Gringotts
Downloads
19,418
Recent files

Authors

Relationships

Optional dependency
Factions
Towny Advanced
Vault
WorldGuard