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

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 sovredcat sovredcat Apr 16, 2014 at 23:20 UTC - 0 likes

    Yeah my fault. I might do that thanks.

  • Avatar of ebenwert ebenwert Apr 16, 2014 at 21:56 UTC - 0 likes

    @sovredcat: Go

    Colors do work. Note they are configured with a § symbol in MC.

    I don't feel making the command customizable adds alot, but you can build the plugin yourself with a command alias added. That should be rather simple.

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

  • Avatar of sovredcat sovredcat Apr 16, 2014 at 21:14 UTC - 0 likes

    Great plugin, it's working fine on my server. I was wondering whether you could add support for colors in messages? They don't seem to work.

    Edit: I was also wondering whether you could allow us to change the command from /money to something else. For example I use "coins" in my server and everything is centered around coin/coins. So having the command /coins would make more sense. I hope this isn't too much to ask for and that you are willing to do this, I'm on 1.6.4 :) Let me know!

    Last edited Apr 16, 2014 by sovredcat
  • Avatar of sovredcat sovredcat Apr 16, 2014 at 12:59 UTC - 0 likes

    Oops I didn't see. Thanks :)

  • Avatar of ebenwert ebenwert Apr 16, 2014 at 06:50 UTC - 0 likes
  • Avatar of sovredcat sovredcat Apr 16, 2014 at 03:36 UTC - 0 likes

    This is what I have in config.yml:

    # currency name and value config
    currency: 6718
    

    But it doesn't work.

  • Avatar of sovredcat sovredcat Apr 16, 2014 at 03:34 UTC - 0 likes

    I don't understand, how do you change it from emeralds to something else? I've made a mod which adds a coin item and I want to set it to that, but it doesn't seem to work :/

  • Avatar of ebenwert ebenwert Apr 13, 2014 at 23:17 UTC - 0 likes

    @WolfHunterzz: Go

    Something like 1-3 weeks. Either way, it doesn't look like anything will break before MC 1.8, so no worries.

  • Avatar of WolfHunterzz WolfHunterzz Apr 13, 2014 at 23:12 UTC - 0 likes

    @ebenwert: Go

    Eta?

  • Avatar of ebenwert ebenwert Apr 13, 2014 at 07:41 UTC - 1 like

    @WolfHunterzz: Go

    An update is in the works!

Facts

Date created
Sep 27, 2012
Categories
Last update
Dec 21, 2013
Development stage
Release
Language
  • deDE
  • enUS
License
BSD License
Curse link
Gringotts
Downloads
12,813
Recent files

Authors

Relationships

Optional dependency
Factions
Towny Advanced
Vault
WorldGuard