Danger

The Adventure docs are currently a work in progress. Some areas may have limited coverage or may not be entirely up to date. Feel free to join our discord at https://discord.gg/MMfhJ8F if you have any questions.

Audiences

An audience, at its core, is a grouping of 0 or more viewers of some content. The concept of an audience is where Adventure makes its most clear break from other Minecraft platforms.

As an API, Audience is designed to be a universal interface for any player, command sender, console, or otherwise who can receive text, titles, boss bars, and other Minecraft media. This allows extending audiences to cover more than one individual receiver - possible “audiences” could include a team, server, world, or all players that satisfy some predicate (such as having a certain permission). The universal interface also allows reducing boilerplate by gracefully degrading functionality if it is not applicable. For instance, it does not make much sense to send a boss bar to a command sender, and you can’t send titles to Minecraft 1.7 clients.

You will normally get audience instances from one of the Platforms. The Adventure API includes two audience implementations itself: one that does not support any action (and thus does nothing). Audience.empty(), and one that forwards an action to each member in the audience, Audience.of() and related methods, along with the ForwardingAudience that implements the forwarding logic for you.

Most users using will primarily use this API to show content created by other parts of the API.