cfharchive / reserve Goto Github PK

A plugin offering a variety of APIs for unison across the Spigot/Bukkit ecosystem.

License: GNU Lesser General Public License v3.0

Java 100.00%

reserve's Introduction

Reserve

The goal of the Reserve project is to provide a common set of APIs to allow for painless compatibility between various spigot plugins.

APIs Available

Economy

Future APIs

Ban
Permissions
Land Protection
Minigame

Maven

If order to include Reserve into your project via Maven use the following repository & dependency lines in your POM file.

<repositories>
    <repository>
        <id>reserve-repo</id>
        <url>https://repo.codemc.io/repository/maven-public/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>net.tnemc</groupId>
        <artifactId>Reserve</artifactId>
        <version>0.1.5.3-SNAPSHOT-4</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

Gradle

In order to include Reserve into your Gradle project, first add the Maven repository to your repositories section.

repositories {
    // Reserve API
    maven {
        name = 'reserve-repo'
        url = 'https://repo.codemc.io/repository/maven-public/'
    }
}

Then you add the latest version into your dependencies category like so.

dependencies {
   // Reserve API
   compileOnly group:'net.tnemc', name: 'Reserve', version: '0.1.5.3-SNAPSHOT-4'
}

reserve's People

Contributors

Stargazers

Watchers

Forkers

d4rk1oyt mrletsplay2003 broduer noisypanic ludwig7959 ninekothecat cyberflamego andre601

reserve's Issues

Merge Request with GemsEconomy

This a economy plugin made by Xanium, it's supports multicurrency system so it will be cool see this with reserve api and not with vault.

https://gitlab.com/xanium-s-spigot-plugins/GemsEconomy

Gradle mention in README.md missing.

The readme does not mention how to add it as a dependency in Gradle.

NBT API

Must allow NBT modifications to craftbukkit and Glowstone
Not require a plugin release for new releases.

Is this still being actively maintained?

https://www.spigotmc.org/resources/reserve.50739/
Spigot page said that it was only tested on 1.14,I'm not sure whether should I use it.

Item API

This would allow the serialization and deserialization of ItemStacks on a multi-version basis.

Need explanation about major and minor tiers of currency

Based on implementation here, it seems to be just returning null.

Any plan on using it?

Ban API

It would be useful a Ban API, for example to detect if a player is banned, or to ban a player not only with the vanilla ban system.

Transactions without world

I'm using it like

reserve.addHoldings(uuid, BigDecimal.valueOf(amount), null, curr.name()

Not sure if it will work until I test it.

Does it count where the world value is null?

Team API

Good to see someone is working on something which is an extended version of Vault. I was actually thinking that it might be good to create one like this, and thanks to you already worked on it.

A Team API is a simple API yet can be a powerful middle man for lots of plugins.

For example, there are lots of plugins that form a team (Factions, Kingdoms, etc.), yet as far as I know, there is no plugin like Vault to query if some players are in the same 'team'.

It can be a handy API for lots of plugins since knowing who is in the same 'team' is helpful in various cases, such as sharing claimed lands, sharing chests, sharing items, private chats, etc.

For now, if someone wants to implement such a sharing functionality, they need to manually support all the plugins that form some kind of group.

I may want to jump in to contribute to the project, yet I don't have lots of time atm. So if you are interested, or anyone in the future, please support this feature.

How can I implement a customized economy using Reserve?

Hi, I am trying to find documentation to use ReserveAPI inside my plugin to create a custom economy system. The problem is that there is almost no documentation and the little that there is almost does not explain anything so I would need extensive documentation to be able to use this API.