Skip to content

Loapu/VanishBridge

Repository files navigation

VanishBridge

VanishBridge is a simple plugin that provides information about vanished players on a proxy level. It is designed to be used by other plugins to provide a better experience for players.

Currently, VanishBridge supports the following proxy software:

And the following backend server software:

If you miss your proxy or backend server software, feel free to open an issue or create a pull request.

For Server Owners

Installation

The installation of VanishBridge could not be easier.

  1. Download the version required for your proxy software (e.g. Velocity) from the releases page.
  2. Drop the downloaded jar into your proxy's plugins folder.
  3. Restart your proxy.
  4. Download the version required for your backend server software (e.g. Paper) from the releases page.
  5. Drop the downloaded jar into every server's plugins folder.
  6. Restart your server's.
  7. Enjoy!

Configuration

No configuration needed!

For Developers

Installation

Maven

<repository>
    <id>loapu-releases</id>
    <name>Loapu Maven Repository</name>
    <url>https://repo.loapu.dev/releases</url>
</repository>

<dependency>
    <groupId>dev.loapu.vanishbridge</groupId>
    <artifactId>vanishbridge-api</artifactId>
    <version>1.0</version>
</dependency>

Gradle

repositories {
    maven("https://repo.loapu.dev/releases")
}
dependencies {
    implementation("dev.loapu.vanishbridge:vanishbridge-api:VERSION")e
}

Usage

Checking if VanishBridge is installed (Velocity)

@Plugin(
    id = "velocityexample",
    name = "VelocityExample",
    version = "1.0.0",
    dependencies = {
        @Dependency(id = "vanishbridge", optional = true)
    }
)
public class VelocityExample
{
    // Make sure to add this to your plugin class if you declared VanishBridge as optional
    public boolean isVanishBridgeInstalled() 
    {
        return proxyServer.getPluginManager().isLoaded("vanishbridge");
    }
	
    // Now you can use VanishBridge
    public void example()
    {
	    if (!isVanishBridgeInstalled()) return;
	    VanishBridge vanishBridge = VanishBridgeProvider.get();
    }
}

Getting a list of vanished players

import dev.loapu.vanishbridge.api.VanishBridge;
import dev.loapu.vanishbridge.api.model.VanishBridgePlayer;
import dev.loapu.vanishbridge.api.VanishBridgeProvider;

public class Example {
    // It's really that easy
    public List<VanishBridgePlayer> vanishedPlayers = VanishBridgeProvider.get().vanishedPlayers();
}

That's it! You can now use VanishBridge in your plugin.