Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Tags
Creators
Details
=============================================================================================
██╗ ██╗ ██████╗ ██╗██╗ File: https://modrinth.com/mod/koil/settings/description
██║ ██╔╝██╔═══██╗██║██║ ----------------------------------
█████╔╝ ██║ ██║██║██║ Platform: Modrinth
██╔═██╗ ██║ ██║██║██║ Owner: SpiritXIV
██║ ██╗╚██████╔╝██║███████╗ Org: Koil
╚═╝ ╚═╝ ╚═════╝ ╚═╝╚══════╝ -----------------------------------
=============================================================================================
Pre note: as of 6/7 I accidentally deleted the version 0.70.25 from the modrinth and thats what gave us the over 4k downloads, I won't be uploading it again as it still isn't compatable with the 0.70.26 changes that are happening
You can still download 0.70.25 directly from Koil after installation, and the koil-online-data github, but it still won't work. The new system has changed files that 0.70.25 cant find anymore.
Even though its a .unfinished build, it is still stable and safe, and can be used as if it was an official build.
What is Koil?
Local AI, automation, development tools, diagnostics, content management, and more, built directly into Minecraft.
Koil is an experimental technical Minecraft mod for developers, creators, power users, and anyone who likes pushing Minecraft far beyond what it was originally built to do.
Run local AI models. Automate the player. Edit files without leaving the game. Inspect your instance. Manage Minecraft content. Debug performance. Render LaTeX and media in chat. Build your own automation with KTL.
Koil brings systems that normally live around Minecraft into Minecraft itself.
What can you do with Koil?
Run Local AI Models In-Game
Koil can run supported GGUF language models locally on your computer.
Models can be downloaded and managed through Minecraft, with Koil handling the local runtime, model configuration, streaming, hardware guidance, and other setup.
Use /ask to talk directly to your selected local model.
Koil currently includes systems for:
- Local GGUF models
llama.cpp- Model downloading and installation
- Streaming responses
- Multiple local model providers
- Model and hardware recommendations
- Conversation context
- Deep Thought
- Tool calling
- Optional voice output
- Automation Mode
Normal /ask conversations do not give the model control of Minecraft.
For that, there is Automation Mode.
Give Your Model Control of Minecraft
Automation Mode allows compatible local models to use Koil's registered tools instead of only producing text.
Koil can expose capabilities for things like:
- Moving
- Looking around
- Jumping
- Sprinting
- Navigation
- Mining blocks
- Using items
- Interacting with blocks
- Interacting with entities
- Attacking
- Inspecting inventory
- Using containers
- Sending chat
- Running Minecraft commands
- Observing blocks and entities
- Reading task state
- Waiting and retrying
The model does not simply send one input and assume the job is finished.
Koil's automation architecture is being built around a larger loop:
inspect → plan → act → observe → verify → recover → continue
This allows automation to work toward increasingly complicated objectives instead of being limited to individual macros.
Automation is still one of Koil's most experimental systems, so expect it to evolve quickly.
KTL
Koil has its own task and automation language called KTL.
KTL allows automation behavior to be described outside of the Java engine so tasks can be expanded, modified, and reused without permanently hardcoding every possible objective into the mod.
Koil's automation layer includes systems for:
- KTL compilation
- Capabilities
- Task planning
- Task execution
- Conditions
- Objectives
- Task state
- Validation
- Approvals
- Failure handling
- Feedback
- Recovery
- Macros
The goal is to make Minecraft automation something you can build on, not just a fixed list of commands.
Deep Thought
Sometimes one model response is not enough.
/ask deep gives Koil's model a longer investigation process with bounded read-only tools.
Deep Thought can gather information, investigate a problem over multiple phases, maintain evidence and conclusions, save progress, and resume an investigation later.
It is designed for questions where the model should actually investigate something instead of immediately guessing an answer.
A Development Workspace Inside Minecraft
Koil includes a growing collection of tools for working on Minecraft without constantly switching between the game, your file manager, configuration folders, logs, and external utilities.
File Explorer
Browse supported files directly from Minecraft.
File Editor
Open and modify text and configuration files in-game.
Development Workspaces
Koil can detect supported development workspaces and allow its development and model systems to inspect bounded project files.
Project Validation
Supported development tools can run registered Gradle validation operations.
Logs
View Koil, Minecraft, and package logs without digging through the instance manually.
Configuration
Find and modify supported configuration from inside the game.
Koil is especially useful if you make:
- Mods
- Datapacks
- Resource packs
- Shaders
- Minecraft tools
- Automation
- Other technical Minecraft projects
Manage Your Minecraft Content
Koil contains tools for managing more of your Minecraft instance without leaving the game.
Current systems work with content such as:
- Mods
- Datapacks
- Resource packs
- Shader packs
- Worlds
- Skins
- Configuration
- Koil packages
Koil can also communicate with services such as Modrinth to search for projects and retrieve compatibility and version information.
The idea is simple:
If it is part of your Minecraft instance, you should be able to interact with more of it from Minecraft.
Dynamic Minecraft Content
Koil contains a world-aware content and registry system designed to understand more of the content that actually exists in the current game.
This includes work around:
- Vanilla content
- Modded content
- Datapack content
- World-specific content
- Blocks and items
- Properties and metadata
- Registry information
This becomes especially useful for Koil's development, automation, and model systems because those systems need to know what exists in the Minecraft instance they are actually running inside.
KPak
Koil also includes its own experimental package format called KPak.
KPak is designed for packaging and installing structured Minecraft and Koil content.
The current system includes:
- Package manifests
- Package building
- Installation
- SHA-256 verification
- Ed25519 signatures
- Author identities
- Compatibility checks
- Transaction state
- Backups
- Rollback
- Installed-file verification
KPak is still experimental and its trust and package systems continue to be developed.
Better Technical Information
Koil heavily expands Minecraft's diagnostic systems.
Its redesigned F3 and performance interfaces are built to make technical information easier to understand instead of simply putting more text on the screen.
Koil can inspect information related to:
- FPS
- Frame timing
- Memory
- Garbage collection
- Rendering
- Entities
- Chunks
- Shaders
- Resource packs
- Mods
- Java
- Hardware
- Server conditions
- Minecraft settings
- Runtime state
Graphs, historical measurements, recommendations, system information, and other visualizations are used where useful.
Koil is not primarily an optimization mod.
Performance is one part of a much larger system.
The goal is to help you understand what Minecraft is doing and why.
Rich Chat
Koil turns Minecraft chat into something considerably more capable.
Its rich-chat systems include support for things such as:
- Multiline messages
- Formatted text
- Links
- LaTeX
- Tables
- Images
- GIFs
- Audio
- Video
- Files
- Attachments
- Media previews
- Clipboard content
- Private-message tools
- Local model interfaces
- Automation interfaces
Yes.
Minecraft chat can render LaTeX.
Because apparently that was necessary.
Some synchronized rich-chat features require Koil to also be installed on the server.
Minecraft Should Still Look Like Minecraft
Koil changes and extends a lot of Minecraft's interface, but it is deliberately designed around Minecraft's existing visual language.
The goal is not to make Minecraft look like Windows, an IDE, or a generic desktop application.
Koil's screens use compact Minecraft-style layouts, familiar controls, pixel-based presentation, and the game's existing visual identity.
On first launch, you can also choose whether supported screens use Koil's redesigned interface or retain a more vanilla presentation.
The rest of Koil does not disappear if you keep the vanilla UI.
Client + Server
A lot of Koil can work locally on the client.
Installing Koil on a server enables additional synchronized systems and APIs.
Server-side integrations currently include infrastructure for things such as:
- Rich-chat synchronization
- Presence
- Activity snapshots
- HUD information
- Market data
- Server-provided state
- Koil networking APIs
Not every Koil feature requires Koil on the server.
Automation also does not bypass Minecraft permissions or server rules.
If a server does not allow automation, don't use it there.
Built to Be Extended
Koil is more than the screens you can see.
Behind them is a collection of reusable systems and APIs covering areas such as:
- Automation
- KTL
- Local models
- Tool calling
- Minecraft state
- Navigation
- Content
- Registries
- Diagnostics
- Performance
- Chat
- Rendering
- Files
- Packages
- Commands
- Multiplayer
- Worlds
- Development tools
Koil's own features use these systems, and the project is being designed so other mods and tools can integrate with them too.
That is the part of Koil that makes it a middleware framework, not just a large collection of utility screens.
Who is Koil for?
Probably not everybody.
Koil is for the kind of Minecraft player who thinks things like:
"Can I automate this?"
"What exactly is Minecraft doing right now?"
"Could I build that inside the game?"
"Why do I need to leave Minecraft to do this?"
"Can I give a local AI model access to that?"
If you like:
- Programming
- Modding
- Technical Minecraft
- Automation
- Local AI
- Datapacks
- Resource packs
- Shaders
- Debugging
- Performance analysis
- Building tools
- Experimenting with Minecraft internals
- Overcomplicating things because it is interesting
...Koil is probably aimed at you.
Experimental by Design
Koil is an active research project.
A lot of it works.
A lot of it is also still being built.
Systems such as KTL, Automation, local model agents, the Automation Workspace, KPak, development tooling, and some server integrations are still changing rapidly.
Development builds may contain bugs.
Back up important worlds and project files before experimenting with powerful automation, package, or file-management features.
If something breaks, reports with reproducible technical information are extremely useful.
Requirements
Minecraft
1.20.1
Loader
Fabric
Java
17+
Required Dependencies
- Fabric API
- Fabric Language Kotlin
Local models also require enough storage, RAM, CPU, and/or GPU resources for whichever model you choose.
Modpacks
Yes, you can use Koil in modpacks.
Koil is licensed under the MIT License.
Compatibility may vary with mods that heavily replace Minecraft interfaces or systems Koil also modifies.
Why Koil?
Minecraft has mods, datapacks, resource packs, shaders, servers, programming environments, automation tools, debuggers, model loaders, launchers, editors, and entire development ecosystems built around it.
Koil asks:
How much of that can exist inside Minecraft itself?
Not by replacing Minecraft.
By building on top of it.
Run a model. Build an automation. Edit something. Inspect the game. Break something weird. Figure out why.
Then keep going.
This is Koil, by SpiritXIV.
[!] Koil Ko-fi Support (100% Optional)
Koil Supporter  Copper $2.59 |
Koil Supporter  Silver $6.98 |
Koil Supporter  Gold $11.72 |
|---|---|---|
| Support the development of Koil by funding a small amount per month! | Support the development of Koil by funding a large amount per month! | Support the development of Koil by funding a Ginormous amount per month! |
 |
|
|