📊 Scoreboard Api
Available Since 0.0.39
Table of content:
Introduction
The Scoreboard Api aka CocoaBoard is a simple way to work with scoreboard in minecraft, The Scoreboard Api work with Observable Api as it accept observable and update the scoreboard by itself
(as for now we only support sidebar scoreboard but there are plan to make it work with list and below-name also with teams)
Showcase

Usage
First we will want to create BoardManager
public class BoardManager {
private final Map<UUID, CocoaBoard> boards = new HashMap<>();
private final MutableObservable<Long> heartbeatTime;
private BukkitTask cprTask;
public BoardManager() {
this.heartbeatTime = Observable.mutable(0L);
}
public void initialize(JavaPlugin plugin) {
if (cprTask != null)
return;
cprTask = new BukkitRunnable() {
@Override
public void run() {
heartbeat();
}
}.runTaskTimer(plugin, 0, 1);
}
public void heartbeat() {
long startTime = System.currentTimeMillis();
for (CocoaBoard board : boards.values())
board.heartbeat();
long endTime = System.currentTimeMillis();
// can be used to get duration of heartbeat
heartbeatTime.set(endTime - startTime);
}
public CocoaBoard getBoard(Player player) {
return boards.computeIfAbsent(
player.getUniqueId(),
uuid -> SpigotCocoaBoard.create(
player, // Player to create scoreboard for
"example", // Objective id
Component.text("Test") // name could be observable
)
);
}
public void unregisterBoard(UUID targetUUID) {
CocoaBoard board = boards.remove(targetUUID);
if (board != null)
board.delete();
}
public void disable() {
if (cprTask == null)
return;
cprTask.cancel();
cprTask = null;
for (CocoaBoard board : boards.values())
board.delete();
boards.clear();
}
// Getters
public Observable<Long> getHeartbeatTime() {
return heartbeatTime;
}
}
Advantages
Include in your project
<dependencies>
<dependency>
<groupId>dev.apartium.cocoa-beans</groupId>
<artifactId>cocoa-beans-scoreboard</artifactId>
<version>0.0.54-beta0</version>
</dependency>
</dependencies>
repositories {
mavenCentral()
}
dependencies {
compileOnly("dev.apartium.cocoa-beans:cocoa-beans-scoreboard:0.0.54-beta0")
}
repositories {
mavenCentral()
}
dependencies {
compileOnly("dev.apartium.cocoa-beans:cocoa-beans-scoreboard:0.0.54-beta0")
}
<dependencies>
<dependency>
<groupId>dev.apartium.cocoa-beans</groupId>
<artifactId>cocoa-beans-scoreboard-spigot</artifactId>
<version>0.0.54-beta0</version>
</dependency>
</dependencies>
repositories {
mavenCentral()
}
dependencies {
compileOnly("dev.apartium.cocoa-beans:cocoa-beans-scoreboard-spigot:0.0.54-beta0")
}
repositories {
mavenCentral()
}
dependencies {
compileOnly("dev.apartium.cocoa-beans:cocoa-beans-scoreboard-spigot:0.0.54-beta0")
}
<dependencies>
<dependency>
<groupId>dev.apartium.cocoa-beans</groupId>
<artifactId>cocoa-beans-scoreboard-minestom</artifactId>
<version>0.0.54-beta0</version>
</dependency>
</dependencies>
repositories {
mavenCentral()
}
dependencies {
compileOnly("dev.apartium.cocoa-beans:cocoa-beans-scoreboard-minestom:0.0.54-beta0")
}
repositories {
mavenCentral()
}
dependencies {
compileOnly("dev.apartium.cocoa-beans:cocoa-beans-scoreboard-minestom:0.0.54-beta0")
}
What next
Last modified: 28 August 2025