Skip to content

Messages

messages.yml holds the text players see: chat messages, the action bar, the pose sidebar, and the names and hints on GUI buttons.

locked-by: "<red>Locked by {player}"
buttons:
  pose: "Pose"
  pose-hint: "Rotate head, arms, legs, body"
slots:                  # the name an empty slot wears
  head: "Head"
  main-hand: "Main Hand"
pose:
  subtitle: "<white><axis>: <angle>°"
  view: { front: front, back: back, side: side }
  sidebar:              # sidebar rows, top to bottom
    - "<white>{part}"
    - ""
    - "<gray>X <white>{x}°"

Formatting

Where the text shows Colours and formatting
Chat, action bar, sidebar, titles on screen MiniMessage tags, like <red>
Lore on GUI items MiniMessage tags, like <yellow>. A line that names no colour comes out grey
The name on an empty slot (slots, balloon.slot-name) MiniMessage tags. Grey when it names no colour
Every other name on a GUI item Plain text

The shape of a hint

Every hint the menus ship follows one shape: what to press in yellow, a colon, then what it does in grey.

buttons:
  visible-hint: "<yellow>Click:<gray> toggle visibility"
pose:
  reset-hint: "<yellow>Shift + Click:<gray> reset"

The colours are in the text, not in the plugin. Nothing is painted for you because a line happens to have a colon in it, so a hint reads exactly as you write it - change <yellow> to anything you like, or leave the tags out and the whole line is grey.

What a button's name says

Two things ride on a button's name rather than its tooltip, because they change while you are looking at them:

  • buttons.state-on / buttons.state-off land after a toggle's name - Visible ON, Visible OFF - carrying their own colour.
  • A part's angles land after its name on the pose page: Left Arm -15, 0, 0. There are no letters in front of them - each number wears its axis colour from pose.axis, so the colour is the label.
buttons:
  state-on: "<yellow>ON"
  state-off: "<gray>OFF"

BoxStand puts one space between the name and either of them; everything else, punctuation included, is in the text.

Empty slot names

The label on an empty slot is written the same way, and ships light grey:

slots:
  head: "<gray>Head"
  main-hand: "<gray>Main Hand"
balloon:
  slot-name: "<gray>Balloon"

A name a player typed - the model name in the balloon prompt - is never read as MiniMessage. Their words stay words.

Placeholders

Placeholder Replaced with Used in
{player} A player's name locked-by and the bypass messages
{count} How many entities were removed commands.cleanup-done
{bone} The leash-bone name from config.yml balloon.model-name-info
{part} The part being posed Posing action bars, sidebars and pose.part-subtitle
{view}, {axis} Where you stand, and the axis you turn Posing action bars and sidebars
{axis} comes with its colour already on, from pose.axis (X #ff1242, Y #23d400, Z #0894ed)

pose.axis colours the letter everywhere the axis is named: the posing action bar, the sidebar and the subtitle. Change it in one place and all three follow. | {x}, {y}, {z} | The part's current angles | Sidebar rows only. A row that only names {x} or {z} is dropped for a part that cannot turn on them: the whole stand, or the body while pose.body-turn-xz is off | | <axis>, <angle> | The axis and angle | pose.subtitle only |

The sidebar has three versions: pose.sidebar for scroll mode, pose.sidebar-wasd for WASD mode, and pose.sidebar-walk while walking around. To turn the sidebar off, set pose.sidebar: false in config.yml.

Text that lives in other files

Text Where to change it
Menu titles gui.yml
Mannequin names name: in each mannequin file
Preset pose names The pose's key in the mannequin file. pose_1 shows as "Pose 1"