Is Date

Description

Matches when the in-game date of the world is the given day and month, in any year.

This condition checks the world of the entity. It never matches in the Nether or the End.

The date comes from the calendar, or is the real date in the configured timezone with sync-time-with-real-world: true. The condition is false while the calendar is off (enabled: false or an empty months list in calendar.yml) and in a world with no date.

Attributes

Attribute Aliases Description Default
date d DD-MM or DD/MM (MM-DD with american-date-format: true), the month as its position in the months list. required

Examples

ChristmasGreeting:
  Conditions:
  - isdate{d=25-12} true
  Skills:
  - message{m="Merry Christmas!"} @Self

Runs on the 25th of the 12th month.

NewYearToast:
  TargetConditions:
  - isdate{date=01-01} true
  Skills:
  - message{m="Happy new year!"}

NewYearBroadcast:
  Skills:
  - skill{s=NewYearToast} @PlayersInWorld{targetself=true}

@PlayersInWorld leaves the caster out unless targetself=true.

MidsummerNotice:
  Skills:
  - message{m="Midsummer night."} @Self ?isdate{d=21/6}

A slash works in place of the dash.

Aliases

  • date
Updated Nov 11, 2026