boba/LoVisual
1
0
Fork 0
Code Issues Pull requests Releases 1 Wiki Activity Actions
No description
120 commits 1 branch 1 tag 35 MiB
Find a file
loki5512344 0f1709f25c
Some checks failed
CI / backend (cargo test + clippy) (push) Failing after 1m19s
Details
CI / frontend (lint + test + build) (push) Failing after 27s
Details
CI / mod (gradle test + checkFolderLimit) (push) Successful in 1m56s
Details
wip(spatialgui): isolate screen render state via second GuiRenderer 
Also repairs origin/main: commit 39b270b1 accidentally registered two
SpatialGui mixins in lovisual.mixins.json without committing their
sources; this commit ships them.

Refactors the SpatialGui capture path to follow the upstream
Spatial-GUI architecture. Instead of cancelling and re-targeting the
main GuiRenderer.draw() pass (which required shadowing private fields
and rebuilding the projection matrices), the open screen is now
extracted into an isolated GuiRenderState + GuiRenderer pair owned by
SpatialGuiCapture:

- GuiSpatialExtractMixin @Redirects Screen.extractRenderStateWithTooltipAndSubtitles
  inside Gui.extractRenderState: while SpatialGui.isCapturing(), the
  screen is extracted into SpatialGuiCapture.extractScreen() using a
  private GuiRenderState instead of the vanilla main state, so the HUD
  pass no longer sees the screen content.
- GameRendererSpatialGuiMixin injects twice around GameRenderer.render:
  just before GuiRenderer.render() it resizes and clears the capture
  texture to transparent from the frame's WindowRenderState, and at
  TAIL it runs the isolated renderer's render()+endFrame() so the
  screen's draw list executes into the capture texture once the main
  HUD pass is done.
- GuiRendererCaptureMixin is now a @ModifyArg on the target argument of
  executeDrawRange inside GuiRenderer.draw(): if the instance is the
  isolated one, the target is swapped for SpatialGuiCapture.target();
  the vanilla main renderer keeps its normal framebuffer untouched.

SpatialGuiCapture gains screenRenderState, screenGuiRenderer, and the
extractScreen/renderIsolatedFrame/clearTransparent/target helpers.
SpatialGui.onRenderWorldEngine gets DebugLog.renderThreadOnChange
traces at each early-return branch (noLevel, closed, captureNotReady,
noTextureView, alpha0, published, closing, mesh) so plane publishing
can be diagnosed from a log without a debugger.

Docstring in SpatialGui updated to describe the new pipeline. Message
kept wip: this pass compiles clean and is behaviour-plausible, but I
have not run it against a live Minecraft session this turn.
2026-10-12 23:05:30 +02:00
.github/workflows docs: README download button points at the site's /download (Forgejo has no releases/latest/download) 2026-10-09 22:25:03 +02:00
backend feat(backend): DELETE /avatars removes the row and the S3 object 2026-10-12 22:42:50 +02:00
docs chore(history): squash 59 commit(s) from 2026-09-23 2026-09-23 22:38:08 +02:00
frontend feat(frontend): avatar crop dialog (viewport 320, wheel/pinch/keyboard, guides+shade, previews, dirty guard) 2026-10-12 22:51:40 +02:00
mod wip(spatialgui): isolate screen render state via second GuiRenderer 2026-10-12 23:05:30 +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: README download button points at the site's /download (Forgejo has no releases/latest/download) 2026-10-09 22:25:03 +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 - Forgejo 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* - Forgejo Actions собирает jar мода и публикует в Releases как lovisual-<версия>.jar и по стабильной ссылке lovisual.jar.

Лицензия

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