PaperMC / PaperMC/adventure

Give boss bars a usable identity

Open
#445 2 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

area: api type: enhancement
Dominant language
Java
Stars
887
Forks
160
PR merge metrics
No merged PRs in 30d

Description

At the moment, platform implementations have to rely on hacky maps and wrapper objects to properly use and manage boss bars which is horrible and not fun to use. Additionally, it makes it incredibly hard for plugins to share boss bars around.

It would be nice to make some of the following changes to boss bars:

  • Give them an identity (most likely a Key to mimic Minecraft).
  • Allow a boss bar to be looked up based on it's identity (either using the API or some form of SPI).
  • Add a method to check if an Audience is viewing a boss bar (this would always default to false on ForwardingAudience).

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading the existing boss bar and Audience APIs. Determine how identity, lookup, and audience visibility should interact, including the required ForwardingAudience default. Done means the API design and behavior for all three requested capabilities are specified and implemented with coverage for the relevant cases.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
api
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.