API

The Velocitab API provides methods for vanishing ("hiding") and modifying usernames on the TAB list.

The API is distributed on Maven through repo.william278.net and can be included in any Maven, Gradle, etc. project. JavaDocs are available here.

Velocitab also provides a plugin message API, which is documented in the Plugin Message API Examples page.

Compatibility

The Velocitab API shares version numbering with the plugin itself for consistency and convenience. Please note minor and patch plugin releases may make API additions and deprecations, but will not introduce breaking changes without notice.

Table of contents

1. Adding the API to your project
2. Adding Velocitab as a dependency
3. Next steps

API Introduction

1.1 Setup with Maven

<repositories>
    <repository>
        <id>william278.net</id>
        <url>https://repo.william278.net/releases</url>
    </repository>
</repositories>

<dependency>
    <groupId>net.william278</groupId>
    <artifactId>velocitab</artifactId>
    <version>VERSION</version>
    <scope>provided</scope>
</dependency>

1.2 Setup with Gradle

allprojects {
    repositories {
        maven { url 'https://repo.william278.net/releases' }
    }
}

dependencies {
    compileOnly 'net.william278:velocitab:VERSION'
}

2. Adding Velocitab as a dependency

Add Velocitab as a dependency in your main class annotation:

@Plugin(
  id = "myplugin",
  name = "My Plugin",
  version = "0.1.0",
  dependencies = {
    @Dependency(id = "velocitab", optional = true)
  }
)
public class MyPlugin {
  // ...
}

{
  "dependencies": [
    {
      "id": "velocitab",
      "optional": true
    }
  ]
}

3. Creating a class to interface with the API

• Unless your plugin completely relies on Velocitab, you shouldn't put Velocitab API calls into your main class, otherwise if Velocitab is not installed you'll encounter ClassNotFoundExceptions

public class VelocitabAPIHook {

    public VelocitabAPIHook() {
        // Ready to do stuff with the API
    }

}

4. Checking if Velocitab is present and creating the hook

• Check to make sure the Velocitab plugin is present before instantiating the API hook class

@Plugin(
        id = "myplugin",
        name = "My Plugin",
        version = "0.1.0",
        dependencies = {
                @Dependency(id = "velocitab", optional = true)
        }
)
public class MyPlugin {

    public VelocitabAPIHook velocitabHook;

    @Subscribe
    public void onProxyInitialization(@NotNull ProxyInitializeEvent event) {
        if (event.getProxy().getPluginManager().getPlugin("velocitab").isPresent()) {
            velocitabHook = new VelocitabAPIHook();
        }
    }

}

5. Getting an instance of the API

• You can now get the API instance by calling VelocitabAPI#getInstance()

import net.william278.velocitab.api.BukkitVelocitabAPI;

public class VelocitabAPIHook {

    private final VelocitabAPI velocitabApi;

    public VelocitabAPIHook() {
        this.velocitabApi = VelocitabAPI.getInstance();
    }

}

6. Next steps

Now that you've got everything ready, you can start doing stuff with the Velocitab API!

• API Examples
• See also: Plugin Message API