TimerCommand icon

TimerCommand -----

spigot, paper, scheduler, task-runner, time-based-commands, automation, placeholderapi, gui-menu, mu




✅ Added support for multiple execution times in TIME scheduled commands, allowing one command to run at several times during the day.

✅ Implemented backward-compatible time parsing for both single values ("HH:mm" / "HH:mm:ss") and YAML lists.

✅ Updated command info/list and GUI display to show all configured times for TIME commands.

✅ Improved daily trigger tracking so each configured time executes once per day reliably.


Code (YAML):
 daily-announce:
    enabled
: true
    type
: "TIME"
    time
:
     - "11:00"
      - "23:00"
    command
: "say Right now is %hour%:%minute%!"
    description
: "Daily announcement"
----------, May 15, 2026

✅ Added full version compatibility support from Minecraft 1.17 up to the latest release, ensuring seamless operation across all modern server versions.

✅ Implemented cross-version handling for internal API changes to maintain consistent behavior and stability.

✅ Ensured all existing features, commands, and placeholders work identically on every supported version without limitations.

✅ Improved long-term maintainability by future-proofing the plugin against upcoming Minecraft updates.

✅ Verified performance and reliability across the entire supported version range for production environments.
----------, Dec 22, 2025

  • ✅ Added
    Code (Text):
    $delay$
    placeholder feature for delayed command execution across all command types (TIME, INTERVAL, WEEKLY, MONTHLY_DAY, GAME_TIME).
  • ✅ Implemented cumulative delay system where multiple
    Code (Text):
    $delay$
    commands execute sequentially with customizable delay intervals.
  • ✅ Commands without
    Code (Text):
    $delay$
    before delayed commands execute immediately, while those after delayed commands execute after all delays complete.
  • ✅ Added comprehensive delay support with delay value specified in seconds via the
    Code (Text):
    delay
    configuration field.
  • ✅ Delay feature works seamlessly with all existing placeholder replacements (%day%, %month%, %year%, %hour%, %minute%, PlaceholderAPI, etc.).
  • ✅ Enhanced configuration flexibility with delay parameter available for all command types without any restrictions.
  • ✅ Added detailed logging for delayed command scheduling and execution with timing information.

Example Configuration

Here's a practical example of using the new delay feature for a server restart countdown:

Code (YAML):

restart-countdown
:
  enabled
: true   # Set to true to enable
  type
: "TIME"
  commands
:
   - "say Restart in 10 seconds"
    - "$delay$ say Restart in 9 seconds"
    - "$delay$ say Restart in 8 seconds"
    - "$delay$ say Restart in 7 seconds"
    - "$delay$ say Restart in 6 seconds"
    - "$delay$ say Restart in 5 seconds"
    - "$delay$ say Restart in 4 seconds"
    - "$delay$ say Restart in 3 seconds"
    - "$delay$ say Restart in 2 seconds"
    - "$delay$ say Restart in 1 second"
    - "$delay$ say Restarting server now!"
    - "$delay$ restart"   # Restart command will execute after all delays
  time
: "23:59"   # Execute at 23:59 every day
  delay
: "1"   # 1 second delay between each command
 
----------, Dec 21, 2025

TimerCommand
✨ Status Update


Fixed: Help command and language files
----------, Dec 12, 2025

✨ New Features in TimerCommand v1.0.3

Three major new features have been added to the TimerCommand plugin!

1. WEEKLY Type – Commands on Specific Days of the Week

Execute commands on specific days of the week at a determined time (e.g., every Friday at 22:59).

Command Format:
/tc add WEEKLY <command_name> <day_1-7> <HH:MM:SS> <command>

Day Numbers:
  • 1 = Monday
  • 2 = Tuesday
  • 3 = Wednesday
  • 4 = Thursday
  • 5 = Friday
  • 6 = Saturday
  • 7 = Sunday

Configuration Example:
Code (Text):

weekly-example:
  enabled: true
  type: "WEEKLY"
  command: "say This command runs every Monday, Wednesday and Friday at 12:00!"
  time: "12:00"
  days:
    - "monday"
    - "wednesday"
    - "friday"
 
In-Game Examples:
  • /tc add WEEKLY friday_event 5 22:59 say Friday night!
  • /tc add WEEKLY weekday_morning 1 09:00 say Good morning!
  • /tc add WEEKLY tuesday_bonus 2 15:30 give @a diamond 5

Supported day names in config.yml (case-insensitive):
monday (MON), tuesday (TUE), wednesday (WED), thursday (THU), friday (FRI), saturday (SAT), sunday (SUN)

---

2. Multiple Commands Support

Execute multiple commands in sequence for a single scheduler instead of just one command!

Configuration Example:
Code (Text):

multiple-commands:
  enabled: true
  type: "TIME"
  commands:
    - "say First command"
    - "give @a diamond 1"
    - "broadcast Server announcement"
  time: "12:00"
 
Weekly Bonus Example:
Code (Text):

weekly-bonus:
  enabled: true
  type: "WEEKLY"
  commands:
    - "broadcast Friday bonus!"
    - "give @a gold_ingot 10"
    - "effect give @a speed 3600 1"
  time: "19:00"
  days:
    - "friday"
 
Features:
  • Works with ALL scheduler types (TIME, INTERVAL, MONTHLY_DAY, WEEKLY, GAME_TIME)
  • Commands execute in the order specified
  • Backward compatible with old single command format

---

3. GAME_TIME Type – Commands Based on In-Game Time

Execute commands at a specific in-game time (measured in ticks) in a specific world!

In-game time is measured in ticks (0-24000 per day):
  • 0 ticks = Sunrise (start of day)
  • 6000 ticks = Noon (sun at highest point)
  • 12000 ticks = Sunset (afternoon/evening)
  • 18000 ticks = Midnight (darkest, start of night)

Command Format:
/tc add GAME_TIME <command_name> <world_name> <tick_0-24000> <command>

Configuration Example:
Code (Text):

game-time-example:
  enabled: true
  type: "GAME_TIME"
  command: "say It's noon in-game!"
  world: "world"
  tick: 6000
 
In-Game Examples:
  • /tc add GAME_TIME noon_event world 6000 say The sun has reached its peak!
  • /tc add GAME_TIME midnight_event world 18000 say It's midnight!
  • /tc add GAME_TIME sunrise_boost world_nether 0 effect give @a speed 300 1

Midnight with Multiple Commands:
Code (Text):

midnight-event:
  enabled: true
  type: "GAME_TIME"
  commands:
    - "say Midnight in-game!"
    - "effect give @a blindness 10"
    - "broadcast The night is darkest!"
  world: "world"
  tick: 18000
 
Important Information:
  • The command runs only once per day at the specified tick
  • The command runs only in the specified world
  • Requires `doDaylightCycle` gamerule enabled
  • Specify the exact world name (e.g., "world", "world_nether", "custom_world")

---

✅ Summary of Updates

  • WEEKLY Type – Schedule commands on specific days of the week
  • GAME_TIME Type – Schedule commands based on in-game time in worlds
  • Multiple Commands – Execute multiple commands sequentially
  • Enhanced Tab Completion – Better autocomplete for all command types
  • Better Documentation – Updated commands.yml with detailed examples
  • Improved Validation – Better error messages for invalid parameters

TIME:
/tc add TIME <command_name> <HH:MM:SS> <command>

INTERVAL:
/tc add INTERVAL <command_name> <ticks> <command>

MONTHLY_DAY:
/tc add MONTHLY_DAY <command_name> <day_1-31> <HH:MM:SS> <command>

WEEKLY:
/tc add WEEKLY <command_name> <day_1-7> <HH:MM:SS> <command>

GAME_TIME:
/tc add GAME_TIME <command_name> <world_name> <tick_0-24000> <command>

---

Backward Compatibility

  • ✅ All old configurations continue to work without changes
  • ✅ New features are completely optional
  • ✅ Automatically prioritizes new features over old format

---

Need help? Check the documentation!
----------, Dec 12, 2025

Added blocked commands in config.yml
Fixed bStats metrics not initializing
----------, Dec 5, 2025

Fixed core plugin functionalities to ensure more stable and reliable performance.
----------, Dec 5, 2025

Resource Information
Author:
----------
Total Downloads: 75
First Release: Dec 5, 2025
Last Update: May 15, 2026
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings