11 KiB
LoVisual
Minecraft utility client for PvP and automation. Fork of Combatant Client, built on ideas from LiquidBounce, Meteor, and ThunderHack.
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
- Install Fabric Loader 0.19.3+ for MC 26.2+
- Download the LoVisual jar
- Place it in your
mods/folder along with Fabric API and Sodium - 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
- Download the jar from Releases
- Place it in your
mods/folder - Restart the game
Русский
Обзор
LoVisual — открытый утилитарный и PvP-клиент для Minecraft. Включает настраиваемые боевые, двигательные, визуальные и автоматизированные модули, кастомный ClickGUI, систему тем и API для аддонов.
Этот репозиторий является форком Combatant Client, который в свою очередь черпал вдохновение из LiquidBounce, Meteor Client и ThunderHack Recode. Цель — продолжать разработку, добавлять новые возможности и поддерживать актуальные версии Minecraft.
Быстрый старт
- Установите Fabric Loader 0.19.3+ для MC 26.2+
- Скачайте LoVisual jar
- Положите в папку
mods/вместе с Fabric API и Sodium - Откройте 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
Установка
- Скачайте jar из Releases
- Положите в папку
mods/ - Перезапустите игру
Development
Building
./gradlew build
Docs
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)