195 lines
11 KiB
Markdown
195 lines
11 KiB
Markdown
<div align="center">
|
||
|
||
# LoVisual
|
||
|
||
Minecraft utility client for PvP and automation.
|
||
Fork of [Combatant Client], built on ideas from LiquidBounce, Meteor, and ThunderHack.
|
||
|
||
|
||
|
||
|
||
|
||
[English](#english) | [Русский](#русский)
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
## 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](../../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](../../releases)
|
||
2. Положите в папку `mods/`
|
||
3. Перезапустите игру
|
||
|
||
---
|
||
|
||
## Development
|
||
|
||
### Building
|
||
|
||
```bash
|
||
./gradlew build
|
||
```
|
||
|
||
### Docs
|
||
|
||
- [Architecture](docs/ARCHITECTURE.md)
|
||
|
||
### License
|
||
|
||
GNU General Public License v3.0. See [LICENSE](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)
|
||
|
||
[Combatant Client]: https://github.com/pivosos2007/combatant
|
||
[LiquidBounce]: https://github.com/CCBlueX/LiquidBounce
|
||
[Meteor Client]: https://github.com/MeteorDevelopment/meteor-client
|
||
[ThunderHack Recode]: https://github.com/Pan4ur/ThunderHack-Recode
|