2069a6bab4ad5a5d90a16a1c2145ca5379dbba6b
codecraft
Codecraft is a Fabric mod for Minecraft that lets players write and run Lua code
from an in-game code editor. Open the editor with J (default, rebindable under
Options → Controls → Codecraft), write your script, and press Run Script —
it executes on the server. Scripts can change the world, react to game events,
and automate gameplay:
for y = 64, 67 do
world.set_block(10, y, -3, "minecraft:cobblestone")
end
Features
- In-game code editor — built with custom widgets: Lua syntax highlighting, autocompletion, snippets, multiple panes, find and replace, and configurable themes and fonts.
- Project file tree — files are named by path (
lib/gui/theme), grouped into folders, andmainis the entrypoint that Run Script executes. - Server-side Lua runtime — scripts run on the server thread through luajava (pure-Java LuaJ, no native libraries), so everything a script does has server permissions.
- Lua API — place and break blocks, spawn and manipulate entities, scoreboards,
HUD and boss bars, items and inventories, commands via
run(), and event listeners (events.on_break_block,events.on_chat, ...) that keep running after the script has finished. - In-game documentation — browse the full API reference from the editor
(Help → Lua API Documentation), or press
F1on a function while editing. - Live collaboration — documents are shared and synced in real time between players editing them together.
- Terminal pane — a server shell right inside the editor.
- Plain-file persistence — the project is stored as
.luafiles underconfig/codecraft/on the server, mirroring project paths, so it can also be edited with an external editor and is re-read every time the editor opens.
Lua API
The full API reference lives in docs/lua-api.md and is browsable in-game from the editor. It covers blocks, entities, scoreboards, HUD and boss bars, items and inventories, events, examples, and limits.
Requirements
| Component | Version |
|---|---|
| Minecraft | 26.2 |
| Fabric Loader | ≥ 0.19.3 |
| Fabric API | any recent build |
| Java | 25+ |
Building
Building requires JDK 25.
./gradlew build— compile and build the mod jar (output inbuild/libs/)../gradlew runClient— launch a dev client with the mod loaded../gradlew runDatagen— regenerate data (lang files) intosrc/main/generated/.
For general Fabric workspace setup, see the Fabric Documentation page related to the IDE that you are using.
License
Distributed under the CC0-1.0 license. See LICENSE for details.
Languages
Java
100%