Gringotts is an item-based economy 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.

Get Gringotts from BukkitDev or from Spigot!

• 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 Towny and WorldGuard
• Vault integration

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 or on it 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.

Read how to use gringotts.

Read how to config gringotts.

Read how gringotts permissions works.

Read how to use gringotts commands.

Download Gringotts and place it in your craftbukkit/plugins folder

Please see the Configuration and Permissions document on how to configure Gringotts.

Have a look at the Wiki. You're welcome to improve it, too!

Would you like to make changes to Gringotts yourself? Fork it! Pull requests are very welcome, but please make sure your changes fulfill the Gringotts quality baseline:

• new features, settings, permissions are documented
• required dependencies are all added to the build by Maven, not included in the repo
• the project builds with Maven out-of-the-box

Gringotts uses the Maven 3 build system. Build a working plugin jar with the command

mvn compile package

This shades in some dependencies (such as plugin metrics). For this reason, creating a jar package manually or from an IDE may not work correctly.

Add the JitPack repository to your build file

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

	allprojects {
		repositories {
			maven { url 'https://jitpack.io' }
		}
	}

Add the dependency

	<dependency>
	    <groupId>com.github.nikosgram</groupId>
	    <artifactId>Gringotts</artifactId>
	    <version>-SNAPSHOT</version>
	</dependency>

	dependencies {
	        implementation 'com.github.nikosgram:Gringotts:-SNAPSHOT'
	}

That's it!

All code within Gringotts is licensed under the BSD 2-clause license. See license.txt for details.