Debug Commands

These commands are intended for troubleshooting and advanced tuning. Most server operators will never need them. All debug commands require the mosaikin.admin permission.

/mosaikin debug <subcommand>

---

debug center

/mosaikin debug center
/mosaikin debug center <x> <y> <z>
/mosaikin debug center reset
/mosaikin debug center none

Adjusts the cube-center compensation offset — a small positional correction applied to each head entity to account for Minecraft's internal head rendering geometry.

If walls appear to have a consistent staircase misalignment after a Minecraft update, this command lets you tune the offset without restarting. The correction is re-applied to all spawned walls immediately after each change.

Sub-argument	Effect
(none)	Print the current compensation value
<x> <y> <z>	Set a custom offset (floating-point)
reset	Restore the compiled-in default
none	Disable compensation entirely (equivalent to 0, 0, 0)

---

debug face

/mosaikin debug face
/mosaikin debug face <face>
/mosaikin debug face <face> <xDeg> <yDeg> <zDeg>
/mosaikin debug face <face> reset
/mosaikin debug face reset

Overrides the per-face rotation for one or all cube faces. Rotations are applied in X → Y → Z order (Euler angles, degrees).

Valid face names: FRONT, BACK, TOP, BOTTOM, LEFT, RIGHT

Sub-argument	Effect
(none)	Print all face rotation values
<face>	Print one face's current rotation
<face> <x> <y> <z>	Set a custom rotation for one face; re-applies to all spawned walls
<face> reset	Restore the compiled-in default for one face
reset	Restore defaults for all faces

Use debug pngtest alongside this command to get a visual reference for which face is which.

---

debug pngtest

/mosaikin debug pngtest

Writes a test image to plugins/Mosaikin/debug-faces.png. The image contains one distinctly colored 8×8 cell per cube face, so you can visually identify which face is which when tuning debug face.

To use it as a wall source after writing:

/mosaikin <name> image file:///path/to/plugins/Mosaikin/debug-faces.png

---

debug tint

/mosaikin debug tint
/mosaikin debug tint off
/mosaikin debug tint <1-8>

Stamps a small colored corner marker onto each face of newly assembled head textures. The color identifies which cube face each region belongs to (FRONT=red, BACK=green, RIGHT=blue, LEFT=yellow, TOP=magenta, BOTTOM=cyan).

The tint size is in pixels (1–8; 8 = full face coverage). Setting off or 0 disables the tint.

Important: The tint only affects textures generated after the command is run. Textures already uploaded to MineSkin cannot be modified. To see the tint on an existing wall, you must destroy and regenerate it.

---

debug depth

/mosaikin debug depth
/mosaikin debug depth on
/mosaikin debug depth off

Controls whether merged-region head entities have a pinned (thin) depth or let their Z scale proportionally with the region span.

Value	Effect
on (default)	Merged heads use uniform depth — all heads sit flush in the wall plane
off	Merged heads scale their depth proportionally — larger merged regions stick out further

Re-applies to all spawned walls immediately.

---

debug inspect

/mosaikin debug inspect <wall> <col> <row>

Dumps detailed internal state for one cell of a wall: lifetime entity references, root chunk data, and the live transformation matrix. Useful for diagnosing rendering anomalies in specific cells.

Argument	Description
<wall>	Wall name
<col>	Grid column (0-based)
<row>	Grid row (0-based)