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

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

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?

  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 silentspectr silentspectr May 20, 2015 at 12:46 UTC - 0 likes

    @ebenwert: Go

    ok thanks for looking at it i'll find an other way

  • Avatar of TitanFoxx TitanFoxx May 18, 2015 at 23:15 UTC - 0 likes

    @ebenwert: Go

    Ah, I figured I could do so I was just hoping it would be something worth adding as a feature :P. Thanks for your response though!

  • Avatar of ebenwert ebenwert May 16, 2015 at 21:59 UTC - 0 likes

    @TitanFoxx: Go

    You can define multiple denominations for your currency (see config instructions), with certain items being worth, for example, 1000 emeralds, and have trade stations for them.

    I'm afraid I currently can't invest time into new features.

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

  • Avatar of ebenwert ebenwert May 16, 2015 at 21:55 UTC - 0 likes

    @silentspectr: Go

    Unfortunately, no : (

  • Avatar of TitanFoxx TitanFoxx May 15, 2015 at 23:09 UTC - 0 likes

    Is there anyway you could add a feature for the ability to put the economy item in containers other than vaults to be able to disable it?

  • Avatar of TitanFoxx TitanFoxx May 14, 2015 at 22:44 UTC - 0 likes

    @ebenwert

    Hey, not sure if it's possible or something you'd be interested in but could you possibly add a "bank note" feature. So a player can create a vault and if he/she wishes they can convert this somehow into bank notes (max amount could be configurable).

    The reason for this is because I don't want players using a virtual payment system at all, no withdraw, deposit, pay etc. So say a player is offering a sword for 1,00,000 Emeralds, it'd be impossible to carry that amount but a bank note could equate to that much.

    Last edited May 14, 2015 by TitanFoxx: name again
  • Avatar of silentspectr silentspectr May 05, 2015 at 07:37 UTC - 0 likes

    @ebenwert: Go

    Hi so do you have any idea on what's causing the bug with areashop ?

    thanks

  • Avatar of HollishKid HollishKid May 04, 2015 at 23:31 UTC - 0 likes

    The idea of this plugin is great!
    I'm fairly new to it though, and trying to install it on my CB1.8 server, it doesn't seem to want to load properly:

    [Server thread/ERROR] : Could not load 'plugins/Gringotts-2.3.jar' in folder 'plugins'
    [Server thread/INFO] : Busy Connections:
    [Server thread/INFO] : Reseting DataSourcePool [Gringotts] min:2 max:20 free:0 busy:0 waiting:0 highWaterMark:0 waitCount:0 hitCount:0
    [Server thread/ERROR] : FATAL: DataSourcePool [Gringotts] is down!!!
    [Server thread/INFO] : DataSourcePool [Gringotts] autoCommit[false] transIsolation[SERIALIZABLE] min[2] max[20]
    [Server thread/ERROR] : ebean.properties not found

    It just generates an empty "Gringotts" directory in plugin folder.
    Any ideas where this could come from?
    Thanks for your response!

    Just another new guy ...

  • Avatar of Maccaronne Maccaronne May 02, 2015 at 20:59 UTC - 0 likes

    @ebenwert: Go

    Great plugin!

    One issue I found though. If a player has a renamed item (i.e: Emerald renamed as "&a1 dollar"), the item is still counted as a currency item and added while using /money, but won't be deducted from using money.

    Please consider fix this, or add custom display support.

    Last edited May 02, 2015 by Maccaronne
  • Avatar of silentspectr silentspectr Apr 29, 2015 at 17:47 UTC - 0 likes

    Hi

    i just noticed that every time i start my server, i got this warning in my logs

    "[Server thread/ERROR]: Error registering MBean[Ebean:server=Gringotts2]"

    it doesn't affect any in game experience but what does this warning means ?

    thanks

Facts

Date created
Sep 27, 2012
Categories
Last update
Mar 22, 2015
Development stage
Release
Language
  • deDE
  • enUS
License
BSD License
Curse link
Gringotts
Downloads
18,116
Recent files

Authors

Relationships

Optional dependency
Factions
Towny Advanced
Vault
WorldGuard