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

supports player UUIDs
old Derby databases will be automatically migrated to the Bukkit-internal database
player names in the database will be automatically migrated to UUIDs
built against Bukkit 1.7.9, Vault 1.4, Java 7.
This version of Gringotts may no longer work with older versions of Bukkit, Vault and Java.
vaults can now be created from most containers (chest, trapped chest, hopper, dropper, dispenser, furnace)
fix a bug preventing creation of vaults when the db still contained vaults in deleted worlds
fix a bug allowing to create multiple vaults on a single container
fix messages on taxed transactions (thanks noidexe!)

v2.2

  • use factions 2.x
  • build against bukkit 1.7.2

v2.0.5

  • fixes for invalid vaults.
  • fix vault creation breaking under some circumstances involving Towny
  • added support for built-in Bukkit database support. This means that the Derby library is no longer required. If the Derby jar is present, Gringotts will continue to use it, otherwise a DB will be created via the Bukkit API. This should also support MySQL if you configure it in bukkit.yml. Please see the http://wiki.bukkit.org/Bukkit.yml#database for details.

Planned Features

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?

For support requests, feature requests and bug reports, please open a ticket.

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 Prodkid Prodkid Oct 07, 2014 at 06:01 UTC - 0 likes

    Could it be possible to store money in a virtual vault, through a command that opens up a chest GUI and stores the vault in a flat file? This could make it possible to have banks in towns and also be a more secure way for players to store their money.

  • Avatar of Machinimatt Machinimatt Sep 25, 2014 at 19:32 UTC - 0 likes

    When I make a Vault for another player it also links me to that Vault and overrides any Vaults I created for myself, how do I stop this from happening?

  • Avatar of ebenwert ebenwert Sep 01, 2014 at 06:29 UTC - 0 likes

    @FabioZumbi12: Go

    You can disable permissions for using, withdrawing and depositing to vaults for your creative world for this effecf.

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

  • Avatar of FabioZumbi12 FabioZumbi12 Sep 01, 2014 at 05:13 UTC - 0 likes

    Can you add a whitelist for the plugin work only in that worlds? I have onde world for criative, and theres a serious problens with this :/

    Thanks!

    Area Z12 Brasil

  • Avatar of ebenwert ebenwert Aug 28, 2014 at 05:08 UTC - 0 likes

    @VaiN474: Go

    The problem with towny can occur when you enable the "closed economy" feature of Towny, because it will try to deposit the money to a virtual account, which doesn't have a vault. Support for this is planned, but not yet implemented.

    By default money in your inventory (and enderchest) counts toward your balance, as long as you are online. This can be disabled with permissions. So that should work - if it doesn't, let me know.

    Vaults can be protected with a third party plugin of your choice, such as Lockette, WorldGuard, etc.

  • Avatar of VaiN474 VaiN474 Aug 28, 2014 at 00:03 UTC - 0 likes

    Anyone manage to get this working with Towny? No matter what I do it can't seem to find my money in any vault created (or from my inventory). It labels the vaults when created so it acts like it working, but towny always says I don't have enough money, even if the vault is full.
    Edit: It seems to be working now. I'm not sure what changed but I removed my vaults and recreated them and now it's updating the bank values for nation/town. It still doesn't let me deposit funds from my inventory or my personal vault though.

    Also is there any way to use what's in your inventory, such that you could purchase from a store just by having the money on you? I'd hate to have to force players to create unprotected vaults in the wilderness when they are already at the store with enough money to make a purchase. Having to carry their funds is a risk I like. But it seems odd they can't use it when it's on them. Or is there some way to create a bank system that is protected? I'd love to have an NPC from Citizens2 that acts as a bank and lets players deposit emeralds into their vault, but I'm guessing it's not possible.

    Last edited Aug 28, 2014 by VaiN474
  • Avatar of ebenwert ebenwert Aug 24, 2014 at 00:34 UTC - 0 likes

    @siemaeniu500: Go

    Sorry, I can't parse that.

  • Avatar of siemaeniu500 siemaeniu500 Aug 23, 2014 at 14:40 UTC - 0 likes

    <<reply 2319501>>

    i want that to create factions player need, just for example: 32 diamonds, 32 iron ores, 32 dirt, 32 stone

    How i can do that

  • Avatar of ebenwert ebenwert Aug 21, 2014 at 23:29 UTC - 0 likes

    @iTurquoise: Go

    You can do this with a third party plugin, such as Item Renamer. However some people have run into some bugs with it. Let me know how it works for you.

  • Avatar of iTurquoise iTurquoise Aug 21, 2014 at 18:13 UTC - 0 likes

    Hi, I was wondering if there is anyway to customize the item name and lore for the currency? I would like to customize my currency name and lore for my server. If this is not a feature, could you please make it possible?

Facts

Date created
Sep 27, 2012
Categories
Last update
Jul 12, 2014
Development stage
Release
Language
  • deDE
  • enUS
License
BSD License
Curse link
Gringotts
Downloads
15,517
Recent files

Authors

Relationships

Optional dependency
Factions
Towny Advanced
Vault
WorldGuard