TaskTimer

Short Description

A powerful and user-friendly task scheduler to automate commands on your Minecraft server.

Full Description

Overview

TaskTimer is an essential utility for any server administrator, allowing you to schedule any command to run at specific times or at regular intervals. Whether you need to run a backup command every few hours, announce a daily event, or trigger a one-time command for a special occasion, TaskTimer handles it with ease. Its intuitive command structure and interactive feedback make task management simple and efficient, directly from within the game.

Features

• Flexible Scheduling

• Interval-based (interval): Run commands after a certain amount of time (e.g., every 30m, 1h, 10s).
• Time-based (time): Run commands at a specific time of day (e.g., at 18:00:00).

• Powerful Execution Control

• once: Run a task a single time. Perfect for delayed actions.
• repeat: Run a task repeatedly. A time-based repeat task will run every day at the specified time, making it ideal for daily announcements or routines.

• Easy In-Game Management

• Create, edit, and remove tasks on the fly without ever needing to restart the server.
• An interactive task list (/tt list) allows you to click on any task to instantly get the command to edit it.

• User-Friendly Interface

• Full tab-completion for all commands and arguments helps you write commands quickly and without errors.
• Helpful, clickable error messages guide you to the correct command usage.

• Persistent Tasks

• All scheduled tasks are saved in tasks.yml and are automatically reloaded on server startup, so you never lose your schedule.

Commands

The main command is /tasktimer (alias: /tt).

• /tt help

• Displays the main help message with command examples.

• /tt create <name> <once|repeat> <interval|time> <value> <command...>

• Creates a new task.
• Example (Interval): /tt create backup once interval 6h paper backup
• Example (Time): /tt create daily_reward repeat time 12:00:00 say It's noon! Claim your reward!

• /tt edit <name> <field> <new_value...>

• Edits an existing task. You can change the executionType, scheduleType, value, or command.

• /tt remove <name>

• Deletes a scheduled task.

• /tt list

• Shows all currently scheduled tasks. Click on a task name to edit it.

• /tt reload

• Cancels all running tasks and reloads them from the tasks.yml file.

Configuration

All tasks are stored in the plugins/TaskTimer/tasks.yml file. While you can edit this file manually, it is recommended to use the in-game commands for management.

© 2025 MichiJP. All Rights Reserved.