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
Browse by topic
Commands & logic
Write functions and commands, target entities and test conditions.
Scores & data
Store numbers, NBT and strings, then compute with them.
Text & interfaces
Format chat text and build dialogs, menus, sidebars and boss bars.
Items & loot
Custom items, recipes, loot, enchantments and trades.
Entities & world
Handle players and mobs, display entities, NPCs, raycasts and particles.
Events & time
React to what players do and drive timers, game states and world clocks.
World generation
Biomes, dimensions, structures, features and terrain noise.
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
.mdappended, such as/docs/getting-started.md - AI Agents skills: Kore-Skill (optional skills pack for AI-assisted Kore work)
Help and community
- Discord: join the Kore Discord for questions and to chat with other datapack devs.
- Issues & bugs: report them on the GitHub repository.
- Known workarounds: check Known Issues before filing a bug.
- Read first: Kore Hello World, a hands-on intro article.
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.
