Configuration en

Configuration

On first run the mod writes aibot.json to the Fabric config dir (usually run/config/aibot.json in dev). Every field has a sane default; missing fields are filled in.

🔑 Prefer the DEEPSEEK_API_KEY environment variable — it takes priority over apiKey in the file.

deepseek — model endpoint

Field	Description
apiKey	API key (empty → read DEEPSEEK_API_KEY)
baseUrl	Endpoint, default https://api.deepseek.com (any OpenAI-compatible URL)
model	Model name, default deepseek-chat
maxTokens	Max reply tokens, default 2048
temperature	Sampling temperature, default 0.3
timeoutSeconds	Request timeout
retryCount / retryBackoffMs	Retry count / backoff

brain — brain behavior

Field	Description
maxHistoryMessages	Conversation history kept
maxToolCallsPerTurn	Max parallel tool calls per turn
maxTurnsPerRequest	Max tool-call rounds per request (prevents token blow-up)
exposeLowLevelTools	Expose low-level tools (move_block / place_block…)
enableMemoryTools	Enable memory tools
enableCoordinationTools	Enable multi-bot coordination tools

perception — perception range

Field	Description
radius	Horizontal perception radius
maxBlocks / maxEntities / maxItems	Caps on blocks / entities / drops fed to the LLM
includeRawLists	Include raw lists

goal — goal engine

Field	Description
maxPlanDepth	Max back-chaining depth
replanOnFailure	Auto re-plan on step failure
autoToolFill	Auto-craft missing tools (e.g. pickaxe before mining)

mining

Field	Description
returnWhenFreeSlots	Return home when free slots drop below this
toolDurabilityFloor	Stop / swap tool below this durability ratio
placeTorches	Auto-place torches while mining

combat

Field	Description
retreatHp	Retreat below this HP
maxEnemiesToFight	Flee above this enemy count

survival

Field	Description
hungerEatThreshold	Eat below this hunger
hungerCriticalThreshold	Critical hunger threshold

night

Field	Description
autoSleep	Auto-sleep at night
torchLightThreshold	Place torches below this light level

nav — pathfinding / movement

Field	Description
jumpReach	Jump look-ahead distance
sidleAfter / sidleLimit	Side-step delay / limit when stuck
hardLimit	Hard-stuck threshold
lookahead / nodeRetry	Path look-ahead / node retry
sprintMinDist	Min distance to sprint

pickup

Field	Description
forceRadiusH / forceRadiusV	Forced-pickup horizontal / vertical radius
sweepRadius	Sweep-pickup radius

watchdog

Field	Description
stuckWindowTicks	Stuck-detection window (no pos/progress/inventory change = stuck)

logging

Field	Description
enabled	Structured logging on/off
directory	Log directory
perBotFile	One file per bot
rotation / maxFileSizeMb / maxBackups	Rotation / size cap / backups

---

Restart (or reload) the server after editing. Actual default values are whatever your local aibot.json shows.