Portraits

portraits.toml says which picture a gump draws for a creature. A gump cannot draw a mobile, so each body is shown by the art of an item that looks like it. The file may be missing: no creature has a picture then, and a gump leaves the place empty.

[[portrait]]
bodies = ["1", "9"]
item = 8415

[[portrait]]
bodies = ["200-201"]
item = 8479

Field	Meaning
bodies	The body ids the picture is for, as single ids ("200") or inclusive ranges ("200-201"), always quoted
item	The id of the item art to draw, from 1 to 65535

A body may be in one entry only. The loader returns one entry per body, sorted by body id.

Who reads it

• <portrait body="..." /> in a gump file, and g:portrait{ body = ... } in a built gump, draw the picture.
• gump.portrait(body) gives a script the item id, or nil for a body the file does not list.
• The Animal Lore gump shows the picture of the creature under its first page.

Validation at startup

The server stops when:

• an entry is not a number or a "min-max" range, a range starts after its end, or an id is above 65535;
• an item is outside 1 to 65535;
• a body is listed twice.

See also

• Gumps: the portrait element and g:portrait.
• Data files overview: file locations, loading order and shared value formats.