Minecraft:Text component format - Revision history

SyncBot: Sync: updated from Minecraft

2026-10-20T11:11:44Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:11, 20 October 2026
Line 49:		Line 49:
	*** {{nbt\|boolean\|obfuscated}}: Optional. Whether to render the content obfuscated.		*** {{nbt\|boolean\|obfuscated}}: Optional. Whether to render the content obfuscated.
	*** {{nbt\|int\|shadow_color}}: The color and opacity of the shadow. If omitted, the shadow is 25% the brightness of the text color and 100% the opacity{{verify}}. Color codes are the ARGB hex code of the color converted to a decimal number, or can be calculated from the opacity, red, green and blue components using this formula:<br>'''Alpha[[Minecraft:wikipedia:Logical shift\|<<]]24 + <span style="color:red">Red</span><<16 + <span style="color:green">Green</span><<8 + <span style="color:blue">Blue</span>'''		*** {{nbt\|int\|shadow_color}}: The color and opacity of the shadow. If omitted, the shadow is 25% the brightness of the text color and 100% the opacity{{verify}}. Color codes are the ARGB hex code of the color converted to a decimal number, or can be calculated from the opacity, red, green and blue components using this formula:<br>'''Alpha[[Minecraft:wikipedia:Logical shift\|<<]]24 + <span style="color:red">Red</span><<16 + <span style="color:green">Green</span><<8 + <span style="color:blue">Blue</span>'''
	*** {{nbt\|list\|shadow_color}}: Another format. A list containing 4 floats corresponding to red, green, blue, and opacity values ~~as a fraction (ranged~~ 0 to 1, ~~inclusive) that is automatically converted to~~ the ~~int format~~.		*** {{nbt\|list\|shadow_color}}: Another format. A list containing 4 floats corresponding to red, green, blue, and opacity values. These values range from 0 to 1 (including decimals). To turn RGB into this format, divide the desired colour value by 255 when the desired value ≠ 0.
	** '''''Interactivity'''''		** '''''Interactivity'''''
	*** {{nbt\|string\|insertion}}: Optional. When the text is shift-clicked by a player, this string is inserted in their chat input. It does not overwrite any existing text the player was writing. This only works in chat messages.		*** {{nbt\|string\|insertion}}: Optional. When the text is shift-clicked by a player, this string is inserted in their chat input. It does not overwrite any existing text the player was writing. This only works in chat messages.

SyncBot: Sync: updated from Minecraft

2026-08-30T11:14:15Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:14, 30 August 2026
Line 6:		Line 6:
	{{For\|text component format used in versions before [[Minecraft:Java Edition 1.21.5]]\|Text component format/Before Java Edition 1.21.5}}		{{For\|text component format used in versions before [[Minecraft:Java Edition 1.21.5]]\|Text component format/Before Java Edition 1.21.5}}

	Text components are written in [[Minecraft:NBT format#SNBT format\|SNBT]], for example {{cd\|{text: "Hello world"<nowiki>}</nowiki>}}. They are used for rich-text formatting in [[Minecraft:written book]]s, [[Minecraft:sign]]s, custom names and the {{cmd\|tellraw}}, {{cmd\|title}}, {{cmd\|bossbar}}, {{cmd\|scoreboard}} and {{cmd\|team}} commands.		Text components are written in [[Minecraft:NBT format#SNBT format\|SNBT]], for example {{cd\|{text: "Hello world"<nowiki>}</nowiki>}}. They are used for rich-text formatting in [[Minecraft:written book]]s, [[Minecraft:sign]]s, [[Minecraft:Display#Text Displays\|text displays]], custom names and the {{cmd\|tellraw}}, {{cmd\|title}}, {{cmd\|bossbar}}, {{cmd\|scoreboard}} and {{cmd\|team}} commands.

	The format is made up of text components. There is a single root component, which can have child components, which can have their own children and so on. Components can also have formatting and interactivity added to them, which is inherited by their children.		The format is made up of text components. There is a single root component, which can have child components, which can have their own children and so on. Components can also have formatting and interactivity added to them, which is inherited by their children.

SyncBot: Sync: updated from Minecraft

2026-08-03T11:08:37Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:08, 3 August 2026
Line 174:		Line 174:
	** {{nbt\|boolean\|interpret}}: Optional, defaults to false. If true, the game attempts to interpret each NBT value as a text component instead of displaying it as SNBT. Ignored if {{nbt\|string\|nbt}} is not present. Can't be set to true at the same time as {{nbt\|boolean\|plain}}.		** {{nbt\|boolean\|interpret}}: Optional, defaults to false. If true, the game attempts to interpret each NBT value as a text component instead of displaying it as SNBT. Ignored if {{nbt\|string\|nbt}} is not present. Can't be set to true at the same time as {{nbt\|boolean\|plain}}.
	** {{nbt\|boolean\|plain}}: Optional, defaults to false. If false, the game will style the SNBT with colors for the keys and values. If true, no coloring is added. Can't be set to true at the same time as {{nbt\|boolean\|interpret}}. Ignored if {{nbt\|string\|nbt}} is not present.		** {{nbt\|boolean\|plain}}: Optional, defaults to false. If false, the game will style the SNBT with colors for the keys and values. If true, no coloring is added. Can't be set to true at the same time as {{nbt\|boolean\|interpret}}. Ignored if {{nbt\|string\|nbt}} is not present.
	** {{nbt\|compound\|separator}}: Optional, defaults to <code>{text: ", "}</code>. A text component. Used as the separator between different tags, if the component selects multiple tags.		** {{Nbt\|string}}{{Nbt\|list}}{{nbt\|compound\|separator}}: Optional, defaults to <code>{text: ", "}</code>. A text component. Used as the separator between different tags, if the component selects multiple tags.
	** {{nbt\|string\|entity}}: A string specifying the [[Minecraft:Selector\|target selector]] for the entity or entities from which the NBT value is obtained. Ignored if {{nbt\|string\|nbt}} is not present.		** {{nbt\|string\|entity}}: A string specifying the [[Minecraft:Selector\|target selector]] for the entity or entities from which the NBT value is obtained. Ignored if {{nbt\|string\|nbt}} is not present.
	** {{nbt\|string\|block}}: A string specifying the coordinates of the block entity from which the NBT value is obtained. The coordinates can be absolute, [[Minecraft:Commands#Tilde and caret notation\|relative]], or local. Ignored if {{nbt\|string\|nbt}} is not present.		** {{nbt\|string\|block}}: A string specifying the coordinates of the block entity from which the NBT value is obtained. The coordinates can be absolute, [[Minecraft:Commands#Tilde and caret notation\|relative]], or local. Ignored if {{nbt\|string\|nbt}} is not present.

SyncBot: Sync: updated from Minecraft

2026-08-02T11:11:00Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:11, 2 August 2026
Line 131:		Line 131:
	** {{nbt\|string\|type}}: Optional. Set to {{code\|"selector"}}.		** {{nbt\|string\|type}}: Optional. Set to {{code\|"selector"}}.
	** {{nbt\|string\|selector}}: A string containing a [[Minecraft:selector]].		** {{nbt\|string\|selector}}: A string containing a [[Minecraft:selector]].
	** {{nbt\|compound\|separator}}: Optional, defaults to <code>{color: "gray", text: ", "}</code>. A text component. Used as the separator between different names, if the component selects multiple entities.		** {{nbt\|string}}{{nbt\|list}}{{nbt\|compound\|separator}}: Optional, defaults to <code>{color: "gray", text: ", "}</code>. A text component. Used as the separator between different names, if the component selects multiple entities.
	</div>		</div>

Line 341:		Line 341:
	* {{nbt\|compound\|hover_event}}		* {{nbt\|compound\|hover_event}}
	** {{nbt\|string\|action}}: <code>show_entity</code>		** {{nbt\|string\|action}}: <code>show_entity</code>
	** {{nbt\|compound\|name}}: Optional. Hidden if not present. A text that is displayed as the name of the entity.		** {{Nbt\|string}}{{Nbt\|list}}{{nbt\|compound\|name}}: Optional. Hidden if not present. A text component that is displayed as the name of the entity.
	** {{nbt\|string\|id}}: A string containing the type of the entity, as a [[Minecraft:resource location]].		** {{nbt\|string\|id}}: A string containing the type of the entity, as a [[Minecraft:resource location]].
	** {{nbt\|string\|}}{{nbt\|int-array\|}}{{nbt\|list\|uuid}}: The [[Minecraft:UUID]] of the entity. Either:		** {{nbt\|string\|}}{{nbt\|int-array\|}}{{nbt\|list\|uuid}}: The [[Minecraft:UUID]] of the entity. Either:

SyncBot: Sync: updated from Minecraft

2026-06-05T11:10:54Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:10, 5 June 2026
Line 181:		Line 181:

	==== Object ====		==== Object ====
	Displays objects as single sprites in component messages. Sprites are rendered as ~~8x8 pixels~~ squares. This will ignore bold and italic styles!		Displays objects as single sprites in component messages. Sprites are rendered as 8×8-pixel squares. This will ignore bold and italic styles!

	===== Atlas Object Type =====		===== Atlas Object Type =====

SyncBot: Sync: updated from Minecraft

2026-05-31T11:17:01Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:17, 31 May 2026
Line 517:		Line 517:

	== External links ==		== External links ==
	* [https://misode.github.io/text-component/ ~~Text~~ component generator on misode.github.io]		* [https://text.datapackhub.net/ Visual text component generator on text.datapackhub.net]
			* [https://misode.github.io/text-component/ Node-based text component generator on misode.github.io]

	== Navigation ==		== Navigation ==
Line 527:		Line 528:
	[[Minecraft:ja:Raw JSONテキストフォーマット]]		[[Minecraft:ja:Raw JSONテキストフォーマット]]
	[[Minecraft:pt:Formato de componente de texto]]		[[Minecraft:pt:Formato de componente de texto]]
			[[Minecraft:ru:Формат текстового компонента]]
	[[Minecraft:zh:文本组件]]		[[Minecraft:zh:文本组件]]

SyncBot: Sync: updated from Minecraft

2026-05-13T11:18:18Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:18, 13 May 2026
Line 221:		Line 221:
	* Writing a text component to any line on a [[Minecraft:sign]].		* Writing a text component to any line on a [[Minecraft:sign]].
	* Writing a text component to a [[Minecraft:text display]]'s {{cd\|text}} tag.		* Writing a text component to a [[Minecraft:text display]]'s {{cd\|text}} tag.
	* Using the '''set_name''' and '''set_lore''' [[Minecraft:Item modifier\|item ~~modifers~~]], but only if their {{nbt\|string\|entity}} field is set and that entity context exists.		* Using the '''set_name''' and '''set_lore''' [[Minecraft:Item modifier\|item modifiers]], but only if their {{nbt\|string\|entity}} field is set and that entity context exists.
	* A text component in a [[Minecraft:written book]] will be resolved once first opened by an ''operator'' or, once placed into a lectern. However, if the resulting text component is too large then it will fail to resolve.		* A text component in a [[Minecraft:written book]] will be resolved once first opened by an ''operator'' or, once placed into a lectern. However, if the resulting text component is too large then it will fail to resolve.
	* Setting a [[Minecraft:boss bar]] name using {{cmd\|bossbar set <id> name}} while the command is executing as an entity.		* Setting a [[Minecraft:boss bar]] name using {{cmd\|bossbar set <id> name}} while the command is executing as an entity.

SyncBot: Sync: updated from Minecraft

2026-04-21T11:10:20Z

Sync: updated from Minecraft

Show changes

SyncBot: Fix template calls: add MC/ prefix

2026-04-09T21:02:48Z

Fix template calls: add MC/ prefix

Show changes

SyncBot: Remove broken links to missing pages

2026-04-09T16:07:24Z

Remove broken links to missing pages

Show changes

← Older revision		Revision as of 11:11, 20 October 2026
Line 49:		Line 49:
	*** {{nbt\|boolean\|obfuscated}}: Optional. Whether to render the content obfuscated.		*** {{nbt\|boolean\|obfuscated}}: Optional. Whether to render the content obfuscated.
	*** {{nbt\|int\|shadow_color}}: The color and opacity of the shadow. If omitted, the shadow is 25% the brightness of the text color and 100% the opacity{{verify}}. Color codes are the ARGB hex code of the color converted to a decimal number, or can be calculated from the opacity, red, green and blue components using this formula:<br>'''Alpha[[Minecraft:wikipedia:Logical shift\|<<]]24 + <span style="color:red">Red</span><<16 + <span style="color:green">Green</span><<8 + <span style="color:blue">Blue</span>'''		*** {{nbt\|int\|shadow_color}}: The color and opacity of the shadow. If omitted, the shadow is 25% the brightness of the text color and 100% the opacity{{verify}}. Color codes are the ARGB hex code of the color converted to a decimal number, or can be calculated from the opacity, red, green and blue components using this formula:<br>'''Alpha[[Minecraft:wikipedia:Logical shift\|<<]]24 + <span style="color:red">Red</span><<16 + <span style="color:green">Green</span><<8 + <span style="color:blue">Blue</span>'''
	*** {{nbt\|list\|shadow_color}}: Another format. A list containing 4 floats corresponding to red, green, blue, and opacity values ~~as a fraction (ranged~~ 0 to 1, ~~inclusive) that is automatically converted to~~ the ~~int format~~.		*** {{nbt\|list\|shadow_color}}: Another format. A list containing 4 floats corresponding to red, green, blue, and opacity values. These values range from 0 to 1 (including decimals). To turn RGB into this format, divide the desired colour value by 255 when the desired value ≠ 0.
	** '''''Interactivity'''''		** '''''Interactivity'''''
	*** {{nbt\|string\|insertion}}: Optional. When the text is shift-clicked by a player, this string is inserted in their chat input. It does not overwrite any existing text the player was writing. This only works in chat messages.		*** {{nbt\|string\|insertion}}: Optional. When the text is shift-clicked by a player, this string is inserted in their chat input. It does not overwrite any existing text the player was writing. This only works in chat messages.

← Older revision		Revision as of 11:08, 3 August 2026
Line 174:		Line 174:
	** {{nbt\|boolean\|interpret}}: Optional, defaults to false. If true, the game attempts to interpret each NBT value as a text component instead of displaying it as SNBT. Ignored if {{nbt\|string\|nbt}} is not present. Can't be set to true at the same time as {{nbt\|boolean\|plain}}.		** {{nbt\|boolean\|interpret}}: Optional, defaults to false. If true, the game attempts to interpret each NBT value as a text component instead of displaying it as SNBT. Ignored if {{nbt\|string\|nbt}} is not present. Can't be set to true at the same time as {{nbt\|boolean\|plain}}.
	** {{nbt\|boolean\|plain}}: Optional, defaults to false. If false, the game will style the SNBT with colors for the keys and values. If true, no coloring is added. Can't be set to true at the same time as {{nbt\|boolean\|interpret}}. Ignored if {{nbt\|string\|nbt}} is not present.		** {{nbt\|boolean\|plain}}: Optional, defaults to false. If false, the game will style the SNBT with colors for the keys and values. If true, no coloring is added. Can't be set to true at the same time as {{nbt\|boolean\|interpret}}. Ignored if {{nbt\|string\|nbt}} is not present.
	** {{nbt\|compound\|separator}}: Optional, defaults to <code>{text: ", "}</code>. A text component. Used as the separator between different tags, if the component selects multiple tags.		** {{Nbt\|string}}{{Nbt\|list}}{{nbt\|compound\|separator}}: Optional, defaults to <code>{text: ", "}</code>. A text component. Used as the separator between different tags, if the component selects multiple tags.
	** {{nbt\|string\|entity}}: A string specifying the [[Minecraft:Selector\|target selector]] for the entity or entities from which the NBT value is obtained. Ignored if {{nbt\|string\|nbt}} is not present.		** {{nbt\|string\|entity}}: A string specifying the [[Minecraft:Selector\|target selector]] for the entity or entities from which the NBT value is obtained. Ignored if {{nbt\|string\|nbt}} is not present.
	** {{nbt\|string\|block}}: A string specifying the coordinates of the block entity from which the NBT value is obtained. The coordinates can be absolute, [[Minecraft:Commands#Tilde and caret notation\|relative]], or local. Ignored if {{nbt\|string\|nbt}} is not present.		** {{nbt\|string\|block}}: A string specifying the coordinates of the block entity from which the NBT value is obtained. The coordinates can be absolute, [[Minecraft:Commands#Tilde and caret notation\|relative]], or local. Ignored if {{nbt\|string\|nbt}} is not present.

← Older revision		Revision as of 11:11, 2 August 2026
Line 131:		Line 131:
	** {{nbt\|string\|type}}: Optional. Set to {{code\|"selector"}}.		** {{nbt\|string\|type}}: Optional. Set to {{code\|"selector"}}.
	** {{nbt\|string\|selector}}: A string containing a [[Minecraft:selector]].		** {{nbt\|string\|selector}}: A string containing a [[Minecraft:selector]].
	** {{nbt\|compound\|separator}}: Optional, defaults to <code>{color: "gray", text: ", "}</code>. A text component. Used as the separator between different names, if the component selects multiple entities.		** {{nbt\|string}}{{nbt\|list}}{{nbt\|compound\|separator}}: Optional, defaults to <code>{color: "gray", text: ", "}</code>. A text component. Used as the separator between different names, if the component selects multiple entities.
	</div>		</div>

Line 341:		Line 341:
	* {{nbt\|compound\|hover_event}}		* {{nbt\|compound\|hover_event}}
	** {{nbt\|string\|action}}: <code>show_entity</code>		** {{nbt\|string\|action}}: <code>show_entity</code>
	** {{nbt\|compound\|name}}: Optional. Hidden if not present. A text that is displayed as the name of the entity.		** {{Nbt\|string}}{{Nbt\|list}}{{nbt\|compound\|name}}: Optional. Hidden if not present. A text component that is displayed as the name of the entity.
	** {{nbt\|string\|id}}: A string containing the type of the entity, as a [[Minecraft:resource location]].		** {{nbt\|string\|id}}: A string containing the type of the entity, as a [[Minecraft:resource location]].
	** {{nbt\|string\|}}{{nbt\|int-array\|}}{{nbt\|list\|uuid}}: The [[Minecraft:UUID]] of the entity. Either:		** {{nbt\|string\|}}{{nbt\|int-array\|}}{{nbt\|list\|uuid}}: The [[Minecraft:UUID]] of the entity. Either: