Get started

Installation

On your computer, Crafting is one more profile in the official launcher. On a server, it's a folder with a start script. You need Minecraft Java 26.3 and Java 25 (the launcher already ships Java; on a server you have to install it).

Build Crafting

There are no published downloads yet: you build it from source.

Terminal
git clone <crafting-repository> crafting && cd crafting
./gradlew :crafting-cli:installDist

The executable ends up in crafting-cli/build/install/crafting/bin/crafting. Add that folder to your PATH; the rest of the documentation just calls it crafting.

On your computer

  1. Open the official launcher once with Minecraft 26.3 so it downloads the game.
  2. Run the installer:
    Terminal
    crafting install --mc 26.3
    crafting install --mc 26.3 --dir "/path/to/.minecraft"   # a different game folder
    It finds the game folder on its own on Windows (%APPDATA%\.minecraft), macOS (~/Library/Application Support/minecraft) and Linux (~/.minecraft). If yours is somewhere else, use --dir.
  3. The Crafting 26.3 profile shows up in the launcher. Pick it and play.

The installer adds the Crafting libraries to the game folder, creates a crafting-0.1.0-26.3 version that inherits from the official one, adds the profile (saving a copy of launcher_profiles.json first) and creates the mods/, plugins/ and config/ folders. Run it again every time you update Crafting.

On a server

Terminal
crafting install --mc 26.3 --server ./server
cd server && cp ~/Downloads/server.jar . && ./start-crafting.sh

The installer copies Crafting to crafting/libs/ and creates start-crafting.sh (Linux, macOS) and start-crafting.bat (Windows). Put the official 26.3 server.jar in the folder and start with the script. Players can join with unmodded Minecraft as long as the server only has plugins; if there are mods that add blocks or items, they need Crafting and those mods (see Config and networking).

Where mods go

Folder What goes there
mods/ CraftScript mods (a .craft file or a folder with main.craft) and .jar mods.
plugins/ Server plugins.
config/ Settings generated by mods (<mod>.toml) and permissions (config/crafting/permissions.json).

A file that ends in .disabled or starts with . is ignored: that's how you disable a mod without deleting it.

The Mods screen

The main menu and the pause menu have a Mods button. It lists every mod in the game with its version, authors and description, and tells you for each one whether it works fully, what is disabled or why it couldn't load. Text appears in Spanish or English depending on the game's language. /crafting mods gives the same list in chat or in the console.

Startup options

Java property Effect
-Dcrafting.dev=true Development mode: scripts and plugins reload when you save them.
-Dcrafting.profile=true Measures, from startup, how long each mod takes in its events.
-Dcrafting.debug=true Detailed log, with full stack traces.