Get started
What is Crafting
Crafting is a modding platform for Minecraft Java 26.3. You write mods in CraftScript, its own language, or in Kotlin (and Java), against an API that doesn't depend on the game's code.
The idea
A Crafting mod never calls Minecraft directly. It calls Crafting: “give this item to the player”, “tell me when someone breaks a block”, “create this block with this hardness”. Crafting knows how to do each of those things in the game version that is running.
When a new version of Minecraft comes out, Crafting is what gets updated. Your mod stays the same file and keeps working. The exact rules of that promise are in Your mod doesn't break.
Two languages, one API
| Use it for | |
|---|---|
| CraftScript | Getting started without knowing Java, and most mods: content, events, commands, game logic. Plain .craft text files that reload when you save. It has types, classes and modules for when the mod grows. Guide |
| Kotlin | Large mods, with static types and the full IDE, or mods that need what only exists here: background work and Java libraries. Java uses the same API. Guide |
Both run side by side in the same game. You can start in CraftScript and move only the part that needs it to Kotlin.
What's there today
- Version
- 0.1.0, in development. Built from source.
- Game
- Minecraft Java 26.3, client and dedicated server.
- API
- Items, blocks with one or more loot drops, recipes, every server event, players, blocks and entities, commands and permissions, timers, blocks of any shape, custom creatures with their own behaviour and 3D model (they spawn on their own and can be tamed, bred, ridden, fly, shoot and use keyframed animations), ores that generate in the world, custom sounds and particles, forms and on-screen elements, the world, players, saved data, file-based settings and client-server networking. All of it, from CraftScript and from Kotlin. It also covers effects, attributes and equipment, armor, weapons and cooldowns, entity events and custom keys.
- Shader packs
- Shader packs as data, installed by copying a folder. See Shader packs.
Where to go next
- Install Crafting in the launcher or on a server.
- Write your first mod and test it without opening the game.
- Read Organizing a mod before it grows.