Actions Usage Examples - VCT Docs

These examples show the most common use cases of timer actions. You can combine them to create more complex mechanics, such as countdown-based games, challenges, or events.

Example 1 — Create a 5-minute timer (`/fivetimer`)

import voiidstudios.vct.api.VCTAPI;
import voiidstudios.vct.api.VCTActions;
import voiidstudios.vct.api.Timer;

public class FiveMinuteTimerCommand implements CommandExecutor {

    @Override
    public boolean onCommand(CommandSender sender, Command command, String label, String[] args) {
        if (!command.getName().equalsIgnoreCase("fivetimer")) {
           return false;
        }

        if (!VCTAPI.isAvailable()) {
            sender.sendMessage("The VCT API is not available");
            return true;
        }

        Timer timer = VCTActions.createTimer("00:05:00", "default", sender);

        if (timer != null) {
            sender.sendMessage("5-minute timer created successfully!");
        } else {
            sender.sendMessage("The timer could not be created.");
        }

        return true;
    }
}

Example 2 — Pause the timer (`/pausetimer`)

import voiidstudios.vct.api.VCTActions;

public class PauseTimerCommand implements CommandExecutor {

    @Override
    public boolean onCommand(CommandSender sender, Command command, String label, String[] args) {
        if (!command.getName().equalsIgnoreCase("pausetimer")) {
           return false;
        }

        boolean success = VCTActions.pauseTimer(sender);

        if (success) {
            sender.sendMessage("Timer paused successfully!");
        } else {
            sender.sendMessage("No active timer to pause.");
        }

        return true;
    }
}

Example 3 — Resume the timer (`/resumetimer`)

import voiidstudios.vct.api.VCTActions;

public class ResumeTimerCommand implements CommandExecutor {

    @Override
    public boolean onCommand(CommandSender sender, Command command, String label, String[] args) {
        if (!command.getName().equalsIgnoreCase("resumetimer")) {
           return false;
        }

        boolean success = VCTActions.resumeTimer(sender);

        if (success) {
            sender.sendMessage("Timer resumed!");
        } else {
            sender.sendMessage("No paused timer found.");
        }

        return true;
    }
}

Example 4 — Add time dynamically (`/addtime <minutes>`)

import voiidstudios.vct.api.VCTActions;

public class AddTimeCommand implements CommandExecutor {

    @Override
    public boolean onCommand(CommandSender sender, Command command, String label, String[] args) {
        if (!command.getName().equalsIgnoreCase("addtime")) {
           return false;
        }

        if (args.length < 1) {
            sender.sendMessage("Usage: /addtime <minutes>");
            return true;
        }

        String minutes = args[0];
        String formatted = "00:" + (minutes.length() == 1 ? "0" + minutes : minutes) + ":00";

        boolean success = VCTActions.modifyTimer("add", formatted, sender);

        if (success) {
            sender.sendMessage("Added " + minutes + " minutes to the timer!");
        } else {
            sender.sendMessage("No active timer to modify.");
        }

        return true;
    }
}

Example 5 — Stop the timer (`/stoptimer`)

import voiidstudios.vct.api.VCTActions;

public class StopTimerCommand implements CommandExecutor {

    @Override
    public boolean onCommand(CommandSender sender, Command command, String label, String[] args) {
        if (!command.getName().equalsIgnoreCase("stoptimer")) {
           return false;
        }

        boolean success = VCTActions.stopTimer(sender);

        if (success) {
            sender.sendMessage("Timer stopped.");
        } else {
            sender.sendMessage("No active timer found.");
        }

        return true;
    }
}