Back to mods
Zoom Button Patch project artwork

Vintage Story Mod DB · Vintage Story mod

Zoom Button Patch

Zoom Button Patch I come across some tricks while working on my Telescope Mod and remembered ZoomButtonReborn had the same issues, so there it is. Progressive improvements and optimizations awaiting to be implemented on the original mod. I will use this mod

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Zoom Button Patch release should I use?

Updated last month
Latest stable file 2.0.0
Game version 1.22.0-pre.1, 1.22.0-pre.2, 1.22.0-pre.3
Loader Built-in Vintage Story mod system

Zoom Button Patch 2.0.0 targets 1.22.0-pre.1, 1.22.0-pre.2, 1.22.0-pre.3. It must be installed on the client. Do not install it on the dedicated server. All 1 required mods have matching files.

Where it goes

Is Zoom Button Patch required on the client, server, or both?

It must be installed on the client. Do not install it on the dedicated server.

Client Required
Dedicated server Not supported
Loader for this release Built-in Vintage Story mod system
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

This Vintage Story file is marked client-only.

What else does Zoom Button Patch 2.0.0 need?

2.0.0. Change the file and its required mods may change too.

All 1 required mods have matching files

Install Zoom Button - Reborn first. We found matching files for this game-version and loader setup.

Zoom Button - Reborn Needed by Zoom Button Patch 2.0.0
required
Matching file found Matched file: 2.0.4

We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add Zoom Button Patch without breaking your instance.

Built for Zoom Button Patch 2.0.0. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 2.0.0. It targets 1.22.0-pre.1, 1.22.0-pre.2, 1.22.0-pre.3; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    Install Zoom Button - Reborn first. We found matching files for this game-version and loader setup.

  3. 03

    Put it on the correct side

    It must be installed on the client. Do not install it on the dedicated server.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 2.0.0. It opens that exact file at the source.

About this project

What does Zoom Button Patch add?

Zoom Button Patch

I come across some tricks while working on my Telescope Mod and remembered ZoomButtonReborn had the same issues, so there it is.

Progressive improvements and optimizations awaiting to be implemented on the original mod.

I will use this mod to test improvements before they are added to the main one.

 Now with online repo and verifiable file integrity! 

What it does

- version 2.0.0

Spoiler!
  • Compatibility: Hooks into third-party `GuiDialog` windows and `IRenderer` HUD overlays across installed mods without requiring manual configuration.

 

- version 1.2.0 & 1.3.0 (merged in zoombuttonreborn 2.0.4)

Spoiler!
  • Even clearer UI: Hides minimap, coordinates hud, hotbar and chat while zooming!

 

- version 1.1.0 (merged in zoombuttonreborn 2.0.4)

Spoiler!
  • Inter-Mod Compatibility: Added a thread-safe Suppression System (StartSuppress / StopSuppress) exposed globally through capi.ObjectCache. Other mods can temporarily lock ZoomButton without hard code dependencies.
  • Also added Live State Exposure (current zoom value).
  • Disconnect Safeguard: Cached original pre-zoom settings on frame 1 of zooming. If the client context unloads or disposes while zoomed in, Dispose() automatically catches the state and force-restores the player's default FOV, sensitivity, smoothing, and hand settings.
  • Performance Optimizations: skips all unnecessary actions when zoom is idle.
  • Edge-Case Coverage: clears vignette and prevents zero-FOV restore on force reset. Better memory management and thread safety.

 

- version 1.0.0 (merged in zoombuttonreborn 2.0.3)

Spoiler!
  • hides player hands when zooming
  • partially resolves FOV bug

Installation

Purely Client side, just as the original mod, which is still required.
I'm actively helping including this fix in the main Mod.

Each patch targets a pecific version.

Compatibility

Confirmed mods:

StatusHudContinued
ExtraInfo
TemporalFatigue

If you find other mods with incompatible GUI or Dialogues let me know on Discord or in the comments.

Known Issues

  • soft-lock then opening the chat while zooming, releasing Z fixes it.
  • FOV glitch when zooming while aiming with a Combat Overhaul Fork ranged weapon. Should not mess with the client configs, just an animations conflict.

 

If for whatever reason the player hands doesn't reappear, this console command will revert them to visible: 

.clientconfig hideFpHands false
As for broken FOV or mouse sensitivity, go to
  • settings > FOV (default should be 70)
  • settings > mouse > sesitivity (default should be 50)

Security & Automated Builds

To guarantee safety and complete transparency:

Automated Cloud Builds: Every release is compiled automatically from open-source code using GitHub Actions in an isolated environment. No local binaries manually uploaded.
Verifiable Integrity: Each release provides an official SHA256 checksum generated directly by the build pipeline to verify file integrity.
Open Source: Anyone can inspect the source code, verify changes, and check the build logs directly on the GitHub page.

Credits

Feedback & Support

For sharing feedback, I have a sub-channel on the Official Discord #mods > Furio's Mods too!

Check out my other mods here

Project description from Vintage Story Mod DB.

Pick your setup

Zoom Button Patch releases for each Vintage Story version.

Choose the version and loader you play, then open the matching release.

23 available setups

Showing the newest 12 of 23 game versions. Older files are in the list below.

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Zoom Button Patch versions and loaders

6 of 6 releases match

Looking for an older file? The official Vintage Story Mod DB project page is in Resources.