LoVisual/combatant-client-26.2

LoVisual

Minecraft utility client for PvP and automation. Fork of Combatant Client, built on ideas from LiquidBounce, Meteor, and ThunderHack.

English | Русский

---

English

Overview

LoVisual is an open-source utility and PvP client for Minecraft. It provides configurable combat, movement, visual, automation, HUD, and UI features with a custom ClickGUI, theme system, and addon API.

This repository is a fork of Combatant Client, which drew inspiration from LiquidBounce, Meteor Client, and ThunderHack Recode. The goal is to continue development, add new features, and maintain compatibility with the latest Minecraft versions.

Quick Start

1. Install Fabric Loader 0.19.3+ for MC 26.2+
2. Download the LoVisual jar
3. Place it in your mods/ folder along with Fabric API and Sodium
4. Open the ClickGUI with RShift (configurable)

Features

Feature	Description
Combat	KillAura, AutoCrystal, AutoAnchor, AutoBed, AutoBow, Criticals, Reach, Velocity, Backtrack, and more
Movement	Speed, Flight, ElytraFly, ElytraHelper, Sprint, Timer, Strafe, TargetStrafe, Scaffold, Parkour
Visuals	ESP, NameTags, Chams, Tracers, Crosshair, Zoom, Freecam, FullBright, MotionBlur, NoRender
Player	AutoTool, AutoEat, AutoArmor, AutoTotem, Scaffold, ClickPearl, FakeLag, XCarry
Misc	BetterMinecraft, FakePlayer, HitSounds, Panic, NoSound
HUD	Draggable elements, TargetHUD, ModuleList, Watermark, Armor, Potions, Keystrokes, Coords, Notifications, Scoreboard
ClickGUI	Full-featured GUI with module browser, settings editor, theme editor, config profiles
Config profiles	.lvisual profiles for modules, HUD, and themes — shareable between users
Addon API	Versioned addon API for extending the client
Custom renderer	Custom UI rendering with MSDF fonts, SVG icons, and shader support
Iris/Sodium/Xaero	Optional compatibility with popular mods

Compatibility

Mod	Status
Sodium	✅ Required
Iris	✅ Optional — shaderpack support
ImmediatelyFast	✅ Optional — performance
Entity Culling	✅ Optional — performance
Xaero's Minimap	✅ Optional — waypoint integration
Xaero's World Map	✅ Optional — waypoint integration
ViaFabricPlus	✅ Optional — protocol translation

Dependencies

• Required: Fabric Loader 0.19.3+, Fabric API, Sodium, Java 25+
• Optional: Iris, ImmediatelyFast, ViaFabricPlus, Entity Culling, Xaero's Minimap, Xaero's World Map

Installation

1. Download the jar from Releases
2. Place it in your mods/ folder
3. Restart the game

---

Русский

Обзор

LoVisual — открытый утилитарный и PvP-клиент для Minecraft. Включает настраиваемые боевые, двигательные, визуальные и автоматизированные модули, кастомный ClickGUI, систему тем и API для аддонов.

Этот репозиторий является форком Combatant Client, который в свою очередь черпал вдохновение из LiquidBounce, Meteor Client и ThunderHack Recode. Цель — продолжать разработку, добавлять новые возможности и поддерживать актуальные версии Minecraft.

Быстрый старт

1. Установите Fabric Loader 0.19.3+ для MC 26.2+
2. Скачайте LoVisual jar
3. Положите в папку mods/ вместе с Fabric API и Sodium
4. Откройте ClickGUI через RShift (настраивается)

Возможности

Возможность	Описание
Combat	KillAura, AutoCrystal, AutoAnchor, AutoBed, AutoBow, Criticals, Reach, Velocity, Backtrack и другие
Movement	Speed, Flight, ElytraFly, ElytraHelper, Sprint, Timer, Strafe, TargetStrafe, Scaffold, Parkour
Visuals	ESP, NameTags, Chams, Tracers, Crosshair, Zoom, Freecam, FullBright, MotionBlur, NoRender
Player	AutoTool, AutoEat, AutoArmor, AutoTotem, Scaffold, ClickPearl, FakeLag, XCarry
Misc	BetterMinecraft, FakePlayer, HitSounds, Panic, NoSound
HUD	Перетаскиваемые элементы: TargetHUD, ModuleList, Watermark, Armor, Potions, Keystrokes, Coords, Notifications, Scoreboard
ClickGUI	Полноценный GUI с браузером модулей, редактором настроек, тем и профилей конфигов
Профили .lvisual	Профили для модулей, HUD и тем — можно шарить между пользователями
Addon API	Версионированное API для аддонов
Кастомный рендер	UI-рендеринг с MSDF-шрифтами, SVG-иконками и шейдерами
Iris/Sodium/Xaero	Опциональная совместимость с популярными модами

Совместимость

Мод	Статус
Sodium	✅ Требуется
Iris	✅ Опционально — шейдерпаки
ImmediatelyFast	✅ Опционально — производительность
Entity Culling	✅ Опционально — производительность
Xaero's Minimap	✅ Опционально — интеграция waypoint
Xaero's World Map	✅ Опционально — интеграция waypoint
ViaFabricPlus	✅ Опционально — протокол

Зависимости

• Обязательные: Fabric Loader 0.19.3+, Fabric API, Sodium, Java 25+
• Опциональные: Iris, ImmediatelyFast, ViaFabricPlus, Entity Culling, Xaero's Minimap, Xaero's World Map

Установка

1. Скачайте jar из Releases
2. Положите в папку mods/
3. Перезапустите игру

---

Development

Building

./gradlew build

Docs

• Architecture

License

GNU General Public License v3.0. See LICENSE.

---

TODO

Фаза 1: Переименование (Rebrand)

• Переименовать package combatant → dev.loki.lovisual
• Переименовать mod ID combatant → lovisual
• Сменить название клиента везде (Combatant → LoVisual)
• Обновить fabric.mod.json, mixins.json
• Обновить все нативные сообщения и debug-строки

Фаза 2: Косметические изменения

• Заменить .cbcfg → .lvisual, путь config/combatant/ → config/lovisual/
• Префикс команд оставить @
• Новый splash/watermark, иконки, логотип
• Переписать theme под LoVisual-стиль

Фаза 3: Рефакторинг

• Выкинуть ненужное: дебажные фичи, лишние интеграции (iris/sodium compat оставить)
• Разбить большие файлы (> 1500 строк): Scaffold, KillAura, AutoCrystal, Renderer2D
• Привести структуру к единому стандарту (нейминг, форматирование)

Фаза 4: Модули

• Добавить модули из ref/modules/ (Sprint, Velocity, AntiAFK, AutoRespawn, AutoFish, ...)
• Переписать IRC-модуль (WebSocket)
• Сделать облачные конфиги (CloudAPI)

Фаза 5: Backend (Go)

• Написать бэкенд с нуля (Go + chi + SQLite)
• Auth (bcrypt, JWT), профили, друзья
• WebSocket хаб для IRC
• REST API для облачных конфигов

Фаза 6: Лаунчер (Rust)

• Написать лаунчер с нуля (Rust + egui)
• Логин/регистрация, дашборд, настройки
• Авто-запуск Minecraft с модом
• Авто-обновление

Фаза 7: Polish

• Звуки (49 звуков)
• Анимации (SpringAnimator)
• 6 стилей HUD
• Load-экран
• Главное меню (MainMenu)