Cartouche — The Message Box Drawn As An Object, for RPG Maker MZ

RPG Maker MZ replaces your dialogue with a blue rectangle. Cartouche replaces it with an object — a made thing, with a material, a worked frame, cut corners, rim treatments and a nameplate struck into its head rail. It builds a different one for every speaker in your game, and it draws all of it at run time.

There is no image file in this package. No PNG, no atlas, no windowskin. Every mark you see is geometry, so it is exact at any size and it restyles from the corpus rather than from a sprite sheet.

It reads your game. You configure nothing.

Drop five files in, switch them on, and every Show Text command already in your project draws a Cartouche. There is no per-speaker authoring step and no setup scene.

• The face sheet decides the tradition. 5 of them — the company, the commons, the adversary, the wild and the numinous — and each one owns its own materials, frame constructions, corners and rim work. A goblin cannot draw a temple spirit's glass.
• Standing decides how much work the object carries. 5 ranks, read from a raised level, a nickname you wrote, or an enemy's gold — and deliberately not from the defaults Kadokawa ships, because those are statements about nothing.
• The individual decides the rest — the ground, the tint, the caret — and only where that freedom means nothing.

What is in it

40 materials	measured at 30 distinct surface structures, not 40 tints of one
18 surface figures	cleaved slate, conchoidal obsidian, planished iron, the Widmanstätten lattice of meteoric star iron, nacre growth arcs, woven rush, hoarfrost needles, figured walnut, tooled hide, banded horn
28 frame constructions	plank, pegged, battened, strapped, riveted, spliced, lashed, antlered, waterworn, tracery, aureoled…
26 corner treatments	all distinct — and the corner is the statement of standing
30 rim treatments	all distinct
35 nameplates	in five letterings: painted, struck, incised, gilt, chalk
15 carets	all distinct

Legibility is treated as a gate, not a preference

This plugin replaces the surface your player reads for an entire game, and a beautiful box that is tiring to read is worse than the stock one. So no ink anywhere is a hard-coded colour: every one is solved against the surface it will actually sit on, at that surface's worst excursion under its own texture.

Measured across all 160 reachable material and ground pairs, the dialogue clears WCAG AAA (7:1). Across all 280 reachable material and nameplate pairs, the name achieves the full contrast its surface allows. A villain's pale hand on a dark ground and a villager's dark hand on pale board come out of the same solver.

The name is struck into the frame

RPG Maker opens a second blue window over your box to hold the speaker's name. Cartouche removes it and cuts the name into the head rail as a plate the object itself carries. It also removes the engine's pause sign, which is drawn on the window frame — outside the object entirely — and draws an advance caret belonging to the speaker's own set.

Performance, measured in the engine

• update half 0.094 ms mean / 0.4 ms p99, against budgets of 2 ms and 4 ms
• 8 draw calls per frame, 0 texture uploads, 0 bitmap dirties, 0 window refreshes
• display objects 361, growth 0 — the box is drawn once when the speaker changes, not per frame
• 0 page errors across 1,800 measured frames

Cartouche stores nothing in your save file. Remove the plugin and your saves still load.

Two plugin commands

setSpeaker overrides the tradition, the standing or the whole identity for the next messages; clearSpeaker gives it back. For a disguised character, a possessed one, or a narrator with no face.

---

⚠️ Compatibility — the question you actually have

Tested against RPG Maker MZ with the stock scripts unmodified, verified by running the plugin in the real engine rather than only in tests.

Plugin Manager order:

1. CartoucheReading.js — Cartouche [1/5] — reads a speaker into a box specification. The classifier: who is talking, and therefore what their message box is made of.
2. CartoucheCorpus.js — Cartouche [2/5] — what every id in the vocabulary LOOKS like. Data only: colours, surfaces, pitches and form selectors.
3. CartoucheRender.js — Cartouche [3/5] — the drawing primitives. Colour solving, relief, and the pitch-to-count derivation every band depends on.
4. CartoucheBox.js — Cartouche [4/5] — composition. Turns one speaker's BoxSpec into a drawn object: field, rails, bands, corners, nameplate and caret.
5. Cartouche.js — Cartouche [5/5] - the message box drawn as an object, and a different object for every speaker.

This order reads sensibly in the list and nothing depends on it. Every file resolves its siblings the first time it needs them rather than when it loads, so Cartouche works in whatever order the Plugin Manager gives you. That is tested rather than hoped for: the headless suite, the store-plate renderer, the capture pipeline and the in-engine verification all load the five files alphabetically — which puts the entry file Cartouche.js first, before the four it reads, composes and draws with — and the in-engine run asserts all five resolved anyway. Cartouche.js is the only one that touches RPG Maker at all; the other four are a classifier, a corpus, a set of drawing primitives and a compositor, and none of them knows the engine exists. Switch Cartouche.js off and nothing is patched.

Core methods extended — all 7 by saved-original prototype extension, none replaced: Scene_Message.prototype.messageWindowRect, Window_Message.prototype.initialize, Window_Message.prototype.update, Window_Message.prototype.drawMessageFace, Window_NameBox.prototype.updatePlacement, Window_Message.prototype.newLineX, Window_Message.prototype.newPage.

Because nothing is clobbered, Cartouche co-exists with other plugins that patch the same seams, including large suites.

---

More from Core Systems Asset Factory for RPG Maker MZ: Escutcheon — a HUD that looks made, not built · Frontispiece — a title screen drawn from your own database · Colophon — save files as pages of a book.

AI disclosure: the code and the generated graphics in this product are AI-authored. It ships no audio and no in-game narrative.