Scoreboard & Teams API

1. Quick Sidebar Scoreboards (FastBoard Style)

For lightweight, reactive sidebar menus (such as lobby or minigame stats), update lines from top to bottom with automatic descending score mapping:

// Fast sidebar creation (ordered top to bottom)
player.set_sidebar_lines("§6§lPotatoMC Network", &[
    "§7-----------------",
    "§fRank: §eMVP+",
    "§fCoins: §612,450",
    "§fOnline: §a48/100",
    "§7-----------------",
    "§epotatomc.flaxa.in",
]);

// Clear or reset scoreboard
player.clear_scoreboard();
player.reset_scoreboard();

2. Advanced Objectives & Display Slots

PotatoMC supports full objective tracking, criterion management, and display slots (Sidebar, BelowName, List / tab-list, and TeamColor):

use potato_api::scoreboard::{Scoreboard, DisplaySlot, ObjectiveCriteria, RenderType};

let mut board = Scoreboard::new("game_board", "§b§lBedWars", DisplaySlot::Sidebar);

// 1. Sidebar Lines
board.set_line(15, "§7Map: §fAirshow");
board.set_line(14, "§7Kills: §a3");
board.set_line(13, "§7Beds Broken: §e1");

// 2. Below-Name Health Objective (showing player health hearts or numbers)
let health_obj = board.register_objective(
    "player_health",
    "§c❤",
    ObjectiveCriteria::Health,
    DisplaySlot::BelowName,
);
health_obj.render_type = RenderType::Hearts;

// 3. Tab-List Kills Objective
board.register_objective(
    "tab_kills",
    "Kills",
    ObjectiveCriteria::PlayerKillCount,
    DisplaySlot::List,
);

// Apply to player
player.set_scoreboard(&board);

3. Score Entries & Score Tracking

Track, query, and modify numeric scores for arbitrary entities or offline usernames:

// Set scores explicitly
board.set_score("Steve", "player_health", 20);
board.set_score("Alex", "player_health", 18);

// Query scores
if let Some(score) = board.get_score("Steve", "player_health") {
    println!("Steve has {} health", score);
}

// Reset single score or all scores for an entry
board.reset_score("Steve", "player_health");
board.reset_scores("Alex");

4. Teams & Name Tags

Configure player prefix/suffix colors, friendly fire, invisibility visibility, and collision rules:

use potato_api::scoreboard::Team;

let red_team = Team::new("red_team")
    .prefix("§c[RED] ")
    .suffix(" §7★")
    .color("red")
    .friendly_fire(false)
    .see_friendly_invisibles(true)
    .add_entry("MAGIC_PLAYZZ")
    .add_entry("Steve");

board.add_team(red_team);

5. Scoreboard Events & Cancellation

use potato_api::event::{ScoreboardScoreChangeEvent, Cancellable};

context.register_event(|event: &mut ScoreboardScoreChangeEvent| {
    println!(
        "[Scoreboard] {} scored {} (was {:?}) in objective {}",
        event.entry,
        event.new_score,
        event.previous_score,
        event.objective_name
    );

    // Cancel unauthorized score modification
    if event.new_score < 0 {
        event.set_cancelled(true);
    }
});