Ver el código de «Formato NBT»

Minecraft utiliza el formato de etiqueta binaria (en ingles '''Named Binary Tag''') con nombre para los diversos archivos en los que guarda los datos. Notch describe el formato en una muy breve explicación [http://web.archive.org/web/20110723210920/http://www.minecraft.net/docs/NBT.txt specification]. El formato está diseñado para almacenar datos en una estructura de árbol compuesta de varias etiquetas. Todas las etiquetas tienen una identificación y un nombre. La versión original conocida era 19132 como se introdujo en [[Beta]] 1.3, y desde entonces se ha actualizado a 19133 con [[Formato de mundo Anvil|Anvil]], con la adición de la etiqueta Int Array. El formato NBT se remonta a [[Indev]] con las etiquetas 0 a 10 en uso.

Otro formato más fácil de usar de NBT es en cadena simple, como se usa en [[comandos]]. Este formato se conoce como '' 'SNBT' '', abreviatura de '' 'NBT en cadena' ''. Es diferente del formato [[JSON]]; por lo tanto, cualquier JSON utilizado en NBT, como [[Comandos#Raw JSON text|raw json text]], debe encerrarse dentro de una etiqueta de cadena {{nbt | string}}.

== Los TAGs ==
Una etiqueta es una parte individual del árbol de datos. El primer byte en una etiqueta es el tipo de etiqueta (ID), seguido de un entero sin signo big-endian de dos bytes para la longitud del nombre, luego el nombre como una cadena en formato UTF-8 (El TAG  '' 'Fin' '' no tiene nombre y no contiene los 2 bytes adicionales; se supone que el nombre está vacío). El nombre de las etiquetas '' puede '' contener espacios, aunque Minecraft nunca guarda etiquetas con espacios en los nombres. Finalmente, dependiendo del tipo de etiqueta, los bytes que siguen son parte de la "carga útil" de esa etiqueta. Esta tabla describe cada una de las 13 etiquetas conocidas en la versión 19133 del formato de etiqueta binaria nombrada:
{| class="wikitable" data-description="NBT tags"
|-
! ID
! Icono
! Tipo de Tag
! Payload
! SNBT Format{{solo|java|short=y}} 
! Descripción
! width="33%" align="center" | Storage Capacity
|-
| style="text-align:center" | '''0'''
| 
| TAG_'''End'''
| -
| -
| Se usa para marcar el final de las etiquetas compuestas. Esta etiqueta '''no tiene nombre''', por lo que solo es un byte 0. También puede ser el tipo de etiquetas de Lista vacías.
| N/A
|-
| style="text-align:center" | '''1'''
| style="text-align:center" | {{nbt|byte}}
| TAG_'''Byte'''
| 1 byte / 8 bits, signed
| <code><number>b</code> or <code><number>B</code>
| Un tipo entero firmado. A veces se usa como si fuera un dato booleanos.
| (2<sup>7</sup>) a (2<sup>7</sup> - 1)<br>(-128 to 127)
|-
| style="text-align:center" | '''2'''
| style="text-align:center" | {{nbt|short}}
| TAG_'''Short'''
| 2 bytes / 16 bits, signed, big endian
| <code><number>s</code> or <code><number>S</code>
| Es un tipo entero firmado.
| (2<sup>15</sup>) a (2<sup>15</sup> - 1)<br>(-32,768 to 32,767)
|-
| style="text-align:center" | '''3'''
| style="text-align:center" | {{nbt|int}}
| TAG_'''Int'''
| 4 bytes / 32 bits, signed, big endian
| <code><number></code>
| Es un tipo entero firmado
| (2<sup>31</sup>) a (2<sup>31</sup> - 1)<br>(-2,147,483,648 to 2,147,483,647)
|-
| style="text-align:center" | '''4'''
| style="text-align:center" | {{nbt|long}}
| TAG_'''Long'''
| 8 bytes / 64 bits, signed, big endian
| <code><number>l</code> or <code><number>L</code>
| Es un tipo entero firmado
| (2<sup>63</sup>) a (2<sup>63</sup> - 1)<br>(-9,223,372,036,854,775,808 to 9,223,372,036,854,775,807)
|-
| style="text-align:center" | '''5'''
| style="text-align:center" | {{nbt|float}}
| TAG_'''Float'''
| 4 bytes / 32 bits, signed, big endian, IEEE 754-2008, binary32
| <code><number>f</code> or <code><number>F</code>
| Es un tipo de dato Float firmado.
| La precisión varía a lo largo de la recta numérica;<br>See [[wikipedia:Single precision floating-point format|Single-precision floating-point format]]. El valor máximo esta sobre 3.4*10<sup>38</sup>
|-
| style="text-align:center" | '''6'''
| style="text-align:center" | {{nbt|double}}
| TAG_'''Double'''
| 8 bytes / 64 bits, signed, big endian, IEEE 754-2008, binary64
| <code><decimal number></code>, <code><number>d</code> or <code><number>D</code>
| Es un tipo de dato Double firmado.
| La precisión varía a lo largo de la recta numérica;<br>See [[wikipedia:Double precision floating-point format|Double-precision floating-point format]]. El valor máximo esta sobre 1.8*10<sup>308</sup>
|-
| style="text-align:center" | '''7'''
| style="text-align:center" | {{nbt|byte-array}}
| TAG_'''Byte'''_'''Array'''
| TAG_Int's payload ''size'', then ''size'' TAG_Byte's payloads.
| <code>[B;<byte>,<byte>,...]</code>
| Este TAG es un array de bytes.
| El número máximo de elementos varía entre (2<sup>31</sup> - 9) y (2<sup>31</sup> - 1) (2,147,483,639 y 2,147,483,647), dependiendo de la JVM específica.
|-
| style="text-align:center" | '''8'''
| style="text-align:center" | {{nbt|string}}
| TAG_'''String'''
| Longitud de carga útil de TAG_Short, luego una cadena UTF-8 con longitud de tamaño.
| -
| Una cadena UTF-8. Tiene un tamaño, en lugar de ser nulo terminado.
| 32,767 bytes interpretables como UTF-8 (see [[wikipedia:UTF-8|UTF-8 format]]; los caracteres más utilizados son de un solo byte).
|-
| style="text-align:center" | '''9'''
| style="text-align:center" | {{nbt|list}}
| TAG_'''List'''
| -
| <code>[<value>,<value>,...]</code>
| Una lista de cargas de etiquetas, sin ID de etiquetas repetidas ni nombres de etiquetas.
| Debido a las limitaciones de JVM y la implementación de ArrayList, el número máximo de elementos de lista es(2<sup>31</sup> - 9), or 2,147,483,639. También tenga en cuenta que las etiquetas Lista y Compuesto no pueden anidarse más allá de una profundidad de 512.
|-
| style="text-align:center" | '''10'''
| style="text-align:center" | {{nbt|compound}}
| TAG_'''Compound'''
| Etiquetas completamente formadas, seguidas de un TAG_End.
| <code>{<tag name>:<value>,<tag name>:<value>,...}</code>
| Una lista de etiquetas completamente formadas, incluidos sus ID, nombres y cargas útiles. No hay dos etiquetas que puedan tener el mismo nombre.
| A diferencia de las listas, no existe un límite estricto para el número de etiquetas dentro de un Compuesto (por supuesto, siempre existe el límite implícito de la memoria virtual). Sin embargo, tenga en cuenta que las etiquetas de Compound y List no pueden anidarse más allá de una profundidad de 512.
|-
| style="text-align:center" | '''11'''
| style="text-align:center" | {{nbt|int-array}}
| TAG_'''Int'''_'''Array'''
| -
| <code>[I;<integer>,<integer>,...]</code>
| Un conjunto de cargas útiles de TAG_Int.
| El número máximo de elementos varía entre (2<sup>31</sup> - 9) y (2<sup>31</sup> - 1) (2,147,483,639 y 2,147,483,647), dependiendo de la JVM específica.
|-
| style="text-align:center" | '''12'''
| style="text-align:center" | {{nbt|long-array}}
| TAG_'''Long'''_'''Array'''
| -
| <code>[L;<long>,<long>,...]</code>
| Un conjunto de cargas útiles de TAG_Long.
| El número máximo de elementos varía entre (2<sup>31</sup> - 9) y (2<sup>31</sup> - 1) (2,147,483,639 y 2,147,483,647), dependiendo de la JVM específica.
|}

Las etiquetas List y Compound pueden estar anidadas recursivamente y, a menudo, están anidadas recursivamente. También debe tenerse en cuenta que, en una lista de listas, cada una de las sublistas puede incluir un tipo diferente de etiqueta.

== Formato de los Archivos ==
Un archivo NBT es una etiqueta compuesta GZip'd, nombre e ID de etiqueta incluidos. Algunos de los archivos utilizados por Minecraft pueden estar sin comprimir, pero en la mayoría de los casos los archivos siguen las especificaciones originales de Notch y están comprimidos con GZip. En [[Legacy Console Edition]], [[chunks]] se comprimen con XMemCompress, una variación de un algoritmo de compresión LZX. No hay encabezado para especificar la versión o cualquier otra información, solo el archivo [[level.dat]] especifica la versión.


== El como lo usan en Minecraft ==
El uso de Minecraft del formato NBT es extraño a veces. En algunos casos, las listas vacías pueden representarse como una lista de etiquetas de bytes en lugar de una lista del tipo correcto, o como una lista de etiquetas finales en las versiones más nuevas de Minecraft, lo que puede romper algunas herramientas NBT más antiguas. Además, casi todas las etiquetas raíz tienen una cadena de nombre vacía y encapsulan solo una etiqueta compuesta con los datos reales y un nombre. Por ejemplo:
<div class="treeview">
* {{nbt|compound}} La etiqueta raíz para la mayoría de las estructuras NBT en Minecraft.
** {{nbt|compound|SomeName}}: La única etiqueta contenida dentro de la etiqueta raíz: tiene un nombre y contiene todos los datos reales.
</div>
Otra rareza notable es que, aunque la especificación original de Notch permite espacios en los nombres de las etiquetas, e incluso el ejemplo usa espacios en los nombres de las etiquetas, Minecraft no tiene archivos conocidos en los que las etiquetas tengan espacios en sus nombres. También hay un uso inconsistente de mayúsculas y minúsculas, principalmente camelCase o PascalCase, pero a veces incluso en minúsculas.

=== Uses ===
* [[level.dat]] se almacena en formato comprimido NBT.
* [[Player.dat format|<player>.dat]] Los archivos se almacenan en formato comprimido NBT.
* [[idcounts.dat]] se almacena en formato NBT sin comprimir.
* [[villages.dat]] se almacena en formato NBT comprimido.
* [[Map item format|map_<#>.dat]] Los archivos se almacenan en formato comprimido NBT.
* [[Servers.dat Format|servers.dat]], se utiliza para almacenar la lista de servidores multijugador guardados como NBT sin comprimir.
* [[Chunk format|Chunk]]s se almacenan en formato NBT comprimido dentro de los archivos [[Region file format|Region]].
* [[Scoreboard#NBT format|scoreboard.dat]] se almacena en formato NBT comprimido.
* [[Generated structures data file format|Generated structures]] se almacena en formato NBT comprimido.
* [[Structure block file format|Saved structures]] se almacena en formato NBT comprimido.

== Software ==
Mojang ha proporcionado clases Java NBT de muestra para que los desarrolladores las utilicen y hagan referencia como parte del código fuente del convertidor [http://www.mojang.com/2012/02/new-minecraft-map-format-anvil/ McRegion -> Anvil converter]. desde la [[Java Edition 1.13|1.13]], Minecraft incluye un convertidor integrado entre el formato SNBT y el formato NBT comprimido. Viene con el [[client.jar|cliente]] y el [https://minecraft.net/download/server servidor oficial].<ref>https://wiki.vg/Data_Generators#NBT_converters</ref>

=== Official ===
{{Véase también|Tutorials/Running the Data Generator}}
El generador de datos de ''Minecraft'' puede convertir archivos Stringified NBT sin comprimir con extensión <samp>.snbt</samp> en una carpeta de entrada a archivos de formato NBT comprimidos con GZip con extensión <samp>.nbt</samp> en una carpeta de salida y viceversa.

El generador de datos Vanilla puede convertir cualquier formato NBT comprimido con GZip a formato SNBT. Simplemente puede cambiar la extensión de archivo de un archivo, como [[Level format#level.dat format|<samp>level.dat</samp>]] a <samp>level.nbt</samp> y ponerlo en la entrada y el generador decodificará los datos NBT comprimidos con GZip.

=== Software de terceros ===
La comunidad ha desarrollado programas para ver y modificar archivos NBT comprimidos y sin comprimir:
{| class="wikitable" style="width: 100%" data-description="NBT editing software"
|-
! Nombre
! NBT Version
! Descripción
! Capturas
|-
| [https://github.com/terminal625/cl-nbt CL-NBT]
| {{Tabla de opción|no|19132|style=text-align:center}}
| CL-NBT es una implementación NBT en Common Lisp que puede leer y escribir archivos NBT y cargar y guardar archivos McRegion. El formato del yunque funciona con ligeras modificaciones.
|-
| [http://www.minecraftforum.net/forums/mapping-and-modding/minecraft-tools/1261629-mineback-minecraft-automated-backup-single-player/ MineBack Ultimate]
| {{Tabla de opción|yes|19133|style=text-align:center}}
| MineBack Ultimate proporciona un editor NBT completo que admite todos los tipos de archivos de formato NBT disponibles (Mapa, Nivel, Mundo, etc.). Viene con una GUI moderna y muchas funciones auxiliares.
|[[File:MineBackNBTEditor.png|128px]]
|-
| [https://github.com/twoolie/nbt NBT for Python]
| {{Tabla de opción|yes|19133|style=text-align:center}}
| Biblioteca para analizar y escribir archivos NBT, tanto independientes como en archivos de región, hecho en el lenguaje de Python. Se proporcionan ejemplos de aplicaciones para inspeccionar y editar los archivos de datos de Minecraft (estadísticas de bloque / cofre / mobs y mapeo mundial simple). Admite los antiguos formatos McRegion, pre-aplanado y los últimos Anvil.
|-
| [http://www.minecraftforum.net/topic/6661-nbtedit/ NBTEdit]
| {{Tabla de opción|no|19132|style=text-align:center}}
| Permite ver y modificar archivos NBT a través de un control de árbol de Windows. Está desactualizado no solo por ser una versión NBT antigua, sino porque no admite múltiples etiquetas con el mismo nombre y fuerza rangos incorrectos en algunos tipos, y carece de soporte para archivos NBT sin comprimir.
| [[File:NBTEdit Level.Dat.png|128px]]
|-
| [[Programs and editors/NBTExplorer|NBTExplorer]] - [http://www.minecraftforum.net/topic/840677-nbtexplorer/ Forum Post]
| {{Tabla de opción|yes|19133|style=text-align:center}}
| Inspirado y basado en NBTEdit, este programa permite ver y editar archivos NBT a través de un control de árbol de Windows. Admite archivos NBT comprimidos y sin comprimir, y permite la edición directa de las estructuras NBT en archivos [[MCRegion]] y [[Anvil file format | Anvil]], [[level.dat]], etc.
| [[File:NBTExplorer.png|128px]]
|-
| [http://www.minecraftforum.net/topic/2078055-nbt-decoding-grammar-for-synalyze-it-mac-os-x/ NBT grammar for Synalyze It!]
| {{Tabla de opción|no|19132|style=text-align:center}}
| Usando esta gramática Synalyze It! muestra un volcado hexadecimal codificado por colores junto con el árbol de etiquetas analizadas. Actualmente solo se admiten archivos sin comprimir.
| [[File:Synalyze-It-NBT-decoded.png|128px]]
|-
| [http://www.minecraftforum.net/topic/63854-neinedit-nbt-editor-for-mac-os-x/ NEINedit]
| {{Tabla de opción|no|19132|style=text-align:center}}
| NTB Editor para mac con una estructura de árbol basada en texto.
| [[File:NEINedit.png|128px]]
|-
| [https://pypi.python.org/pypi/nbt2yaml NBT2YAML]
| {{Tabla de opción|yes|19133|style=text-align:center}}
| nbt2yaml presenta una interfaz de línea de comandos para leer y editar archivos Minecraft NBT usando un formato YAML personalizado. También incluye una API de Python para analizar y escribir archivos NBT desde una estructura de datos Python simple.
|-
| [https://irath96.github.io/webNBT/ webNBT]
| {{Tabla de opción|yes|19133|style=text-align:center}}
| webNBT es un editor NBT que se ejecuta en navegadores modernos sin requerir que el usuario descargue una aplicación o use complementos de navegador de terceros (como Flash o JavaScript).
| 
|}

== Historial ==
{{Historial|java}}
{{Historial||1.0.0|snap=28 de septiembre de 2011|slink={{tweet|notch|119296531592515584}}|Notch publico en twitter "Estoy trabajando en una forma de guardar datos arbitrarios con instancias de elementos."}}
{{h||1.12|snap=?|Se agregaron las etiquetas de matriz larga {{nbt|long array}}.}}
{{h||1.13|snap=18w01a|Se agregó un generador de datos tanto a ''Minecraft'' [[client.jar|client]] como al software multijugador predeterminado.}}
{{h||1.14|snap=19w08a|{{nbt|string}} Las etiquetas de cadena ahora pueden estar entre comillas simples {{Código|'}} además de comillas dobles {{Código|"}}.<ref>{{cita|url=https://github.com/Mojang/brigadier/pull/52|title=Allow single quote in strings by boq · Pull Request #52 |website=Mojang/brigadier – GitHub}}</ref>}}
{{Historial|foot}}

== Referencias ==
{{Lista de referencias}}

{{Java Edition}}

[[de:NBT]]
[[en:NBT format]]
[[fr:Format NBT]]
[[ja:NBTフォーマット]]
[[nl:NBT formaat]]
[[pt:Formato NBT]]
[[ru:Формат NBT]]
[[zh:NBT格式]]