BungeeCord¶

Adventure targets the latest version of BungeeCord and BungeeCord-compatible forks, such as Waterfall.

Warning

The BungeeCord platform is intended for legacy environments only. Most developers will want to write plugins for Velocity, which natively implements the Adventure API. No adapters required!

Declaring the dependency:

Maven

 <dependency>
    <groupId>net.kyori</groupId>
    <artifactId>adventure-platform-bungeecord</artifactId>
    <version>4.3.4</version>
 </dependency>

Gradle (Groovy)

 repositories {
    mavenCentral()
 }

 dependencies {
    implementation "net.kyori:adventure-platform-bungeecord:4.3.4"
 }

Gradle (Kotlin)

 repositories {
    mavenCentral()
 }

 dependencies {
    implementation("net.kyori:adventure-platform-bungeecord:4.3.4")
 }

Need development/snapshot builds? Using Snapshot Builds

Usage¶

You should first obtain a BungeeAudiences object by using BungeeAudiences.create(plugin). This object is thread-safe and can be reused from different threads if needed. This object should also be closed when the plugin is disabled.

Note that not all functionality is available on the proxy. Sending chat messages, action bar messages, titles, and boss bars, and tab list header and footer are supported, but all other requests will fail silently.

A simple example of how to appropriately initialize this platform follows:

public class MyPlugin extends Plugin {
  private BungeeAudiences adventure;

  public @NonNull BungeeAudiences adventure() {
    if(this.adventure == null) {
      throw new IllegalStateException("Cannot retrieve audience provider while plugin is not enabled");
    }
    return this.adventure;
  }

  @Override
  public void onEnable() {
    this.adventure = BungeeAudiences.create(this);
  }

  @Override
  public void onDisable() {
    if(this.adventure != null) {
      this.adventure.close();
      this.adventure = null;
    }
  }

}

Component serializers¶

For functionality not already supported by Audience, the BungeeComponentSerializer allows you to convert between Adventure Components and the native BungeeCord chat component API and back.

Caution

For some areas of the proxy (notably, sending server list responses), the component serializer cannot be appropriately injected unless a BungeeAudiences instance has been initialized. Using Adventure Component instances will not work without a created BungeeAudiences instance.