No description
loki5512344
4fce425dcd
Rebuilds the "pick a photo" flow around an Edit Image modal, matching every product surveyed in the 2026-10 avatar-settings research (Discord, Google, Slack, Figma, Cropper.js playground). Before: 240 px circular viewport with no visible crop frame, a single range slider, and no way to close with the keyboard — the direct reason the previous version felt unfinished. cropMath: VIEWPORT=320, OUTPUT_SIZE=512 (matches Slack min), plus wheelZoom (exp so scroll up then down returns to the same zoom, unlike linear), pinchZoom (ratio of two-pointer distance), PAN_STEP/ZOOM_STEP for keyboard, PREVIEW_SIZES for the "how others see it" column. AvatarCropper is now a pure canvas: pointer capture for pan, two-pointer tracking for pinch, wheel handler with exponential zoom, tabIndex=0 + onKeyDown for arrows/+/-/0, a Reset button, and a visual frame with rule-of-thirds guides (40 % opacity) and an inset box-shadow that dims the corners outside the round target — so the user actually sees what falls in the file. Cancel/Confirm live in the dialog; dirty signal and current CropState bubble up via props. AvatarEditDialog is a portal: bg-black/60 backdrop with click-to-close, role=dialog + aria-modal, initial focus into the card, ESC closes, X button in the header. If the user has panned/zoomed (dirty), closing prompts for confirmation. Header shows file.name + size + the accepted-format hint previously only surfaced after a failed upload. Right column renders 3 live previews at 128/64/32 px so the small HUD nameplate treatment is visible before upload. Progress bar and error notice moved inside so the user does not have to look away during a slow upload. AvatarUpload picks the dialog instead of the raw cropper; two-step "Remove avatar" from the previous commit is unchanged. Tests: 5 new cropMath cases (wheel symmetric, wheel clamps both ends, pinch ratio, pinch guards zero baseline). Existing 140 stay green (145 total), tsc clean, oxlint 0/0. Not yet: no dep on react-easy-crop — own code as planned. No focus trap beyond initial focus + ESC (dialog traps implicitly via portal + backdrop covering). Rotate is still missing — deliberately, since Discord does not ship it either and extending sourceRect for theta would complicate the preview pass. |
||
|---|---|---|
| .github/workflows | ||
| backend | ||
| docs | ||
| frontend | ||
| mod | ||
| server-plugin | ||
| .gitattributes | ||
| .gitignore | ||
| README.md | ||
| TODO.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.
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
.lvcfgprofiles - 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.