Kotlin scripts for Minecraft. Write a small .kts file, type its name in chat, and it runs
inside the game. Edit it and run it again: no restart.
Beta 0.1.0 · Fabric · Minecraft 26.3 · Java 25 · GPL-3.0-or-later
Beta: things may still change before 1.0. Each release lists what changed.
- Install Fabric Loader for Minecraft 26.3 (it needs Java 25).
- Put these in
.minecraft/mods:- Fabric API
- Fabric Language Kotlin
- Minekt, from Releases:
minekt-<version>.jar(downloads the Kotlin compiler on first start) orminekt-<version>-full.jar(has it built in, works offline).
- Start the game and open a world. Type
\helloin chat.
Scripts live in .minecraft/minekt/ (Minekt creates it, with a few examples). Save this as
.minecraft/minekt/ores.kts, then type \ores in chat:
val ores = findBlocks(16) { it.endsWith("_ore") }
echo("${ores.size} ores nearby")
ores.firstOrNull()?.let { echo("nearest:", it.id, "at", it.pos) }Change it, save, and type \ores again: it runs the new version. Your first scripts goes on from
here, and examples/ has more to copy: a radar, a minimap, tracers, a custom crosshair…
| Command | |
|---|---|
\<script> [args] |
run <script>.kts from .minecraft/minekt/ |
\menu |
the script manager: run, stop, settings and logs |
\jobs, \kill <id|all> |
see and stop running scripts |
\install <link> |
install someone's script, after showing what it can do |
\help |
every command |
With Mod Menu, Minekt's settings are under Configure. More in Getting started.
On a server: put the same three jars in the server's mods folder. Operators run scripts from the server's
minekt/ folder with /mks run <script>. See Server scripts.
Scripts can do anything on your computer, not just in the game. Only run scripts you trust, and check a server's rules before using automation there.
Scripts are full Kotlin with the game and every installed mod on hand, and mod code works in them as it is.
- API overview: everything scripts can call, on one page
- Player and world, Events, Drawing and screens, Data and the web, Errors and logs, Sharing
- Advanced: Fabric API events, method hooks, class rewriting, packets, other mods, Baritone
- Coming from Fabric: the same mod written both ways
- Server scripts: the server API,
/mks, permission nodes for permission managers, andminekt:hostfor other mods - How it works: internals, building from source, the tests
All the docs: docs/.
A large part of Minekt's code, tests and documentation was written with the help of an AI. I review and test the changes, and every release is built only after the automated tests and the real-server tests pass. No vibeslop here trust.
GPL-3.0-or-later. See LICENSE.