Steve functions as an AI Agent — or an entire team of Agents if you enable multiple instances. You simply describe what you want, and Steve understands the context, forms a plan, and executes it. The concept is the same as natural-language code assistants, except here the “output” is not code: it's embodied Steves operating directly inside your Minecraft world.
The interface is simple: press K to open the command panel and type your request. The agents handle everything — interpretation, planning, and in-game execution. Ask “mine some iron”, and the agent reasons about spawn depths, navigates to the correct layer, locates ore veins, and extracts resources. Request a house, and it evaluates available materials, generates an appropriate layout, and builds it block by block.
Where things get truly interesting is multi-agent coordination. When multiple Steves work on the same task, they don’t just perform actions independently — they actively collaborate, preventing conflicts and optimizing workload distribution. Tell three agents to build a castle, and they’ll automatically partition the blueprint, assign sections among themselves, and construct it in parallel.
These agents aren’t following scripted behaviors. They operate entirely from natural-language instructions, enabling:
- Resource extraction with optimal mining strategies
- Autonomous building, including layout planning and material management
- Combat and defense, with threat assessment and team coordination
- Exploration and gathering using dynamic pathfinding
- Collaborative execution, with automatic load-balancing and conflict prevention
How It Works
Each Steve runs an agent loop:
- Your command is sent to an LLM (powered by Groq for high-speed inference).
- The LLM decomposes your request into structured game instructions.
- The instructions execute using Minecraft’s actual mechanics.
- If a step fails, the agent queries the LLM again to generate a new plan.
Multi-Agent Coordination
When multiple Steves work together, a dedicated coordination system ensures seamless team behavior:
- Tasks are automatically divided into sections.
- Each agent claims a portion of the work.
- Agents avoid placing blocks in the same location.
- If one finishes early, responsibilities are rebalanced.
All coordination is handled server-side through a deterministic manager that tracks builds, assigns tasks, and prevents race conditions or inconsistent states.
How to Install Steve AI (Mod)
Steve AI by gnustellah is verified for Forge across Minecraft versions 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6 (latest release: 1.8.1, file size: 1.5 MB). Follow the steps below to install it safely from ModCraft.tv:
- Click the Download button above and select your Minecraft version (1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6) and platform (Forge).
- Make sure you have the compatible loader or environment installed for Forge.
- Move the downloaded Steve AI file into your Minecraft
.minecraft/modsfolder and launch the game.
All Versions
+ Add Version| Name | Game version | Platforms | Published | Downloads | Actions |
|---|---|---|---|---|---|
| 2mo ago | 1 | ||||
| 2mo ago | 1 | ||||
| 2mo ago | 1 | ||||
| 2mo ago | 1 | ||||
| 3mo ago | 1 | ||||
|
R
1.5.1
|
4mo ago | 1 | |||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 9mo ago | 1 | ||||
| 10mo ago | 1 | ||||
| last yr. | 1 |
## Added
- Local planning for simple
craft/make,smelt, andgather/collect/minegoals. - Support for registered item IDs, mod namespaces, and simple English item names.
- Inventory-aware planning: request a desired inventory total and Steve produces only the missing quantity. Already satisfied goals complete without consuming materials.
- Offline operation for supported goals with
[autonomy] maxLlmCallsPerGoal = 0. - The
localPlanningconfiguration option, enabled by default. - Seven dedicated Minecraft GameTests covering crafting, gathering, furnace smelting, existing inventory, pause/stop, denied permissions, and unsupported offline requests.
## Fixed
- Local execution no longer depends on initializing a language model or having an available LLM call budget.
- Prerequisite planning preserves requested quantities and accounts for ingredients already in inventory.
- Prerequisite nesting is limited to eight levels to prevent unbounded dependency chains.
- Local planning outcomes use valid execution state transitions.
## Behavior and compatibility
- Existing permissions, pause/stop controls, bounded recovery, and deterministic goal verification remain enforced.
- Compound or unknown requests still use LLM fallback. With a zero-call budget, unsupported requests stop with an explanation.
- This release provides bounded local task planning; it does not add unrestricted offline language understanding or new proactive behavior.
``
text
craft 8 oak_planks
smelt 16 iron_ingots
gather 4 oak_log
``Bound goal/plan/memory persistence, reject unsafe LLM fallback mutations,
skip unloaded chunks, and keep command-path recovery bounded. User commands
interrupt background work; blocked goals do not auto-resume after restart.
This hotfix corrects the production artifact that caused Minecraft to crash while loading Steve AI.
Fixed
- Fixed the startup crash caused by the Caffeine runtime library being absent from the installed mod JAR.
- The complete Forge Jar-in-Jar artifact is now produced as
steve-ai-mod-1.5.1.jar. - The dependency-free development artifact is now clearly named
steve-ai-mod-1.5.1-slim.jarand must not be installed in Minecraft. - Maven publishing now uses the complete Jar-in-Jar artifact instead of the slim JAR.
- The GitHub release workflow now selects the exact installable JAR instead of relying on a filename glob.
Build safeguards
- Added a
verifyReleaseJarGradle task that checks the installable filename and required runtime contents. - Release verification now fails if Caffeine, Resilience4j, or Jar-in-Jar metadata is missing.
- Updated the build and release documentation to distinguish the installable and development artifacts.
Verification
- Clean Gradle build completed successfully.
- 22 JUnit tests passed with no failures, errors, or skipped tests.
- The dedicated Forge GameTest server passed its required test.
- The LLM cache initialized successfully during the Forge runtime test.
- The final installable JAR contains Caffeine 3.1.8 and all five required Resilience4j 2.1.0 modules.
This release focuses on reliability, safer AI actions, multiplayer behavior, and Forge packaging.
Highlights
- AI planning no longer blocks the Minecraft server thread.
- New commands replace outdated plans, and stopped plans cannot resume later.
- LLM responses are parsed and validated before any Minecraft action runs.
- Procedural structure building works again when no NBT template is available.
- Collaborative builds now distribute work correctly, avoid duplicate block claims, and stay isolated by dimension.
- The release JAR now includes the Caffeine and Resilience4j libraries required at runtime.
Gameplay and action fixes
- Added strict validation for action names, coordinates, quantities, block lists, and structure dimensions.
- Protected regions are now respected when mining, placing blocks, building structures, and placing mining torches.
- Mining only counts blocks that Minecraft successfully destroyed.
- Tunnel mining no longer removes the floor below Steve.
- Resource gathering now delegates to the real mining action instead of returning a placeholder result.
- The unfinished crafting action is no longer exposed as a supported AI action.
- Combat now attacks at the intended rate instead of applying damage every tick.
- Pathfinding, following, and block placement stop navigation cleanly after a timeout.
- Action failures are contained so one broken action cannot break Steve's entire tick loop.
- Action interceptors now receive start, completion, and failure events.
Structures
- Fixed a bug that prevented all procedural structures from being generated.
- Collaborative construction can now be completed by a single Steve across every build section.
- Cancelled, failed, and timed-out builds release their shared state correctly.
- Completed structures are registered only after every block has been processed.
- Structure templates preserve block-state properties such as door halves and orientation data.
- External NBT templates can be loaded from the structures directory.
- Invalid template names are rejected to prevent unsafe file paths.
- Generated houses now place valid upper and lower door blocks.
Server and multiplayer
- Removed client-only GUI references from common server code.
- Client GUI registration now happens exclusively during client setup.
- Steve entities are reconciled with the manager after world and chunk loading.
- Steve names are validated, case-insensitive, and limited to command-safe characters.
- Duplicate names and failed entity spawns no longer leave stale manager entries.
- Steve action executors are created lazily after persisted names are loaded.
- Event-bus executors are shut down when their Steve entity is removed.
- Commands that spawn, remove, stop, or direct a Steve now require operator permission level 2.
AI provider reliability
- Fixed asynchronous retry handling so failed futures are retried correctly.
- Cache keys now include request parameters, preventing responses with differen
- Bug fixes.
- Minecraft Forge mod entry point (
SteveMod) with full lifecycle management (FML events, server start/stop) - In-game command interface: open panel with
K, issue natural-language commands via/steve spawn <name>
#### Agent & Action System
ActionExecutor— orchestrates action execution with retry logic and error handlingCollaborativeBuildManager— multi-agent workload balancing and conflict resolution for building tasksTask/ActionResult— typed task/result models for the agent pipeline- Built-in action implementations:
BuildStructureAction— autonomous structure planning and block-by-block placementCombatAction— threat assessment and combat coordinationCraftItemAction— recipe lookup and crafting executionFollowPlayerAction— pathfinding to track a target playerGatherResourceAction— resource location and gatheringIdleFollowAction— passive follow behaviour when idleMineResourceAction— optimal mining location selection and executionNavigateAction— point-to-point navigation
#### LLM Integration
TaskPlanner— converts natural-language input into a structured action plan using LLMsPromptBuilder/ResponseParser— prompt construction and response parsing utilities- Synchronous clients:
OpenAIClient,GroqClient,GeminiClient - Asynchronous clients:
AsyncOpenAIClient,AsyncGroqClient,AsyncGeminiClient(non-blocking LLM calls) LLMCache— response caching to reduce API calls and latencyLLMExecutorService— managed thread pool for async LLM requestsLLMFallbackHandler/ResilientLLMClient— automatic provider fallback and resilience policiesResilienceConfig— configurable retry, timeout, and circuit-breaker settingsLLMException/LLMResponse— typed error and response models
#### Execution Engine
SteveAPI— public API surface for issuing commands to agentsCodeExecutionEngine— safe execution sandbox for generated code snippetsMetricsInterceptor— records execution metrics (latency, success rate, token usage)
#### Memory & World Knowledge
SteveMemory— per-agent short-term and long-term memory storeWorldKnowledge— shared world state cache (blocks, entities, resources)StructureRegistry— persistent registry of built and planned structures
#### Plugin System
ActionPlugin/ActionFactory/ActionRegistry— extensible plugin API for registering custom actionsCoreActionsPlugin— default plugin bundling all built-in actionsPluginManager— runtime plugin discovery and lifecycle management via Java ServiceLoader
#### Structure Generation
StructureGenerators— procedural generators for common structures (houses, walls, platforms, etc.)StructureTemplateLoader— loads structure templates from resource filesBlockPlacement— value type representing a single block placement operation
#### Utilities & Events
ActionUtils— shared helper methods for action
- Bug fixes
#### ⛏ Iron Mining
- Adjusted the optimal iron mining depth to **Y=16**.
- Forced Steve to descend until solid ground is found at the correct Y level before starting to mine.
- Fixed the issue where Steve would mine straight forward at surface level, “flying” and placing torches in mid-air.
- Improved torch placement logic to prevent placement in invalid (air) positions.
#### 💎 Ore Drops
- Removed incorrect inventory handling from Steve.
- Kept
destroyBlock(..., true)so blocks correctly drop items on the ground for the player to collect.
#### 🏠 Structure Building (House)
- Fixed a bug where only half of the house was being built.
- Removed doors from the build plan (doors require special two-block placement logic and were being dropped).
- Increased the number of blocks placed per tick to speed up construction.
- Fixed compilation and initialization errors related to
BlockState.
#### 🖥 GUI (SteveGUI)
- Removed Minecraft formatting codes (
§l,§7,§8) that caused garbled characters. - Removed special characters (such as
→) that caused encoding issues (e.g. “ât”). - Cleaned up chat text rendering for better readability.
#### 🧪 Stability & Debugging
- Fixed multiple potential
StringIndexOutOfBoundsExceptionandIndexOutOfBoundsExceptioncrashes. - Added structured debug logging (NDJSON) for better runtime diagnostics.
- Stabilized the build process and ensured the mod compiles successfully.
### ✅ Current Status
- Mining:** Steve now correctly descends to the proper depth before mining.
- Building:** Structures are built fully (without doors).
- Follow command:** Working as expected.
- UI:** No more corrupted or confusing characters.
- Model responses:** Still echo commands (prompt / API limitation, not a code issue).