A feature release on top of 26.2, built around three things that were missing from the datapack loop: string manipulation at runtime, a Gradle plugin to get the pack in game without leaving the editor, and whole-pack optimization passes that clean up what the DSL generated.

Nothing here is breaking. Everything is opt-in: an unused module generates no mcfunction at all.

What's new?

• Dynamic Strings: a kotlin.String-shaped API over NBT storage. substring, split, join, replace, trim, padStart, uppercase, indexOf, reverse, plus a KoreStringList for the list side. Operators (+=, -=, *=) and a build { } DSL on top, results coming back as scoreboard scores.
• Gradle plugin: id("io.github.ayfri.kore") adds koreBuild, koreLink, koreReload, koreRun, koreClean and koreWorlds. Runs your entry point, copies the pack into your worlds, and reloads a running server over RCON.
• Optimization passes: seven whole-pack passes running right before the pack is written, pruning dead functions, shortening execute chains, hoisting score conditions into selectors, sorting selector arguments and merging duplicated functions.
• Lantern Load: lanternLoad { } generates the whole convention, version scores on load.status and runtime dependency guards, so a pack can depend on Bookshelf or Smithed and be depended on in return.
• Typed NBT paths: NbtPath replaces interpolated path strings, and resolveNbt writes one tree mixing literals and runtime scores.
• Score arithmetic: *=, /=, %=, setTo, minWith, maxWith and swapWith between score handles and delegated scores, plus a FakePlayer entity for #-prefixed holders.

Dynamic strings

A datapack cannot return a value, so every helper that computes something writes it into a fake-player score and returns a DynamicStringResult, which is a ScoreboardEntity. Predicates all use the same 1 / 0 convention:

Splitting, joining and the list primitives round-trip a list through a single string, which is how a list fits in an item name, a sign line or one storage field:

Scores convert in both directions, so a formatted counter needs no score chat component:

Gradle plugin

Every save regenerates the pack, copies it into the worlds and reloads the running server over RCON, with no alt-tab at all.

Optimization passes

They are disabled by default, since a pass deletes content. Writing the block runs every built-in pass in order and prints one summary line each, [kore:prune-empty-functions] pruned 12 empty functions and 4 calls to them.

reorder-selector-arguments is the same idea applied to the selector itself: @e[nbt={...},type=marker] deserializes the NBT of every entity in range before checking the type, while @e[type=marker,nbt={...}] reads it for markers only. Same result set, so the reordering is free.

Lantern Load

Your version lands on load.status as three fake players, and each dependency generates a runtime guard following the ecosystem rule, major equal and minor at least the requested one:

init runs only when every guard passes, so the pack never half-initializes against a missing library.

Typed NBT paths and score resolution

resolveNbt declares a tree once and emits both halves of it, the literal data modify and one execute store result per runtime score:

Score arithmetic and fake players

A fake player has no entity behind it, so asSelector() throws instead of emitting @e[name=#wave], which matches an entity custom name and would silently target nothing. Score APIs go through asScoreHolder() and accept one.

Changelog

New Features

• feat(oop): Add the dynamic strings module, DynamicString and KoreStringList over NBT storage, with operators, the build { } DSL, expression forms, the unified DynamicStringResult, multiplatform sources and a fully configurable runtime through DynamicStringConfig. 32c7801 8fa481c a3983ca 2116576 cc9631e 0e0d65d 4069051
• feat(oop): Accept a DynamicString operand in replace, replaceFirst and split, a score-driven count in repeat, padStart and padEnd, and convert to and from a scoreboard score with setFrom, appendFrom, prependFrom and toScore. 5821058 6b0c954
• feat(oop): Add the join operation concatenating a KoreStringList into a DynamicString with a separator, prefix and postfix. 4692fd8
• feat(gradle-plugin): Add the io.github.ayfri.kore Gradle plugin running a datapack entry point, linking it into worlds and reloading over RCON, published to Central and the Gradle Plugin Portal on the shared version. 957c6b0 b02fa8a
• feat(kore): Add opt-in whole-pack optimization passes, simplifying execute chains, hoisting score conditions, sorting selector arguments, merging duplicated functions, pruning empty and unreferenced generated ones and linting unreachable code. a2c5c66 bb32196
• feat(kore): Add lanternLoad { } generating the Lantern Load boilerplate, version scores and dependency guards. 6977f33
• feat(helpers): Add typed NbtPath paths, resolveNbt score resolution, and arithmetic between delegated scores. 6ca9be4
• feat(kore): Add String.toNbt and String.toNbtTag to parse SNBT text back into tags. fdc7be2
• feat(oop): Make ItemStack.toNbt public so a stack can be written into any NBT target. 40afa11

Bug Fixes

• fix(oop): Add FakePlayer and route score APIs through Entity.asScoreHolder, so fake holders stop emitting @e[name=...]. abff7a4
• fix(predicates): Annotate id in DamageTagPredicate with ArgumentSerializer. fcde15c

Performance improvements

• perf(serializers): Skip the KSP rounds after the first and resolve supertypes through a shared cache in SerializerMapProcessor. e44424b
• perf(utils): Hoist the per-call Regex instances out of snakeCase, handleMacro, macro name validation and unescapeChatComponent. f673376

Refactors

• refactor(kore): Extract the entity-argument rewrite of an inlined execute command into inlineTargets. 23b0219

Documentation

• docs(website): Add the Dynamic Strings page, structured around concepts, cost tiers, the operator forms and the scoreboard-result convention, with a typewriter dialogue box and a config-line parser as end-to-end examples. 47182c7 6c4242d 0b226a7 cbe2fcc 96fe3ec 17271d6 1b56ba5 94c6d99
• docs(oop): Add before/after examples to the KDoc of every dynamic string operation. af011c5
• docs(website): Add the Gradle plugin guide and document the shared publication version. ce52956
• docs(website): Add the Optimization guide, document the seven passes and the order they run in, and list the optimization option on the configuration page. 7c02dee a31a936
• docs(website): Add the Lantern Load guide covering load order, versioning and dependency guards. a589e76
• docs(website): Use the current gamerule names in the dynamic strings, test features and world events pages. 2b92e0b 038994b

Full changelog: https://github.com/Ayfri/Kore/compare/v2.13.1-26.2..v2.14.0-26.2

Welcome to Kore 26.2!

Kore 26.2 is the cycle where the library stopped being JVM-only, and where most of the data-driven DSL got a serious retype.

It started on the tail of 26.1 with a Kotlin 2.4 upgrade and a multiplatform port, then turned into a long pass over worldgen and predicates: scoped builders everywhere, vanilla names everywhere, and a lot of fields fixed to actually match the JSON the game reads. On top of that, the new 26.2 content landed as it came: sulfur cubes, speleothems, geysers, and the usual batch of item component changes.

This cycle is also the most breaking one in a while. Nearly every rename here exists because the old API let you write something the game refuses, or because a global function polluted autocomplete in places it had no business being. The migration is mostly mechanical, and the examples below show the before and after.

What's new?

The big stuff this cycle was:

• Multiplatform Support: kore, oop, helpers and bindings now target JVM and JS (browser + Node.js) at the same coordinates, powered by a pure-Kotlin ZipReader/ZipWriter and a PlatformIO abstraction (OPFS in the browser). org.joml and kotlin-reflect are gone as dependencies.
• Kotlin 2.4: no more -Xcontext-parameters compiler argument, and java.util.UUID is replaced by the stable multiplatform kotlin.uuid.Uuid.
• Worldgen: density functions, surface rules, carvers, processor lists, template pools, structures, block predicates, state providers, vertical anchors and height providers all moved to scoped builders, so autocomplete only offers what is valid in each context. New Providers and Carvers pages came with it.
• Predicates: every sub-predicate now carries its vanilla *Predicate name, serialization is checked against vanilla-mcdoc, item sub-predicates moved to the component matchers, and score holders became a sealed ScoreProvider.
• 26.2 content: sulfur_cube_archetype with explosion, contact damage, knockback and sounds, the speleothem rename, geyser particles, the sequence, template, weighted_random_selector and random_patch configured features, and the interval_select density function.

Code examples

Here is what the biggest 26.2 changes look like in practice.

Multiplatform datapacks

Scoped worldgen builders

Configured features, carvers and surface rules are built inside their own scope instead of loose global functions, so autocomplete only offers what is valid where you are.

World presets keyed by dimension id

Dimensions are keyed by their id instead of their type, so two dimensions can share a type, and generator builders set generator themselves.

Sulfur cubes

Migration notes

Every rename in this cycle, with the code to change on your side.

UUID becomes Uuid

The stable kotlin.uuid.Uuid is idiomatic, simpler, and multiplatform. If you only use the uuid() helpers, nothing changes.

item(...) becomes items(...) on item predicates

The builder takes several items and matches any of them, so the plural fits. Loot table entries keep their own item(...), which drops a single item.

Sub-predicates take their vanilla name

Each one is named after the vanilla type it produces, so a name found in the wiki maps to the Kore one, and the global functions stop clashing with other builders of the same name. The loot context enum EntityType became EntityTarget to stop clashing with the EntityTypes registry.

timeCheck requires its clock

Vanilla needs a clock to know which time to read, so it moved from a trailing nullable argument to the mandatory first one.

valueCheck requires its range

A value_check without a range never matches anything, so the range is mandatory. An IntRange overload comes with it, since the game clamps both bounds to an integer anyway.

Score holders are now a sealed ScoreProvider

Two nullable parameters let you pass both or neither and get invalid JSON, so the holder is a sealed type now: contextScore for a loot context entity, fixedScore for a name.

providersRange(...) becomes intRange(...)

Both built the same bound, so they are merged under intRange, which covers floats, providers, ClosedFloatingPointRange and IntRange.

Number providers only resolve inside their scopes

constant, uniform and the others now extend IntProviderScope/FloatProviderScope, so they only show up where a provider is accepted, and the int and float versions stop being ambiguous. weightedList gets a shorter syntax at the same time.

HeightConstant becomes VerticalAnchor

Vertical anchors and height providers are scoped too, so they only appear where a height is expected.

equippable takes a generated EquipmentAssets entry

The asset id was typed as ModelArgument, so any model name compiled. EquipmentAssets is generated from the vanilla list instead.

Dripstone becomes speleothem

Vanilla renamed the features in 26.2, and they gained base_block, pointed_block and replaceable_blocks.

Removed, with no replacement

weird_scaled_sampler and the noise_gradient surface rule are gone from vanilla, so they are gone from Kore. noise_threshold gained an optional 3D evaluation and covers most of what noise_gradient was used for.

New builders worth knowing

Changelog

Documentation

• docs(commands): Clarify and expand the command docs. 1d1e597
• docs(components): Revise the components guide to update examples, clarify predicates, and link the component matchers table. 9d3cf51
• docs(contributing): Update the architecture guide with GeneratedSealedSerializer usage and KSP-based serializer factory details. b5cf883
• docs(generation): Add short KDoc to the generation module's key entry points. f8b527a
• docs(home): Add community project links and the jumpr entry to the README list. e6b41aa 5aaf9c4
• docs(oop): Improve the item, scoreboard, and team documentation. 708af24
• docs(vfx-engine): Enhance the VfxEngine documentation with detailed explanations on shapes, coordinate spaces, and offsets. 035c1b9
• docs(website): Update the guide content, clarify Kore usage and migration paths, add a version matrix to the Home page. 0af799b
• docs(worldgen): Add a dedicated Carvers page and move the carver sections out of the Biomes page. d2f3cf1
• docs(worldgen): Document the IntProviderScope/FloatProviderScope builder receivers on the Providers page, fix the stale providersRange/binomial snippets in Item Modifiers and Loot Tables. 6aec34b
• docs(worldgen): Restructure the worldgen pages around a single end-to-end example, extract the shared providers to their own page, and condense the environment attribute reference into tables. 6aa1827
• docs(worldgen): Rewrite the Noise & Terrain page as a full density function, noise router, and surface rule reference. 38558ae
• docs(worldgen): Rewrite the Structures processor list and template pool sections with the scoped element builders. c403250 ba6c643

New Features

• feat(arguments): Add toStringWithDecimal for consistent decimal point formatting, update the positional, rotational, and vector conversions. 03158e9
• feat(bindings): Add the DatapackUpload API for exploring and importing datapack ZIPs in-memory, with cross-platform tests. 7dc0800
• feat(bindings): Enhance parseReference to support dotted GitHub repo names. a3f00b4
• feat(commands): Add team modify <team> color reset through colorReset. f6c6bc5
• feat(datapack): Introduce folderName to decouple output folder names from namespaces, add tests for the folder, jar, and zip modes. 8497d8b
• feat(enchantments): Add the geyser, geyser_base, geyser_plume, and geyser_poof particle options with unit tests. ccea6c1
• feat(entity-predicates): Introduce type-specific EntitySubPredicate subclasses (CubeMob, FishingHook, Lightning, Player, Raider, Sheep) and an EntityTypeSpecificScope to group them. 987b370
• feat(execute): Change run's block to Function.() -> Unit, allowing if/for control flow inside it. abc4a5c
• feat(fabric): Add ResourceCondition with fabricLoadConditions, implement condition-based JSON generation. 10543f8
• feat(generation): Add a DatapackFolderRegistry generator producing a datapack-folder-to-Argument-type map from the existing generator definitions. 75bf9a9
• feat(generation): Add a pure-Kotlin ZipReader and Inflate for cross-platform ZIP handling, unify the unzip logic with commonUnzipToTempDir. 2cad91a
• feat(generation): Generate the EnchantmentProviders and EquipmentAssets enums, retype equippable around EquipmentAssetArgument. c2c2bc5
• feat(generation): Introduce platform-agnostic I/O with PlatformIO, OPFS browser support, and a pure-Kotlin ZipWriter, unifying file operations across JVM, JS, and browser. 05e7b6a
• feat(helpers): Add a minimal in-house port of org.joml (Matrix4f, Matrix3f, AxisAngle4f, Quaternionf, Vector3f, JomlMath) for display transformation math. 0265cd6
• feat(item-components): Add the SulfurCubeContentComponent, with tests and documentation. 8afcac3
• feat(selector-arguments): Add fromString to parse selectors back from text, with deserialization logic and advanced selector support. 6feb45f
• feat(sulfur-cube-archetype): Add the sulfur_cube_archetype data-driven registry with attribute modifiers and buoyancy. b2e9a3d
• feat(sulfur-cube-archetype): Replace explosionFuse with structured explosion, contactDamage, and knockback powers, then add hit and push sound settings with pushSoundCooldown and pushSoundImpulseThreshold. 03233a1 42a9fbb df98bdf
• feat(test-environments): Add the difficulty test environment with unit tests. 961bbe7
• feat(vfx-engine): Add coordinate space support to drawShape, enhance VfxShape with positionType and origin. 2a5a916
• feat(worldgen): Accept a block ID or list of IDs, in addition to a tag, for the geode, root system, vegetation patch, dimension type infiniburn, and protected blocks replaceable fields. 7349b97
• feat(worldgen): Add the sequence and template configured feature types. 53eb47e
• feat(worldgen): Add the weighted_random_selector configured feature, plus levelTestDistance and maxLevelDeviation on root_system. bf4163c f9fdad8
• feat(worldgen): Add the interval_select density function and the matching_biomes block predicate, remove weird_scaled_sampler, make the multiface_growth block and the tree below_trunk_provider mandatory. af33acf
• feat(worldgen): Add optional 3D evaluation to noise_threshold and remove the obsolete noise_gradient surface rule. d25fd01
• feat(worldgen): Introduce IntProviderScope/FloatProviderScope as builder receivers across placed features, configured features, dimension types, enchantment providers, carvers, and processors, and add the random_patch configured feature. 779217c
• feat(worldgen): Enhance the Lake configuration with the canPlaceFeature, canReplaceWithAirOrFluid, and canReplaceWithBarrier block predicates. dccef30
• feat(worldgen): Rename the dripstone_cluster/pointed_dripstone configured features to speleothem_cluster/speleothem, add the base_block/pointed_block/replaceable_blocks fields, and add replaceable_blocks to large_dripstone. 9a56efe

Bug Fixes

• fix(bindings): Fix the illegal interface property initializers and unsafe identifiers left in the Resources and Tags generators. 53d8836
• fix(chat-components): Simplify the serialization logic for extra fields and enhance the JSON/NBT handling in chat components. 0aee14b 34d72bb 400f99f
• fix(commands-execute): Correct the targetArg logic to handle UUIDArgument equality with a self-check, and optimize the selector argument handling. 59c6eca
• fix(components): Add the missing saddle equipment slot. b5df734
• fix(datapack): Set pack_format to an integer only and fix its default value. b613e04
• fix(enchantments): Write the providers to enchantment_provider instead of trades, and allow any file name and sub-folder. 7d649e9
• fix(helpers): Rewrite fromAxisAngle to use sin/cos trigonometric calculations instead of instantiating a Quaternionf. c25bcdf
• fix(item-components): Change food's nutrition field from Float to Int, make use_cooldown's cooldown_group optional, and remove the invalid contact_cooldown_ticks field from kinetic_weapon. d47a492 2175192 1de41ea
• fix(item-components): Rename attack_range's min_range/max_range to min_reach/max_reach, blocks_attacks's disable_sound to disabled_sound, and firework_explosion's has_flicker to has_twinkle. f6ef4da 26bf1b2 415971b
• fix(item-components): Serialize the SulfurCubeContentComponent as an inlined item id instead of a nested object. 65db924
• fix(item-predicates): Add support for partial and negated components, enhance clearPredicate, and simplify the setPartial and negate logic. 3e7804d
• fix(pack): Fix the packFormat warning wrongly reported as outside the min_format/max_format range when it shares their major version. b458689
• fix(predicates): Rename the mob effect ambiant field to ambient, and write the periodic_tick and type_specific/cube_mob sub-predicate keys vanilla expects. 9a20f9b f3b3204
• fix(serializers): Serialize and deserialize half-open bounds in FloatRangeOrFloatJsonSerializer instead of throwing. 2e273bf
• fix(worldgen): Fix the noise and spline density functions and the stone_depth surface type to match the vanilla JSON, make the noise settings tests exhaustive. d09d92f
• fix(worldgen): Rename the misspelled biome spawner categories to ambient, axolotls, and waterAmbient, and add the missing misc one. 626e421 c4946a4
• fix(worldgen): Replace the ocean ruin type field by biomeTemp, and default the jigsaw size to 1 instead of the out-of-range 0. 635cc66 0e9bd53
• fix(worldgen): Return a ConfiguredStructureArgument from every configured structure builder so structure sets accept them. fab9d5c

Performance improvements

• perf(arguments): Scope the Argument interface classpath scan to the arguments packages and parallelize the Class.forName lookups. 00bfcde
• perf(datapack): Cache the jsonEncoder instead of rebuilding a Json config on every access. 7441a97
• perf(item-components): Encode component values directly instead of round-tripping through a JsonElement/NbtTag tree, and skip the redundant encode-to-element pass in ComponentsScope.asJson/asNbt. de3a95e f69791c

Refactors

• refactor(uuid)!: Replace java.util.UUID with kotlin.uuid.Uuid across modules, updating the related methods and constructors.
• refactor(components): Move the item sub-predicates to components/matchers as DataComponentPredicate and EnchantmentPredicate, rename item(...) to items(...), and add the missing villager/variant matcher. 72b3a6b
• refactor(density-functions): Add the densityFunctions builder with per-type block syntax, fix the snakeCase acronym and digit boundaries. dfe5c62
• refactor(enchantments): Share the effect builders through scopes, fix the explode, play_sound, and crossbow_charging_sounds codecs, and complete the effect components. 9a2be54
• refactor(predicates): Rename the sub-predicates to their vanilla *Predicate names, fix their serialization against vanilla-mcdoc, and require clock on timeCheck. 111e1a1
• refactor(predicates): Split the score targets into a ScoreProvider sealed type, require ranges on valueCheck, and add the IntRange overload. 1674e14
• refactor(trade-sets): Enhance TradeSet with new builder methods for trade amounts and sequences, with tests for empty and single trades. 892f75e
• refactor(worldgen): Scope the configured carver builders to ConfiguredCarversScope, add the missing nether_cave type, fix the vanilla defaults and the flat biome carvers list. f68c443
• refactor(worldgen): Scope the surface rule builders to SurfaceRulesScope, replace entry() with state/empty, and collapse the single-rule conditions. 1068a96
• refactor(worldgen): Scope the processor list builders to ProcessorsScope, fix the blackstone_replace name and the vanilla defaults. 0ddc09c
• refactor(worldgen): Scope the template pool builders to PoolEntriesScope and PoolElementsScope, fix the vanilla defaults, and add the legacySingle liquid settings. 87c932c
• refactor(worldgen): Scope the block predicate, block state provider, and rule test builders, replace offset with a per-predicate offset { }, add unobstructed and targets { } on the ore-like features, and fix the noise_threshold_provider, randomized_int_state_provider, and tag_match naming. 43d05a9 cf5c3c8 872ab1c
• refactor(worldgen): Rename HeightConstant to VerticalAnchor, scope the anchor and height provider builders, and document them with tests. e5ebca4
• refactor(worldgen): Key the world preset dimensions by their id instead of their type, make every dimension generator builder set generator, remove the obsolete natural dimension type field, and add a layers { } builder for the superflat settings. e8ca92c 41c83f7 99f997e bed0900
• refactor(worldgen): Replace the list-based amplitude and octave methods with a unified amplitudes(...). 2de880c
• refactor(worldgen): Retype the structures builder around a StructuresScope, fix the mineshaft, shipwreck, spawn override, and generation step keys, and document every type with tests. 6a0795f

Full changelog: https://github.com/Ayfri/Kore/compare/v2.6.1-26.1..v2.13.1-26.2-rc-2

Big one this release: Kore was JVM-only until now. kore, oop, helpers and bindings are all Kotlin Multiplatform (JVM + JS, browser and Node.js), at the same coordinates. Full writeup here: Multiplatform Support.

That's powered by new pure-Kotlin ZipReader/ZipWriter + PlatformIO (OPFS in the browser), a hand-rolled codegen model replacing KotlinPoet in bindings, and KSP-generated serializers replacing reflection everywhere. Two dependencies gone as a result: org.joml (re-ported by hand, see below) and kotlin-reflect.

A few smaller additions too:

Plus a minimal in-house org.joml port (Matrix4f, Matrix3f, AxisAngle4f, Quaternionf, Vector3f, JomlMath) for display transforms, one less dependency, and fabricLoadConditions/ResourceCondition for condition-based Fabric resources. Less libraries: faster and simplified Kore usage.

Documentation

• docs(contributing): Update architecture guide with GeneratedSealedSerializer usage and KSP-based serializer factory details. b5cf883

New Features

• feat(arguments): Add toStringWithDecimal for consistent decimal point formatting, update positional, rotational, and vector conversions. 03158e9
• feat(bindings): Add DatapackUpload API for exploring and importing datapack ZIPs in-memory, implement cross-platform tests. 7dc0800
• feat(bindings): Enhance parseReference to support dotted GitHub repo names, update tests to verify functionality. a3f00b4
• feat(datapack): Introduce folderName to decouple output folder names from namespaces, add tests for folder, jar, and zip modes, and update documentation for creating datapacks. 8497d8b #246
• feat(execute): Change run's block to Function.() -> Unit, allowing if/for control flow. abc4a5c #243
• feat(fabric): Add ResourceCondition with fabricLoadConditions, implement condition-based JSON generation. 10543f8
• feat(generation): Add DatapackFolderRegistry generator producing a datapack-folder-to-Argument-type map from existing generator definitions. 75bf9a9 #246
• feat(generation): Add pure-Kotlin ZipReader, Inflate for cross-platform ZIP handling, unify unzip logic with commonUnzipToTempDir. 2cad91a
• feat(generation): Introduce platform-agnostic I/O abstractions with PlatformIO, implement OPFS browser support, add ZipWriter for pure-Kotlin ZIP generation, and unify file operations across JVM, JS, and browser. 05e7b6a
• feat(helpers): Add minimal port of org.joml classes including Matrix4f, Matrix3f, AxisAngle4f, Quaternionf, Vector3f, and JomlMath for display transformation math. 0265cd6
• feat(selector-arguments): Add fromString to parse selector arguments, implement deserialization logic, enhance test cases, and support advanced selector parsing. 6feb45f

Bug Fixes

• fix(datapack): Set pack_format to integer only and fix default value. b613e04 #245
• fix(helpers): Rewrite fromAxisAngle to use trigonometric calculations with sin and cos, replacing Quaternionf instantiation, and adjust imports in Quaternion. c25bcdf

Full changelog: https://github.com/Ayfri/Kore/compare/v2.7.0-26.1.2..v2.8.0-26.1.2

This release updates Kore to Kotlin 2.4.0, which is great news because you don't need the -Xcontext-parameters compiler argument anymore ! I also migrated the UUIDArgument to use the new stable Uuid API from Kotlin instead of UUID from Java, this is because the API is more idiomatic to Kotlin and simpler and multiplatform.

If you're using the uuid() functions you probably don't need to change anything, else the migration is very easy:

Documentation

• docs(components): Revise components guide to update examples, clarify predicates, and link component matchers table. 9d3cf51
• docs(generation): Add short KDoc to the generation module's key entry points. f8b527a

Refactors

• refactor(uuid)!: Replace java.util.UUID with kotlin.uuid.Uuid across modules, update related methods and constructors accordingly.

Full changelog: https://github.com/Ayfri/Kore/compare/v2.6.2-26.1.2..v2.7.0-26.1.2

Welcome to Kore 26.1!

Kore 26.1 was a pretty long cycle.

It started with some groundwork on the late 1.21.11 side, then turned into a proper push for the new 26.1 data-driven systems. World clocks, timelines, villager trades, better time utilities, more worldgen coverage, and nicer OOP handles for displays and mannequins all landed here.

A lot of this cycle was also just polish, in the good way. There are plenty of docs, tests, serializer cleanups, and small API fixes in here because 26.1 added a lot of surface area, and I wanted Kore's DSL around it to feel nice instead of just technically complete.

What's new?

The big stuff this cycle was:

• World Clocks and the expanded Time DSL let you create custom clocks, timelines, time markers, clock-aware predicates, and time.of(clock) command flows.
• Villager Trades introduce fully data-driven villager_trade and trade_set generators, with item modifiers, predicates, and reusable trade pools.
• Worldgen Features grew a lot during 26.1: more vanilla configured features, better block state providers, new height and number providers, and stronger test coverage for generated JSON.
• Display Entities and Mannequins gained cleaner OOP entity handles, making it easier to summon, target, move, and manage generated entities from Kotlin.

A lot of the later releases were quieter, but they still mattered. Most of that work went into tightening serialization, filling API gaps, and expanding docs and test coverage for worldgen, predicates, commands, and helpers.

Code examples

Here are a few examples of what the biggest 26.1 additions look like in practice.

World clocks, timelines, and commands

Villager trades and trade sets

This one defines a custom trade and groups it into a level-based trade set, which is exactly the kind of data-driven economy flow 26.1 made possible.

Expanded worldgen DSL

Worldgen got a lot more expressive in 26.1, with richer configured features, state providers, and placement helpers.

OOP handles for generated entities

Helpers and OOP utilities also became easier to compose, especially when you want a generated display or mannequin to turn into a strongly-typed handle you can reuse later.

Changelog

Documentation

• docs(advanced): Extend Known_Issues.md with detailed limitations and workarounds for Kore. 51f7ab3
• docs(ai): Update README and Home.md to include Kore-Skill AI skills pack link. 0cde2af
• docs(bindings): Update Bindings.md with new setup steps and example improvements. d0028c5
• docs(commands): Add KDoc to all commands. e5bf892
• docs(commands): Fix wrong syntaxes in commands examples. 16ba50b
• docs(concepts): Add Selectors.md with comprehensive overview on building Minecraft target selectors in Kore, including typed builders, filtering capabilities, and score-based conditions. 2d44932
• docs(concepts): Add Time documentation for ticks, seconds, and days, usage examples, arithmetic, conversions, and command integration. 9b2c569
• docs(contributing): Add Arguments.md and Cookbook.md for contributors. Introduction to Kore's argument system, practical datapack patterns, including setup functions, logic reuse, custom items, delayed actions, and more. 150a544 80bc008
• docs(getting-started): Add link to "Learn X in Y Minutes - Kotlin" for a quick syntax refresher. 8b8750b
• docs(getting-started): Expand Kotlin basics section, add explanations for val/var, functions, and extension functions, include quick learning resources links. 9ac611c
• docs(guide): Revamp Getting_Started.md to provide a more comprehensive guide, emphasizing iterative development, modular project structure, and practical tips. ddbcb78
• docs(guides): Add advanced migration guide from Datapacks to Kore. 5c22eba
• docs(guides): Enhance configuration guide with detailed explanations. 8a3862f
• docs(helpers): Update Display_Entities and Mannequins docs with OOP entity handles, code examples, and enhanced functionality descriptions. 48fac17
• docs(markdown): Standardize links and hyphenation in documentation, fix inconsistent Markdown syntax, and improve clarity in examples and descriptions. c5df568
• docs(nbt): Add complete documentation about NBTs. 5a7592d
• docs(number-providers): Add KDoc to all number providers, update documentation. 8ff7ba5
• docs(pages): Add copy button for markdown content and load sources. ec2d4c1 2ec7dcf
• docs(villager-trades): Add Villager Trades documentation, update related pages with references to trade gating, item modifiers, and enchantments. 68f02d9
• docs(world-clock): Add the World Clocks guide, update Timelines to reference clocks and time markers, improve examples, and align the docs with snapshot 26.1 changes. f3436b5
• docs(worldgen): Add documentation for FloatProvider types with descriptions, examples, and usage scenarios in feature configuration. 2b1991e
• docs(worldgen): Document IntProvider types with descriptions, examples, and usage scenarios in feature configuration. aeb9e5f
• docs(worldgen): Expand Features.md with new vanilla feature types, no-config objects, modifiers, and height providers. Add examples, update descriptions, and fix typos. 676cc22

New Features

• feat(arguments): Introduce MOB.INVENTORY, replacing the old PIGLIN and VILLAGER slots. aba3d82
• feat(advancement): Add the player-interact-with-entity trigger. 69cd1be
• feat(bindings): Add support for customizable HTTP request payload and headers, update related tests and documentation. eefe605
• feat(bindings): Enhance the GitHub function with API key authentication details, add tests and docs. 00f7dcf
• feat(chat-components): Add the fallback property to ObjectTextComponent and its subcomponents, update builders, tests, and docs. 30b7b80
• feat(commands): Add the first swing command support with SwingHand and unit tests. e8bc54f
• feat(commands): Add placeJigsaw overload with JigsawArgument, enhance placeTemplate with integrity and TemplateMirror, and improve KDoc for place functions. f885b8f
• feat(commands): Expand /time with of subcommands for clocks, add pause, resume, new queries and setters, update docs and tests. 09fc73f
• feat(commands): Expand swing with main-hand usage and targets support, update tests. f4ff4f4
• feat(commands): Update locatePointOfInterest to use PointOfInterestTypeOrTagArgument, add KDoc comments to locate functions. 8a223fd 513a6d7 d4a906e
• feat(data-driven): Add TradeSet and VillagerTrade generators with builder functions, integrate them into DataPack. 2d035ae c6f034b 94590e7
• feat(datapack): Add path and iconPath utility functions, removing the need for the kotlinx.io library in simple projects. 8556f71
• feat(entities): Add OOP entity handles for displays and mannequins, with selector-based targeting, UUID-based identity, and enhanced functionality. f22d89b
• feat(entities): Add toEntity and entity factory methods for EntityType, update docs with usage examples, and extend tests to validate the new flow. 7e92bf3
• feat(environment-attributes): Add ambientLightColor, blockLightTint, and nightVisionColor with tests and documentation. fa73f7a
• feat(item-components): Add the AdditionalTradeCost component with tests and documentation. 79af872
• feat(item-modifiers): Add includeAdditionalCostComponent to enchantRandomly and enchantWithLevels, update tests and documentation. c6f7022
• feat(item-modifiers): Add setRandomDyes and setRandomPotion, update documentation and item modifier functionality. 55e6dae
• feat(item-slot): Add the piglin item slot. 37a10b7
• feat(nbt-utils): Add more builders for NBT lists. fbe3973
• feat(oop): Add a more customizable ItemStack.summon. 91d4be2
• feat(pig-sound-variants): Add the eatSound property to PigSoundVariant, update docs and tests. d96d2a4
• feat(predicates): Add the environmentAttribute function and EnvironmentAttributeNumberProvider. 2e0c84e
• feat(predicates): Add environmentAttributeCheck condition and overloads, update docs and tests. 654d184
• feat(predicates): Add PlayerFoodPredicate with level and saturation, update tests and documentation. 09db797
• feat(predicates): Add the clock parameter to TimeCheck, update overloads, and cover clock plus period combinations in tests. 7f1df0d
• feat(predicates): Add the sum number provider, update documentation and tests. a4fc50e
• feat(predicates): Add utility x, y, z setter functions to Position. 40995b2
• feat(test-environments): Add the timelineAttributes environment, update docs and tests for timeline-driven mechanics. 5c6e0a6
• feat(test-environments): Replace TimeOfDay with ClockTimeEnvironment, add a clock parameter, update tests and docs for clock-based time environments. 7b722ed
• feat(time-command): Add the rate function to control day-night cycle speed, update tests and docs accordingly. 346ad90
• feat(timelines): Add support for timeMarkers in timelines, introduce TimeMarkerArgument and TimelineMarker, update tests to cover marker usage and clock-aware flows. ea7bbef
• feat(vec3): Enhance Vec3 and PosNumber with serialization support and docs. f68a73c
• feat(website-styles): Add scrollMarginTop to the html element for better scrolling behavior. 7cfd313
• feat(wolf-sound-variants): Add support for age-specific wolf sounds with adultSounds and babySounds, update tests and docs. c1c40b8
• feat(worldclock): Add the WorldClock class and worldClock function, with tests for creation and registration. 77bd8a8
• feat(worldgen): Add defaultClock to DimensionType, update tests and docs for WorldClock integration. 0af46d7
• feat(worldgen): Add the endSpike factory function, update docs. b55db8d
• feat(worldgen): Add extensive configuredFeature test coverage for many vanilla feature types, including bamboo, basaltColumns, dripstoneCluster, geode, and more. 53df549
• feat(worldgen): Add FloatProvider factory functions with aliases for disambiguation, plus full unit test coverage for all supported float provider types. a1ea226
• feat(worldgen): Add TrapezoidIntProvider and the trapezoid factory function, update functions.kt ordering. 16dab69

Bug Fixes

• fix(advancement): Add the missing from AdvancementRoute, improve KDoc. bf07d93
• fix(bindings): Correct the cache directory path in getCacheDir for consistency. 48bde8d
• fix(bossbar): Add the missing setName overload with a text component and improve KDoc. 15b8767
• fix(commands): Add the missing entity literal to teleport overloads, improve KDoc. 318f75e
• fix(commands): Add the missing fill options for the fill command. c76866e
• fix(commands): Add the missing set sub-literal for style in waypoint modify, refine KDoc for WaypointModify and related functions. c0a7fa2
• fix(commands): Fix many clone grammar issues, add missing modes and sub-literals, improve KDoc. 9ed7482
• fix(commands): Replace sequenceId with RandomSequenceArgument, improve random command KDoc. 5eb7557
• fix(components): Replace InlinableList with List in ProvidesBannerPatterns, add PatternListSerializer, and update providesBannerPatterns helpers. 3515467
• fix(data): Add missing support for string-based data commands, including append, insert, merge, and prepend operations. e041065
• fix(docs): Update test commands in contributing documentation for consistency. 32feda0
• fix(helpers): Fix the double namespace issue, broken self-recursion, and max-hit dedup in raycast. 933743b
• fix(item): Correct the argument order in toItemArgument. 669152c
• fix(playsound): Replace SoundArgument with SoundEventArgument in playSound. 4ae24e5
• fix(stopwatch): Update the scale parameter to use a float type. 84edfb0
• fix(time): Update Time.toString() to use toStringTruncatedIfRound, extend TitleCommand tests. 5b7969b
• fix(vec): Fix the double truncation logic, add more tests, and repair the raycast test. b3e3618
• fix(worldgen): Add the randomSelector factory function and DSL, update docs. 25114cc
• fix(worldgen): Simplify Features serialization logic, replace InlinableListSerializer with ListSerializer, and preserve positional order with empty lists. ebde9c9

Refactors

• refactor(item-components): Update components to support multiple IDs or tags for providesBannerPatterns, blocksAttacks, and damageResistant. 945596b
• refactor(item-modifiers): Enhance setInstrument to support a single ID, a tag, or multiple IDs and tags, update related docs and tests. d3d82af
• refactor(number-providers): Remove the custom serializer from ScoreTargetNumberProvider, simplify the implementation. e7d0d5a
• refactor(worldgen): Add DSL improvements for RuleBasedBlockStateProvider, enhance rule configurability, update related tests and docs. 7af02b8
• refactor(worldgen): Enhance the AlterGround tree decorator DSL, add builder block support, update tests and usage. c87b7e3
• refactor(worldgen): Remove Flower, NoBonemealFlower, and RandomPatch configurations, update documentation to reflect the change. f16ae73
• refactor(worldgen): Rename RuleBasedBlockStateProvider to RuleBasedStateProvider, update usages, tests, and docs accordingly. aef0afb
• refactor(worldgen): Replace RuleBasedBlockStateProvider with BlockStateProvider across tree configurations, update the relevant docs and test cases. fa1f987

Full changelog: https://github.com/Ayfri/Kore/compare/v2.0.2-1.21.11..v2.6.1-26.1-rc-3

Another small release with many improvements to the documentation, a few small fixes, a missing advancement trigger, and improvements to NBTs with even its own documentation page.

Documentation

• docs(advanced): Extend Known_Issues.md with detailed limitations and workarounds for Kore. 51f7ab3
• docs(ai): Update README and Home.md to include Kore-Skill AI skills pack link. 0cde2af
• docs(getting-started): Add link to "Learn X in Y Minutes - Kotlin" for quick syntax refresher. 8b8750b
• docs(getting-started): Expand Kotlin basics section, add explanations for val/var, functions, and extension functions, include quick learning resources links. 9ac611c
• docs(guide): Revamp Getting_Started.md to provide a more comprehensive guide, emphasizing iterative development, modular project structure, and practical tips. ddbcb78
• docs(guides): Add advanced migration guide from Datapacks to Kore. 5c22eba
• docs(guides): Enhance configuration guide with detailed explanations. 8a3862f
• docs(nbt): Add complete documentation about NBTs. 5a7592d
• docs(pages): Add copy button for markdown content and load sources. ec2d4c1 2ec7dcf

New Features

• feat(advancement): Add player interact with entity trigger 69cd1be
• feat(nbt-utils): Add more builders for Nbt Lists. fbe3973
• feat(oop): Add a more customizable ItemStack.summon. 91d4be2
• feat(vec3): Enhance Vec3 and PosNumber with serialization support and docs. f68a73c

Bug Fixes

• fix(data): Add missing data ... string commands support, append, insert, merge, and prepend operations. e041065

Refactors

Full changelog: https://github.com/Ayfri/Kore/compare/v2.0.2-1.21.11..v2.0.3-1.21.11

Small but big release, adding a lot of missing KDoc on commands, new documentation for Selectors, Arguments Internals for contributors and a Cookbook with common patterns you would want to know.

I've also fixed many small issues with rarely used commands. Point Of Interest enum generation and argument support for locate poi command, new way to configure Bindings Github API Key and url parameters.

Documentation

• docs(bindings): Update Bindings.md with new setup steps and example improvements. d0028c5
• docs(commands): Add KDoc to all commands. e5bf892
• docs(commands): Fix wrong syntaxes in commands examples. 16ba50b
• docs(concepts): Add Selectors.md with comprehensive overview on building Minecraft target selectors in Kore, including typed builders, filtering capabilities, and score-based conditions. 2d44932
• docs(contributing): Add Arguments.md and Cookbook.md for contributors. Introduction to Kore's argument system, practical datapack patterns, including setup functions, logic reuse, custom items, delayed actions, and more. 150a544 80bc008

New Features

• feat(bindings): Add support for customizable HTTP request payload and headers, update related tests and documentation. eefe605
• feat(bindings): Enhance GitHub function with API key authentication details, add tests and docs. 00f7dcf
• feat(commands): Add placeJigsaw overload with JigsawArgument, enhance placeTemplate with integrity and TemplateMirror, and improve KDoc for place functions. f885b8f
• feat(commands): Update locatePointOfInterest to use PointOfInterestTypeOrTagArgument, add KDoc comments to locate functions. 8a223fd 513a6d7 d4a906e
• feat(predicates): Add utility x, y, z setter functions to Position. 40995b2

Bug Fixes

• fix(advancement): Add missing from AdvancementRoute, improve KDoc. bf07d93
• fix(bindings): Correct cache directory path in getCacheDir function for consistency. 48bde8d
• fix(bossbar): Add missing setName with text component and improve KDoc. 15b8767
• fix(commands): Add set sub-literal for style in waypoint modify, refine KDoc for WaypointModify and related functions. c0a7fa2
• fix(commands): Add missing entity literal to teleport overloads, improve KDoc. 318f75e
• fix(commands): Add missing fill options for fill command. c76866e
• fix(commands): Fix many clone command grammar issues, add missing modes and sub-literals, improve KDoc. 9ed7482
• fix(commands): Replace sequenceId with RandomSequenceArgument, improve random command KDoc. 5eb7557
• fix(docs): Update test commands in contributing documentation for consistency. 32feda0
• fix(item): Correct argument order in toItemArgument method. 669152c #216
• fix(playsound): Replace SoundArgument with SoundEventArgument in playSound command. 4ae24e5
• fix(stopwatch): Update scale parameter to use float type. 84edfb0

Full changelog: https://github.com/Ayfri/Kore/compare/v2.0.1-1.21.11..v2.0.2-1.21.11

Small fix to execute if block and a lot of new documentation on how to contribute to Kore!

Documentation

• docs(commands): Add KDoc to all execute and execute condition functions. 6773147
• docs(contributing): Add comprehensive contributor guides on architecture, workflow, CI/CD, and generator creation. 50d926c
• docs(contributing): Revise guidelines for contribution, link to detailed docs for architecture, workflow, and CI/CD, and update README and website with clearer contribution instructions. 1fbb46a
• docs(home): Fix error in example code. 8ea2d2e

Bug Fixes

• fix(execute): Add missing execute if block with BlockTag argument. 993bf55

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

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.