YardWatch (for server owners)

Implementation of YardWatchAPI for common protection plugins. If any of supported plugins implements the API itself, then this plugin will stop providing its implementation to allow the plugin to take over.

If you're a developer looking for information how to implement YardWatchAPI in your plugin, see YardWatchAPI

Requirements

• Java 17
• Minecraft 1.16+

Implementations for:

• GriefPrevention (v16+)
• WorldGuard (7.0.0+)
• LWCX
• FactionsUUID
• SuperiorSkyBlock
• Towny
• PlotSquared (6.0.0+)

Plugin you're using is not implementing YardWatchAPI?

Contact the plugin developer and send them here!

You can also request a temporary implementation within this plugin here.

YardWatchAPI (for developers)

API to unify protection plugins for minecraft bukkit servers to allow easy protection queries without having to import 10 different plugin apis with separate implementations.

Current version:

If you're looking for a plugin implementing YardWatchAPI for common protection plugins, see YardWatch plugin.

Usage

Import the api using dependency manager

In any case of usage you will need to import the API. Replace VERSION with current version tag. You should also adjust your <scope> to provided if you're not implementing the api and just querying it.

Maven

<repository>
    <id>jitpack.io</id>
    <url>https://jitpack.io</url>
</repository>
<dependency>
    <groupId>com.github.YouHaveTrouble</groupId>
    <artifactId>YardWatchAPI</artifactId>
    <version>VERSION</version>
    <scope>compile</scope>
</dependency>

Gradle

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        mavenCentral()
        maven { url 'https://jitpack.io' }
    }
}
dependencies {
    compileOnly 'com.github.YouHaveTrouble:YardWatchAPI:VERSION'
}

For plugins wanting to see if something is protected

Check if player can break a block

Example handling of block breaking check. There's no need to depend on any plugins for this.

public boolean canBreakBlock(Player player, Block block) {
    ServicesManager servicesManager = getServer().getServicesManager();
    Collection<RegisteredServiceProvider<Protection>> protections = servicesManager.getRegistrations(Protection.class);
    for (RegisteredServiceProvider<Protection> protection : protections) {
        if (protection.getProvider().canBreakBlock(player, block.getState(true))) continue;
            return false; // if any protection plugin disallowed breaking the block, return false
        }
    // If all protection plugins allowed breaking the block, return true
    return true;
}

For protection plugins

Depend on YardWatch plugin

You can optionally softdepend and check if YardWatch is present to add an optional integration.

depend:
  - "YardWatch"

Implement Protection interface

Implement all the methods required by the interface

public class YourPluginProtection implements Protection {}

Register your implementation as a service

@Override
public void onEnable() {
    getServer().getServicesManager().register(
        Protection.class,
        new YourPluginProtection(),
        this,
        ServicePriority.Normal
    );
}