A visual node editor for building Minecraft automation workflows.
Created by soymods.
🇺🇸 English · 🇩🇪 Deutsch · 🇪🇸 Español · 🇫🇷 Français · 🇵🇱 Polski · 🇧🇷 Português (BR) · 🇷🇺 Русский
Pathmind lets you build automation with a visual graph instead of writing commands or scripts. You place nodes, connect them, configure parameters, then run the graph in-game.
The current mod includes:
- A visual editor for building automation graphs in-game.
- Workspace and preset management for saving and organizing your graphs.
- Runtime automation features for executing workflows and reacting to game state.
- Pathfinding and movement automation, with optional integrations for expanded behavior.
- An in-game marketplace for sharing and discovering community presets.
- HUD and editor feedback to help monitor execution and troubleshoot graphs.
- Full-screen graph editing built around nodes and connections.
- Tools for organizing, editing, and validating workflows.
- Customizable editor presentation and general usability settings.
- Node categories for flow control, world interaction, player actions, data handling, sensing, parameters, and reusable logic.
- Support for combining simple actions into larger automation workflows.
- Scratch-style Routines: create a named flow block, add typed inputs, define it once, and call it anywhere in that preset.
- A separate Routine Library for explicitly linking or copying routines between presets.
- Run Preset for launching another complete automation without confusing it with an in-preset routine.
- Open Routines and choose Create Routine.
- Give it a useful label and add typed inputs, such as
break [block] within [range]. - Build the behavior under the Routine entry node.
- Exit the routine workspace, then drag the generated routine from the sidebar into your main workspace.
- Attach different values to each call. Every call gets its own input values and waits for the routine to finish.
Variables are separate from routine inputs: local variables belong to one running chain, while global variables are shared by all running chains.
- Run graphs directly in-game and monitor what they are doing.
- Build workflows that respond to events, conditions, and changing state.
- Use runtime state and feedback overlays while automation is active.
Sensor searches use world data already loaded by the Minecraft client; they never force distant chunks to load. See Sensor range and loaded-chunk behavior for default ranges and multiplayer limitations.
Pathmind ships with its own local movement backend and also supports Baritone-aware nodes.
- Built-in movement and pathfinding support for navigation-focused automation.
- Optional Baritone integration for players who want expanded navigation behavior.
- Visual feedback for navigation state while workflows are running.
The in-game marketplace is more than a static browser:
- Browse shared presets from inside the mod.
- Import community presets into your own workspace.
- Publish and manage your own presets through the in-game UI.
Default keybinds:
- Open editor:
Right Alt - Play graphs:
K - Stop graphs:
J
Pathmind also adds main-menu integration so the editor is reachable before joining a world.
- Minecraft
1.21through1.21.11, or26.1through26.2 - Java
21for Minecraft 1.21.x; Java25for Minecraft 26.x - Fabric: Fabric Loader
0.17.3or newer + matching Fabric API - NeoForge: NeoForge
21.0.166or newer
- Baritone API mod for Baritone-backed nodes and extended navigation/building integration
- UI Utils for UI automation nodes and related integrations
Fabric:
- Install Fabric Loader for your target Minecraft version.
- Install the matching Fabric API release.
- Download the correct
pathmind-fabric-*+mc<version>.jarfrom Modrinth. - Place the Pathmind and Fabric API jars in your
modsfolder. - Launch the game and open Pathmind with the configured keybind.
NeoForge:
- Install NeoForge for your target Minecraft version.
- Download the correct
pathmind-neoforge-*+mc<version>.jarfrom Modrinth. - Place the Pathmind jar in your
modsfolder. - Launch the game and open Pathmind with the configured keybind.
Pathmind stores data inside your Minecraft directory under pathmind/.
pathmind/presets/: saved workspace graphspathmind/routine-library.json: routines explicitly added to the shared local librarypathmind/active_preset.txt: current preset selectionpathmind/settings.json: user settingspathmind/marketplace_auth.json: marketplace session data
Imported marketplace presets and exported graphs also flow through this preset system.
- Release jars are versioned as
pathmind-{fabric|neoforge}-<modVersion>+mc<gameVersion>.jar. - The same codebase is built for Fabric and NeoForge across every supported Minecraft target from
1.21through1.21.11and26.1through26.2. - Multiple language files are included.
- Marketplace listings include version compatibility metadata.
Contributor documentation:
docs/node-architecture.mdmaps the node system, execution routing, UI helpers, localization rules, and current compat source sets.docs/minecraft-compatibility-baseline.mdrecords the protected1.21.xmatrix, artifact contract, source inventory, and smoke-test procedure.docs/build-generations.mdexplains the stable build commands and the Java 21/remapped versus Java 25/unobfuscated boundary.docs/compatibility-maintenance.mdis the new-version, verification-tier, graphics-smoke, deprecation, and release playbook.docs/minecraft-multiversion-roadmap.mddefines the staged transition to clean1.21.xand26.xsupport.
git clone https://github.com/soymods/pathmind.git
cd pathmind
./gradlew buildSelectedTarget "-Pmc_version=1.21.11"For 1.21.x, jars are written to fabric/build/libs/ and neoforge/build/libs/. The root tasks route 26.x through the isolated build, whose jars are written to mc26/fabric/build/libs/ and mc26/neoforge/build/libs/.
# Default dev client (Fabric, Minecraft 1.21.11)
./gradlew runClient
# Fabric dev client
./gradlew runFabricClient "-Pmc_version=1.21.11"
# NeoForge dev client
./gradlew runNeoForgeClient "-Pmc_version=1.21.11"
# Direct project tasks also work
./gradlew :fabric:runClient "-Pmc_version=1.21.11"
./gradlew :neoforge:runClient "-Pmc_version=1.21.11"Unqualified runClient and runServer default to Fabric because Fabric is the primary loader. The aliases are case-insensitive, so runclient also resolves to Fabric instead of launching every matching subproject run task.
# All declared release loaders
./gradlew buildSelectedTarget -Pmc_version="1.21.11"
# Fabric only
./gradlew buildSelectedFabric -Pmc_version="1.21.11"
# NeoForge only
./gradlew buildSelectedNeoForge -Pmc_version="1.21.11"Convenience tasks:
./gradlew buildMc1_21_11- builds both platforms for 1.21.11./gradlew buildAllTargets- builds all 14 declared Minecraft targets and verifies all 28 release jars
Compatibility tasks:
./gradlew compatibilityReport- prints dependency, Java, loader, and source-family selection for every target./gradlew verifyCompatibilityManifest- checks the manifest against runtime support, metadata, docs, and CI./gradlew verifyCompatibilityStructure- rejects ambiguous family names and loader-level product mirrors./gradlew verifySelectedCompatibilityArtifacts- validates the selected target's release filenames, metadata, Mixins, and archive contents./gradlew configureMc26BuildGeneration- validates the Java 25, mapping-free 26.x generation contract
The machine-readable version source of truth is gradle/minecraft-versions.properties.
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.2
| Component | Version |
|---|---|
| Mod Version | 1.1.5 |
| Supported Minecraft Versions | 1.21 - 1.21.11, 26.1 - 26.2 |
| Fabric Loader | 0.17.3+ |
| NeoForge | 21.0.166+ |
| Java | 21 for 1.21.x; 25 for 26.x |
This project is distributed under the custom Pathmind License (All Rights Reserved) in LICENSE.txt.
In short:
- Redistribution, modification, or re-uploading is not allowed without explicit written permission.
- Videos featuring the mod are allowed, including monetized videos.
- Modpack inclusion is allowed under the limits described in the license.
- The mod is provided as-is without warranty.
- Issues: GitHub Issues
- Downloads: Modrinth
- Community: Discord
- FabricMC for the Fabric modding framework
- NeoForged for the NeoForge modding framework
- Architectury for the cross-platform mod toolchain
- Baritone as an architectural reference for Pathmind's native navigator; Baritone is licensed under the GNU LGPL v3 or later
- Blender and Scratch for helping inspire the node-based workflow direction