2.0.0-1.21.11

v2.0.0-1.21.11calendar_monthPublished 02/04/2026 • (today)

Welcome to Kore 2.0!

Kore 2.0 is here! This release contains so many changes, improvements, and new features that it deserved a major version bump. From a completely revamped build system to powerful new OOP utilities and helpers, this is the biggest update Kore has ever seen.

What's new?

The new Helpers module provides a rich set of utilities for common datapack patterns:

Math engine - vector math, area utilities, and floating-point formatting helpers for Vec2, Vec3, Position, and Rotation.
Raycasts - easily create block and entity raycasts with configurable step size, max distance, and hit callbacks.
State delegates - Kotlin property delegates backed by scoreboards.
Text utilities - selectors, text components, and formatting helpers.
MiniMessageRenderer, MarkdownRenderer, and ANSIRenderer - advanced text formatting renderers.
VFX & Particles - high-level particle helpers for visual effects.

Also, the prior Helpers have been moved to the helpers module, such as Display Entities, Inventory Manager, Mannequins, Scheduler, and ScoreboardManager. See also Scoreboard Math.

The OOP module brings object-oriented abstractions on top of Minecraft commands:

Boss Bars - create and manage boss bars with team integration.
Entity management - EntityCommands for fluent entity manipulation.
Events - event-driven architecture for datapack logic.
Game State Machine - GameState and GameStateManager for managing game phases and transitions.
Spawners - configurable entity spawner utilities.
Timers & Cooldowns - schedule delayed or repeating actions with Timer and Cooldown APIs.

Code examples

Here are a few examples of what you can build with the biggest additions in Kore 2.0.

Helpers

This first example combines the math helpers with a raycast to measure a path and react to blocks or entities hit along the way.

val origin = pos(0, 64, 0)
val target = pos(12.75, 65.0, -3.5)
val distance = origin.distanceTo(target)

function("helpers_demo") {
	comment("Formatted distance: ${distance.toStringTruncatedIfRound()}")

	raycast(
		from = origin,
		direction = rotation(0f, 0f),
		maxDistance = 32.0,
		step = 0.25,
		onHitBlock = ::hitBlock,
		onHitEntity = ::hitEntity,
	)
}

And this one uses the particle helpers to turn an impact point into a small visual burst.

function("helpers_particles_demo") {
	val impact = pos(4.5, 65.0, -2.5)

	particle(
		particle = flame(),
		pos = impact,
		delta = vec3(0.15, 0.35, 0.15),
		speed = 0.02f,
		count = 12,
	)
}

This one shows how state delegates let you read and write scoreboard-backed values like regular Kotlin properties.

class GameContext {
	var score by score("game.score")
	var phase by score("game.phase")
}

val context = GameContext()

function("state_delegate_demo") {
	context.score += 10
	context.phase = 2
	comment("Score: ${context.score} | Phase: ${context.phase}")

	runIf(context.phase eq 2) {
		say("Phase 2 is over!")
	}
}

OOP

Here, a boss bar and a timer are wired together so players see the bar appear and initialize automatically when the intro starts.

val bossBar = BossBar("game:boss") {
	name = text("Final Boss")
	color = BossBarColor.PURPLE
	max = 100
}

val introTimer = Timer("game:intro", 100) {
	bossBar.players += allPlayers()
	bossBar.value = 100
}

This last example shows the event system forwarding a player join into the current game state, which keeps phase-specific logic nicely encapsulated.

val gameStateManager = GameStateManager(
	initialState = LobbyState(),
)

events.listen<PlayerJoinEvent> {
	gameStateManager.currentState.onPlayerJoin(player)
}

And here a spawner is paired with a cooldown to keep waves under control without scattering timing logic everywhere.

val waveCooldown = Cooldown("game:next_wave", 200)

val arenaSpawner = Spawner("game:arena") {
	spawnEntity = EntityTypes.ZOMBIE
	position = pos(0, 64, 0)
}

events.listen<TickEvent> {
	if (waveCooldown.isFinished) {
		arenaSpawner.spawn()
		waveCooldown.reset()
	}
}

Changelog

CI/CD

Add ci.yml workflow for automated tests. 2720e85
Add publish-snapshot.yml workflow for snapshot builds, update docs with snapshot setup instructions, and enhance build logic for snapshot versioning. b93e1df

Documentation

Update bindings documentation for namespace remapping and normalization. 5c066da - @e-psi-lon
Add scoreboard comparison examples for equalTo, notEqualTo, and related helpers. Extend documentation with Kotlin DSL mappings to generated commands. a516ef1
Add new documentation for helpers module (renderers, raycasts, math, particles, state delegates). 941fa47
Enhance Helpers and OOP documentation with new workflows, API examples, expanded Events, Display Entities, Raycasts, and scheduling sections. e6d986d
Update module descriptions, installation guides, and examples for bindings, helpers, and oop modules. 4c59c0b
Add OOP documentation for cooldowns, timers, game state machine, boss bars, events, entities, and spawners. 761d7ec 89bb489 33747c3

New Features

State: Add score-based comparison functions, runIf, runWhile, and repeatScore helpers. Enhance ScoreboardDelegate with asExecuteScore and scoreboardEntity integration. fd63024
State: Replace repeatScore with repeat, update iteration handling, enhance documentation, and adjust tests and examples. ce4a0ef
Bindings: Add support for per-namespace renaming. e9ded19 - @e-psi-lon
Bindings: Use XDG-compliant caching and prefer Path over File. 67e8f76 - @e-psi-lon
Maths: Add utility functions for truncation and formatting in Position, Rotation, Time, Vec2, and Vec3, improve toString methods and type-specific property access. fb0be06
Maths: Add delegate-based math helpers, improve trigonometric functions, enhance sqrt initialization, and update tests and documentation. c16b0e79
OOP: Add OOP wrappers for entity management, game state transitions, timers, spawners, and boss bars. d677d20 a8b3ba9 46f9de7

Bug Fixes

Bindings: Normalize namespace object name. a1b167a - @e-psi-lon
Commands: Add missing literal("under") argument to spreadPlayers command. c7cdcfa
Arguments: Fix unintended cast of Double coordinates to Int (e.g. 0.0 → 0), replace str with toStringTruncatedIfRound for correct entity positioning. c28b4ba 08a37ef - #213
Files: Fix createTempDirectory actually not creating the temporary directory, add more utilities to Path, and update docs and tests. 0c95069

Refactors

Arguments: Add Argument parsing and deserialization logic, enhance BlockArgument serializer, and introduce proxy creation for arguments. 6353257 bedbedc
Bindings: Add @Suppress("DEPRECATION") for deprecated properties, update code generators to use CodeBlock for pack metadata, remove infix remapping function. 449b021 b6c500a c9c5f78 - @e-psi-lon
Bindings: Use native cache directory for macOS and Windows. a68df12 - @e-psi-lon
Build: Remove buildSrc, migrate build logic to build-logic directory, introduce kotlin-dsl plugin, define version catalogs, configure repositories, and add kotest-conventions for shared test configuration. f0aab38 601b748 d30d43f 788d574
Core: Remove unnecessary @OptIn annotations, fix typos, improve validation for path commonality check. 4a44232
Generation: Add merging logic for load.json/tick.json tags, improve path normalization, fix duplicate archive entries, and simplify mod function parameters. 7d938be 865947d
Helpers & OOP: Migrate helpers from oop to dedicated helpers module, add Area utilities, enhance GameState/GameStateManager, improve entities, timers, teams, and standardize indentation to tabs. ace2f01 2efe908 53cef64 fd2326d
Scoreboard: Replace fn.data/fn.scoreboard with direct calls, update copyDataFrom/copyTo logic. b948855
Serialization: Improve deserialization logic, simplify serializers by leveraging EnumStringSerializer, enhance NBT/JSON compatibility. 1785d7a 20677eb
Utils: Simplify dateFormats calculations, optimize imports in MarkdownRenderer, simplify parentElement type usage. 3c168b9

Thanks to @e-psi-lon for his contributions!

Full changelog: https://github.com/Ayfri/Kore/compare/v1.42.1-1.21.11..v2.0.0-1.21.11

1.42.1-1.21.11

v1.42.1-1.21.11calendar_monthPublished 20/02/2026 • (1 month ago)

Kore Releases

Changelogs

2.0.0-1.21.11

Welcome to Kore 2.0!

What's new?

Code examples

Helpers

OOP

Changelog

CI/CD

Documentation

New Features

Bug Fixes

Refactors

1.42.1-1.21.11

Documentation

Bug Fixes

Refactors

1.42.0-1.21.11

Changelog

1.41.3-1.21.11

Changelog

1.41.2-1.21.11

Changelog

1.41.1-1.21.11

Changelog

Worldgen & Environment

Combat & Components

Datapack Utilities

Core & Docs

1.37.0-1.21.10

Changelog

1.37.0-1.21.9

Changelog

1.33.2-1.21.8

Changelog

1.33.1-1.21.8

Changelog

1.33.1-1.21.7

Changelog

1.33.1-1.21.6

Changelog

1.28.0-1.21.5

Changelog

1.24.0-1.21.4

Changelog

1.23.0-1.21.4

Changelog

1.21.3-1.21.3

Changelog

1.21.2-1.21.3

Changelog

1.21.2-1.21.2

Changelog

1.17.0-1.21.1

Changelog

1.16.0-1.21.1

Changelog

1.15.1-1.21.1

Changelog

1.15.0-1.21.1

Changelog

1.15.0-1.21

Changelog

1.10.1-1.20.6

Changelog

1.10.1-1.20.5

Changelog

1.1.0-1.20.4

Changelog

1.1.0-1.20.3

Changelog

1.0.0-1.20.2 First release !

Kore Library v1.0.0 Released! 🎉

Releases by Minecraft Version