boba/LoVisual
1
0
Fork 0
Code Issues Pull requests Releases 1 Wiki Activity Actions
No description
97 commits 1 branch 1 tag 35 MiB
Find a file
loki5512344 b0ee4ab317
Some checks failed
CI / backend (cargo test + clippy) (push) Failing after 1s
Details
CI / frontend (lint + test + build) (push) Failing after 26s
Details
CI / mod (gradle test + checkFolderLimit) (push) Successful in 1m57s
Details
build(backend): one shared Dockerfile with cargo cache mounts, sequential compose build, stripped release binaries 
All four services now share one builder stage (dependencies compile once per
deploy, not once per service). BuildKit cache mounts keep the cargo registry
and target/ between deploys: a one-line change rebuilds in ~16 s instead of
recompiling the whole dependency tree.
2026-10-09 22:01:09 +02:00
.github/workflows fix: CI workflow, password reset flow, health/limits in services, session refactor, dead mixin stub cleanup 2026-10-09 19:21:17 +02:00
backend build(backend): one shared Dockerfile with cargo cache mounts, sequential compose build, stripped release binaries 2026-10-09 22:01:09 +02:00
docs chore(history): squash 59 commit(s) from 2026-09-23 2026-09-23 22:38:08 +02:00
frontend feat(accounts): outgoing mail over SMTP (Resend), email verification, fail-closed password reset 2026-10-09 21:08:33 +02:00
mod fix: CI workflow, password reset flow, health/limits in services, session refactor, dead mixin stub cleanup 2026-10-09 19:21:17 +02:00
server-plugin feat: GuiPresence (chat-service presence backend, gateway route, mod module); restore TODO history 2026-10-02 13:41:49 +02:00
.gitattributes init 2026-07-30 11:12:56 +02:00
.gitignore feat(brand): 3D pixel-heart icon and updated site tagline 2026-09-28 22:14:14 +02:00
README.md docs: add a real root README and rewrite the frontend one 2026-09-28 17:28:41 +02:00
TODO.md docs: accounts-service email plan (Resend SMTP, verification, password reset), TODO phase 11 closed 2026-10-09 19:25:55 +02:00

README.md

LoVisual

Open-source Minecraft utility client and the platform around it - website, cloud config sharing, and a Rust backend.

Developed and maintained by loki5512344.

Release Java Rust React License

⬇ Download the mod · Releases

English | Русский

English

What is this?

LoVisual is three things in one repository:

Component What it is Stack
mod/ The Minecraft client itself - 60+ modules, ClickGUI, HUD editor, theme system, custom renderer Java 25 · Fabric · OpenGL/Vulkan
frontend/ The website - downloads, docs, live demos of the in-game GUI, account & config pages React 19 · Vite · TypeScript · Tailwind · bun
backend/ The platform services - API gateway, accounts, cloud config slots with share codes Rust · Axum · PostgreSQL · gRPC

The pieces talk to each other: link the mod to your platform account with %link, push a config to a cloud slot with %config save <1-4>, and a friend imports it by code with %config load <code>.

Mod highlights

  • Combat / Visuals / Player / Misc - Reach, ESP, NameTags, Chams, FullBright, Freecam, AutoTool, FakePlayer and more (see mod README for the full list)
  • ClickGUI on RShift - module browser, settings, theme editor, config profiles
  • HUD editor - draggable and static elements: TargetHUD, ModuleList, Watermark, Keystrokes…
  • Cloud configs - 4 slots per account, short share codes, public showcase
  • .lvcfg profiles - export/import modules, HUD and themes locally, no account needed
  • Addon API - versioned API for extending the client

Requires Fabric Loader, Fabric API and Sodium; optional compatibility with Iris, ViaFabricPlus, Xaero's Minimap/World Map and more.

Repository layout

├── mod/         Fabric client (Gradle, Java)      → mod/README.md
├── frontend/    marketing + dashboard site (bun)  → frontend/README.md
├── backend/     gateway, accounts-, configs-service → backend/STRUCTURE.md
├── docs/        cross-cutting docs                 → docs/README.md
└── ref/         reference material (not shipped)

Development

Mod (from mod/):

./gradlew build        # compile + remap jar into build/libs
./gradlew runClient    # launch a dev Minecraft client
./gradlew test         # unit tests

Frontend (from frontend/, requires bun):

bun install
bun run dev            # http://localhost:5173
bun run test           # vitest
bun run build          # type-check + production bundle

Backend (from backend/, requires Rust + PostgreSQL):

cargo build
cargo test

Releases are cut by pushing a v* tag - GitHub Actions builds the mod jar and publishes it to Releases as both lovisual-<version>.jar and a stable lovisual.jar link.

License

GNU General Public License v3.0. See LICENSE.

Русский

Что это?

LoVisual - три проекта в одном репозитории:

Компонент Что это Стек
mod/ Сам клиент для Minecraft - 60+ модулей, ClickGUI, редактор HUD, темы, свой рендер Java 25 · Fabric · OpenGL/Vulkan
frontend/ Сайт - загрузки, документация, живые демо внутриигрового GUI, страницы аккаунта и конфигов React 19 · Vite · TypeScript · Tailwind · bun
backend/ Сервисы платформы - API-шлюз, аккаунты, облачные слоты конфигов с кодами расшаривания Rust · Axum · PostgreSQL · gRPC

Части связаны: привяжи мод к аккаунту командой %link, залей конфиг в облачный слот через %config save <1-4>, друг заберёт его по коду командой %config load <code>.

Возможности мода

  • Combat / Visuals / Player / Misc - Reach, ESP, NameTags, Chams, FullBright, Freecam, AutoTool, FakePlayer и другие (полный список - в README мода)
  • ClickGUI на RShift - браузер модулей, настройки, редактор тем и профилей
  • Редактор HUD - перетаскиваемые и статические элементы: TargetHUD, ModuleList, Watermark, Keystrokes…
  • Облачные конфиги - 4 слота на аккаунт, короткие коды, публичный показ
  • Профили .lvcfg - локальный экспорт/импорт модулей, HUD и тем без аккаунта
  • Addon API - версионированное API для расширения клиента

Нужны Fabric Loader, Fabric API и Sodium; опционально - Iris, ViaFabricPlus, Xaero's Minimap/World Map и др.

Структура репозитория

├── mod/         клиент Fabric (Gradle, Java)       → mod/README.md
├── frontend/    сайт-витрина и дашборд (bun)       → frontend/README.md
├── backend/     gateway, accounts-, configs-service → backend/STRUCTURE.md
├── docs/        сквозная документация               → docs/README.md
└── ref/         референсы (не поставляется)

Разработка

Мод (из mod/):

./gradlew build        # сборка и remap jar в build/libs
./gradlew runClient    # запуск dev-клиента Minecraft
./gradlew test         # модульные тесты

Фронтенд (из frontend/, нужен bun):

bun install
bun run dev            # http://localhost:5173
bun run test           # vitest
bun run build          # типы + production-сборка

Бэкенд (из backend/, нужны Rust и PostgreSQL):

cargo build
cargo test

Релизы создаются пушем тега v* - GitHub Actions собирает jar мода и публикует в Releases как lovisual-<версия>.jar и по стабильной ссылке lovisual.jar.

Лицензия

GNU General Public License v3.0. См. LICENSE.