Kore Documentation

Kore is a Kotlin library for building Minecraft datapacks with a concise, type-safe Kotlin DSL. It focuses on readable builders, stable generation of datapack JSON, and tight integration with vanilla concepts (functions, loot tables, predicates, worldgen, ...).

Start here

  • New to Kore? Follow the Getting Started guide, a step-by-step introduction to creating your first datapack.
  • Already writing datapacks by hand? Read Coming from Datapacks, and Why Kore for the comparison.
  • Want to try it first? The playground runs Kore in your browser, with nothing to install.
  • Looking for something to copy? Browse the Cookbook for practical patterns you can reuse.

Prerequisites: Java 25 (JDK 25) and a Kotlin 2.4+ build environment. For a ready-to-run project, use the Kore Template.

Minimal example

fun main() {
	val datapack = dataPack("example") {
		function("display_text") {
			tellraw(allPlayers(), textComponent("Hello World!"))
		}
	}

	datapack.generateZip()
}
Kotlin

Browse by topic

The sidebar search (Ctrl K) finds any page, and the Features page lists everything Kore covers with in-game previews.

Modules

Kore is split into installable modules: start with kore, then add the others depending on the abstractions or tooling you need.

Module What it adds Artifact Docs
kore The core DSL to build datapacks. io.github.ayfri.kore:kore:2.28.0-26.3 Getting Started
oop Higher-level abstractions for boss bars, cooldowns, entities, game states, scoreboards, spawners, teams, and timers. io.github.ayfri.kore:oop:2.28.0-26.3 OOP Module
helpers Renderers, raycasts, scheduler utilities, scoreboard math, state delegates, particle helpers, and related utilities. io.github.ayfri.kore:helpers:2.28.0-26.3 Helpers Module
bindings Importer of existing datapacks that generates type-safe Kotlin bindings for their functions, resources, and tags. io.github.ayfri.kore:bindings:2.28.0-26.3 Importing Datapacks

All four modules are Kotlin Multiplatform (JVM + JS): file/ZIP/JAR generation works on the JVM and Node.js, while browser JS consumers build the DSL and call exportAsStrings() / generateZipBytes() instead. See Multiplatform Support for what runs where.

2.28.0-26.3 targets Minecraft 26.3: the version matrix lists the release for each Minecraft version, and the snapshot builds section of Getting Started shows how to use the latest unreleased changes.

Tooling

  • Kore Assistant: gutter icons, hovers, and declaration navigation for the Kore DSL in your editor, for IntelliJ IDEA and VS Code.
  • Gradle plugin: generates the datapack, copies it into your worlds and reloads a running server, see Gradle Plugin.
  • Starter template: Kore Template, a ready-to-run project.
  • LLM-friendly documentation: llms.txt | llms-full.txt | every page also has a plain Markdown copy at its URL with .md appended, such as /docs/getting-started.md
  • AI Agents skills: Kore-Skill (optional skills pack for AI-assisted Kore work)

Help and community

To contribute to Kore itself, start with Contributing to Kore, the hub for architecture, workflow, and maintainer docs.

Built with Kore

Real projects built with Kore, useful to see the DSL used at full project scale:

To add your project to the list, open an issue on the repository or ping me on Discord.