Description
Kodkraft — real programming inside Minecraft
Computers, robots and drones that run your own programs in Python, JavaScript or Lua. Write code in the in-game editor, press Run and watch it open doors, sort chests, farm wheat and fly drones.
Language note: the in-game help, the example programs and the error explanations are in Russian (the mod was made for Russian-speaking students). Code, modules and function names are in English, and all blocks and items have English names.
Three languages
- Python — the mod's own interpreter: classes, exceptions, f-strings, list comprehensions, big integers.
- JavaScript (ES6) —
let/const, arrow functions, template strings, destructuring,Map/Set,JSON. - Lua 5.2 — tables, coroutines,
string.format,pcall.
The file extension picks the language: main.py, main.js or main.lua. The device modules are the same in all three.
Safe for servers
- Every program runs in its own thread with a step budget:
while Truenever freezes the server, and Stop always works. - JavaScript and Lua are sandboxed: no Java classes, no files, no processes.
- A program that eats memory is stopped with a
MemoryErrorinstead of crashing the server. - Robots and drones break and place blocks as a fake player, so claim and protection mods apply to them.
- Fireworks, lightning and particles from programs are visual only — they can't hurt anyone.
What's inside
- Code editor — highlighting for all three languages, line numbers, auto-indent, copy/paste, undo,
several files per device,
import/requireof your own files, 45 example programs and built-in help. - Computer — redstone on all six sides, sensors, chat, radio, monitors.
- Robot — drives block by block, digs, places blocks, uses items, fights mobs, milks cows and crafts in its own 16-slot inventory.
- Drone — flies anywhere at 8 blocks per second, picks up items, unloads into chests, harvests and replants crops.
- Monitor — a wall of monitors up to 8×6 blocks becomes one screen (48×48 pixels per block): pixels, lines, circles, text and touch input. Build a radar, a base dashboard or a Snake game.
- Storage Adapter — put it on a chest or on another mod's storage (drawers, vaults, bins, barrels…), give it a name,
and programs reach that storage by name from up to 256 blocks away. Items can be picked by name, by mask (
"*_log") or by tag ("#c:ingots"), so sorting works with modded items too. - Remote — right-click sends a signal to programs: who pressed it, with or without Shift, and what they were looking at (up to 64 blocks). Point at a block and the drone flies there.
- Sensors — players and mobs nearby (with a hostile flag), blocks and their properties, light, biome,
ore search (
world.find_blocks("#c:ores")), fluids and energy (FE) in machines. - Radio between devices, chat commands, fireworks, particles and titles.
A taste of the code
import drone
import world
home = drone.position()
for item in world.items(16):
drone.fly_to(item["x"], item["y"] + 1, item["z"])
drone.pick_up()
drone.fly_to(home[0], home[1], home[2])
drone.drop()
// sort ingots of every mod into the storage named "ingots"
const moved = storage.move("input", "ingots", "#c:ingots");
console.log(`moved ${moved} ingots`);
for side = 1, 4 do
for step = 1, 3 do robot.forward() end
robot.turn_right()
end
Recipes
| Item | Ingredients |
|---|---|
| Computer | 5 iron ingots, glass pane, 2 redstone, comparator |
| Robot | lightning rod, computer, chest, 4 iron ingots |
| Drone | computer, 4 iron ingots, 4 feathers |
| 2 Monitors | 4 iron ingots, 4 glass panes, redstone |
| 2 Storage Adapters | 2 iron ingots, ender pearl, redstone |
| Remote | redstone torch, stone button, iron ingot |
Server settings
config/kodkraft-server.toml: stepsPerTick (program speed), robotsBreakBlocks, playerRadius (how far programs
see players, 32 by default), netRange (radio and adapter range, 256), scanRadius (find_blocks radius, 8).
Compatibility
- Minecraft 1.21.1, NeoForge 21.1+, Java 21. Needed on both the client and the server.
- No other mods required. Tested in All the Mods 10.
- The Storage Adapter works with anything that exposes NeoForge item, fluid or energy capabilities. Checked in game: Functional Storage, Sophisticated Storage, Create item vault, Mekanism bins, tanks and energy cubes. On an AE2 or Refined Storage interface the adapter sees that block's own slots, not the whole network.




