imported>Sul4ur: Expanded the doc a lot

2025-04-23T16:11:10Z

Expanded the doc a lot

New page

{{documentation header}}

{{lua|Pack format table}}
== Usage ==
This template represents one entry in a pack format wikitable.

=== Pack format ===
Set the first parameter to the pack format value for the versions.

=== Versions ===
==== Stable versions ====
The second and the third parameters represent the first release (stable) version and the last release version that use this pack format value, respectively.

If there is only one stable version with the pack format value, put it in the second parameter and leave the third parameter empty.

==== Development versions ====
The <code>|dev1=</code> and <code>|dev2=</code> parameters represent the first version and the last version that use this pack format, respectively. It doesn't matter whether the versions are stable or not.

If there is only one version with the pack format value, put it in the <code>|dev1=</code> parameter and leave the <code>|dev2=</code> parameter empty.

Do not use these parameters in the <code>releaseonly</code> table.

==== Other info ====
By default, the versions link to the appropriate version page. You can use the {{cd|{{!}}v1link{{=}}|{{!}}v2link{{=}}|{{!}}dev1link{{=}}|{{!}}dev2link{{=}}|delim=and}} parameters to change this. Possible values are:
* <code><nowiki>ver</nowiki></code> — link to the version article, i.e. the default behavior.
* Any URI/URL — external link to this URI/URL.
* Any page on the wiki — internal link to this page.
* <code><nowiki>none</nowiki></code> — no link.

You can also use the <code>|upcoming=</code> parameter to tag the last stable version as an upcoming version. It doesn't matter what you put into the parameter, as long as it's not empty.

=== Significant/Breaking changes ===
The other unnamed parameters each represent one significant or breaking change. This template supports unlimited changes per pack format value.

== Examples ==
<syntaxhighlight lang="wikitext">...
{{Pack format table|4|dev1=17w48a|dev2=19w46b|1.13|1.4.4|Change 1|Change 2}}
{{Pack format table|5|dev1=1.15 Pre-release 1|dev2=1.16 Pre-release 3|1.15|1.16.1|Added [[predicates]].}}
{{Pack format table|7|dev1=20w46a|dev2=1.17.1|1.17|1.17.1|The {{cmd|replaceitem}} command was replaced with {{cmd|item}}.|Rolls, {{cd|set_damage}}, and possibly other parameters in loot tables now require a valid {{cd|type}} field when using min-max for numbers.|{{cd|score}} conditions' {{cd|entity}} parameter was replaced with {{cd|target}}.}}
{{Pack format table|13|dev1=23w12a|dev2=23w14a|||NBT paths for lines of text, {{cd|GlowingText}}, and {{cd|Color}} on the front of signs are now at {{cd|front_text.messages[<index>]}}, {{cd|front_text.has_glowing_text}}, and {{cd|front_text.color}}, respectively. The relevant tags for the backs of signs are in {{cd|back_text}}.}}
{{Pack format table|16|dev1=23w31a|||{{cd|entity_roar}} and {{cd|entity_shake}} game events have been removed and replaced with the {{cd|entity_action}} game event.|Renamed {{cd|belowName}} value in display slot argument in scoreboard command to {{cd|below_name}}.|Added {{cd|macro}} functions.|{{cd|pack.mcmeta}} now includes an optional {{cd|supported_formats}} field and optional {{cd|overlays}} section to allow creation of packs that are compatible with multiple versions of the game.}}
...</syntaxhighlight>

{| class="wikitable sortable collapsible" style="text-align: center;"
|+ Data pack formats
|-
! rowspan="2" | Value
! colspan="2" | Versions
! colspan="2" | Releases
! rowspan="2" | Significant/Breaking Changes
|-
! From !! To
! From !! To
|-
{{Pack format table|4|dev1=17w48a|dev2=19w46b|1.13|1.4.4|Change 1|Change 2}}
{{Pack format table|5|dev1=1.15 Pre-release 1|dev2=1.16 Pre-release 3|1.15|1.16.1|Added [[predicates]].}}
{{Pack format table|7|dev1=20w46a|dev2=1.17.1|1.17|1.17.1|The {{cmd|replaceitem}} command was replaced with {{cmd|item}}.|Rolls, {{cd|set_damage}}, and possibly other parameters in loot tables now require a valid {{cd|type}} field when using min-max for numbers.|{{cd|score}} conditions' {{cd|entity}} parameter was replaced with {{cd|target}}.}}
{{Pack format table|13|dev1=23w12a|dev2=23w14a|||NBT paths for lines of text, {{cd|GlowingText}}, and {{cd|Color}} on the front of signs are now at {{cd|front_text.messages[<index>]}}, {{cd|front_text.has_glowing_text}}, and {{cd|front_text.color}}, respectively. The relevant tags for the backs of signs are in {{cd|back_text}}.}}
{{Pack format table|16|dev1=23w31a|||{{cd|entity_roar}} and {{cd|entity_shake}} game events have been removed and replaced with the {{cd|entity_action}} game event.|Renamed {{cd|belowName}} value in display slot argument in scoreboard command to {{cd|below_name}}.|Added {{cd|macro}} functions.|{{cd|pack.mcmeta}} now includes an optional {{cd|supported_formats}} field and optional {{cd|overlays}} section to allow creation of packs that are compatible with multiple versions of the game.}}
|}

<syntaxhighlight lang="wikitext">...
{{Pack format table|4|1.13|1.14.4|Added the initial pack format version of 4.}}
{{Pack format table|5|1.16.1||Added stuff.}}
{{Pack format table|7|1.19|upcoming=1||Added more stuff.}}
...</syntaxhighlight>

{| class="wikitable sortable collapsible" style="text-align: center;"
|+ Data pack formats
|-
! rowspan="2" | Value
! colspan="2" | Releases
! rowspan="2" | Significant/Breaking Changes
|-
! From !! To
|-
{{Pack format table|4|1.13|1.14.4|Added the initial pack format version of 4.}}
{{Pack format table|5|1.16.1||Added stuff.}}
{{Pack format table|7|1.19|upcoming=1||Added more stuff.}}
|}

<includeonly>{{sandbox other||

[[fr:Modèle:Tableau de format de pack]]
[[ja:テンプレート:Pack format]]
[[pt:Predefinição:Tabela de formato de pacote]]
[[ru:Шаблон:Таблица форматов]]
[[uk:Шаблон:Таблиця формату пакета]]
}}</includeonly>
<noinclude>

[[fr:Modèle:Tableau de format de pack/doc]]
[[ja:テンプレート:Pack format/doc]]
[[pt:Predefinição:Tabela de formato de pacote/doc]]
[[ru:Шаблон:Таблица форматов/док]]
[[uk:Шаблон:Таблиця формату пакета/док]]
</noinclude>

Template:MC/Pack format table/doc - Revision history

imported>Sul4ur: Expanded the doc a lot