# Minecraft Painting Variant

> Minecraft Painting Variant 画作变体定义：PAINTING_VARIANT 注册表、data/<namespace>/painting_variant/ 数据包路径、tags/painting_variant/ 标签、JSON 格式（width 画作宽度 方块数 1-16、height 画作高度 方块数 1-16、asset_id 画作纹理 assets/<namespace>/textures/painting/<path>.png、title 画作标题文本组件、author 画作作者文本组件）、Definition Behavior 定义行为（服务器启动加载一次、/reload 不重新加载、PAINTING_VARIANT 注册表至少一个元素）、Tooltip 提示信息（显示 painting/variant 组件变体尺寸+作者+标题）。

- Skill: `zmjjkk123-hub/minecraft-painting-variant` (Agent Skill)
- Install (CLI): `npx skillmds@latest add zmjjkk123-hub/minecraft-painting-variant`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zmjjkk123-hub/minecraft-painting-variant/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ZMJJKK123-hub (https://skillmd.com/u/zmjjkk123-hub)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/zmjjkk123-hub/minecraft-painting-variant

---


# Painting Variants

This content applies only to Java Edition.

Painting variants determine a painting's content and dimensions. Definition files are their data-driven definitions in datapacks.

## Definition format

Painting variants use the `PAINTING_VARIANT` registry; the datapack path is `painting_variant` (definitions in `data/<namespace>/painting_variant`, tags in `data/<namespace>/tags/painting_variant`).

Definition files use JSON with the following structure:

- JSON file root object
  - `width` (int, required): (1≤v≤16) painting width in blocks.
  - `height` (int, required): (1≤v≤16) painting height in blocks.
  - `asset_id` (string, required): (namespace ID) painting texture; resolved to `assets/<namespace>/textures/painting/<path>.png`.
  - `title` (string/compound/list): (text component) painting title.
  - `author` (string/compound/list): (text component) painting author.

## Definition behavior

Painting variant data is loaded only once at server startup; `/reload` does not reload it — a server restart is required. The `PAINTING_VARIANT` registry must have at least one element, or the game errors during sync and blocks world loading.

### Tooltip

The painting item shows the dimensions of its `painting/variant` component variant in the tooltip, plus the author and title if set.