DreamBossBar.java

Go to the documentation of this file.

/*
 * MIT License
 *
 * Copyright (c) 2025 Dreamfire Studio
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in all
 * copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 * SOFTWARE.
 */
package com.dreamfirestudios.dreamcore.DreamBossBar;
 
import com.dreamfirestudios.dreamcore.DreamCore;
import com.dreamfirestudios.dreamcore.DreamJava.DreamClassID;
import lombok.Getter;
import org.bukkit.Bukkit;
import org.bukkit.boss.BarFlag;
import org.bukkit.boss.BossBar;
import org.bukkit.entity.Player;
 
import java.util.*;
 
public class DreamBossBar extends DreamClassID {
    private List<DreamBossBarData> frames;
    private BarFlag[] barFlags;
    @Getter private BossBar bossBar;
    private int currentFrameIndex;
    @Getter private boolean bossBarPaused = true;
    private final List<UUID> viewers = new ArrayList<>();
 
    public boolean isPlayer(Player player){
        if (player == null) throw new IllegalArgumentException("Player cannot be null.");
        return viewers.contains(player.getUniqueId());
    }
 
    public void resetBossBar(){
        if (frames == null || frames.isEmpty()) return;
        currentFrameIndex = 0;
        var first = frames.get(0);
        if (bossBar == null) {
            bossBar = Bukkit.createBossBar(first.safeTitle(null), first.barColor(), first.barStyle(), barFlags);
        } else {
            bossBar.setTitle(first.safeTitle(null));
            bossBar.setColor(first.barColor());
            bossBar.setStyle(first.barStyle());
            bossBar.setProgress(first.clampedProgress());
        }
    }
 
    public void addPlayer(Player... players){
        if (players == null) return;
        for (var p : players) {
            if (p != null) addPlayer(p);
        }
    }
 
    public void addPlayer(Player player) {
        if (player == null) throw new IllegalArgumentException("Player cannot be null.");
        var id = player.getUniqueId();
        if (viewers.contains(id)) return;
        if (new BossBarPlayerAddedEvent(this, player).isCancelled()) return;
        ensureBossBarInitialized();
        bossBar.addPlayer(player);
        viewers.add(id);
    }
 
    public void removePlayer(Player player){
        if (player == null) throw new IllegalArgumentException("Player cannot be null.");
        var id = player.getUniqueId();
        if (!viewers.contains(id)) return;
        new BossBarPlayerRemovedEvent(this, player);
        if (bossBar != null) bossBar.removePlayer(player);
        viewers.remove(id);
    }
 
    public void removeAllPlayers(){
        if (viewers.isEmpty()) return;
        // Create a copy to avoid ConcurrentModificationException
        List<UUID> copy = new ArrayList<>(viewers);
        for (var uuid : copy){
            var player = Bukkit.getPlayer(uuid);
            if (player != null) removePlayer(player);
        }
    }
 
    public void displayNextFrame(){
        if (frames == null || frames.isEmpty() || viewers.isEmpty() || bossBarPaused) return;
        ensureBossBarInitialized();
 
        var frame = frames.get(currentFrameIndex);
        for (var uuid : viewers){
            var player = Bukkit.getPlayer(uuid);
            if (player == null) continue;
            frame.DisplayBarData(bossBar, player);
        }
 
        new BossBarFrameAdvancedEvent(this, currentFrameIndex);
        currentFrameIndex = (currentFrameIndex + 1) % frames.size();
    }
 
    public void pause(){
        if (!bossBarPaused){
            bossBarPaused = true;
            new BossBarPausedEvent(this);
        }
    }
 
    public void play(){
        if (bossBarPaused){
            bossBarPaused = false;
            new BossBarStartedEvent(this);
        }
    }
 
    public DreamBossBar stop() {
        bossBarPaused = true;
        new BossBarStoppedEvent(this);
        removeAllPlayers();
        return DreamCore.DreamBossBars.remove(getClassID());
    }
 
    private void ensureBossBarInitialized() {
        if (bossBar != null) return;
        if (frames == null || frames.isEmpty()) {
            bossBar = Bukkit.createBossBar("", org.bukkit.boss.BarColor.WHITE, org.bukkit.boss.BarStyle.SOLID, barFlags);
            return;
        }
        var first = frames.get(0);
        bossBar = Bukkit.createBossBar(first.safeTitle(null), first.barColor(), first.barStyle(), barFlags);
        bossBar.setProgress(first.clampedProgress());
    }
 
    public static final class Builder {
        private final List<DreamBossBarData> frames = new ArrayList<>();
        private final List<Player> players = new ArrayList<>();
 
        public Builder dreamfireBossBarData(DreamBossBarData barData, int numberOfFrames) {
            if (barData == null) throw new IllegalArgumentException("Bar data cannot be null.");
            if (numberOfFrames <= 0) throw new IllegalArgumentException("Number of frames must be > 0.");
            for (int i = 0; i < numberOfFrames; i++) frames.add(barData);
            return this;
        }
 
        public Builder players(Player... toAdd) {
            if (toAdd == null) return this;
            for (var p : toAdd) if (p != null) players.add(p);
            return this;
        }
 
        public DreamBossBar build(BarFlag... barFlags) {
            if (frames.isEmpty()) throw new IllegalArgumentException("Boss bar frames must not be empty.");
            var dbb = new DreamBossBar();
            dbb.frames = new ArrayList<>(frames);
            dbb.barFlags = (barFlags == null ? new BarFlag[0] : barFlags.clone());
            dbb.resetBossBar();
            players.forEach(dbb::addPlayer);
            return DreamCore.DreamBossBars.put(dbb.getClassID(), dbb);
        }
    }
}