| name | setup |
| description | Sets up the Promptcraft environment. Installs Python dependencies, creates or updates config.json with the user's WorldEdit schematics path, and validates everything works end to end. Safe to run multiple times — re-running will update your config or repair a broken install. |
| disable-model-invocation | false |
Promptcraft — /promptcraft:setup
Walk the user through setup in order. This skill is idempotent — each step checks the current state before acting, so it's safe to run multiple times.
Step 1 — Check Python version
python --version
Promptcraft requires Python 3.8 or higher. If the version is lower or python is not found:
Step 2 — Install dependencies
python -m pip install -r requirements.txt
This is idempotent — pip will skip the install if mcschematic is already up to date.
If pip fails (permissions error), try:
python -m pip install --user -r requirements.txt
Step 3 — Verify the install
python -c "import mcschematic; print('mcschematic OK')"
If this fails, tell the user exactly what went wrong. Common fix: python -m pip install --upgrade mcschematic.
Step 4 — Configure the WorldEdit schematics path
Check if config.json already exists by reading it with the Read tool (or python -c "import json; print(json.dumps(json.load(open('config.json')), indent=2))" as a fallback).
If config.json exists and has a non-empty schematics_dir:
Tell the user:
config.json found. Current schematics path:
<current path>
Is this still correct? (yes to keep it, or paste a new path to update)
Wait for their response. If they confirm, keep it. If they give a new path, update config.json.
If config.json doesn't exist or schematics_dir is empty:
Tell the user:
No WorldEdit schematics path configured yet. Let's set that up.
Your schematics folder depends on your launcher and OS:
Prism Launcher (Windows):
C:\Users\YOU\AppData\Roaming\PrismLauncher\instances\<instance>\minecraft\config\worldedit\schematics
Vanilla Minecraft (Windows):
C:\Users\YOU\AppData\Roaming\.minecraft\config\worldedit\schematics
Vanilla Minecraft (Mac):
~/Library/Application Support/minecraft/config/worldedit/schematics
Vanilla Minecraft (Linux):
~/.minecraft/config/worldedit/schematics
Spigot / Paper server:
/path/to/server/plugins/WorldEdit/schematics
Not sure where yours is? See the WorldEdit docs:
https://worldedit.enginehub.org/en/latest/usage/files/#schematics
What is your WorldEdit schematics folder path?
Wait for the user's answer, then write config.json:
{
"schematics_dir": "<their path>"
}
Step 5 — Validate the schematics path
Check that the path exists:
dir "<schematics_dir>"
ls "<schematics_dir>"
If it doesn't exist, tell the user:
That folder doesn't exist yet. WorldEdit creates it automatically the first time
you save a schematic in-game. Either:
- Load Minecraft once and let WorldEdit create it, then re-run /promptcraft:setup
- Or create it manually now
Promptcraft will still work — it creates the folder if missing — but confirm
the path is correct before continuing.
Ask the user if they want to continue anyway or fix the path first.
Step 6 — Run a test build
Run the included demo to confirm everything works end to end:
python example_watchtower.py
python build.py output/watchtower.json
Confirm:
output/watchtower.json was generatedoutput/watchtower.schem was created- The
.schem was auto-copied to the user's schematics folder (if config is set)
If anything fails, diagnose and fix it before continuing.
Step 7 — Done
Tell the user:
✅ Promptcraft is ready!
Setup summary:
Python: <version>
mcschematic: installed
WorldEdit folder: <schematics_dir>
Test build: output/watchtower.schem ✓
To build something, run:
/promptcraft:build <describe what you want>
Examples:
/promptcraft:build a small medieval watchtower with battlements
/promptcraft:build a cozy forest cabin with a fireplace inside
/promptcraft:build an Egyptian pyramid, hollow, 30 blocks tall
Then in Minecraft:
//schem load <name>
//paste -a
