ED5 Camera Zoom Plugin
A downloadable asset pack
🎮 ED5 Scroll Wheel Zoom v2.0
Professional map zoom system for RPG Maker MV & MZ
Smooth, customizable, and pixel-perfect
🌟 Features
Core Functionality
- ✨ Mouse Scroll Wheel Zoom - Zoom in and out with your mouse wheel
- ✨ Smooth Transitions - Configurable smooth zoom animations
- ✨ Pixel-Perfect Click Detection - Accurate click-to-move at any zoom level
- ✨ Middle Click Reset - Instantly reset zoom with middle mouse button
- ✨ Keyboard Shortcuts - Configurable reset key (PageDown by default)
Advanced Controls
- 🎛️ Toggle System - Enable/disable zoom with plugin commands, switches, or scripts
- 🎛️ Map-Specific Settings - Per-map zoom limits and defaults via notetags
- 🎛️ Runtime Control - Change zoom programmatically during gameplay
- 🎛️ Save Compatibility - Zoom settings persist through save/load
Compatibility
- ✅ MV & MZ Compatible - Works on both RPG Maker MV and MZ automatically
- ✅ Plugin-Friendly - Compatible with most other plugins
- ✅ Performance Optimized - Minimal CPU usage, smooth even on low-end devices
- ✅ Mobile Ready - Touch controls supported
📦 Installation
For RPG Maker MZ:
- Download
ED5_ScrollWheelZoom.js
- Copy to
js/plugins/
folder - Open Plugin Manager in RPG Maker MZ
- Add the plugin and enable it
- Configure parameters (optional)
- Save your project
For RPG Maker MV:
- Download
ED5_ScrollWheelZoom.js
- Copy to
js/plugins/
folder - Open Plugin Manager in RPG Maker MV
- Add the plugin and enable it
- Configure parameters (optional)
- Save your project
That's it! The plugin works automatically with sensible defaults.
🎮 How to Use
Basic Usage
Once installed, the zoom feature is active by default:
Action | Result |
---|---|
Scroll Up | Zoom In |
Scroll Down | Zoom Out |
Middle Click | Reset to Default Zoom |
PageDown Key | Reset to Default Zoom |
That's all you need to know to start using it!
⚙️ Plugin Parameters
General Settings
Parameter | Default | Description |
---|---|---|
Enabled By Default | true |
Whether zoom is enabled when game starts |
Enable Switch | 0 (None) |
Game switch to control zoom enable/disable |
Debug Mode | false |
Show debug logs in console (F8) |
Zoom Settings
Parameter | Default | Description |
---|---|---|
Default Zoom | 1.0 |
Default zoom level (1.0 = normal) |
Max Zoom | 3.0 |
Maximum zoom level (higher = more zoomed in) |
Min Zoom | 0.3 |
Minimum zoom level (lower = more zoomed out) |
Zoom Speed | 0.1 |
How much each scroll changes zoom |
Default Zoom: 1.0 Min Zoom: 0.5 Max Zoom: 2.0 Zoom Speed: 0.1 Smooth Zoom: true Smooth Speed: 0.15
🎯 Plugin Commands
RPG Maker MZ (GUI Commands)
Use the plugin command interface:
◆Plugin Command: ED5_ScrollWheelZoom → Enable ZoomDisable Zoom
◆Plugin Command: ED5_ScrollWheelZoom → Disable ZoomToggle Zoom
◆Plugin Command: ED5_ScrollWheelZoom → Toggle ZoomSet Zoom Level
◆Plugin Command: ED5_ScrollWheelZoom → Set Zoom Level └─ Zoom Level: 1.5Reset Zoom
◆Plugin Command: ED5_ScrollWheelZoom → Reset Zoom
RPG Maker MV (Text Commands)
Type these directly in the plugin command box:
EnableZoom DisableZoom ToggleZoom SetZoom 1.5 ResetZoom
💻 Script Calls
Use these in Script event commands (works in both MV & MZ):
Enable/Disable Zoom
$gameSystem.setZoomEnabled(true); // Enable zoom $gameSystem.setZoomEnabled(false); // Disable zoom
Set Zoom Level
$gameSystem.setZoomLevel(1.5); // Set to 1.5x zoom $gameSystem.setZoomLevel(2.0); // Set to 2.0x zoom $gameSystem.setZoomLevel(0.5); // Set to 0.5x zoom (zoomed out)
Get Current Zoom Level
const zoom = $gameSystem.zoomLevel(); console.log("Current zoom: " + zoom);
Reset Zoom
$gameSystem.resetZoom(); // Reset to default zoom
🗺️ Map Notetags
Control zoom behavior per-map using these notetags in the map's note field:
Notetag | Description |
---|---|
<ZoomMin:0.5> |
Sets minimum zoom for this map (0.5 = can zoom out to 50%) |
<ZoomMax:2.0> |
Sets maximum zoom for this map (2.0 = can zoom in to 200%) |
<ZoomDefault:1.5> |
Sets default zoom when entering this map (1.5 = starts at 150%) |
<DisableZoom> |
Completely disables zoom on this map |
<ZoomMin:0.8> <ZoomMax:1.5> <ZoomDefault:1.0>
This creates a map with:
• Minimum zoom: 0.8x (can zoom out to 80%)
• Maximum zoom: 1.5x (can zoom in to 150%)
• Default zoom: 1.0x (normal zoom on entry)
🎬 Common Use Cases
1. Cutscene with Fixed Zoom
◆Plugin Command: DisableZoom ◆Plugin Command: SetZoom 0.5 ◆Text: Welcome to our village! ◆[Show panoramic view of village] ◆Wait: 120 frames ◆Plugin Command: ResetZoom ◆Plugin Command: EnableZoom
2. Battle Arena Zoom Out
◆Transfer Player: [Battle Arena Map] ◆Plugin Command: SetZoom 0.7 ◆Text: The arena expands before you...
3. Secret Room Zoom In
◆Transfer Player: [Secret Room] ◆Plugin Command: SetZoom 1.5 ◆Text: You notice intricate details on the walls...
4. Investigation Mode
◆Plugin Command: EnableZoom ◆Text: Investigation Mode Active! ◆Text: Use scroll wheel to zoom in and examine clues. ◆[Player investigates] ◆Plugin Command: DisableZoom ◆Plugin Command: ResetZoom
🎓 Tips & Best Practices
Recommended Zoom Ranges
Map Type | Min | Max | Default |
---|---|---|---|
Small Indoor | 0.8 | 2.0 | 1.2 |
Large Outdoor | 0.5 | 1.5 | 1.0 |
Battle Map | 0.6 | 1.2 | 0.8 |
Puzzle Room | 1.0 | 2.5 | 1.5 |
World Map | 0.3 | 1.0 | 0.5 |
Design Considerations
- Don't force extreme zoom in cutscenes (uncomfortable)
- Give players control - don't disable zoom unnecessarily
- Use map notetags to set appropriate limits
- Test click-to-move at various zoom levels
- Consider zoom in puzzle design (hide/reveal clues)
📜 Changelog
v2.0.2 (October 11, 2025) - Latest
- Fixed click-to-move accuracy on small maps when zoomed in
- Fixed clicks near map edges being offset by several tiles
- Improved coordinate transformation to account for camera clamping
- Fixed initialization error when game starts (scrollType null error)
- Pixel-perfect click detection at any zoom level
- Proper handling of zoom center on small maps
- Better display offset calculation
- Enhanced safety checks for map loading
v2.0.1 (October 11, 2025)
- Fixed
TypeError: Cannot read property 'scrollType' of null
on game start - Added safety checks for map data loading
- Fixed
clearZoom
being called before map initialization
v2.0.0 (October 11, 2025)
- Complete rewrite from v1.0
- Added RPG Maker MV compatibility (now supports both MV & MZ!)
- Added toggle system (3 methods: plugin commands, script calls, switches)
- Added smooth zoom transitions with configurable speed
- Added map-specific notetag support
- MZ Plugin Commands:
EnableZoom
,DisableZoom
,ToggleZoom
,SetZoom
,ResetZoom
- MV Plugin Commands: Text-based uppercase commands
- Map Notetags:
<ZoomMin>
,<ZoomMax>
,<ZoomDefault>
,<DisableZoom>
- Enable Switch parameter for easy on/off control
- Debug mode with detailed logging
- Save/load compatibility
- Fixed
currentZoom = currentZoom
no-op bug - Fixed missing TouchInput event handlers
- Fixed direct property access issues
- Fixed uninitialized values on startup
- Fixed zoom state not persisting through save/load
📊 Version Comparison
Feature | v1.0 | v2.0.2 |
---|---|---|
MZ Support | ✅ | ✅ |
MV Support | ❌ | ✅ |
Plugin Commands | ❌ | ✅ |
Map Notetags | ❌ | ✅ |
Toggle System | ❌ | ✅ |
Smooth Zoom | ❌ | ✅ |
Click Accuracy | ⚠️ Basic | ✅ Pixel-Perfect |
Save Compatible | ❌ | ✅ |
Bug Fixes | - | ✅ 7+ Fixed |
🎁 Support the Developer
If you enjoy this plugin and want to support future development:
- ⭐ Leave a rating on itch.io
- 💬 Share feedback in the comments
- 🐦 Spread the word on social media
- ☕ Buy me a coffee on Patreon
- 🎮 Show off your game using this plugin!
💖 Your support helps me create more awesome tools for the RPG Maker community!
📞 Contact & Support
Author: ED5 (CHIGOOX)
Version: 2.0.2
Release Date: October 11, 2025
License: Free for commercial and non-commercial use
Need Help?
- 📖 Read the documentation above
- 💬 Leave a comment on itch.io
- 🐛 Report bugs with detailed info
- 💡 Suggest features for future versions
Credits:
If you use this plugin, please credit:
ED5 Scroll Wheel Zoom by ED5 (CHIGOOX)
📝 License
Free to use in commercial and non-commercial projects.
✅ Allowed:
- Use in free games
- Use in commercial games
- Modify for personal use
- Include in game compilations
❌ Not Allowed:
- Redistribute as your own
- Sell the plugin separately
- Remove author credits
🚀 Quick Start Guide
Get Started in 3 Steps:
• Copy to js/plugins/
• Enable in Plugin Manager
• Start game
• Scroll mouse wheel
• See zoom in action!
• Adjust parameters in Plugin Manager
• Add map notetags for special maps
• Create events with plugin commands
That's it! You're ready to zoom! 🎮✨
🎯 Perfect For:
Let players zoom to see more or focus on details
Zoom in to examine clues
Zoom out to see full room layouts
Dynamic view distance
Hide/reveal solutions with zoom
Cinematic zoom effects in cutscenes
Better battlefield overview
Let players appreciate detailed sprites
⚡ Feature Highlights
🎊 Thank You!
Thank you for using ED5 Scroll Wheel Zoom!
I hope it enhances your game and brings joy to your players! 🎮💙
Happy Game Making! ✨
ED5 Scroll Wheel Zoom v2.0.2
Professional map zoom for RPG Maker MV & MZ
RPG Maker MV | MZ
Updated | 6 days ago |
Status | Released |
Category | Assets |
Author | ChigooX |
Tags | RPG Maker MZ, sourcecode |
Download
Click download now to get access to the following files:
Development log
- ED5 Camera Zoom 2.0 Major Update10 days ago
Comments
Log in with itch.io to leave a comment.
Is there any preview video of the actual effect?
I’ll be releasing it soon! I had a free version I guess it got replaced let me see
version 1.0 is free but 2.0 is a lot better!
Hello! Is it possible to add a Zoom on/off switch? If not, would it be possible to put this in the plugin?
added!
Off-Screen Event Management: Prevents off-screen events from running, optimizing game performance and focusing on the visible gameplay area.
I like this description, no doubt it will help save performance on large maps. However I saw you talking about "skyrim" and I found "Ocram-NPC-Schedule" which allows NPCs to have their own daily routines like in Skyrim. Anyway I wonder if there is a way to coexist.
do you permit this for commercial use?
yep, us as you want! I’ll be updating soon so you can turn off the effects mainly for cut scenes and stuff like that !
is there a reason why you allow the minimum map zoom to be set less than 1.0? it seems like all it does is break the map
no reason at all. At one point I was using it to test enemy spawn to see where they were spawning outside the screen. Me personally I think 1 is even too zoomed out.
could i possibly pay you to port this to MV?
sure, lol. Not a problem