Overview

Minecraft time is measured in ticks (20 ticks = 1 second, 24 000 ticks = 1 day). Kore models this with TimeNumber, a typed value that carries both the numeric amount and the time unit (TICKS, SECONDS, DAYS).

Commands that accept a duration - schedule, title times, time add, weather, worldborder - take a TimeNumber argument, so you never have to remember the raw tick math yourself.

Creating time values

Use the extension properties on any Number:

import io.github.ayfri.kore.arguments.numbers.ticks
import io.github.ayfri.kore.arguments.numbers.seconds
import io.github.ayfri.kore.arguments.numbers.days

val a = 100.ticks    // 100t  →  5 seconds
val b = 5.seconds    // 5s
val c = 2.days       // 2d    →  48 000 ticks
val d = 1.5.seconds  // 1.5s  (fractional values are preserved)

Or use the time() factory for dynamic construction:

import io.github.ayfri.kore.arguments.numbers.time
import io.github.ayfri.kore.arguments.numbers.TimeType

val e = time(200)                    // 200t
val f = time(10, TimeType.SECONDS)   // 10s

Serialization (command output)

TimeNumber.toString() produces what Minecraft commands expect:

Expression	Output
`100.ticks`	`100`
`1.5.ticks`	`1.5`
`5.seconds`	`5s`
`1.5.seconds`	`1.5s`
`2.days`	`2d`
`0.2.days`	`0.2d`

Integer values drop the .0 suffix; fractional values are preserved as-is.

Arithmetic

TimeNumber supports the standard operators (same unit required for meaningful results):

val delay = 3.seconds + 2.seconds   // TimeNumber(5.0, SECONDS)
val half = 10.ticks / 2.ticks      // TimeNumber(5.0, TICKS)
val neg = (-1).days                  // TimeNumber(-1.0, DAYS)

Unit conversions

Convert between units while keeping the logical duration the same:

val twentyTicks = 20.ticks
twentyTicks.inSeconds()   // TimeNumber(1.0, SECONDS)
twentyTicks.inDays()      // TimeNumber(1/1200 ≈ 0.000833, DAYS)

val oneDay = 1.days
oneDay.inTicks()          // TimeNumber(24000.0, TICKS)
oneDay.inSeconds()        // TimeNumber(1200.0, SECONDS)

toTicks() / toSeconds() / toDays() reinterpret the raw number without converting (rarely needed):

100.ticks.toSeconds()  // TimeNumber(100.0, SECONDS) - still 100, just retagged as "s"

Usage in commands

Any command that takes a duration accepts TimeNumber directly:

import io.github.ayfri.kore.arguments.numbers.seconds
import io.github.ayfri.kore.arguments.numbers.ticks
import io.github.ayfri.kore.arguments.numbers.days

// schedule
schedule.function(myFunction, 5.seconds)
schedule.function(myFunction, 100.ticks, ScheduleMode.REPLACE)

// title times (fade-in, stay, fade-out)
title(self(), 0.5.seconds, 3.seconds, 0.5.seconds)

// world time
time.add(1.days)

// weather
weatherClear(30.seconds)

// worldborder grow
worldBorder.add(10.0, 200.ticks)

linkOverview

linkCreating time values

linkSerialization (command output)

linkArithmetic

linkUnit conversions

linkUsage in commands

linkFurther reading