Клиентский мод для Майнкрафт, добавляющий внутриигрового ИИ-помощника для Shape Shifter's Curse и его аддона. Он читает состояние персонажа и помогает разобраться с формами, эволюцией, едой, крафтами и механиками этих модов.
Возможности
- Открывает компактное окно вопросов и ответов, а также показывает настраиваемый виджет на экране. Помощник может проверять инвентарь, надетую броню, предметы в обеих руках, здоровье, голод, насыщение, опыт, координаты, измерение, эффекты и характеристики игрока.
- Считывает раскладку открытой сетки крафта и её результат, ищет рецепты по идентификатору или названию предмета.
- Показывает точные параметры еды: восстанавливаемый голод, насыщение, доступность еды сейчас и эффекты. Расчёт выполнен по алгоритму AppleSkin; при наличии Apoli учитываются изменения еды у текущей формы.
- При установленном Trinkets читает аксессуары, а при установленном Shape Shifter's Curse — текущую форму, ресурсы Apoli, перезарядки, ману и энергию.
- Ищет сведения о формах, эволюции, механиках и командах в встроенной базе знаний Shape Shifter's Curse и его аддона.
- При включённых читах и правах оператора может искать ближайшие структуры и биомы, выполнять разрешённые команды, выдавать предметы, менять максимальное здоровье, полностью лечить персонажа, восполнять голод и задавать уровень опыта. Опасные команды, включая
op,stopиban, блокируются. - Поддерживает совместимые с OpenAI API сервисы: адрес, ключ и модель можно указать вручную. Сообщения помощника не засоряют игровой чат: результаты команд записываются в журнал.
Как пользоваться
Нажмите K, чтобы открыть окно помощника; клавишу можно переназначить в настройках управления. Окно работает и поверх открытого инвентаря или верстака. В чате можно создавать, переключать и удалять сессии, редактировать собственное сообщение и заново получить ответ; стрелки ↑ и ↓ листают историю ввода.
Для работы с ИИ выберите сервис в настройках, укажите ключ API и сохраните параметры. Чит-функции доступны только при включённом cheatEnabled и правах оператора уровня 2 на сервере.
Настройки
Настройки хранятся в config/ssc_compass.json и доступны через внутриигровое меню с кнопкой ⚙. Там задаются параметры подключения provider, baseUrl, apiKey, model, temperature, maxTokens и maxHistory.
В редакторе интерфейса можно перетащить значок виджета и настроить положение, размер, шрифт и прозрачность через hudBallX, hudBallY, hudBoxX, hudBoxY, hudBoxWidth, hudBoxHeight, hudBgAlpha, hudFontPct и chatFontPct.
Встроенную базу знаний можно дополнить Markdown-файлами в assets/ssc_compass/knowledge/core/; после перезапуска они становятся доступны для поиска.
Требования и совместимость
Для работы нужны Fabric Loader и Fabric API. Trinkets, Shape Shifter's Curse и его аддон необязательны, но открывают чтение аксессуаров, данных форм, ресурсов и связанных механик.
