Skip to content

Repository files navigation

Lens Banner

Lens

A lightweight, configurable zoom mod for Minecraft Forge.

Smooth • Lightweight • Client-side • Open Source


Demo

▶ Watch Demo


Features

Lens focuses on one thing—providing a clean and polished zoom experience.

  • Smooth zoom animation
  • Mouse wheel zoom adjustment
  • Adjustable zoom level
  • Fully configurable
  • Automatic mouse sensitivity scaling
  • Optional zoom HUD
  • Lightweight and optimized
  • No additional dependencies

Compatibility

Minecraft Loader Side
1.20.1 Forge 47.x Client

Lens is a client-side mod.

It works on multiplayer servers without requiring the server to install the mod.


Configuration

Configuration file:

.minecraft/config/lens-client.toml
Setting Description
Default Zoom Initial zoom level
Minimum Zoom Lowest allowed zoom
Maximum Zoom Highest allowed zoom
Zoom Step Mouse wheel adjustment step
Smooth Zoom Speed Animation speed
Sensitivity Multiplier Mouse sensitivity while zooming
Enable Smooth Zoom Enables smooth zoom animation
Reduce Mouse Sensitivity Reduces mouse sensitivity
Automatic Sensitivity Automatically scales sensitivity
Show Zoom HUD Displays the current zoom level

Configuration GUI mods such as Configured or Catalogue automatically display localized option names.


Controls

Action Default
Zoom C

The keybinding can be changed in Minecraft's Controls menu.


Screenshots


Philosophy

Lens is intentionally small.

Instead of adding dozens of rarely used features, the goal is to provide:

  • predictable behavior
  • smooth animation
  • excellent performance
  • vanilla-friendly design
  • clean codebase

Simple mods are easier to maintain, easier to use, and often provide a better overall experience.


Localization

Currently available:

  • 🇺🇸 English
  • 🇷🇺 Russian

Contributions for additional languages are always welcome.


Contributing

Bug reports, feature suggestions, and pull requests are welcome.

If you discover an issue, please open an Issue with clear reproduction steps.


License

This project is licensed under the MIT License.

See the LICENSE file for details.


Made with ❤️ for the Minecraft Forge community.

About

A lightweight client-side zoom mod for Minecraft Forge 1.20.1 with smooth animations, adjustable zoom, and customizable controls.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages