Diorama 2.5D for RPG Maker MZ

Your maps, rebuilt as living 2.5D dioramas.
Diorama 2.5D takes the maps you already made in RPG Maker MZ and renders them as lit, tilt-shift 3D scenes, with real walls, roofs, shadows and depth of field. Your characters stay as crisp pixel sprites standing in the world. One plugin file. No code, no new tilesets, no editor changes.

Drop it in and press Playtest
Diorama 2.5D reads your tilesets, passability and autotiles to build each map automatically. Walls rise, roof tiles become pitched roofs, water sinks below the shore, and props like cups, books and bottles stand up as cutout cards that sit properly on your tables and counters. It works with the default RTP art and your own tilesets alike.

What's in the box

• Automatic 3D map building from your existing MZ maps: walls, roofs, cliffs, counters, water and props
• Dynamic lighting: sun shadows, up to 10 point lights for lamps, torches and candles, flicker, and a player lantern
• Camera: tilt-shift depth of field, smooth follow, orbit, zoom and focus commands
• 8 looks (Day, Storybook, Dusk, Night, Indoor, Dungeon, Overworld, Flat) with bloom, colour grading and split toning; blend between them in real time
• Cutaway walls that dither away when the player walks behind them
• 3D weather and particles: MZ's rain, storm and snow, plus fireflies, dust, embers, leaves, petals and sparkles
• The Reveal: a plugin command (or map tag) that unfolds the flat 2D map into the 2.5D diorama on screen, perfect for intros and title moments
• 3D battles: front and side view battles with your battlebacks staged in depth
• Live F7 editor in playtest: tune camera, look, lights and heights with sliders, then copy the notetags or save straight to your project
• Quality settings (Low, Medium, High, Ultra) plus dynamic resolution, and a "3D Quality" entry in the Options menu for players
• Per-map control: every map is 2.5D by default, tag a map to keep it 2D (or flip the default), and switch between 2D and 2.5D mid-game

Built to play nicely with MZ
Menus, message windows, battles, Effekseer animations, screen tints, flashes, fades, saves and transfers all work as normal. The plugin renders inside MZ's own WebGL context, so there's no second canvas and no extra window.

Plugin commands
Camera (Set, Orbit, Focus, Reset) · Look (Set, Adjust, Reset) · Reveal · Particles · Event Light · Player Lantern · Depth of Field · Toggle 3D · Set Quality

Notetags
Map notes: look, camera, sun, fog, bloom and grading, wall and roof shapes, region heights, glowing tiles, particles and the reveal. Event notes: lights, glow, flat, wall-hung, height, scale and shadow. Every tag is listed in the plugin's help, and the F7 editor writes them for you.

Requirements

• RPG Maker MZ 1.7 or newer
• Runs on Windows, Mac and web (browser) deployments; a WebGL 2 capable GPU is recommended
• Mobile deployments: use the Low or Medium quality setting

What you get

• Diorama25D.js (a single plugin file, nothing else to install)
• Five demo maps, including the village and tavern from the trailer, built only from the default RTP
• Full documentation inside the plugin's help panel

Terms of use
Use in commercial and non-commercial RPG Maker MZ games. Credit is appreciated but not required ("Diorama 2.5D by RPG_Maker_Plugins on itch.io"). Don't resell or redistribute the plugin file itself.

Support
Found a bug or have a compatibility question? Leave a comment on this page with your MZ version and the plugins you use, and I'll take a look.