Steve AI

Core Mod

• 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 handling
• CollaborativeBuildManager — multi-agent workload balancing and conflict resolution for building tasks
• Task / ActionResult — typed task/result models for the agent pipeline
• Built-in action implementations:
  • BuildStructureAction — autonomous structure planning and block-by-block placement
  • CombatAction — threat assessment and combat coordination
  • CraftItemAction — recipe lookup and crafting execution
  • FollowPlayerAction — pathfinding to track a target player
  • GatherResourceAction — resource location and gathering
  • IdleFollowAction — passive follow behaviour when idle
  • MineResourceAction — optimal mining location selection and execution
  • NavigateAction — point-to-point navigation

LLM Integration

• TaskPlanner — converts natural-language input into a structured action plan using LLMs
• PromptBuilder / 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 latency
• LLMExecutorService — managed thread pool for async LLM requests
• LLMFallbackHandler / ResilientLLMClient — automatic provider fallback and resilience policies
• ResilienceConfig — configurable retry, timeout, and circuit-breaker settings
• LLMException / LLMResponse — typed error and response models

Execution Engine

• SteveAPI — public API surface for issuing commands to agents
• CodeExecutionEngine — safe execution sandbox for generated code snippets
• MetricsInterceptor — records execution metrics (latency, success rate, token usage)

Memory & World Knowledge

• SteveMemory — per-agent short-term and long-term memory store
• WorldKnowledge — 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 actions
• CoreActionsPlugin — default plugin bundling all built-in actions
• PluginManager — 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 files
• BlockPlacement — value type representing a single block placement operation

Utilities & Events

• ActionUtils — shared helper methods for action implementations
• SteveCommands — registers and handles all Forge commands
• ServerEventHandler — listens to server-side Minecraft events (player join/leave, world tick, etc.)

Configuration

• TOML config file (config/steve-common.toml) supporting OpenAI, Groq, and Gemini API credentials and model settings
• Config example file (config/steve-common.toml.example)

Testing

• Unit test stubs for ActionExecutor, TaskPlanner, WorldKnowledge, and StructureGenerators

Infrastructure

• Gradle build system with Minecraft Forge (1.20.1-47.3.0) setup
• gradlew / gradlew.bat wrapper scripts
• scripts/run_steve.sh helper script for local development
• Resource files: mods.toml, en_us.json language file, pack.mcmeta
• .gitignore covering Gradle, IDE, and OS-specific files