You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
> Este documento é uma tradução [do original](./HAFN-v2_0.md). Caso observe inconsistências em relação ao conteúdo do jogo neste idioma, por favor, [nos avise](https://github.com/Habbianos/notations/issues/new/choose) para que possamos corrigir a localização.
9
9
10
10
<details><summary>Sumário</summary>
@@ -230,7 +230,7 @@ Embora o HAFN v2 seja uma notação textual e **não execute código**, as imple
230
230
- Ataques de injeção
231
231
- Renderização incorreta devido a entrada malformada
232
232
233
-
> [!IMPORTANTE]
233
+
> [!IMPORTANT]
234
234
> Strings HAFN v2 **não verificam propriedade de roupas ou cores**. Elas representam **apenas aparência** e não devem ser usadas para impor acesso ou propriedade de partes da figura.
235
235
236
236
A adesão estrita à sintaxe e às diretrizes de processamento é necessária para uma implementação segura.
Copy file name to clipboardExpand all lines: avatar-figure/spec/HAFN-v2_0-es.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@
4
4
-**Fecha:** 2025-05-02
5
5
-**Disponible en:**[Inglés (original)](./HAFN-v2_0.md) • [Portugués](./HAFN-v2_0-br.md) • Español
6
6
7
-
> ![NOTE]
7
+
> [!NOTE]
8
8
> Este documento es una traducción [del original](./HAFN-v2_0.md). Si observas inconsistencias con el contenido del juego en este idioma, por favor, [avísanos](https://github.com/Habbianos/notations/issues/new/choose) para que podamos corregir la localización.
9
9
10
10
<details><summary>Índice</summary>
@@ -230,7 +230,7 @@ Aunque HAFN v2 es una notación textual y **no ejecuta código**, las implementa
230
230
- Ataques de inyección
231
231
- Renderización incorrecta debido a inputs malformadas
232
232
233
-
> [!IMPORTANTE]
233
+
> [!IMPORTANT]
234
234
> Las strings HAFN v2 **no verifican la propiedad** de ropa o colores. **Solo representan la apariencia** y no deben usarse para imponer acceso o la propiedad de partes de la figura.
235
235
236
236
La estricta adherencia al syntax y a las directrices de procesamiento son requeridas para una implementación segura.
Copy file name to clipboardExpand all lines: group-badge/README.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ Available Specifications:
4
4
5
5
-[HGBN v1.0](spec/HGBN-v1_0.md)
6
6
-**Specification Status:** Draft
7
-
-**Date:** 2025-04-18
7
+
-**Date:** 2025-05-02
8
8
-**Available in:** English
9
9
-**Summary:** The text-based notation designed to represent group badges within the Habbo ecosystem. It encodes structured badge data as a single string composed of multiple six-character segments. Each segment defines either a base image asset or a symbol overlay, including data about the asset id, tint color, and its placement on a 3×3 grid.
Copy file name to clipboardExpand all lines: group-badge/spec/HGBN-v1_0.md
+4-2Lines changed: 4 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
# **Habbo Group Badge Notation (HGBN) v1.0**
2
2
3
3
-**Specification Status:** Draft
4
-
-**Date:** 2025-04-18
4
+
-**Date:** 2025-05-02
5
5
-**Available in:** English
6
6
7
7
<details><summary>Table of Contents</summary>
@@ -81,7 +81,7 @@ A valid HGBN string **MUST**:
81
81
82
82
A HGBN v1 string represents a complete badge by concatenating multiple six-character segments. The string is always ordered starting with the asset that should be at the bottom (base, identified by `b`), followed by the assets on top (symbols, identified by `s`).
83
83
84
-
> ![NOTE]
84
+
> [!NOTE]
85
85
> The trailing hash in the file name (e.g., `b01bfc395d8c4be707922c3da5b3f561`) is probably used for image caching and security and is **ignored in the notation specification**.
86
86
87
87
### **5.2. Grammar**
@@ -262,3 +262,5 @@ Strict adherence to the syntax and processing guidelines is required for safe im
> Este documento é uma tradução [do original](./HGBN-v1_1.md). Caso observe inconsistências em relação ao conteúdo do jogo neste idioma, por favor, [nos avise](https://github.com/Habbianos/notations/issues/new/choose) para que possamos corrigir a localização.
9
9
10
10
<details><summary>Sumário</summary>
@@ -84,7 +84,7 @@ Uma string HGBN válida **DEVE**:
84
84
85
85
Uma string HGBN v1 representa um emblema completo concatenando múltiplos segmentos de seis caracteres. A string sempre começa pelo recurso base (identificado por `b`), seguido pelos símbolos sobrepostos (identificados por `s` ou `t`).
86
86
87
-
> ![NOTE]
87
+
> [!NOTE]
88
88
> O hash final no nome do arquivo (por exemplo, `b01bfc395d8c4be707922c3da5b3f561`) provavelmente é usado para cache de imagem e segurança e **é ignorado na especificação da notação**.
89
89
90
90
### **5.2. Gramática**
@@ -480,3 +480,5 @@ As tabelas a seguir listam os mapeamentos aprovados de ativos. Implementadores e
Copy file name to clipboardExpand all lines: group-badge/spec/HGBN-v1_1-es.md
+42-40Lines changed: 42 additions & 40 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@
4
4
-**Date:** 2025-05-02
5
5
-**Available in:**[Inglés (original)](./HGBN-v1_1.md) • [Portugués](./HGBN-v1_1-br.md) • Español
6
6
7
-
> ![NOTE]
7
+
> [!NOTE]
8
8
> Este documento es una traducción [del original](./HGBN-v1_1.md). Si observas inconsistencias con el contenido del juego en este idioma, por favor, [avísanos](https://github.com/Habbianos/notations/issues/new/choose) para que podamos corregir la localización.
9
9
10
10
<details><summary>Índice</summary>
@@ -29,7 +29,7 @@ Aunque HGBN v1 refleja la definición actual del diseño de insignias, **no es u
29
29
30
30
Esta especificación existe para formalizar y documentar cómo Habbo Hotel procesa **componentes de insignias de grupo**. Está dirigida a:
31
31
32
-
-**Una especificación no oficial**, lo que significa que Sulake puede no adoptar las actualizaciones.
32
+
-**Una especificación no oficial**, lo que significa que Sulake puede no adoptar las actualizaciones.
33
33
-**Destinada a documentación e interoperabilidad**, permitiendo que desarrolladores analicen, generen y manipulen insignias de grupo fuera del juego.
34
34
35
35
HGBN **no es un estándar mantenido por Sulake**, y sus extensiones futuras **PUEDEN NO** reflejarse en la implementación del juego.
@@ -38,13 +38,13 @@ HGBN **no es un estándar mantenido por Sulake**, y sus extensiones futuras **PU
38
38
39
39
HGBN v1 es una representación textual de símbolos en capas diseñada para:
40
40
41
-
-**Almacenar configuraciones de insignias** como una cadena de texto compacta
42
-
-**Análisis y generación programática** por desarrolladores e investigadores
43
-
- Facilitar la **interoperabilidad** de herramientas que representen, manipulen o analicen insignias de grupo de Habbo
41
+
-**Almacenar configuraciones de insignias** como una cadena de texto compacta
42
+
-**Análisis y generación programática** por desarrolladores e investigadores
43
+
- Facilitar la **interoperabilidad** de herramientas que representen, manipulen o analicen insignias de grupo de Habbo
44
44
45
45
### **1.3. Audiencia**
46
46
47
-
Esta especificación está dirigida a desarrolladores, investigadores, archivistas y entusiastas de la comunidad de Habbo Hotel, particularmente aquellos que trabajan en herramientas para insignias de grupo de Habbo. También sirve como referencia común para comprender, implementar y manipular la Notación de Insignias de Grupo de Habbo (HGBN), que puede usarse en tareas como el desarrollo de software interoperable, emuladores y documentación para proyectos de fans. El público también incluye científicos de datos que puedan utilizar esta notación en investigaciones o análisis relacionados con imágenes. Se recomienda, pero no es obligatorio, familiaridad con conceptos básicos de programación, manipulación de cadenas y manipulación de imágenes.
47
+
Esta especificación está dirigida a desarrolladores, investigadores, archivistas y entusiastas de la comunidad de Habbo Hotel, particularmente aquellos que trabajan en herramientas para insignias de grupo de Habbo. También sirve como referencia común para comprender, implementar y manipular la Notación de Insignias de Grupo de Habbo (HGBN), que puede usarse en tareas como el desarrollo de software interoperable, emuladores y documentación para proyectos de fans. El público también incluye científicos de datos que puedan utilizar esta notación en investigaciones o análisis relacionados con imágenes. Se recomienda, pero no es obligatorio, familiaridad con conceptos básicos de programación, manipulación de cadenas y manipulación de imágenes.
48
48
49
49
---
50
50
@@ -66,15 +66,15 @@ Las palabras clave "DEBE", "NO DEBE", "OBLIGATORIO", "DEBERÁ", "NO DEBERÁ", "R
66
66
67
67
Una implementación se considera conforme con HGBN v1.1 si sigue la sintaxis, las reglas de procesamiento y las restricciones definidas en este documento. Un analizador (parser) conforme:
68
68
69
-
-**DEBE** soportar al menos un segmento base seguido de uno o más segmentos de símbolo.
70
-
-**DEBE** rechazar cadenas de insignia que violen las reglas estructurales o las restricciones de valor.
71
-
-**PUEDE** extender la funcionalidad mediante extensiones no oficiales, siempre que **NO INTERFIERAN** con la conformidad central.
69
+
-**DEBE** soportar al menos un segmento base seguido de uno o más segmentos de símbolo.
70
+
-**DEBE** rechazar cadenas de insignia que violen las reglas estructurales o las restricciones de valor.
71
+
-**PUEDE** extender la funcionalidad mediante extensiones no oficiales, siempre que **NO INTERFIERAN** con la conformidad central.
72
72
73
73
Una cadena HGBN válida **DEBE**:
74
74
75
-
1. Seguir la definición de sintaxis en la [Sección 5](#5-definición-de-sintaxis).
76
-
2. Utilizar el formato de datos correcto (identificadores de segmento, números de longitud fija y dígitos de posición).
77
-
3. Asegurar que los asset IDs y los color IDs tengan exactamente dos dígitos cada uno, y que la posición sea un único dígito que represente un valor en una cuadrícula 3×3.
75
+
1. Seguir la definición de sintaxis en la [Sección 5](#5-definición-de-sintaxis).
76
+
2. Utilizar el formato de datos correcto (identificadores de segmento, números de longitud fija y dígitos de posición).
77
+
3. Asegurar que los asset IDs y los color IDs tengan exactamente dos dígitos cada uno, y que la posición sea un único dígito que represente un valor en una cuadrícula 3×3.
78
78
79
79
---
80
80
@@ -84,7 +84,7 @@ Una cadena HGBN válida **DEBE**:
84
84
85
85
Una cadena HGBN v1 representa un emblema completo concatenando múltiples segmentos de seis caracteres. La cadena siempre comienza con el recurso que debe estar en la base (identificado por `b`), seguido por los recursos superiores (símbolos, identificados por `s` o `t`).
86
86
87
-
> ![NOTE]
87
+
> [!NOTE]
88
88
> El hash final en el nombre de archivo (por ejemplo, `b01bfc395d8c4be707922c3da5b3f561`) probablemente se usa para caché y seguridad de imágenes, y **se IGNORA en la especificación de notación**.
89
89
90
90
### **5.2. Gramática**
@@ -126,15 +126,15 @@ La siguiente expresión regular puede usarse para validar la estructura general
126
126
127
127
### **6.1. Semántica de Composición de Insignias**
128
128
129
-
- El **segmento base** es la base de la insignia y **DEBE** aparecer como el primer segmento.
130
-
- Los **segmentos de símbolo****DEBEN** superponerse sobre el segmento base en el orden en que aparecen en la cadena.
131
-
- El orden de los símbolos afecta la renderización, ya que los símbolos anteriores pueden aparecer debajo de los posteriores.
129
+
- El **segmento base** es la base de la insignia y **DEBE** aparecer como el primer segmento.
130
+
- Los **segmentos de símbolo****DEBEN** superponerse sobre el segmento base en el orden en que aparecen en la cadena.
131
+
- El orden de los símbolos afecta la renderización, ya que los símbolos anteriores pueden aparecer debajo de los posteriores.
132
132
133
133
### **6.2. Consideraciones de Renderización**
134
134
135
-
- El **assetId** corresponde a un recurso de imagen específico almacenado en el sistema.
136
-
- El **colorId** indica cómo se debe teñir la imagen del recurso. Las porciones no coloreables (máscara) del recurso permanecen sin cambios.
137
-
- El valor de **posición**, dentro de una cuadrícula 3×3 (posiciones 0–8), determina dónde se coloca el recurso. Las implementaciones **DEBEN** renderizar el recurso en la celda correspondiente de la cuadrícula. El recurso **NO DEBE** desbordar el área de la insignia.
135
+
- El **assetId** corresponde a un recurso de imagen específico almacenado en el sistema.
136
+
- El **colorId** indica cómo se debe teñir la imagen del recurso. Las porciones no coloreables (máscara) del recurso permanecen sin cambios.
137
+
- El valor de **posición**, dentro de una cuadrícula 3×3 (posiciones 0–8), determina dónde se coloca el recurso. Las implementaciones **DEBEN** renderizar el recurso en la celda correspondiente de la cuadrícula. El recurso **NO DEBE** desbordar el área de la insignia.
138
138
139
139
### **6.3. Manejo de Errores**
140
140
@@ -145,7 +145,7 @@ La siguiente expresión regular puede usarse para validar la estructura general
145
145
|**ERR_INVALID_POSITION**|`position` no es un dígito entre 0 y 8. |
146
146
|**ERR_SYNTAX**| Falta segmentos o delimitadores requeridos en la cadena. |
147
147
148
-
Un parser conforme con HGBN **DEBE** rechazar cadenas inválidas y reportar el error apropiado.
148
+
Un parser conforme con HGBN **DEBE** rechazar cadenas inválidas y reportar el error apropiado.
149
149
150
150
---
151
151
@@ -196,23 +196,23 @@ b12063s78110t00118t27114
196
196
197
197
Posibles extensiones futuras de HGBN **PUEDEN** incluir:
198
198
199
-
1.**Tipos de Segmento Adicionales:** Más identificadores además de `b`, `s` y `t` para soportar nuevas funcionalidades.
200
-
2.**Intervalos Expandibles:** Extensión de los rangos de asset IDs o color IDs para futuros diseños visuales.
201
-
3.**Mejoras Posicionales:** Definición de posicionamientos más granulares o prioridades de superposición más allá de la cuadrícula básica 3×3.
199
+
1.**Tipos de Segmento Adicionales:** Más identificadores además de `b`, `s` y `t` para soportar nuevas funcionalidades.
200
+
2.**Intervalos Expandibles:** Extensión de los rangos de asset IDs o color IDs para futuros diseños visuales.
201
+
3.**Mejoras Posicionales:** Definición de posicionamientos más granulares o prioridades de superposición más allá de la cuadrícula básica 3×3.
202
202
203
-
Las revisiones de la especificación **DEBERÁN** versionarse adecuadamente, y la retrocompatibilidad **PUEDEN** mantenerse cuando sea posible.
203
+
Las revisiones de la especificación **DEBERÁN** versionarse adecuadamente, y la retrocompatibilidad **PUEDEN** mantenerse cuando sea posible.
204
204
205
205
---
206
206
207
207
## **9. Consideraciones de Seguridad**
208
208
209
209
Aunque HGBN es una notación textual y **no ejecuta código**, las implementaciones **DEBEN** sanitizar y validar rigurosamente las cadenas de entrada para prevenir:
210
210
211
-
- Desbordamientos de búfer
212
-
- Ataques de inyección
213
-
- Renderización incorrecta debido a entradas malformadas
211
+
- Desbordamientos de búfer
212
+
- Ataques de inyección
213
+
- Renderización incorrecta debido a entradas malformadas
214
214
215
-
La estricta adherencia a la sintaxis y a las directrices de procesamiento es requerida para una implementación segura.
215
+
La estricta adherencia a la sintaxis y a las directrices de procesamiento es requerida para una implementación segura.
216
216
217
217
---
218
218
@@ -461,20 +461,22 @@ Las siguientes tablas enumeran los mapeos de activos aprobados. Los implementado
461
461
462
462
## **12. Referencias**
463
463
464
-
-*[API de Grupos Habbo](https://www.habbo.com.br/api/public/groups/g-hhbr-d5c67dd48b87d8b62f5a6a14ebbf4d8d)*
465
-
-*[Servicio de Renderizado de Insignias de Grupo Habbo](https://www.habbo.com.br/habbo-imaging/badge/b12134s47114s46114s48114s45114f6bbe1ccfa2e8dd23d17c70895929672.png)* (también disponible en `.gif` y vía `badge-fill` para fondo no transparente)
464
+
-*[API de Grupos Habbo](https://www.habbo.com.br/api/public/groups/g-hhbr-d5c67dd48b87d8b62f5a6a14ebbf4d8d)*
465
+
-*[Servicio de Renderizado de Insignias de Grupo Habbo](https://www.habbo.com.br/habbo-imaging/badge/b12134s47114s46114s48114s45114f6bbe1ccfa2e8dd23d17c70895929672.png)* (también disponible en `.gif` y vía `badge-fill` para fondo no transparente)
466
466
467
467
---
468
468
469
469
### **Registro de Cambios**
470
470
471
-
-**v1.1.0 – 2025‑04‑12**
472
-
- Actualización desde `v1.0` con nueva información encontrada.
473
-
- Llenado de las tablas de referencia.
474
-
- Corrección de los IDs de posición con índice cero.
475
-
- Ajustes menores del borrador.
476
-
-**v1.1.1 – 2025‑04‑17**
477
-
- Estandarización de la estructura de la especificación.
478
-
- Ajustes menores del borrador.
479
-
-**v1.1.2 – 2025‑04‑18**
480
-
- Correcciones gramaticales menores.
471
+
-**v1.1.0 – 2025‑04‑12**
472
+
- Actualización desde `v1.0` con nueva información encontrada.
473
+
- Llenado de las tablas de referencia.
474
+
- Corrección de los IDs de posición con índice cero.
475
+
- Ajustes menores del borrador.
476
+
-**v1.1.1 – 2025‑04‑17**
477
+
- Estandarización de la estructura de la especificación.
478
+
- Ajustes menores del borrador.
479
+
-**v1.1.2 – 2025‑04‑18**
480
+
- Correcciones gramaticales menores.
481
+
-**v1.1.3 - 2025-05-02**
482
+
- Corrección de la etiqueta de alerta de Markdown.
Copy file name to clipboardExpand all lines: group-badge/spec/HGBN-v1_1.md
+3-1Lines changed: 3 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -81,7 +81,7 @@ A valid HGBN string **MUST**:
81
81
82
82
A HGBN v1 string represents a complete badge by concatenating multiple six-character segments. The string is always ordered starting with the asset that should be at the bottom (base, identified by `b`), followed by the assets on top (symbols, identified by `s` or `t`).
83
83
84
-
> ![NOTE]
84
+
> [!NOTE]
85
85
> The trailing hash in the file name (e.g., `b01bfc395d8c4be707922c3da5b3f561`) is probably used for image caching and security and is **ignored in the notation specification**.
86
86
87
87
### **5.2. Grammar**
@@ -477,3 +477,5 @@ The following tables list the approved asset mappings. Implementers and develope
0 commit comments