科伊尔 · 我的世界Mod

.detail-panel[hidden] { display: block !important; } .detail-tabs { display: none; } /* These three panels are rendered by the browser. */ [data-versions], [data-changelog-panel], [data-comments] { display: none; }

前置说明：截至 6/7，我意外从 Modrinth 删除了版本 0.70.25，正是它为我们带来了超过 4k 的下载量。我不会再重新上传它，因为它仍然与正在发生的 0.70.26 变更不兼容。

你仍然可以在安装 Koil 后直接从 Koil 下载 0.70.25，也可以从 koil-online-data 的 GitHub 获取，但它仍然无法正常工作。新系统更改了文件，0.70.25 已经找不到它们了。

尽管它是一个 .unfinished 构建，但它仍然稳定且安全，可以像官方构建一样使用。

什么是 Koil？

本地 AI、自动化、开发工具、诊断、内容管理等等，直接内置于 Minecraft 中。

Koil 是一个实验性的技术型 Minecraft 模组，面向开发者、创作者、高级用户，以及任何喜欢将 Minecraft 推向远超其原本设计极限的人。

运行本地 AI 模型。自动化玩家。无需离开游戏即可编辑文件。检查你的实例。管理 Minecraft 内容。调试性能。在聊天中渲染 LaTeX 和媒体。使用 KTL 构建你自己的自动化。

Koil 将通常存在于 Minecraft 周围的系统带入了 Minecraft 本身。

你能用 Koil 做什么？

在游戏内运行本地 AI 模型

Koil 可以在你的计算机上本地运行受支持的 GGUF 语言模型。

模型可以通过 Minecraft 下载和管理，Koil 负责处理本地运行时、模型配置、流式传输、硬件引导以及其他设置。

使用 /ask 直接与你选择的本地模型对话。

Koil 目前包含以下系统：

本地 GGUF 模型
llama.cpp
模型下载与安装
流式响应
多个本地模型提供者
模型与硬件推荐
对话上下文
Deep Thought
工具调用
可选语音输出
自动化模式

普通的 /ask 对话不会让模型控制 Minecraft。

为此，需要使用 自动化模式。

让你的模型控制 Minecraft

自动化模式允许兼容的本地模型使用 Koil 注册的工具，而不仅仅是生成文本。

Koil 可以暴露以下能力：

移动
环顾四周
跳跃
疾跑
导航
挖掘方块
使用物品
与方块交互
与实体交互
攻击
检查物品栏
使用容器
发送聊天
运行 Minecraft 命令
观察方块和实体
读取任务状态
等待与重试

模型不会仅仅发送一个输入就假定任务已经完成。

Koil 的自动化架构正围绕一个更大的循环构建：

检查 → 规划 → 行动 → 观察 → 验证 → 恢复 → 继续

这使得自动化能够朝着越来越复杂的目标推进，而不是仅限于单个宏。

自动化仍然是 Koil 最具实验性的系统之一，因此预计它会快速演进。

KTL

Koil 拥有自己的任务与自动化语言，称为 KTL。

KTL 允许在 Java 引擎之外描述自动化行为，因此任务可以被扩展、修改和复用，而无需将所有可能的目标永久硬编码到模组中。

Koil 的自动化层包含以下系统：

KTL 编译
能力
任务规划
任务执行
条件
目标
任务状态
验证
审批
失败处理
反馈
恢复
宏

其目标是让 Minecraft 自动化成为你可以在其之上构建的东西，而不仅仅是一份固定的命令列表。

Deep Thought

有时一个模型的单次响应并不足够。

/ask deep 为 Koil 的模型赋予一个更长的调查过程，并配备有界的只读工具。

Deep Thought 可以收集信息、在多个阶段中调查问题、维护证据与结论、保存进度，并在之后恢复调查。

它专为那些模型应当真正调查某事，而非立即猜测答案的问题而设计。

Minecraft 内的开发工作区

Koil 包含一套不断增长的工具集合，让你无需在游戏、文件管理器、配置文件夹、日志和外部实用程序之间不断切换，即可处理 Minecraft 相关的工作。

文件浏览器

直接从 Minecraft 中浏览受支持的文件。

文件编辑器

在游戏内打开并修改文本和配置文件。

开发工作区

Koil 可以检测受支持的开发工作区，并允许其开发与模型系统检查有界的项目文件。

项目验证

受支持的开发工具可以运行已注册的 Gradle 验证操作。

日志

无需手动翻查实例即可查看 Koil、Minecraft 和包日志。

配置

在游戏内查找并修改受支持的配置。

如果你制作以下内容，Koil 尤其有用：

模组
数据包
资源包
着色器
Minecraft 工具
自动化
其他技术型 Minecraft 项目

管理你的 Minecraft 内容

Koil 包含让你无需离开游戏即可管理更多 Minecraft 实例内容的工具。

当前系统可处理以下内容：

模组
数据包
资源包
着色器包
世界
皮肤
配置
Koil 包

Koil 还可以与 Modrinth 等服务通信，以搜索项目并获取兼容性和版本信息。

思路很简单：

如果它是你 Minecraft 实例的一部分，你就应该能够从 Minecraft 中与它交互。

动态 Minecraft 内容

Koil 包含一个世界感知的内容与注册表系统，旨在理解当前游戏中实际存在的更多内容。

这包括围绕以下方面的工作：

原版内容
模组内容
数据包内容
世界特定内容
方块与物品
属性与元数据
注册表信息

这对 Koil 的开发、自动化和模型系统尤其有用，因为这些系统需要知道它们实际运行所在的 Minecraft 实例中存在什么。

KPak

Koil 还包含自己的实验性包格式，称为 KPak。

KPak 旨在打包和安装结构化的 Minecraft 与 Koil 内容。

当前系统包含：

包清单
包构建
安装
SHA-256 校验
Ed25519 签名
作者身份
兼容性检查
事务状态
备份
回滚
已安装文件验证

KPak 仍处于实验阶段，其信任和包系统仍在持续开发中。

更好的技术信息

Koil 大幅扩展了 Minecraft 的诊断系统。

其重新设计的 F3 和性能界面旨在让技术信息更易于理解，而不仅仅是在屏幕上放置更多文字。

Koil 可以检查与以下内容相关的信息：

FPS
帧时间
内存
垃圾回收
渲染
实体
区块
着色器
资源包
模组
Java
硬件
服务器状况
Minecraft 设置
运行时状态

在有用之处使用图表、历史测量、建议、系统信息和其他可视化。

Koil 主要不是一个优化模组。

性能只是一个更大系统的一部分。

其目标是帮助你理解 Minecraft 正在做什么以及为什么。

富文本聊天

Koil 将 Minecraft 聊天变成了功能强大得多的东西。

其富文本聊天系统支持以下内容：

多行消息
格式化文本
链接
LaTeX
表格
图片
GIF
音频
视频
文件
附件
媒体预览
剪贴板内容
私信工具
本地模型界面
自动化界面

没错。

Minecraft 聊天可以渲染 LaTeX。

因为显然这是必要的。

某些同步富文本聊天功能需要服务器端也安装 Koil。

Minecraft 仍应看起来像 Minecraft

Koil 改变并扩展了大量 Minecraft 界面，但它刻意围绕 Minecraft 现有的视觉语言进行设计。

其目标不是让 Minecraft 看起来像 Windows、IDE 或通用桌面应用程序。

Koil 的界面使用紧凑的 Minecraft 风格布局、熟悉的控件、基于像素的呈现以及游戏现有的视觉标识。

首次启动时，你还可以选择受支持的界面使用 Koil 重新设计的界面还是保留更原版的呈现。

即使你保留原版 UI，Koil 的其余部分也不会消失。

客户端 + 服务器

Koil 的许多功能可以在客户端本地运行。

在服务器上安装 Koil 可启用额外的同步系统和 API。

服务器端集成目前包含以下基础设施：

富文本聊天同步
在线状态
活动快照
HUD 信息
市场数据
服务器提供的状态
Koil 网络 API

并非所有 Koil 功能都需要在服务器上安装 Koil。

自动化也不会绕过 Minecraft 权限或服务器规则。

如果服务器不允许自动化，请不要在那里使用它。

为扩展而构建

Koil 不仅仅是你能看到的那些界面。

在它们背后，是一组可复用的系统和 API，涵盖以下领域：

自动化
KTL
本地模型
工具调用
Minecraft 状态
导航
内容
注册表
诊断
性能
聊天
渲染
文件
包
命令
多人游戏
世界
开发工具

Koil 自身的功能使用这些系统，并且该项目正被设计为让其他模组和工具也能与之集成。

正是这部分让 Koil 成为一个 中间件框架，而不仅仅是一大堆实用界面。

Koil 面向谁？

可能不是所有人。

Koil 面向那种会思考以下问题的 Minecraft 玩家：

"我能自动化这个吗？"

"Minecraft 现在究竟在做什么？"

"我能在游戏内构建那个吗？"

"为什么我需要离开 Minecraft 才能做这件事？"

"我能让本地 AI 模型访问那个吗？"

如果你喜欢：

编程
模组制作
技术型 Minecraft
自动化
本地 AI
数据包
资源包
着色器
调试
性能分析
构建工具
尝试 Minecraft 内部机制
因为有趣而把事情过度复杂化

……Koil 很可能就是为你准备的。

生而实验

Koil 是一个活跃的研究项目。

其中很多部分可以工作。

也有许多部分仍在构建中。

诸如 KTL、自动化、本地模型代理、自动化工作区、KPak、开发工具以及部分服务器集成 等系统仍在快速变化。

开发构建可能包含 bug。

在尝试强大的自动化、包或文件管理功能之前，请备份重要的世界和项目文件。

如果出现问题，带有可复现技术信息的报告非常有用。

要求

Minecraft

1.20.1

加载器

Fabric

Java

17+

必需依赖

Fabric API
Fabric Language Kotlin

本地模型还需要为你所选择的模型提供足够的存储、RAM、CPU 和/或 GPU 资源。

整合包

是的，你可以在整合包中使用 Koil。

Koil 采用 MIT 许可证 授权。

与那些大量替换 Minecraft 界面或 Koil 同样修改的系统的模组，兼容性可能有所差异。

为什么是 Koil？

Minecraft 周围构建了大量模组、数据包、资源包、着色器、服务器、编程环境、自动化工具、调试器、模型加载器、启动器、编辑器以及完整的开发生态系统。

Koil 提出：

其中有多少可以存在于 Minecraft 本身之内？

不是通过替换 Minecraft。

而是通过在其之上构建。

运行模型。构建自动化。编辑某些东西。检查游戏。以奇怪的方式弄坏某些东西。弄清楚为什么。

然后继续前进。

这就是 Koil，由 SpiritXIV 制作。

[!] Koil Ko-fi 支持（100% 可选）

Koil 支持者 Copper $2.59	Koil 支持者 Silver $6.98	Koil 支持者 Gold $11.72
通过每月资助少量金额来支持 Koil 的开发！	通过每月资助大量金额来支持 Koil 的开发！	通过每月资助巨额金额来支持 Koil 的开发！

[!] Koil YouTube 展示

Minecraft 有了新的文件浏览器和一个文件编辑器？？

下载 Minecraft 内容变得简单多了