CinematicZoom (NeoForge Port)
A lightweight client-side mod that adds smooth cinematic zoom with optional black bars, HUD hiding, and smooth camera movement – perfect for screenshots, videos, or a more immersive gameplay experience.

Features
- 🎬 Cinematic Zoom (default key:
C) - 📏 Adjustable black bars
- 🖱️ Mouse wheel zoom control
- ⚙️ Fully configurable via NeoForge settings
- 👻 Optional HUD and crosshair hide during zoom
- 🎥 Smooth camera movement
- 🚀 Client-side only – works on any server
Support & Info
For more details, source code, and updates:
GitHub Repository
All Versions
+ Add Version- Minecraft / Mappings:** Updated target to
Minecraft 1.21.1, Parchment mappings2024.11.17, and NeoForge21.1.215. - Branch:** Added branch
1.21.1for the backport. - Keybinding:** Replaced
KeyMapping.Categoryusage with a string category key to match the 1.21.1 API. - Mod Metadata:** Added required loader fields to
src/main/templates/META-INF/neoforge.mods.toml(modLoaderandloaderVersion). - Mixin (FOV):** Adjusted
GameRendererMixinto match the runtimeGameRenderer#getFov(Camera, float, boolean)signature (returnsdouble). - Crash Fix:** Removed the float-return injection that caused a Double→Float ClassCastException; now uses the Double-return injection matching the runtime descriptor.
- Build & Test:** Rebuilt successfully and ran the dev client to verify startup without the previous ClassCastException.
Notes:
- These changes are limited to the backport; API differences between 1.21.10 and 1.21.1 were handled with minimal, targeted edits.
### Added
- Initial NeoForge port of CinematicZoom for Minecraft 1.21.10
- Smooth cinematic zoom with customizable black bars
- Mouse wheel control for dynamic zoom adjustment
- Configurable settings via NeoForge config screen
- Optional HUD hiding during zoom
- Optional cinematic camera mode during zoom
- Full compatibility with NeoForge 21.10.49+
### Changed
- Ported from Fabric to NeoForge mod loader
- Migrated config system from JSON to NeoForge's ModConfigSpec (TOML)
- Updated keybinding registration to use NeoForge's RegisterKeyMappingsEvent
- Updated client tick handling to use PlayerTickEvent.Post
- Updated all Minecraft API calls to NeoForge mappings
### Technical Details
- Package:
de.smallinger.cinematiczoom - Mixins: GameRendererMixin, MouseMixin, InGameHudMixin
- Config type: CLIENT (stored in config/cinematiczoom-client.toml)
- Requires Java 21
## Original Fabric Version
This is a port of the original [CinematicZoom for Fabric](https://github.com/mel1x/CinematicZoom) by Mel1x.
For the Fabric version changelog, please visit the original repository.
## Credits
- Original Mod**: Mel1x - [CinematicZoom for Fabric](https://github.com/mel1x/CinematicZoom)
- NeoForge Port**: [Smallinger](https://github.com/Smallinger/CinematicZoom)
- License**: MIT