DreamStopwatch.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.DreamStopwatch;
 
import org.bukkit.Bukkit;
import org.bukkit.plugin.Plugin;
 
import java.util.Objects;
import java.util.function.BiConsumer;
import java.util.function.Consumer;
 
public final class DreamStopwatch {
 
    private final Plugin plugin;
    private final long periodTicks;
    private final Consumer<Integer> onTick;                 // elapsed seconds
    private final BiConsumer<Integer, Boolean> onPause;     // (elapsed, paused=true/false)
    private final Consumer<Integer> onStop;                 // final elapsed seconds
 
    private int taskId = -1;
    private int elapsedSeconds = 0;
    private boolean paused = false;
    private boolean stopped = false;
 
    public DreamStopwatch(
            Plugin plugin,
            long periodTicks,
            Consumer<Integer> onTick,
            BiConsumer<Integer, Boolean> onPause,
            Consumer<Integer> onStop
    ) {
        this.plugin = Objects.requireNonNull(plugin, "plugin");
        this.periodTicks = Math.max(1L, periodTicks);
        this.onTick = onTick == null ? s -> {} : onTick;
        this.onPause = onPause == null ? (s, p) -> {} : onPause;
        this.onStop = onStop == null ? s -> {} : onStop;
    }
 
    public void start() {
        if (taskId != -1) return;
        stopped = false;
        paused = false;
        taskId = Bukkit.getScheduler().runTaskTimer(plugin, () -> {
            if (stopped || paused) return;
            elapsedSeconds++;
            // callback
            onTick.accept(elapsedSeconds);
            // event
            Bukkit.getPluginManager().callEvent(new StopwatchTickEvent(this, elapsedSeconds));
        }, 0L, periodTicks).getTaskId();
        Bukkit.getPluginManager().callEvent(new StopwatchStartedEvent(this));
    }
 
    public void pause() {
        if (taskId == -1 || paused || stopped) return;
        paused = true;
        onPause.accept(elapsedSeconds, true);
        Bukkit.getPluginManager().callEvent(new StopwatchPausedEvent(this, elapsedSeconds));
    }
 
    public void resume() {
        if (taskId == -1 || !paused || stopped) return;
        paused = false;
        onPause.accept(elapsedSeconds, false);
        Bukkit.getPluginManager().callEvent(new StopwatchResumedEvent(this, elapsedSeconds));
    }
 
    public void stop() {
        if (taskId == -1 || stopped) return;
        stopped = true;
        cancelTask();
        onStop.accept(elapsedSeconds);
        Bukkit.getPluginManager().callEvent(new StopwatchStoppedEvent(this, elapsedSeconds));
    }
 
    public void reset() {
        elapsedSeconds = 0;
        paused = false;
        stopped = false;
    }
 
    private void cancelTask() {
        if (taskId != -1) {
            Bukkit.getScheduler().cancelTask(taskId);
            taskId = -1;
        }
    }
 
    // --- Accessors ---
 
    public int getElapsedSeconds() { return elapsedSeconds; }
    public boolean isRunning() { return taskId != -1 && !paused && !stopped; }
    public boolean isPaused()  { return paused; }
    public boolean isStopped() { return stopped; }
 
    public static String formatHMS(int seconds) {
        int m = seconds / 60;
        int s = seconds % 60;
        return String.format("%02d:%02d", m, s);
    }
}