MinecraftWars / Gringotts

Item based economy plugin for Bukkit
BSD 2-Clause "Simplified" License
37 stars 77 forks source link

Gringotts

Join the chat at https://gitter.im/MinecraftWars/Gringotts Build Status

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 get Gringotts from Spigot!

Looking for maintainers!

I initially created Gringotts a long time ago for a server that no longer exists, and I don't play Minecraft much anymore, and have many other interesting things to do. Thus, I can't devote much time to the project. I would like to hand the project off to somebody interested in its continued existence.

How to become a maintainer?

  1. Open a pull request with some kind of update for Gringotts:
    • update for a new version of Bukkit
    • add a feature
    • fix a bug
    • update documentation
  2. Say that you would like to be a maintainer.
  3. If the PR is reasonable, I will give you commit access to the GitHub repository and the bukkitdev project.

Features

Usage

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.

For full usage documentation, please see the usage page

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

Commands

See Usage.

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.

Problems? Questions?

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

Development

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:

Gringotts uses the Apache Maven 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.

Depending on Gringotts

Gringotts makes use of JitPack to provide itself as a just-in-time compiled Maven dependency.

Step 1

Add the JitPack repository to your project's build system.

See JitPack.io for boilerplate examples.

Supported build systems:

Step 2

Add the dependency. See your documentation, or the boilerplate on JitPack.io, for dependency declaration instructions. An example is given below for Apache Maven.

Replace the RELEASE_TAG with a valid tagged commit, or use master-SNAPSHOT to track the master branch. Note that Snapshots may require extra configuration of your repository.

<dependency>
   <groupId>com.github.MinecraftWars</groupId>
   <artifactId>Gringotts</artifactId>
   <version>RELEASE_TAG</version>
   <scope>provided</scope>
</dependency>

License

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