# Minecraft Data Component Predicate

> Minecraft Data Component Predicate 数据组件谓词：Usage Formats 使用格式（advancements/predicates predicates 映射、commands minecraft:item_predicate 参数类型、item models predicate/value condition/component）、Existence Checks 存在性检查（空对象 {} 测试组件存在、谓词ID与组件ID重叠 优先解释为值测试 回退存在性检查）、Value Predicates 值谓词（attribute_modifiers 修饰符 集合谓词 size/count/contains、bundle_contents/container 物品堆栈 集合谓词 count/items/components/predicates、custom_data 自定义数据 JSON/NBT/SNBT、damage damage/durability 整数边界、enchantments/stored_enchantments 附魔 条件数组 enchantments/levels、firework_explosion 爆炸集合谓词 has_trail/has_twinkle/shape、fireworks flight_duration+explosions、jukebox_playable song 歌曲ID、potion_contents potion/custom_effects 药水内容、trim 装饰 material/pattern ID、villager/variant 村民类型、writable_book_content 书与笔 pages 集合谓词、written_book_content 成书 pages/author/title/generation/resolved）。

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

---


# Data Component Predicate

Data component predicates (component predicates) test whether data components satisfy conditions. Java Edition only.

## Usage Formats

- **Advancements/predicates**: a map of `<component predicate ID>: <test content>` inside `predicates`:

```json
{ "predicates": { "minecraft:damage": { "durability": { "min": 5 } } } }
```

- **Commands**: the `minecraft:item_predicate` argument type accepts `<predicate ID>~<test content>`.
- **Item models**: `{ "predicate": "<predicate ID>", "value": <test content> }` in `condition`/`component` property (see the item-model-mapping skill).

## Existence Checks

An empty object `{ "<component ID>": {} }` tests that the component exists. Because predicate IDs overlap with component IDs, the game first tries to interpret the key as a value-testing predicate type; only if that interpretation is invalid does it fall back to an existence check. E.g. `{"minecraft:instrument": {}}` tests existence, but `{"minecraft:potion_contents": {}}` is invalid because `potion_contents` is a real predicate type that doesn't accept this format.

## Value Predicates

- `attribute_modifiers` — modifiers in the component. Collection predicate: `size` (int bounds on modifier count), `count` (list of `{count, test}` — number of modifiers matching a test), `contains` (list of tests; each test must match ≥1 modifier, one modifier may satisfy several). Modifier test: `amount` (double bounds), `attribute` (ID/tag/list), `id`, `operation` (`add_value`/`add_multiplied_base`/`add_multiplied_total`), `slot`.
- `bundle_contents` / `container` — item stacks in the component (collection predicate over item stack predicates: `count` (int bounds), `items` (ID/tag/list), `components` (exact match of the given components), `predicates` (nested component predicates)).
- `custom_data` — matches the custom data (JSON object, NBT compound, or SNBT string converted at parse time).
- `damage` — `damage` (damage value int bounds; from the `damage` component) and/or `durability` (int bounds; `max_damage` − `damage`; `max_damage` absent = 0).
- `enchantments` / `stored_enchantments` — array of conditions (all must pass): `enchantments` (ID/list/tag; any one present passes), `levels` (int bounds on that enchantment's level; without `enchantments`, any enchantment of a matching level passes).
- `firework_explosion` — collection predicate over explosions: `has_trail`, `has_twinkle` (bools), `shape` (`small_ball`/`large_ball`/`star`/`creeper`/`burst`).
- `fireworks` — `flight_duration` (int bounds, in gunpowder units) + `explosions` collection predicate (same firework tests).
- `jukebox_playable` — `song` (jukebox song ID/list/tag).
- `potion_contents` — only the `potion` and `custom_effects` fields are tested. Pre-26.3: `potion` ID/list/tag. From 26.3: `potions` (ID/list/tag; any present passes) and `effects` (collection predicate over status effects: mob effect predicates with `size`/`count`/`contains`).
- `trim` — checks IDs only (inline data always fails): `material` (trim material ID/list/tag), `pattern` (trim pattern ID/list/tag).
- `villager/variant` — `villager` type ID/list/tag.
- `writable_book_content` — `pages` collection predicate (each page test is a string exactly matching a page's unfiltered raw text).
- `written_book_content` — `pages` collection predicate (each test is a text component exactly matching a page's unfiltered raw text), plus `author`, `title` (unfiltered raw), `generation` (0–3 int bounds), `resolved` (bool).