boba/LoVisual
1
0
Fork 0
Code Issues Pull requests Releases 1 Wiki Activity Actions
No description
109 commits 1 branch 1 tag 35 MiB
Find a file
LoVisual AI 15f070af6d
Some checks failed
CI / backend (cargo test + clippy) (push) Failing after 6m48s
Details
CI / frontend (lint + test + build) (push) Failing after 24s
Details
CI / mod (gradle test + checkFolderLimit) (push) Successful in 1m57s
Details
feat(mod): Stage 3 (continued) — LivingEntityLod + BubbleColumnUp + LevelRendererOutline 
Per mod/docs/optimize-layer-design.md Stage 3 (continued). Three more simple
mixin'ы are added on top of the existing RenderBackendOps + lazy-clear/TBO/
RenderTypes trio:

mixins/optimize/entity/LivingEntityLodMixin.java:
- ModifyExpressionValue on LivingEntityRenderer.submit's shouldRenderLayers
  call — return false when the entity's distanceToCameraSq is beyond the
  Stage 1 entity_lod threshold. Skips the layer pass (armour, held items,
  eyes, cape, elytra, stuck arrows) for far entities. Ported from
  zako.opt.mixin.entity.LivingEntityLodMixin.

mixins/optimize/particle/BubbleColumnUpParticleMixin.java:
- WrapOperation on BubbleColumnUpParticle.tick's ClientLevel.getFluidState
  call — consult BubbleColumnCache first, store on miss. Cache is cleared
  per-tick (BlockPos.asLong key + game-tick tracking). Ported from
  zako.opt.mixin.particle.BubbleColumnUpParticleMixin.

mixins/optimize/world/LevelRendererOutlineMixin.java:
- Inject on LevelRenderer.doEntityOutline HEAD-cancellable — skip the
  outline render when no glowing entity was seen this frame (OutlineTracker).
- WrapOperation on LevelRenderer.addMainPass's clearColorTexture — call
  OutlineTracker.markGlowing() to record that the renderer is about to
  draw an outline this frame. (Conservative: marks every clear, not just
  the entity-outline one — ZakoOpt uses @Local for precision, we keep it
  simple to avoid MixinExtras @Local fragility across MC versions.)
- Ported from zako.opt.mixin.entity.LevelRendererOutlineMixin.

Helpers (features/.../optimize/):
- particle/TickCache<V>: generic per-tick keyed cache (Long2ObjectOpenHashMap).
  BubbleColumnCache wraps it for FluidState. Other per-tick caches
  (ParticleLightCache etc.) can reuse it in later Stage 3 commits.
- particle/BubbleColumnCache: thin wrapper over TickCache<FluidState>.
- world/OutlineTracker: per-frame state for the outline-skip optimization
  (glowingThisFrame + dirty flag, beginFrame/markGlowing/markCleared API).

lovisual.mixins.json: three new entries in the 'client' array:
  optimize.entity.LivingEntityLodMixin
  optimize.particle.BubbleColumnUpParticleMixin
  optimize.world.LevelRendererOutlineMixin

Tests (JUnit 5):
- TickCacheTest: 9 tests covering get/put/clear-on-tick-change/multi-key/
  overwrite/null-values/long-keys.
- OutlineTrackerTest: 8 tests covering enabled flag, skip-when-no-glowing,
  begin-frame-clears, dirty-tracking, needsClear logic.
- (BubbleColumnCache itself is a 4-line wrapper around TickCache so its
  test would just re-test TickCache — skipped.)
Total suite: 866 tests, 0 failures. checkFolderLimit: OK (0 папок >4).
2026-10-10 18:53:38 +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 deploy(nginx): serve the mod jar from nginx with a speed cap (750k per connection) and 2 connections per IP 2026-10-09 22:26:27 +02:00
docs chore(history): squash 59 commit(s) from 2026-09-23 2026-09-23 22:38:08 +02:00
frontend feat(site): redesigned /download, releases and links moved from GitHub to Forgejo 2026-10-09 22:15:55 +02:00
mod feat(mod): Stage 3 (continued) — LivingEntityLod + BubbleColumnUp + LevelRendererOutline 2026-10-10 18:53:38 +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.