setup

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:

• Tell the user to install Python from https://www.python.org/downloads/
• Stop here until they fix it.

---

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:

# Windows
dir "<schematics_dir>"

# Mac / Linux
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 generated
• output/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