stonecut-map-builder 0.1.0 → 0.1.1

package/README.md

@@ -1,6 +1,6 @@
 # Stonecut Map Builder
 
-Website: https://stonecut.studio/resources | npm: https://www.npmjs.com/package/stonecut-map-builder
+Website: https://stonecut.studio/resources | npm: https://www.npmjs.com/package/stonecut-map-builder | YouTube: https://www.youtube.com/@StonecutStudios (videos coming soon)
 
 Let your AI agent build Minecraft maps for you. Stonecut Map Builder gives Claude Code (or any agent
 that supports MCP) its own private Minecraft test server on your computer. The agent sets it up,
@@ -13,10 +13,25 @@ paste on any server. Free and open source under the MIT license.
 
 1. Install Node.js 20 or newer from https://nodejs.org (the LTS download).
 2. Have Claude Code installed and signed in.
-3. Add the tool to Claude Code:
+3. Add the tool to Claude Code. If the `claude` command works in your terminal:
    - macOS and Linux: `claude mcp add --scope user stonecut-map-builder -- npx -y stonecut-map-builder`
    - Windows: `claude mcp add --scope user stonecut-map-builder -- cmd /c npx -y stonecut-map-builder`
-4. Start Claude Code, type `/mcp` and check that stonecut-map-builder shows as connected.
+
+   If you only use the Claude Code extension in VS Code, `claude` is usually not on your PATH
+   ("not recognized" / "command not found"). Run the copy bundled with the extension instead:
+   - Windows (PowerShell):
+
+     ```powershell
+     & (Get-ChildItem "$env:USERPROFILE\.vscode\extensions\anthropic.claude-code-*\resources\native-binary\claude.exe" | Sort-Object { [version]($_.FullName -replace '.*claude-code-([\d.]+).*','$1') } | Select-Object -Last 1).FullName mcp add --scope user stonecut-map-builder -- cmd /c npx -y stonecut-map-builder
+     ```
+
+   - macOS and Linux:
+
+     ```sh
+     "$(ls -d ~/.vscode/extensions/anthropic.claude-code-*/resources/native-binary/claude | sort -V | tail -n 1)" mcp add --scope user stonecut-map-builder -- npx -y stonecut-map-builder
+     ```
+4. Start Claude Code (in VS Code: "Developer: Reload Window"), type `/mcp` and check that
+   stonecut-map-builder shows as connected.
 5. Paste the setup prompt from [docs/setup-with-ai.md](docs/setup-with-ai.md). The agent installs
    the skill (it asks first), asks your Minecraft version and modpack, shows what it will download,
    and asks you to accept the Minecraft EULA. Nothing is installed without your yes.

package/dist/doctor.js

@@ -141,7 +141,7 @@ async function checkStart(start, settingsOk) {
         return {
             ok: false,
             label: `The MCP server does not start: ${message(e)}`,
-            fix: settingsOk ? `Check the message above. To add it to Claude Code again: ${ADD_COMMAND}` : 'Fix the settings file first (see above).',
+            fix: settingsOk ? `Check the message above. To add it to Claude Code again: ${ADD_COMMAND}. In VS Code, where the claude command is usually missing, use the VS Code command in the README's setup step 3.` : 'Fix the settings file first (see above).',
         };
     }
 }

package/dist/version.js

@@ -1,2 +1,2 @@
-export const VERSION = '0.1.0';
+export const VERSION = '0.1.1';
 export const SERVER_NAME = 'stonecut-map-builder';

package/docs/setup-with-ai.md

@@ -4,9 +4,30 @@ This is the prompt for the "Set up with AI" button on the downloads page. The pe
 into their agent (for example Claude Code) after adding the tool with the one command shown on the
 page:
 
+If Claude Code is installed as a command-line tool (the `claude` command works in a terminal):
+
 - macOS and Linux: `claude mcp add --scope user stonecut-map-builder -- npx -y stonecut-map-builder`
 - Windows: `claude mcp add --scope user stonecut-map-builder -- cmd /c npx -y stonecut-map-builder`
 
+If they only use the Claude Code extension in VS Code, `claude` is usually not on their PATH (the
+terminal says "claude is not recognized" or "command not found"). The extension ships its own copy
+of the CLI; these commands find the newest one and run it:
+
+- Windows (PowerShell):
+
+  ```powershell
+  & (Get-ChildItem "$env:USERPROFILE\.vscode\extensions\anthropic.claude-code-*\resources\native-binary\claude.exe" | Sort-Object { [version]($_.FullName -replace '.*claude-code-([\d.]+).*','$1') } | Select-Object -Last 1).FullName mcp add --scope user stonecut-map-builder -- cmd /c npx -y stonecut-map-builder
+  ```
+
+- macOS and Linux:
+
+  ```sh
+  "$(ls -d ~/.vscode/extensions/anthropic.claude-code-*/resources/native-binary/claude | sort -V | tail -n 1)" mcp add --scope user stonecut-map-builder -- npx -y stonecut-map-builder
+  ```
+
+After adding it, restart Claude Code (in VS Code: run "Developer: Reload Window" from the command
+palette).
+
 ## The prompt
 
 ```text
@@ -15,10 +36,19 @@ this computer. Follow these steps in order, and ask me before you install, downl
 anything.
 
 1. Check that the MCP server "stonecut-map-builder" is connected and that you can call its
-   status tool. If it is not connected, tell me the one command to add it for my system
-   (macOS/Linux: claude mcp add --scope user stonecut-map-builder -- npx -y stonecut-map-builder,
-   Windows: claude mcp add --scope user stonecut-map-builder -- cmd /c npx -y stonecut-map-builder),
-   ask me to restart you after running it, and stop here.
+   status tool. If it is not connected, tell me the one command to add it for my system, ask me
+   to restart you after running it, and stop here.
+   - Claude Code in a terminal, macOS/Linux:
+     claude mcp add --scope user stonecut-map-builder -- npx -y stonecut-map-builder
+   - Claude Code in a terminal, Windows:
+     claude mcp add --scope user stonecut-map-builder -- cmd /c npx -y stonecut-map-builder
+   - Claude Code in VS Code (the claude command is usually not installed, so use the copy
+     bundled with the extension), Windows PowerShell:
+     & (Get-ChildItem "$env:USERPROFILE\.vscode\extensions\anthropic.claude-code-*\resources\native-binary\claude.exe" | Sort-Object { [version]($_.FullName -replace '.*claude-code-([\d.]+).*','$1') } | Select-Object -Last 1).FullName mcp add --scope user stonecut-map-builder -- cmd /c npx -y stonecut-map-builder
+   - Claude Code in VS Code, macOS/Linux:
+     "$(ls -d ~/.vscode/extensions/anthropic.claude-code-*/resources/native-binary/claude | sort -V | tail -n 1)" mcp add --scope user stonecut-map-builder -- npx -y stonecut-map-builder
+   If you are running inside VS Code, give me the VS Code command. To restart in VS Code I run
+   "Developer: Reload Window" from the command palette.
 
 2. Install the map-builder skill. Run: npx -y stonecut-map-builder --skill-path
    It prints the folder of the bundled skill. Ask me, then copy that map-builder folder into my

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stonecut-map-builder",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "MCP server and skill that let a coding agent build Minecraft maps on a private test server on your own computer.",
   "license": "MIT",
   "author": "Stonecut Studio",