Skip to content

Commit c7890b1

Browse files
Deploying to main from @ saicone/rtag@08ed7bf 🚀
1 parent f98be8c commit c7890b1

File tree

10 files changed

+55
-55
lines changed

10 files changed

+55
-55
lines changed

i18n/es/docusaurus-plugin-content-docs/current/rtag/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
sidebar_position: 1
33
title: Rtag
4-
description: La librería de "leer NBTTagCompound" en una forma fácil.
4+
description: La librería para manejar datos de Minecraft de forma sencilla.
55
---
66

77
Bienvenid@ a la wiki de Rtag, aquí encontrarás información sobre como utilizar Rtag además de sus posibilidades dentro de la "customización" de un servidor de Minecraft.

i18n/es/docusaurus-plugin-content-docs/current/rtag/advanced/explanation.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ String sameObject = (String) mirror.getTagValue(nbtTag);
5454

5555
## Instancia principal de Rtag
5656

57-
Es el propio Rtag, con esta instancia puedes editar cualquier `NBTTagCompound` y `NBTTagList` de una manera simple, puedes agregar y remover objetos utilizando una estructura de datos de árbol para las rutas.
57+
Es el propio Rtag, con esta instancia puedes editar cualquier `CompoundTag` y `ListTag` de una manera simple, puedes agregar y remover objetos utilizando una estructura de datos de árbol para las rutas.
5858

5959
Incluyendo compatibilidad con objetos custom al registrar un (de)serializador.
6060

@@ -64,7 +64,7 @@ Rtag rtag = new Rtag();
6464
// Usar la instancia pública
6565
Rtag rtag = Rtag.INSTANCE;
6666

67-
// Un objeto NBTTagCompound
67+
// Un objeto CompoundTag
6868
Object compound = ...;
6969

7070
String str = "My String";

i18n/es/docusaurus-plugin-content-docs/current/rtag/advanced/minecraft.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ El class `ItemObject` sirve para manejar items de Bukkit y Minecraft utilizando
1212

1313
### Crear
1414

15-
Crear un `ItemStack` de Minecraft utilizando un `NBTTagCompound`, también mediante otros formatos.
15+
Crear un `ItemStack` de Minecraft utilizando un `CompoundTag`, también mediante otros formatos.
1616

1717
```java
1818
// Crear utilizando un compound
@@ -45,10 +45,10 @@ Editar varias cosas de los `ItemStack` de Bukkit y Minecraft.
4545
```java
4646
Object item = ItemObject.newItem(TagCompound.newTag("{id:\"minecraft:diamond_sword\"}"));
4747

48-
// Guardar los datos del item en un NBTTagCompound
48+
// Guardar los datos del item en un CompoundTag
4949
Object compound = ItemObject.save(item);
5050

51-
// Obtener el tag del item como un NBTTagCompound
51+
// Obtener el tag del item como un CompoundTag
5252
Object tag = ItemObject.getCustomDataTag(item);
5353
// Reemplazar el tag del item
5454
ItemObject.setCustomDataTag(item, tag);
@@ -90,9 +90,9 @@ Editar varias cosas de los `Entity` de Minecraft.
9090
```java
9191
Object entity = ...;
9292

93-
// Guardar los datos de la entidad en un NBTTagCompound
93+
// Guardar los datos de la entidad en un CompoundTag
9494
Object compound = EntityObject.save(entity);
95-
// Cargar los datos en una entidad utilizando un NBTTagCompound
95+
// Cargar los datos en una entidad utilizando un CompoundTag
9696
EntityObject.load(entity, compound);
9797
```
9898

@@ -102,24 +102,24 @@ El class `BlockObject` sirve para manejar bloques de Bukkit y Minecraft utilizan
102102

103103
### Convertir
104104

105-
Convertir cualquier `Block` de Bukkit en un `TileEntity` de Minecraft (solo si es aplicable).
105+
Convertir cualquier `Block` de Bukkit en un `BlockEntity` de Minecraft (solo si es aplicable).
106106

107107
```java
108108
Block block = ...;
109109

110-
// Convertir en un TileEntity de Minecraft
111-
Object mcTileEntity = BlockObject.getTileEntity(block);
110+
// Convertir en un BlockEntity de Minecraft
111+
Object blockEntity = BlockObject.getTileEntity(block);
112112
```
113113

114114
### Editar
115115

116-
Editar varias cosas de los `TileEntity` de Minecraft.
116+
Editar varias cosas de los `BlockEntity` de Minecraft.
117117

118118
```java
119119
Object tileEntity = ...;
120120

121-
// Guardar los datos del TileEntity en un NBTTagCompound
121+
// Guardar los datos del BlockEntity en un CompoundTag
122122
Object compound = BlockObject.save(tileEntity);
123-
// Cargar los datos en un TileEntity utilizando un NBTTagCompound
123+
// Cargar los datos en un BlockEntity utilizando un CompoundTag
124124
BlockObject.load(tileEntity, compound);
125125
```

i18n/es/docusaurus-plugin-content-docs/current/rtag/advanced/tags.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -51,10 +51,10 @@ Object value = TagBase.getValue(mirror, nbtObject);
5151

5252
## TagList
5353

54-
Es un class más específico para manejar cualquier `NBTTagList` como si fuera en java un `List<NBTBase>`, tambíén tiene los métodos mencionados anteriormente del class `TagBase`, pero solo funcionan para las listas de NBT.
54+
Es un class más específico para manejar cualquier `ListTag` como si fuera en java un `List<Tag>`, tambíén tiene los métodos mencionados anteriormente del class `TagBase`, pero solo funcionan para las listas de NBT.
5555

5656
```java
57-
// Crear un NBTTagList
57+
// Crear un ListTag
5858
Object nbtList = TagList.newTag();
5959

6060
// Agregar un valor
@@ -66,7 +66,7 @@ int size = TagList.size(nbtList);
6666
// Obtener un valor desde su posición
6767
Object nbtObject = TagList.get(nbtList, 0); // posición: 0
6868

69-
// Obtener el valor dentro de la instancia de NBTTagList, una lista de NBTBase
69+
// Obtener el valor dentro de la instancia de ListTag, una lista de Tag
7070
List<Object> value = TagList.getValue(nbtList);
7171

7272
// Limpiar la lista
@@ -75,12 +75,12 @@ TagList.clear(nbtList);
7575

7676
## TagCompound
7777

78-
Es un class más específico para manejar cualquier `NBTTagCompound` como si fuera en java un `Map<String, NBTBase>`, tambíén tiene los métodos mencionados anteriormente del class `TagBase`, pero solo funcionan para los NBTTagCompound.
78+
Es un class más específico para manejar cualquier `CompoundTag` como si fuera en java un `Map<String, Tag>`, tambíén tiene los métodos mencionados anteriormente del class `TagBase`, pero solo funcionan para los CompoundTag.
7979

8080
```java
81-
// Crear un NBTTagCompound
81+
// Crear un CompoundTag
8282
Object nbtCompound = TagCompound.newTag();
83-
// O crear un NBTTagCompound utilizando un SNBT (también es compatible con json)
83+
// O crear un CompoundTag utilizando un SNBT (también es compatible con json)
8484
Object nbtCompound = TagCompound.newTag("{greeting:\"Hello\",someValue:123}");
8585

8686
// Agregar un valor
@@ -92,10 +92,10 @@ int size = TagCompound.getValue(nbtCompound).size();
9292
// Obtener un valor utilizando su key
9393
Object nbtObject = TagCompound.get(nbtCompound, "greeting");
9494

95-
// Obtener el valor dentro de la instancia de NBTTagCompound, un Map de NBTBase
95+
// Obtener el valor dentro de la instancia de CompoundTag, un Map de Tag
9696
Map<String, Object> value = TagCompound.getValue(nbtCompound);
9797

98-
// Obtener el NBTTagCompound como si fuera un String en formato Json
98+
// Obtener el CompoundTag como si fuera un String en formato Json
9999
String json = TagCompound.getJson(nbtCompound);
100100

101101
// Limpiar el compound

i18n/es/docusaurus-plugin-content-docs/current/rtag/feature/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ title: Características
44
description: Opciones extra que ofrece Rtag
55
---
66

7-
Rtag tiene una variedad de opciones para manejar los NBTTagCompound.
7+
Rtag tiene una variedad de opciones para manejar los CompoundTag.
88

99
```mdx-code-block
1010
import DocCardList from '@theme/DocCardList';

i18n/es/docusaurus-plugin-content-docs/current/rtag/feature/custom-objects.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,9 @@ Con Rtag puedes establecer objetos custom como NBT y obtenerlos según el tipo d
1010

1111
Al usar la librería Gson dentro del código de Bukkit, es posible (de)serializar objetos mediante el siguiente proceso:
1212

13-
**Serializer (establecer)**: Objeto custom -> String en Json -> Map -> NBTTagCompound
13+
**Serializer (establecer)**: Objeto custom -> String en Json -> Map -> CompoundTag
1414

15-
**Deserializer (obtener)**: NBTTagCompound -> Map -> String en Json -> Objeto custom
15+
**Deserializer (obtener)**: CompoundTag -> Map -> String en Json -> Objeto custom
1616

1717
```java
1818
// Crear tu objeto custom

i18n/es/docusaurus-plugin-content-docs/current/rtag/feature/functions.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ Para entender esta página deberías ver la información sobre [Objetos de Tag](
1313
:::
1414

1515

16-
Las rutas con una estructura de datos de árbol utilizadas en Rtag son bastante simples, así que hay una forma más compleja de manejar las ediciones mediante funciones que aceptan cualquier objeto de `NBTTagCompound` y `NBTTagList` mientras la ruta es resuelta.
16+
Las rutas con una estructura de datos de árbol utilizadas en Rtag son bastante simples, así que hay una forma más compleja de manejar las ediciones mediante funciones que aceptan cualquier objeto de `CompoundTag` y `ListTag` mientras la ruta es resuelta.
1717

1818
## Como usarlo
1919

@@ -41,7 +41,7 @@ Es imposible para una estructura de datos de árbol obtener el valor `value` o e
4141

4242
En un caso normal deberías obtener la lista entera e iterar sobre esta para revisar cual valor tiene `EPIC` en el `id`, lo cual gastaría muchos recursos debido a que Rtag convetirá la lista entera en objetos normales incluyendo valores que no se utilizarán en la operación.
4343

44-
Para resolver eso puedes utilizar rutas funcionales al proveer una función que itera el `NBTTagList` directamente.
44+
Para resolver eso puedes utilizar rutas funcionales al proveer una función que itera el `ListTag` directamente.
4545

4646
```java
4747
// Preparar la función

i18n/es/docusaurus-plugin-content-docs/current/rtag/feature/stream.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ description: Convierte NBT en otros tipos de datos y viceversa
66

77
## Información
88

9-
Rtag tiene la opción de guardar los NBTTagCompound en diferentes formas:
9+
Rtag tiene la opción de guardar los CompoundTag en diferentes formas:
1010

1111
* Archivos
1212
* [Base64](https://en.wikipedia.org/wiki/Base64)
@@ -22,15 +22,15 @@ Incluyendo compatibilidad con objetos serializables.
2222
Cualquier serialización que haya convertido un objeto en un array de bytes (probablemente guardado en Base64) es compatible si está hecha con los siguientes métodos:
2323

2424
1. Usando un `BukkitObjectInputStream` para guardar los objetos como el tipo requerido o como `byte[]`.
25-
2. Usando el class `NBTCompressedStreamTools` para guardar los objetos como `NBTTagCompound`, `NBTTagList` o `NBTTagByteArray` en bytes.
25+
2. Usando el class `NbtIo` para guardar los objetos como `CompoundTag`, `ListTag` o `ByteArrayTag` en bytes.
2626
3. Objetos NBT guardados con el formato GZIP.
2727
4. Objetos NBT guardados dentro de otro objeto NBT (como una lista de nbt o un array de bytes nbt).
2828

2929
:::
3030

3131
## TagCompound Data
3232

33-
El class TagCompound incluido en Rtag contiene una forma fácil para convertir y obtener cualquier NBTTagCompound desde Archivo, Base64, Bytes, Map y String.
33+
El class TagCompound incluido en Rtag contiene una forma fácil para convertir y obtener cualquier CompoundTag desde Archivo, Base64, Bytes, Map y String.
3434

3535
```mdx-code-block
3636
import Tabs from '@theme/Tabs';
@@ -40,7 +40,7 @@ import TabItem from '@theme/TabItem';
4040
<TabItem value="file" label="Archivo" default>
4141
4242
```java
43-
// NBTTagCompound desde cualquer parte
43+
// CompoundTag desde cualquer parte
4444
Object compound = ...;
4545
4646
// Convertirlo en un archivo
@@ -54,7 +54,7 @@ Object tagCompound = TStream.COMPOUND.fromFile(file);
5454
<TabItem value="base64" label="Base64">
5555

5656
```java
57-
// NBTTagCompound desde cualquer parte
57+
// CompoundTag desde cualquer parte
5858
Object compound = ...;
5959

6060
// Convertirlo en Base64
@@ -68,7 +68,7 @@ Object tagCompound = TStream.COMPOUND.fromBase64(base64)[0]; // Devuelve un arra
6868
<TabItem value="bytes" label="Bytes">
6969

7070
```java
71-
// NBTTagCompound desde cualquer parte
71+
// CompoundTag desde cualquer parte
7272
Object compound = ...;
7373

7474
// Convertirlo en un array de bytes
@@ -82,7 +82,7 @@ Object tagCompound = TStream.COMPOUND.fromBytes(bytes);
8282
<TabItem value="map" label="Map">
8383

8484
```java
85-
// NBTTagCompound desde cualquer parte
85+
// CompoundTag desde cualquer parte
8686
Object compound = ...;
8787

8888
// Convertirlo en un Map
@@ -96,7 +96,7 @@ Object tagCompound = TStream.COMPOUND.fromMap(map);
9696
<TabItem value="string" label="String">
9797

9898
```java
99-
// NBTTagCompound desde cualquer parte
99+
// CompoundTag desde cualquer parte
100100
Object compound = ...;
101101

102102
// Convertirlo en un SNBT

i18n/es/docusaurus-plugin-content-docs/current/rtag/intro.md

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -10,28 +10,28 @@ El NBT por sus siglas en inglés significa "Etiqueta Binaria con Nombre" (Named
1010

1111
El formato de NBT es comúnmente utilizado para guardar objetos de Minecraft como mundos, items, entidades... etc.
1212

13-
Los classes de NBT dentro del código de Minecraft están extendidos por `NBTBase` y hacen referencia a objetos normales de Java: `NBTTagString`, `NBTTagInt`, `NBTTagLong`, `NBTTagList`... etc. El class principal de las estructuras de datos NBT sería el `NBTTagCompound` que se refiere a un Map en Java y es el objeto básico para guardar objetos NBT con sus respectivas keys (llaves) en un `Map<String, NBTBase>`.
13+
Los classes de NBT dentro del código de Minecraft están extendidos por `Tag` y hacen referencia a objetos normales de Java: `StringTag`, `IntTag`, `LongTag`, `ListTag`... etc. El class principal de las estructuras de datos NBT sería el `CompoundTag` que se refiere a un Map en Java y es el objeto básico para guardar objetos NBT con sus respectivas keys (llaves) en un `Map<String, Tag>`.
1414

1515
## Objetos compatibles
1616

1717
Los objetos NBT definidos por su número de ID son:
1818

19-
1. **NBTTagByte**: Lo mismo que `byte` en Java.
20-
2. **NBTTagShort**: Lo mismo que `short` en Java.
21-
3. **NBTTagInt**: Lo mismo que `int` en Java.
22-
4. **NBTTagLong**: Lo mismo que `long` en Java.
23-
5. **NBTTagFloat**: Lo mismo que `float` en Java.
24-
6. **NBTTagDouble**: Lo mismo que `double` en Java.
25-
7. **NBTTagByteArray**: Lo mismo que `byte[]` en Java.
26-
8. **NBTTagString**: Lo mismo que `String` en Java.
27-
9. **NBTTagList**: Lo mismo que `List<NBTBase>` en Java.
28-
10. **NBTTagCompound**: Lo mismo que `Map<String, NBTBase>` en Java.
29-
11. **NBTTagIntArray**: Lo mismo que `int[]` en Java.
30-
12. **NBTTagLongArray**: Lo mismo que `long[]` en Java (Agregado en MC 1.12).
19+
1. **ByteTag**: Lo mismo que `byte` en Java.
20+
2. **ShortTag**: Lo mismo que `short` en Java.
21+
3. **IntTag**: Lo mismo que `int` en Java.
22+
4. **LongTag**: Lo mismo que `long` en Java.
23+
5. **FloatTag**: Lo mismo que `float` en Java.
24+
6. **DoubleTag**: Lo mismo que `double` en Java.
25+
7. **ByteArrayTag**: Lo mismo que `byte[]` en Java.
26+
8. **StringTag**: Lo mismo que `String` en Java.
27+
9. **ListTag**: Lo mismo que `List<Tag>` en Java.
28+
10. **CompoundTag**: Lo mismo que `Map<String, Tag>` en Java.
29+
11. **IntArrayTag**: Lo mismo que `int[]` en Java.
30+
12. **LongArrayTag**: Lo mismo que `long[]` en Java (Agregado en MC 1.12).
3131

3232
:::info ¿Y el objeto de boolean?
3333

34-
Seguramente notaste que los booleans no son compatibles, eso es porque son guardados como `byte` (`NBTTagByte`).
34+
Seguramente notaste que los booleans no son compatibles, eso es porque son guardados como `byte` (`ByteTag`).
3535

3636
Así que toma en cuenta que Java por defecto no puede convertir un `byte` en `boolean` de manera automática (pero si al revés jaja), verás una mejor explicación después.
3737

@@ -49,15 +49,15 @@ Así que ha sido un problema frecuente para los desarrolladores que utilizan el
4949

5050
## La magia de Rtag
5151

52-
Para simplificar el uso de NBT, la librería Rtag explicada en inglés como "Tag legible" (readable tag) proveé una forma fácil para manejar los NBTTagCompound y los otros objetos compatibles.
52+
Para simplificar el uso de NBT, la librería Rtag explicada en inglés como "Tag legible" (readable tag) proveé una forma fácil para manejar los CompoundTag y los otros objetos compatibles.
5353

54-
Rtag hace (o lo intenta) una conversión de cualquier objeto de Java en un `NBTBase` y viceversa, y de esta manera manejar los NBT como si fueran objetos normales de java en una forma fácil.
54+
Rtag hace (o lo intenta) una conversión de cualquier objeto de Java en un `Tag` y viceversa, y de esta manera manejar los NBT como si fueran objetos normales de java en una forma fácil.
5555

5656
```java
5757
// OBTENER - Lo verás como un objeto normal
58-
NBTBase -> Object
59-
// ESTABLECER - El servidor lo guardará como un objeto NBTBase
60-
Object -> NBTBase
58+
Tag -> Object
59+
// ESTABLECER - El servidor lo guardará como un objeto Tag
60+
Object -> Tag
6161
```
6262

6363
Actualmente limitado por la conversión de `boolean`, así que es sugerido obtenerlos como `byte` o ejecutar una [conversión explícita](feature/types.md#conversión).

i18n/es/docusaurus-plugin-content-docs/current/rtag/usage/editor.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ title: RtagEditor
44
description: El objeto principal para editar NBT fácilmente
55
---
66

7-
Las instancias de `RtagEditor` (editor de tags) convierten un objeto de Bukkit en uno del servidor de Minecraft y proveen una forma de editar el tag (NBTTagCompound) dentro, usando una instancia de Rtag para manejar las operaciones con NBT.
7+
Las instancias de `RtagEditor` (editor de tags) convierten un objeto de Bukkit en uno del servidor de Minecraft y proveen una forma de editar el tag (CompoundTag) dentro, usando una instancia de Rtag para manejar las operaciones con NBT.
88

99
## Editar
1010

0 commit comments

Comments
 (0)