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 ebenwert ebenwert Jul 17, 2014 at 10:31 UTC - 0 likes

    @Ionaru: Go

    Yes, use the standard minecraft color markers (see http://minecraft.gamepedia.com/Formatting_codes)

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

  • Avatar of Ionaru Ionaru Jul 17, 2014 at 10:27 UTC - 0 likes

    In version 2.2, is it possible to add colors to the plugin messages?

    Last edited Jul 17, 2014 by Ionaru

    BFAK:90681013,9ac748b39f45e2bc686718915e64f1a6e139b48d2a4de03ae2c9fd8f9e8c253d

    https://dl.dropboxusercontent.com/u/43514962/Technobenner2metal.png

  • Avatar of ebenwert ebenwert Jul 06, 2014 at 22:22 UTC - 0 likes

    @FlintlockManager: Go

    No, Gringotts has only one currency config. You may customize item names with other plugins though.

  • Avatar of FlintlockManager FlintlockManager Jul 06, 2014 at 22:17 UTC - 0 likes

    Is there any way to use this plugin to setup different items per world, ex: Survival uses Emeralds while Factions uses Slimeballs?

    Also, is there a way to make it so the currency items have custom names and lore, therefore being unable to be duplicated by players??

  • Avatar of ebenwert ebenwert Jun 30, 2014 at 10:56 UTC - 1 like

    @Take4Spam: Go

    Latest version.

  • Avatar of Take4Spam Take4Spam Jun 30, 2014 at 10:50 UTC - 0 likes

    UUID?

  • Avatar of ebenwert ebenwert Jun 22, 2014 at 08:06 UTC - 0 likes

    @x_clucky: Go

    The behavior you see is to support this, even if you don't have it configured. You will observe that it only goes up to a limit.

  • Avatar of x_clucky x_clucky Jun 22, 2014 at 00:17 UTC - 0 likes

    @ebenwert: Go

    What exactly do you mean? Could you elaborate further? My economy doesn't support decimal values, only whole numbers (emeralds). Here is my config:

    # supported languages: "custom" (default, english) and "de" (german)
    language: custom
    
    # currency name and value config
    currency:
      # currency name to use in messages
      name:
        singular: Emerald
        plural: Emeralds
    
      # number of decimal digits supported by currency value (0 for whole numbers only)
      digits: 0
    
      # value of individual denominations. default: emerald: 1, emerald block: 9
      denominations:
        388: 1
        133: 9
    
    # tax on /money pay transactions
    transactiontax:
      flat: 0.0
      rate: 0.0
    
    # balance to start an account with (purely virtual)
    startingbalance:
      player: 0
      faction: 0
      town: 0
      nation: 0
    
    # globally (dis)allow use of vault types
    usevault:
      container: false
      enderchest: true
    
    Last edited Jun 22, 2014 by x_clucky
  • Avatar of ebenwert ebenwert Jun 20, 2014 at 06:50 UTC - 0 likes

    @x_clucky: Go

    Right, this can happen up to a small limit (specifically the value of the highest denomination). This is to support transaction values smaller than the lowest denomination.

  • Avatar of x_clucky x_clucky Jun 20, 2014 at 04:24 UTC - 0 likes

    @ebenwert: Go

    I didn't have container vaults enabled in the config, and when a player bought something from my shop (http://dev.bukkit.org/bukkit-plugins/shops), he got the item and I got a "virtual emerald". No errors, no denial of transaction, nothing.

    Last edited Jun 20, 2014 by x_clucky

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
14,303
Recent files

Authors

Relationships

Optional dependency
Factions
Towny Advanced
Vault
WorldGuard