[MV] Message Busts

PICO_VNBusts_MV

A complete bust system for RPG Maker MV. Characters that enter with style, react in the moment, change expression mid-sentence, and stay exactly where you put them — all written directly in the dialogue box, alongside the text.

No parallel events. No juggling windows. Just write the scene.

---

How it works

You register your characters once in the Plugin Manager — name, position, expressions, scale. From that point on, a single short command is all it takes to bring someone on screen, shift the focus, or swap their expression mid-line.

The Command Registry takes this further. Store any command sequence under a short ID and call it with \BCT[id]. Your dialogue stays clean and readable, and if you ever need to change how a character enters, you update one place — every scene in your project updates with it.

// Plugin Manager → Command Registry
id: marina        \BPLAY[2, marina, 20, outBack, true, true]
id: marina_react  \BSHIFTCHAR[marina, -12, 0, 14, outBack, false]
// In your event
\BCT[marina]\BFRONT[marina]Marina: Hey! You're finally awake!
\BCT[marina_react]Are you okay?! Breathe! Blink!

---

What's included

• Bust Registry with full expression support — multiple images per character, swappable by name or index
• Command Registry — reusable command shortcuts for fast, clean scene writing
• \BFRONT — brings any character to the foreground by name, handles layers and focus automatically
• Animations — 8 easing curves, animated entrances and exits, bounce reactions, scale effects
• Tone system — 11 built-in presets, flash effects, custom tones via Tone Registry
• All commands by character name — no manual picture ID tracking, even after layer swaps

---

Command reference

\BCT[id]	Execute a registered command sequence inline with dialogue.
\BPLAY[pic, reg, ...]	Animated entrance using a registry entry.
\BSHOW[pic, reg, ...]	Instant display using a registry entry.
\BERASE[ids|all]	Erase one, many or all busts.
\BFRONT[name ...]	Bring characters to front by name. Applies focus automatically.
\BSWAPCHAR[name, expr]	Swap expression by name or index.
\BSHIFTCHAR[name, ...]	Bounce reaction by name. Returns automatically.
\BMOVECHAR[name, ...]	Move relative to current position by name.
\BFOCUS / \BDIM / \BCLEAR	Focus control by picture ID.
\BFLASH[ids, tone, dur]	Flash a tone and fade back to the previous one automatically.
\BTONE[apply, ids, tone]	Apply tone presets to one, many or all pictures.
\BMOVE / \BSHIFT / \BSCALE	Manual movement and scale by picture ID.
\BSWAP[id, file]	Swap image by picture ID, keeping position and tone.
\BREORDER[id id]	Manually swap two pictures between layers.
\BLOAD / \BDEBUG	Preload images. Toggle debug overlay at runtime.

---

Requirements

RPG Maker MV. No other plugins required. Compatible with adult (18+) content projects.

License

May be used in personal and commercial projects, including adult (18+) content.
Do not redistribute the script file without permission.
Do not use in projects that promote hate.