vitaminmcp 3.0.3 → 3.1.0

package/README.md

@@ -43,12 +43,13 @@ agent leaves its host, ports and token where this server reads them.
 - Open, read, click and assert on inventories and plugin GUIs
 - Wait for events and conditions instead of sleeping
 - Read live server state: events, logs, exceptions, permissions
-- Paper / Purpur 1.21 through 1.21.11, from one install
+- Paper / Purpur 1.21 through 26.1, from one install
 
 ## Requires
 
 - **Java 21 or later** on this machine — the jars run on the JVM. Point `JAVA_HOME` at it, or have
-  `java` on `PATH`
+  `java` on `PATH`. (The Paper server itself needs Java 25 from 26.1 on; that is Paper's
+  requirement, and the agent loads there unchanged)
 - **Node 18.17 or later** when using the source runner fallback. If Node is absent, the launcher
   selects a pinned platform runner asset instead.
 - **Paper 1.21 or later** on the Minecraft server, with `VitaminMCP.jar` in its `plugins/`

package/checksums.json

@@ -1,14 +1,14 @@
 {
-  "version": "3.0.3",
+  "version": "3.1.0",
   "jars": {
-    "mcp-server.jar": "e077b0ab2ea776f4d57560c260818f0b9bb7ed7e76418e513fcdcc8a110a3801"
+    "mcp-server.jar": "f64ee16d5aaa115a9d4e019adccf830b74ebe8683d2ade5e05b7db0cf9692d66"
   },
   "assets": {
-    "bot-runner-win-x64.exe": "19cec3a83b03611c29808aad3bc3f395d8ace7202ead621a6bd0eb9dd5dc03bf",
-    "bot-runner-linux-x64": "63443c1b796d1ef8132bdb7212860462db88b020948d53ca940e468f7fa26c9a",
-    "bot-runner-linux-arm64": "871b9ce95e5f0411451935bcb2cf11b1151ca82d17448dda314eae8f4c6d3e41",
-    "bot-runner-darwin-x64": "f69a7b78c936fd183eeb1bfb2734a7d54c6d34d36d61532ea0738c818bc195d9",
-    "bot-runner-darwin-arm64": "81e30798ad2d06aced01b2fea076ed5c6a334debe96ae0dd12213aa961c696b9",
+    "bot-runner-win-x64.exe": "8af36a3e4a3678db5246777c1c8080bea230b50a742dff173758d0513df74e98",
+    "bot-runner-linux-x64": "2f344983a5558d36cf03e4bcf55e0752324d159aebefc18f711c28704cf48264",
+    "bot-runner-linux-arm64": "fa6c49b5db5b6cc84b62d295bbef2ace49305400a7480e86baa009e9629d120c",
+    "bot-runner-darwin-x64": "1769db980857d36204bf93e14bbe5ba329435032b116c8003a12043ba817168a",
+    "bot-runner-darwin-arm64": "b137677b9117af944d006ff0da0e94b524875c86ebfa2596c2b856b9ef63fd2e",
     "bot-runner-viewer-win-x64.tgz": "e39a36cdf92b9223aa7c9610f8231afc7a577e8ed007bc3571895bd945baf3e1"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vitaminmcp",
-  "version": "3.0.3",
+  "version": "3.1.0",
   "mcpName": "io.github.Backas03/vitaminmcp",
   "description": "MCP server for testing Minecraft plugins: drives a real Paper server and real protocol bots from an AI agent.",
   "keywords": [

package/runner/runner.mjs

@@ -16,6 +16,12 @@ import { Dispatch } from './src/dispatch.mjs';
 import * as protocol from './src/protocol.mjs';
 import { pingProtocol, versionForProtocol } from './src/version.mjs';
 
+// stdout is the protocol channel; a dependency's console.log (mineflayer did this on 26.1, with a
+// stack trace) desynchronises every later reply. `write` below is the only path to stdout.
+for (const level of ['log', 'info', 'debug']) {
+  console[level] = (...messages) => process.stderr.write(`${messages.map(String).join(' ')}\n`);
+}
+
 async function main() {
   const argv = process.argv.slice(2);
   if (argv.length < 2) {

package/runner/src/actions.mjs

@@ -234,26 +234,45 @@ export function useEntity(bot, name, x, y, z, radius, type) {
     );
   }
 
-  // Both packets, in this order, because that is what a real client sends and what the Java
-  // runner reproduces: a plugin listening only for the second sees nothing without the first.
-  bot._client.write('use_entity', {
-    target: entityId,
-    mouse: INTERACT_AT,
-    x: 0.0,
-    y: 1.0,
-    z: 0.0,
-    hand: MAIN_HAND,
-    sneaking: false,
-  });
-  bot._client.write('use_entity', {
-    target: entityId,
-    mouse: INTERACT,
-    hand: MAIN_HAND,
-    sneaking: false,
-  });
+  if (interactCarriesMouseButton(bot)) {
+    // Both packets, in this order, because that is what a real client sends and what the Java
+    // runner reproduces: a plugin listening only for the second sees nothing without the first.
+    bot._client.write('use_entity', {
+      target: entityId,
+      mouse: INTERACT_AT,
+      x: 0.0,
+      y: 1.0,
+      z: 0.0,
+      hand: MAIN_HAND,
+      sneaking: false,
+    });
+    bot._client.write('use_entity', {
+      target: entityId,
+      mouse: INTERACT,
+      hand: MAIN_HAND,
+      sneaking: false,
+    });
+  } else {
+    // 26.1: one packet with a hand and a hit position; attacks have their own packet.
+    bot._client.write('use_entity', {
+      target: entityId,
+      hand: MAIN_HAND,
+      location: { x: 0.0, y: 1.0, z: 0.0 },
+      sneaking: false,
+    });
+  }
   return entityId;
 }
 
+/** Through 1.21.11 `use_entity` has a `mouse` field; from 26.1 it has a `location` instead. */
+function interactCarriesMouseButton(bot) {
+  const fields = bot.registry?.protocol?.play?.toServer?.types?.packet_use_entity?.[1];
+  if (!Array.isArray(fields)) {
+    throw new Error('The protocol definition for use_entity is missing, so the bot cannot interact with entities.');
+  }
+  return fields.some((field) => field?.name === 'mouse');
+}
+
 /** Left-clicks the nearest tracked entity. */
 export function attackEntity(bot, name, x, y, z, radius, type) {
   requireInWorld(bot, name);

package/runner/src/bots.mjs

@@ -153,6 +153,8 @@ export function connectionOptions(host, port, version, id, clientIp) {
     auth: 'offline',
     version,
     checkTimeoutInterval: LOGIN_TIMEOUT_MILLIS,
+    // mineflayer's default console.logs bot errors, and stdout is the protocol channel.
+    logErrors: false,
   };
   if (clientIp && clientIp.trim()) {
     options.fakeHost = addressField(host, clientIp.trim(), id);

package/runner/src/dispatch.mjs

@@ -30,7 +30,8 @@ export class Dispatch {
     try {
       return await this.#run(verb, command);
     } catch (error) {
-      return protocol.encode(protocol.ERROR, verb, String(error?.message ?? error));
+      // A newline in the message would become a second stdout line, read as the next reply.
+      return protocol.encode(protocol.ERROR, verb, protocol.sanitize(error?.message ?? error));
     }
   }