SimpleFabricScoreboardAPI

SimpleFabricScoreboard

A lightweight Kotlin library for the Fabric modding ecosystem that gives modders a simple, flexible API for managing Minecraft scoreboards.

Description / Overview

SimpleFabricScoreboard is designed for mod creators who want to integrate scoreboard functionality into their mods without dealing with the low-level boilerplate.

Key goals:

• Minimal footprint: no heavy dependencies, only core Kotlin + Fabric.

• Flexible API: modular scoreboard registration, dynamic updates, optional display mechanics.

• Ease of use: tailored for developers who want scoreboard support “just working” behind the scenes.

Features

• Create and register scoreboard objectives easily (e.g. tracking kills, points, custom stats).

• Update scores in a modular, thread-safe way.

• Extensible architecture so other mods can hook into or build upon it.

• Written in Kotlin, works seamlessly in Fabric environments.

Use Cases / Scenarios

• A mini-game mod that tracks “kills / points / rounds survived” and displays a sidebar leaderboard.

• Any mod where you want to show a scoreboard element

• Modpacks / add-ons that want to unify scoreboard logic across components.

Usage (Kotlin Example)

register a sideboard and set its content:

val board = ScoreboardManager.createScoreboard(
                "Test Board", 
                server,
                Text.of("Line 1"),
                Text.of("Line 2"),
                Text.of("Line 3"),
                Text.of("Line 4"),
                )
            
ScoreboardManager.setPlayerScoreboard(player, board)

update content dynamically:

board.updateLine(3, Text.of("Updated Line 3"))

remove the sideboard from a player:

ScoreboardManager.removePlayerScoreboard(player)

remove all sideboards:

ScoreboardManager.clearAllBoards()