Skip to content

User Badge

The ServerBadgePacket is a client-bound packet that allows servers to display a badge in the tab list next to the player's name and in the nametag.

Tablist Badge Tablist Nametag

Set the Badge Infos

Important Note

You must first send the Badge Infos before the badges can be displayed next to the players.

The packet can either be sent via the LabyModPlayer object of the player, or directly via the LabyModProtocol.

You can send one or more server badge info to the player.

// Get the LabyModPlayer
LabyModPlayer player = LabyModProtocolService.get().getPlayer(uniqueId);

// Create a new ServerBadge
ServerBadge owner = ServerBadge.create(
        1, // The ID of the badge
        new Color(255, 0, 0), // The color of the badge
        "https://example.com/image_owner.png" // The URL of the badge image
);
ServerBadge developer = ServerBadge.create(
        2, // The ID of the badge
        new Color(0, 0, 255), // The color of the badge
        "https://example.com/image_developer.png" // The URL of the badge image
);

// Register the badges
player.registerBadges(List.of(owner, developer));

Via the LabyModProtocol

// Get the LabyModProtocol
LabyModProtocol labyModProtocol = LabyModProtocolService.get().labyModProtocol();

// Create a new ServerBadge
ServerBadge owner = ServerBadge.create(
        1, // The ID of the badge
        new Color(255, 0, 0), // The color of the badge
        "https://example.com/image_owner.png" // The URL of the badge image
);
ServerBadge developer = ServerBadge.create(
        2, // The ID of the badge
        new Color(0, 0, 255), // The color of the badge
        "https://example.com/image_developer.png" // The URL of the badge image
);

// Send the packet
labyModProtocol.sendPacket(uniqueId, new ServerBadgePacket(owner, developer));

Set the badges for the players.

The packet can either be sent via the LabyModPlayer object of the player, or directly via the LabyModProtocol.

// Get the LabyModPlayer
LabyModPlayer player = LabyModProtocolService.get().getPlayer(uniqueId);

// Create a new ServerUserBadge
ServerUserBadge serverUserBadge = ServerUserBadge.create(
        uniqueId, // The UUID of the user who has the badge
        1 // The ID of the badge
);

// Bind the badges
player.bindBadges(List.of(serverUserBadge));

Via the LabyModProtocol

Now you can assign the badge to a player, which will then be displayed.

// Get the LabyModProtocol
LabyModProtocol labyModProtocol = LabyModProtocolService.get().labyModProtocol();

// Create a new ServerUserBadge
ServerUserBadge serverUserBadge = ServerUserBadge.create(
        uniqueId, // The UUID of the user who has the badge
        1 // The ID of the badge
);

// Send the packets
labyModProtocol.sendPacket(uniqueId, new ServerUserBadgePacket(serverUserBadge));