LLM Connect

⚠️ Important Setup Note 🔗

You must add the following line to your minetest.conf for the mod to work:

secure.http_mods = llm_connect

About LLM Connect 🔗

LLM Connect turns Luanti into an AI-assisted development environment. It connects your server to any OpenAI-compatible LLM API — local or hosted — and provides three integrated AI modes: a context-aware chat assistant, a full Smart Lua IDE with sandboxed code execution, and an AI-driven WorldEdit agency mode.

Features 🔗

🗨️ AI Chat 🔗

• Talk to the LLM directly from the in-game chat
• Context-aware: sends server info, player position, active mods, available commands and materials
• Persistent conversation history per player
• 29 configurable response languages

🖥️ Smart Lua IDE 🔗

• Full-screen two-panel editor (code + output) with snippet file manager
• AI Code Generation — describe what you want in plain language, get working Lua code
• Sandboxed Execution — code runs in a secure environment; only llm_connect: prefixed registrations are allowed
• Pre-Executor — static analysis before every run: syntax check, naming convention enforcement, required field validation
• Auto-Fix Loop — after a failed run the LLM automatically receives the error and corrects the code; configurable iteration limit
• Asset Picker — browse all registered Nodes, Items/Tools and Sounds with search and pagination; selected assets are injected as structured metadata into the LLM context
• API Reference Injection — optional slim or full Luanti API reference injected per session
• Syntax check, semantic analysis and code explain tools
• Startup persistence: successful code can be saved and re-executed on every server start

🏗️ WorldEdit Agency 🔗

• Requires worldedit (optional: worldeditadditions)
• Single-shot mode — describe a structure, the LLM generates and executes the commands
• Loop mode — iterative multi-step building with up to N LLM calls
• Automatic undo snapshot before each execution
• Material Picker UI — select up to 8 materials with weights
• Nearby node sampling for material-aware suggestions
• WorldEditAdditions support: torus, ellipsoid, erode, convolve, overlay, layers, replacemix

Supported API Providers 🔗

Any OpenAI-compatible endpoint works, including:

• Mistral API (tested, recommended for free tier)
• OpenAI API
• Ollama (local)
• LM Studio (local)
• LocalAI (local)
• Open WebUI

Privileges 🔗

Quick Start 🔗

1. Add secure.http_mods = llm_connect to minetest.conf
2. Enable the mod for your world
3. Configure your API in-game via /llm_config
4. Grant yourself privileges: /grant <name> llm_root