Koil

============================================================================================= ██╗ ██╗ ██████╗ ██╗██╗ File: https://modrinth.com/mod/koil/settings/description ██║ ██╔╝██╔═══██╗██║██║ ---------------------------------- █████╔╝ ██║ ██║██║██║ Platform: Modrinth ██╔═██╗ ██║ ██║██║██║ Owner: SpiritXIV ██║ ██╗╚██████╔╝██║███████╗ Org: Koil ╚═╝ ╚═╝ ╚═════╝ ╚═╝╚══════╝ -----------------------------------

<hr>
<a href="https://discord.gg/kz6ajy99kX" target="_blank" rel="noopener noreferrer">
    <img src="https://github.com/Koil-public/koil-online-data/blob/main/content/sys/design/images/koil_discord_badge.png?raw=true" alt="koil" width="200px"/>
</a>
<a href="https://ko-fi.com/spiritxiv/tiers" target="_blank" rel="noopener noreferrer">
    <img src="https://github.com/Koil-public/koil-online-data/blob/main/content/sys/design/images/koil_support_badge.png?raw=true" alt="koil" width="200px"/>
</a>
<a href="https://wepwawet.net/p/koil" target="_blank" rel="noopener noreferrer">
    <img src="https://github.com/Koil-public/koil-online-data/blob/main/content/sys/design/images/koil_wepwawet_badge.png?raw=true" alt="koil" width="200px"/>
</a>
<hr>

### Предупреждение: 6/7 я случайно удалил версию 0.70.25 с modrinth, и именно она дала нам более 4к загрузок. Я не буду загружать её снова, так как она всё ещё несовместима с изменениями 0.70.26, которые сейчас происходят
Вы всё ещё можете скачать 0.70.25 напрямую из Koil после установки, а также с github koil-online-data, но она всё равно не будет работать. Новая система изменила файлы, которые 0.70.25 больше не может найти.

#### Хотя это .unfinished сборка, она всё ещё стабильна и безопасна, и её можно использовать как официальную сборку.
<hr>

# Что такое Koil?

**Локальный ИИ, автоматизация, инструменты разработки, диагностика, управление контентом и многое другое — всё встроено прямо в Minecraft.**

Koil — это экспериментальный технический мод для Minecraft для разработчиков, создателей, продвинутых пользователей и всех, кто любит раздвигать границы Minecraft далеко за пределы того, для чего он изначально создавался.

Запускайте локальные ИИ-модели. Автоматизируйте игрока. Редактируйте файлы, не выходя из игры. Изучайте свой инстанс. Управляйте контентом Minecraft. Отлаживайте производительность. Рендерите LaTeX и медиа в чате. Создавайте свою автоматизацию с помощью KTL.

**Koil переносит системы, которые обычно живут вокруг Minecraft, в сам Minecraft.**

---

# Что можно делать с Koil?

## Запускать локальные ИИ-модели прямо в игре

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 похожим на Windows, IDE или обычное десктопное приложение.

Экраны Koil используют компактные макеты в стиле Minecraft, знакомые элементы управления, пиксельную подачу и существующую визуальную идентичность игры.

При первом запуске вы также можете выбрать, будут ли поддерживаемые экраны использовать переработанный интерфейс Koil или сохранят более ванильную подачу.

Остальной Koil не исчезает, если вы оставите ванильный интерфейс.

---

# Клиент + сервер

Многое в Koil может работать локально на клиенте.

Установка Koil на сервер включает дополнительные синхронизированные системы и API.

Серверные интеграции сейчас включают инфраструктуру для, например:

- Синхронизации богатого чата
- Присутствия
- Снимков активности
- Информации HUD
- Рыночных данных
- Состояния, предоставляемого сервером
- Сетевых API Koil

Не каждая функция Koil требует Koil на сервере.

Автоматизация также не обходит разрешения Minecraft или правила сервера.

Если сервер не разрешает автоматизацию, не используйте её там.

---

# Создан для расширения

Koil — это больше, чем экраны, которые вы видите.

За ними стоит набор переиспользуемых систем и API, охватывающих такие области, как:

- Автоматизация
- KTL
- Локальные модели
- Вызов инструментов
- Состояние Minecraft
- Навигация
- Контент
- Реестры
- Диагностика
- Производительность
- Чат
- Рендеринг
- Файлы
- Пакеты
- Команды
- Мультиплеер
- Миры
- Инструменты разработки

Собственные функции Koil используют эти системы, и проект проектируется так, чтобы другие моды и инструменты тоже могли с ними интегрироваться.

Именно эта часть делает Koil **middleware-фреймворком**, а не просто большой коллекцией утилитарных экранов.

---

# Для кого Koil?

Наверное, не для всех.

Koil — для такого игрока в Minecraft, который думает примерно так:

> **"Могу ли я это автоматизировать?"**

> **"Что именно Minecraft делает прямо сейчас?"**

> **"Могу ли я построить это внутри игры?"**

> **"Почему мне нужно выходить из Minecraft, чтобы сделать это?"**

> **"Могу ли я дать локальной AI-модели доступ к этому?"**

Если тебе нравится:

- Программирование
- Моддинг
- Технический Minecraft
- Автоматизация
- Локальный AI
- Датапаки
- Ресурспаки
- Шейдеры
- Отладка
- Анализ производительности
- Создание инструментов
- Эксперименты с внутренностями Minecraft
- Усложнять всё, потому что это интересно

...то Koil, скорее всего, для тебя.

---

# Экспериментальный по задумке

Koil — это активный исследовательский проект.

Многое в нём работает.

Многое ещё только строится.

Такие системы, как **KTL, Automation, агенты локальных моделей, Automation Workspace, KPak, инструменты разработки и некоторые серверные интеграции**, всё ещё быстро меняются.

В dev-сборках могут быть баги.

Делай резервные копии важных миров и файлов проектов, прежде чем экспериментировать с мощной автоматизацией, пакетами или функциями управления файлами.

Если что-то сломалось, отчёты с воспроизводимой технической информацией крайне полезны.

---

# Требования

### 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.

<details>
<summary>[!] Koil Youtube Showcases</summary>
<details>
<summary>В Minecraft появился новый файловый менеджер И РЕДАКТОР ФАЙЛОВ??</summary>
<iframe width="560" height="315" src="https://www.youtube.com/embed/esc8L1SIFus?si=IgnZBe6ev4pIv_ZE" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
</details>
<details>
<summary>Скачивать контент для Minecraft стало гораздо проще</summary>
<iframe width="560" height="315" src="https://www.youtube.com/embed/kpfs4UBjiwA?si=ImNIl7CvWrPF9HTV" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
</details>
</details>