{"url":"https://levimc.org/mods/github.com/Unny984/Zoomidy/","id":"github.com/Unny984/Zoomidy","name":"Zoomidy","description":"Zoomify-style smooth zoom for Minecraft Bedrock Edition","owner":"Unny984","logo":"https://levimc.org/mods/icons/6a2fd47656c2fc95-288.webp","repository":"https://github.com/Unny984/Zoomidy","issues":"https://github.com/Unny984/Zoomidy/issues","releases":"https://github.com/Unny984/Zoomidy/releases","stars":2,"downloads":158,"updated":"2026-09-25T06:35:59Z","published":"2026-08-21T13:04:19Z","created":"2026-08-21T12:53:15Z","license":"MIT","side":["client"],"platform":["win-x64"],"gameVersions":["1.26.51","1.26.20","1.26.10"],"tags":["platform:levilamina","type:mod"],"latest":{"variant":"client","version":"0.5.0","install":"lip install github.com/Unny984/Zoomidy#client@0.5.0"},"readmes":[{"file":"README.md","lang":"en","text":"# Zoomidy\n\nSmooth, animated zoom for **Minecraft Bedrock Edition** on Windows, in the spirit of\n[Zoomify](https://modrinth.com/mod/zoomify) and\n[MCBE-Win10-FOV-Changer](https://github.com/xroix/MCBE-Win10-FOV-Changer).\n\nBuilt as a **client-side [LeviLamina](https://github.com/LiteLDev/LeviLamina) mod**.\n\n## Features\n\n| | |\n|---|---|\n| **Hold `F` to zoom** | Or switch to toggle. The key is rebindable to any keyboard key. |\n| **Animated transition** | 0.2 s by default, with six easing curves to pick from. |\n| **Adjustable magnification** | 4x by default; the scroll wheel changes it live while zoomed. |\n| **Hide the hand** | The first-person arm and held item disappear while zoomed. |\n| **Sensitivity scaling** | Relative (follows the zoom), fixed, or off. |\n| **Cinematic camera** | Optional. The camera lags on the way in and coasts out after a flick. |\n| **In-game settings screen** | `/zoomidy` opens a real Minecraft form. |\n\n## Requirements\n\n- Windows 10/11 x64\n- LeviLamina installed on the client, via\n  [LeviLauncher](https://lamina.levimc.org/user_guides/install_on_client/) — either line below\n- The matching Minecraft Bedrock Edition client version\n\n| LeviLamina | Minecraft client | Zoomidy variant |\n|---|---|---|\n| **26.20.x** | **1.26.20.4** | `client` (default) |\n| **26.10.x** | **1.26.10.4** | `client_26_10` |\n| **26.51.x** | **1.26.51.1** | `client_26_51` |\n\n> The Store copy of Minecraft is usually newer than whatever LeviLamina supports, and the hooks\n> here are resolved against the exact game binary. Use LeviLauncher to download and switch to the\n> supported client version; it keeps it separate from your Store install. Each Zoomidy variant is\n> built against, and only works with, the matching LeviLamina line — installing the wrong one\n> will fail to load.\n\n## Install\n\nDrop the built `zoomidy` folder into your client's `mods/` directory, or install with `lip`.\nThis installs the LeviLamina **26.20.x** build:\n\n```bash\nlip install github.com/Unny984/Zoomidy\n```\n\nOn LeviLamina **26.10.x**, install the matching variant instead:\n\n```bash\nlip install github.com/Unny984/Zoomidy#client_26_10\n```\n\nOn LeviLamina **26.51.x**:\n\n```bash\nlip install github.com/Unny984/Zoomidy#client_26_51\n```\n\n## Usage\n\nHold `F`. That is the whole thing.\n\nZoomidy watches the key rather than taking it over, so pick one Minecraft does not already use.\nIf you bind it to a key that already does something, both will happen — but nothing gets locked\naway, and you can always rebind from the config file.\n\n### Settings screen\n\n```\n/zoomidy\n```\n\n> **The settings form only opens in a world this client is hosting** — single-player, or a world\n> you opened to LAN. Minecraft's form system belongs to the *server* half of the game, and there\n> is no server half to talk to when you are a guest on somebody else's world. The sub-commands\n> below work everywhere, and so does editing the config file.\n\n**Every change saves itself.** There is no Apply button on either version — touch a control and it\ntakes effect and is written to `config.json` straight away.\n\nThe **26.51** build uses the same screen as 26.20. The **26.10** build holds the same settings but\nshows them differently, because that version of LeviLamina predates the UI API the 26.20 screen is\nbuilt on. The only screen it has that can report anything before it closes is a menu of buttons,\nso that is what it uses:\n\n| | 26.20 | 26.10 |\n|---|---|---|\n| Layout | One page of controls | A menu, one screen per setting |\n| Numbers | Sliders | A value with `+` / `-` buttons |\n| Choices | Dropdowns | A short list to pick from |\n| Zoom key | Type it | Pick from the usual candidates, or `/zoomidy key` for the rest |\n\n### Sub-commands\n\nThese work in every world, including remote servers, because they never touch the form system.\n\n```\n/zoomidy status\n/zoomidy reload\n/zoomidy key <F|Z|SPACE|LSHIFT|F5|0x46|...>\n/zoomidy activation <Hold|Toggle>\n/zoomidy magnification <1.5-50>\n/zoomidy transition <milliseconds> [curve]\n/zoomidy hidehand <true|false>\n/zoomidy sensitivity <Off|Relative|Fixed> [multiplier]\n/zoomidy cinematic <true|false> [strength]\n```\n\n`/zoomidy` is registered on the client, so the command never reaches the server you are playing\non and needs no permissions there.\n\n### Config file\n\n`mods/zoomidy/config/config.json`. Edit it and run `/zoomidy reload`, or restart the game.\n\n```json\n{\n  \"version\": 1,\n  \"zoom\": {\n    \"keyCode\": 70,\n    \"activation\": \"Hold\",\n    \"factor\": 4.0,\n    \"minFactor\": 1.5,\n    \"maxFactor\": 50.0,\n    \"scrollToAdjust\": true,\n    \"scrollStep\": 1.2,\n    \"rememberScrolledFactor\": false\n  },\n  \"animation\": { \"durationSeconds\": 0.2, \"curve\": \"EaseOutQuad\" },\n  \"view\": { \"hideHand\": true },\n  \"sensitivity\": { \"mode\": \"Relative\", \"multiplier\": 1.0 },\n  \"cinematic\": { \"enabled\": false, \"strength\": 0.6 }\n}\n```\n\n`keyCode` is a [Windows virtual-key code](https://learn.microsoft.com/en-us/windows/win32/inputdev/virtual-key-codes);\n70 (`0x46`) is `F`.\n\n## How it works\n\n| Piece | Mechanism |\n|---|---|\n| The zoom | Hooks `LevelRendererPlayer::getFov` and divides the answer. |\n| Hiding the hand | Skips `ItemInHandRenderer::renderFirstPerson` for the frame. |\n| The key | Listens to `ll::event::KeyInputEvent`, gated on the pointer being locked, so it does not fire while you are typing in chat. |\n| Sensitivity | Rewrites `dx`/`dy` on `ll::event::MouseInputEvent`, carrying the sub-count remainder forward so slow aiming survives a 0.25x scale. |\n| Cinematic camera | Banks the movement, then drains it a frame at a time from a `MouseMapper::tick` hook and feeds it back through `Mouse::feed`. |\n| Scroll to adjust | Cancels the wheel event while zoomed, so the hotbar does not move with it. |\n| Settings screen | `ll::ui::CustomForm` on 26.20, a menu of `ll::form::SimpleForm`s on 26.10. Built on the server thread either way. |\n\n### Why the camera coast needs its own hook\n\nA camera that keeps turning after the mouse stops cannot be driven by mouse events, because during\na coast there are none. Filtering the events in place can only ever slow the camera down. So the\nmovement is banked instead and paid out from `MouseMapper::tick`, which runs once per frame on the\nsame thread the real events arrive on, immediately before the queue it is handed gets drained.\n\nGuards, since this synthesises input rather than only filtering it: the banked motion is capped,\nthe per-frame step is capped so a hitch cannot release it all at once, a re-entrancy flag keeps\nthe synthetic events out of the filter that produced them, and the drain stops entirely once the\npointer is released so it can never push movement into an open menu.\n\n### A note on the zoom curve\n\nThe magnification is interpolated **geometrically** (`factor ^ eased`) rather than linearly.\nPerceived zoom is logarithmic — 1x → 2x feels like the same amount of movement as 2x → 4x — so a\nlinear ramp crawls through the barely-zoomed range and then lurches at the end. The endpoints are\nstill exactly 1x and the configured magnification.\n\n## Building\n\nNeeds [xmake](https://xmake.io), plus **both** Windows toolchains — clang-cl for the 26.20 and\n26.51 builds and MSVC for the 26.10 one. For clang-cl, install LLVM or add *C++ Clang Compiler for\nWindows* in the Visual Studio Installer. The 26.51 build needs LLVM 22 or newer; the clang that\nships with Visual Studio is too old for its headers.\n\n```bash\nxmake f -p windows -a x64 -m release -y\nxmake\n```\n\nThis builds against LeviLamina **26.20.x** by default. For the **26.10.x** or **26.51.x** line,\npass the version explicitly:\n\n```bash\nxmake f -p windows -a x64 -m release --levilamina_version=26.10 -y\nxmake\n```\n\n```bash\nxmake f -p windows -a x64 -m release --levilamina_version=26.51 -y\nxmake\n```\n\nThe packed mod ends up in `bin/`.\n\n> **The compiler is not a free choice.** `xmake.lua` picks it from the target version, and it has\n> to: LeviLamina's event ids are a hash of a type name the *compiler* produces, and the event\n> classes live in an inline namespace that MSVC and clang spell differently. 26.20 and 26.51 are\n> built with clang and 26.10 with MSVC, so a mod compiled with the other one registers its\n> listeners under ids that nothing ever emits — it loads, reports no error, and then quietly does\n> nothing.\n\n## License\n\nSee [LICENSE](LICENSE).\n"}],"gallery":[],"versions":[{"version":"0.5.0","prerelease":false,"released":"2026-09-25T06:35:59Z","releaseUrl":"https://github.com/Unny984/Zoomidy/releases/tag/v0.5.0","manifestUrl":"https://github.com/Unny984/Zoomidy/blob/v0.5.0/tooth.json","info":{"name":"Zoomidy","description":"Zoomify-style smooth zoom for Minecraft Bedrock Edition","tags":["platform:levilamina","type:mod"]},"variants":{"client":[{"side":"client","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina#client":"26.20.*"}}],"client_26_10":[{"side":"client","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina#client":"26.10.*"}}],"client_26_51":[{"side":"client","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina#client":"26.51.*"}}]}},{"version":"0.3.1","prerelease":false,"released":"2026-08-21T13:04:19Z","releaseUrl":"https://github.com/Unny984/Zoomidy/releases/tag/v0.3.1","manifestUrl":"https://github.com/Unny984/Zoomidy/blob/v0.3.1/tooth.json","info":{"name":"Zoomidy","description":"Zoomify-style smooth zoom for Minecraft Bedrock Edition","tags":["platform:levilamina","type:mod"]},"variants":{"client":[{"side":"client","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina#client":"26.20.*"}}]}}],"dependencies":{"github.com/liteldev/levilamina":{"id":"github.com/LiteLDev/LeviLamina","name":"LeviLamina","owner":"LiteLDev","url":"https://levimc.org/mods/github.com/LiteLDev/LeviLamina/"}},"requiredBy":[]}