IMPORTANT LICENSE NOTICE
By using this project in any form, you hereby give your "express assent" for the terms of the license of this project (see LICENSE), and acknowledge that I (the author of this project) have fulfilled my obligation under the license to "make a reasonable effort under the circumstances to obtain the express assent of recipients to the terms of this License".
Zume
An over-engineered simple zoom mod.
This mod adds a keybind which zooms in your FOV while it's held down, allowing you to see further away, and keybinds for increasing and decreasing the zoom level.
FAQ
Q: Where is the config?
A: You'll find the config at .minecraft/global/zume.json5 (note that this is the default .minecraft folder, not
the instance .minecraft). You can modify the file while the game is running, and the config will be automatically
reloaded. On platforms which have mod menus (such as Forge, and Fabric with Mod Menu
installed), the config button for Zume will open this file in your system text editor.
Q: discord where
A: https://discord.gg/6ZjX4mvCMR
Q: What version is this for?
A: Zume supports the following platforms:
- Fabric: Any version supported by Fabric Keybinding API v1 (currently 14.4+)
- NeoForge: 20.4+ (requires NeoForge 20.4.195+)
- LexForge: 14.4 - 20.5 (requires MixinBootstrap before 16.1) (there are currently no plans to support 20.6+)
- Legacy Fabric: Any version supported by Legacy Fabric Keybinding API v1 (currently 7.10 - 12.2)
- Babric (Fabric for Minecraft Beta): Any version supported by Station API (currently b7.3)
- Vintage Forge: 8.9 - 12.2 (requires MixinBooter or UniMixins)
- Archaic Forge: 7.10 (requires UniMixins)
Q: Can you add support for \?
A: Every platform I intend to add support for myself is already supported. PRs are welcome for other platforms if the following conditions are met:
- Must not break single-jar compatibility with any already supported platform (obviously).
- Must not be for a platform that has a 1st-party compatibility layer for an already supported platform - explicit Quilt support will not be accepted so long as Quilt maintains a Fabric compatibility layer; it'd be a waste of CI time. Sinytra Connector is a 3rd-party compatibility layer, so explicit Forge support will be provided.
- Must not manually maintain overridden game options; implementations that look like Mooz's will not be accepted - no offense embeddedt. Direct ASM is fine as long as functionality is similar enough.
- Must make a reasonable effort to be maximize compatibility with existing mods on target platforms - see use of
Neo/LexForge API over mixins in Neo/LexForge implementations, and use of
@WrapWithConditionand@ModifyExpressionValueand such from MixinExtras over@Redirectin most implementations. - Must follow existing format - add a Unimined subproject for each newly supported platform.
- Must not have exclusive features without significant justification - if you're adding a feature, add it to every version.
Q: What kind of weird license is this?
A: OSL-3.0 is the closest equivalent to a LAGPL I could find. AGPL and GPL are incompatible with Minecraft, and LGPL doesn't protect network use. OSL-3.0 protects network use and is compatible with Minecraft.
Q: Why though? It's so strict!!!!
A: This is, and will remain, free, copyleft software. Any requests to change the license other than to make it even stronger will be denied immediately (unfortunately GPL and AGPL aren't compatible with Minecraft due to linking restrictions, as much as I'd like to use them). Even in situations where I use parts of other projects with more "permissive" licenses, I will treat them as copyleft, free software.
License
This project is licensed under OSL-3.0. For more information, see LICENSE.
Need a Minecraft server? Consider CreeperHost!

All Versions
+ Add Version| Name | Game version | Platforms | Published | Downloads | Actions |
|---|---|---|---|---|---|
|
R
1.2.2
|
1d ago | 1 | |||
|
R
1.2.1
|
1d ago | 1 | |||
|
R
1.2.0
|
1d ago | 1 | |||
|
R
1.1.4
|
1d ago | 1 | |||
|
R
1.1.3
|
1d ago | 1 | |||
|
R
1.1.2
|
1d ago | 1 | |||
|
R
1.1.1
|
1d ago | 1 | |||
|
R
1.1.0
|
1d ago | 1 | |||
|
R
1.0.0
|
1d ago | 1 | |||
|
R
0.19.1
|
1d ago | 1 | |||
|
R
0.19.0
|
1d ago | 1 | |||
|
R
0.18.1
|
1d ago | 1 | |||
|
R
0.18.0
|
1d ago | 1 | |||
|
R
0.17.0
|
1d ago | 1 | |||
|
R
0.16.0
|
1d ago | 1 | |||
|
R
0.15.1
|
1d ago | 1 | |||
|
R
0.15.0
|
1d ago | 1 | |||
|
R
0.14.0
|
1d ago | 1 | |||
|
R
0.13.2
|
1d ago | 1 | |||
|
R
0.13.1
|
1d ago | 1 | |||
|
R
0.13.0
|
1d ago | 1 | |||
|
R
0.12.1
|
1d ago | 1 | |||
|
R
0.12.0
|
1d ago | 1 | |||
|
R
0.11.1
|
1d ago | 1 | |||
|
R
0.11.0
|
1d ago | 1 | |||
|
R
0.10.0
|
1d ago | 1 | |||
|
R
0.9.0
|
1d ago | 1 | |||
|
R
0.8.0
|
1d ago | 1 | |||
|
R
0.7.0
|
1d ago | 1 | |||
|
R
0.6.0
|
1d ago | 1 | |||
|
R
0.5.0
|
1d ago | 1 | |||
|
R
0.4.1
|
1d ago | 1 | |||
|
R
0.4.0
|
1d ago | 1 | |||
|
R
0.3.0
|
1d ago | 1 | |||
|
R
0.2.0
|
1d ago | 1 | |||
|
R
0.1.1
|
1d ago | 1 | |||
|
R
0.1.0
|
1d ago | 1 |
- fix crash when mods do foolish things like adding camera types -_-
- further improvements to overall system stability and other minor adjustments have been made to enhance the user experience
- fix Fabric 21.11
- further improvements to overall system stability and other minor adjustments have been made to enhance the user experience
- fix config bug
- support 1.21.9+
- further improvements to overall system stability and other minor adjustments have been made to enhance the user experience
- fix config bug
- further improvements to overall system stability and other minor adjustments have been made to enhance the user experience
- fix NeoForge 21.2+
- fix global config folder being created even if override or instance config is used
- further improvements to overall system stability and other minor adjustments have been made to enhance the user experience
- fix 24w33a
- fix Forge 8.9
- further improvements to overall system stability and other minor adjustments have been made to enhance the user experience
- fix NeoForge 21.0.112-beta support
- further improvements to overall system stability and other minor adjustments have been made to enhance the user experience
- added support for Legacy Fabric 6.4 (requires Legacy Fabric API 1.10.2+) (huge thanks to @thecatcore for backporting Legacy Fabric API to 6.4)
- further improvements to overall system stability and other minor adjustments have been made to enhance the user experience
- added Embeddium config screen integration on LexForge 20.1, Fabric 20.1-20.6, and NeoForge 20.1 and 21+
- applied more aggressive jar size reduction techniques (@rhysdh540)
- wrote much smaller custom config serializer from scratch to replace Jankson
- obfuscate/shrink more class and member names
- reduced jar size impact of mixins
- fixed Fabric and NeoForge 21 compatibility
- dropped LexForge 20.6+
- further improvements to overall system stability and other minor adjustments have been made to enhance the user experience
- further improvements to overall system stability and other minor adjustments have been made to enhance the user experience
- fixed crash on NeoForge 20.5+
- created APIs for 3rd-party integrations with Zume (other mods that integrate with Zume should only use these API classes from now on)
- compressed JAR even more (@rhysdh540 is a mad man)
- added ProGuard optimization & obfuscation to further reduce JAR size (with much help from @rhysdh540 and @embeddedt)
- publish releases to maven (thanks @jaredlll08)
- many internal refactors
- further improvements to overall system stability and other minor adjustments have been made to enhance the user experience
- added support for NeoForge 20.5+
- made missing dependencies error on Fabric more user-friendly
- improved mod compatibility by using events on LexForge for mc17-mc18.2
- added explicit incompatibility with outdated versions of Embeddium++ which were causing obscure crashes
- further improvements to overall system stability and other minor adjustments have been made to enhance the user experience
- added global config (stored in
.minecraft/global/zume.json5) (overridden by old config file if present) - added config path override (use JVM argument
-Dzume.configPathOverride="path/to/zume.json5") - added
thirdPersonToggleModeconfig option - third-person zoom now uses
defaultZoomconfig value instead of activating at maximum value - easing now uses exponent instead of named methods
- fixed bounce when deactivating third-person zoom
- fixed single-frame flicker when deactivating zoom
- fixed Vintage Forge implementation bug with some mixin loaders
- fixed bug with third-person zoom in Legacy Fabric & Vintage Forge implementations
- fixed 14.4 and 15.2 compatibility
- streamlined release process
- further improvements to overall system stability and other minor adjustments have been made to enhance the user experience
- refactored easing (again)
- added easing to third-person zoom
- buffed JAR compression
- made
defaultZoomconfig value more intuitive (0.7is now 70% zoom, not 30% zoom) - Zume should do nothing on servers now (hopefully)
- performed Herobrine summoning ritual (thanks @basdxz)
- further improvements to overall system stability and other minor adjustments have been made to enhance the user experience
- added third-person zoom (zoom behaviour will be different in third-person)
- bumped minimum NeoForge version for NeoZume to 20.4.195
- fixed Mod Menu config bug on Fabric 16.5
- user no longer needs to press escape after opening config from Mod Menu on Fabric 14.4
- further improvements to overall system stability and other minor adjustments have been made to enhance the user experience
- fixed Mod Menu integration on Fabric 20.3+
- fixed
NullPointerExceptionon Archaic Forge mod incompatibility screen - release JARs are now properly compressed (thanks @rdh)
- further improvements to overall system stability and other minor adjustments have been made to enhance the user experience
- improved compatibility on Fabric implementations with other mods hooking mouse scrolling
- de-duplicated some logic
- bumped Fabric Loader version
- removed
maxFOVconfig option (this hasn't really had much of an effect for several versions now, and it causes bugs on lower FOV values) - further improvements to overall system stability and other minor adjustments have been made to enhance the user experience
- fixed obscure bug
- added config modification API (should enable other mods to make a proper config screen for Zume)
- added disable option (for modpacks containing mods that JiJ Zume)
- made Zume not cause a crash if used on servers (to be clear, there is no reason to use Zume on a server, and absolutely no support will ever be provided for bugs caused by using Zume on a server)
- further improvements to overall system stability and other minor adjustments have been made to enhance the user experience
- fixed localization issue on Vintage Forge
- made jar smaller (thanks @rdh)
- fixed zoom scrolling on LexForge 20.2+
- made config buttons work on applicable platforms (Modern Fabric w/ Mod Menu + Neo/LexForge)
- fixed Zoom key still applying while screens (such as inventory) are open
- further improvements to overall system stability and other minor adjustments have been made to enhance the user experience
- icon should work on Lex/NeoForge implementations now
- added capability for platform-specific jars (for JiJ support)
- removed Herobrine (I only have myself to blame this time)
- did a lot of internal refactors
- added
toggleModeconfig option - when enabled, the Zoom keybind will act as a toggle (disabled by default) - removed Herobrine (fixed Windows config reloading for the 12th time - maybe this time it will actually work?) (big
- removed all mixins from NeoZume (thanks @embeddedt)
- dropped 20.2 NeoForge support (sorry, was necessary for above)
- actually fixed Windows config reloading issue (hopefully)
- replace several mixins with events on LexForge & NeoForge implementations
- add zoom out animation when zoom key is released
- sync mod manifests
- migrate to Kotlin buildscript (I hate Kotlin but I hate Groovy more)
- migrate to Unimined (adding new platforms should be way easier now)
- add support for LexForge 14.4+ (this required 3 separate implementations :harold:)
- add support for NeoForge 20.1+
- remove hard dependency on MixinBooter in Vintage Forge; Zume just verifies that mixins get loaded now, it doesn't
- fixed config reloading issues on Windows
- add support for legacy forge (7.10 - 12.2)
- fix compat with 23w51b+
- add support for b7.3 via Babric & 7.10 - 12.2 via Legacy Fabric
- update Fabric Loader to 0.15.0
- remove JiJ'd MixinExtras (the jar is now way smaller)
- now use quadratic easing for animations (can be disabled in config)
- the
resetOnPressconfig option has been removed. if you used it and want it back please yell at me about it but unless someone actually wants it its annoying to keep around - some default config options have been tweaked for new easing so double check your config options after updating