How unaveragetech/belfegor works
Belfegor is a Fabric Minecraft automation agent: users issue chat commands, which become goals and composable tasks that gather, craft, move, build, or survive in-game. Its README describes source selection, guarded inventory transactions, persistent memory, autonomy, an in-game UI, and an AI advisor. Edges below follow those documented relationships; source excerpts are partial, so internal links not documented there are omitted.
Main entry points: Task.java Task engine · chains Task chains · resources Resource tasks · movement Movement tasks
Components 22
User interface
- Commands
src/main/java/adris/belfegor/commands - Command system
src/main/java/adris/belfegor/commandsystem - Control panel
src/main/java/adris/belfegor/ui/BelfegorScreen.java - Mod runtime
src/main/java/adris/belfegor/Belfegor.java
Planning and scheduling
- Task catalogue
src/main/java/adris/belfegor/TaskCatalogue.java - Task chains
src/main/java/adris/belfegor/chains - Task engine
src/main/java/adris/belfegor/tasksystem/Task.java - Event bus
src/main/java/adris/belfegor/eventbus/EventBus.java
World actions
- Resource tasks
src/main/java/adris/belfegor/tasks/resources - Movement tasks
src/main/java/adris/belfegor/tasks/movement - Construction tasks
src/main/java/adris/belfegor/tasks/construction - Survival and combat
src/main/java/adris/belfegor/chains - Baritone navigation
src/main/java/adris/belfegor/tasks/movement
Inventory and memory
- Container tasks
src/main/java/adris/belfegor/tasks/container - Inventory transactions
src/main/java/adris/belfegor/util/helpers/InventoryManager.java - Item storage tracker
src/main/java/adris/belfegor/trackers/storage/ItemStorageTracker.java - Persistent memory
src/main/java/adris/belfegor/memory/BaseMemory.java
Autonomy and intelligence
- Butler whispers
src/main/java/adris/belfegor/butler/Butler.java - AI advisor
src/main/java/adris/belfegor/llm/LlmAdvisor.java - Macros
src/main/java/adris/belfegor/macros/MacroRunner.java
Other components
- Player
- Minecraft client
Connections 25
- Player → Commands: issues command
- Commands → Command system: parses
src/main/java/adris/belfegor/commands/RetrieveCommand.java - Player → Control panel: uses controls
- Control panel → Task chains: starts tasks
- Command system → Task chains: creates goal
- Butler whispers → Task chains: submits tasks
- Task chains → Task engine: schedules
- Task engine → Task catalogue: plans recipes
- Task engine → Resource tasks: executes
- Task engine → Movement tasks: executes
src/main/java/adris/belfegor/tasksystem/Task.java - Task engine → Construction tasks: executes
- Task chains → Survival and combat: runs background chains
- Resource tasks → Container tasks: chooses sources
- Resource tasks → Inventory transactions: crafts with guards
- Container tasks → Inventory transactions: moves items
- Resource tasks → Item storage tracker: checks availability
- Task engine → Persistent memory: uses persistent state
- Movement tasks → Baritone navigation: navigates with
- Movement tasks → Minecraft client: acts in world
- Construction tasks → Minecraft client: builds in world
- Survival and combat → Minecraft client: responds to threats
- AI advisor → Persistent memory: reads context
src/main/java/adris/belfegor/llm/LlmAdvisor.java - Player → AI advisor: asks questions
- Macros → Task engine: runs task steps
- Mod runtime → Event bus: dispatches events
src/main/java/adris/belfegor/Belfegor.java