# Minecraft Banner Pattern

> Minecraft Banner Pattern 旗帜图案定义：BANNER_PATTERN 注册表、data/<namespace>/banner_pattern/ 数据包路径、tags/<namespace>/tags/banner_pattern/ 标签、JSON 格式（asset_id 纹理资源 ID、translation_key 翻译键前缀）、纹理路径（assets/<namespace>/textures/entity/banner/<path>.png 旗帜、assets/<namespace>/textures/entity/shield/<path>.png 盾牌）、translation_key 完整格式（<value>.<color name> 颜色后缀）、服务器启动加载（/reload 不重新加载）、图案层渲染（列表顺序、后层覆盖前层）、层名称派生（translation_key + color）。

- Skill: `zmjjkk123-hub/minecraft-banner-pattern` (Agent Skill)
- Install (CLI): `npx skillmds@latest add zmjjkk123-hub/minecraft-banner-pattern`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zmjjkk123-hub/minecraft-banner-pattern/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-banner-pattern

---


# Banner Pattern Definitions

This content applies only to Java Edition.

Banner patterns define the pattern types available for banners and shields. Banner pattern definition files are their data-driven definitions in datapacks.

## Definition format

Banner patterns use the `BANNER_PATTERN` registry; the datapack path is `banner_pattern`, so definitions live in `data/<namespace>/banner_pattern`, and tags in `data/<namespace>/tags/banner_pattern`.

Definition files use JSON with the following structure:

- JSON file root object
  - `asset_id` (string, required): (namespace ID) texture used by the pattern; rendered from `assets/<namespace>/textures/entity/banner/<path>.png` (banners) and `assets/<namespace>/textures/entity/shield/<path>.png` (shields).
  - `translation_key` (string, required): prefix of the pattern's tooltip translation key; the full key is `<value>.<color name>` using the layer's color.

## Definition behavior

Banner pattern data is loaded only once at server startup; `/reload` does not reload it — a server restart is required.

A banner pattern defines the style of one pattern layer; each layer has a style and a color, rendered in list order (later layers cover earlier ones). The layer name is derived from `translation_key` and the color. For example, with translation key `block.minecraft.banner.custom.pattern` and color red, the full key is `block.minecraft.banner.custom.pattern.red`.