> ## Documentation Index
> Fetch the complete documentation index at: https://docs.headlesslabs.xyz/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Emoji

> Headless ofrece dos funciones relacionadas con emojis: copiar emojis personalizados al servidor y configurar emojis de respuesta del bot. No son el mismo catálogo ni tienen los mismos permisos.

> **Requisitos**
>
> Quien copia necesita **Manage Expressions** o permiso equivalente. Headless necesita Manage Emojis and Stickers y deben quedar slots disponibles.

> **Lotes**
>
> Agrupa emojis con `.emoji copy-batch`; revisa el reporte final porque algunos pueden copiarse aunque otros fallen.

> **Organización**
>
> Usa nombres claros, evita duplicados y prueba primero con pocos elementos.

> [!NOTE]
>
> Copiar emojis al servidor, editar la apariencia global del bot y administrar el pack visual Headless son operaciones separadas, con permisos y almacenamiento diferentes.

## Copiar emojis al servidor

`.emoji copy <emoji> [nombre]` y `.emoji copy-batch <emojis...>` requieren `Manage Emojis`. El bot necesita permiso para crear emojis y espacio disponible en el servidor. Los fallos de permisos o del límite de emojis se informan. Discord puede mostrar este permiso como `Manage Expressions`; `.emoji copy-batch` acepta los aliases `batch` y `multi`, y `.emoji copy` acepta `clonar` e `import`.

### Copiar un emoji

```headless-command Syntax theme={null}
.emoji copy <emoji> [name]
```

```headless-command Example theme={null}
.emoji copy <:emoji_name:REAL_ID> nombre
```

### Copiar un lote

```headless-command Syntax theme={null}
.emoji copy-batch <emojis>
```

```headless-command Example theme={null}
.emoji copy-batch <:first:REAL_ID> <:second:REAL_ID>
```

> [!NOTE]
>
> Reemplaza `REAL_ID` y los nombres de ejemplo por el marcado de emojis personalizados accesibles que copias desde Discord. Los valores son marcadores de posición, no IDs universales.

## Emojis de respuesta del bot

`/emoji view` requiere `Manage Server`; `/emoji set` y `/emoji reset` requieren `Administrator`. Las claves editables incluyen success, error, warn, verified, brand, typing, log, log\_arrow y log\_link. Los cambios se aplican en runtime y se guardan en la configuración del bot; el reset global conserva el mapeo del pack visual Headless. `/emoji reset` admite una clave opcional: sin clave restablece todos los emojis de respuesta editables.

```headless-command Syntax theme={null}
/emoji view
```

```headless-command Example theme={null}
/emoji view
```

```headless-command Syntax theme={null}
/emoji set key:<key> emoji:<emoji>
```

```headless-command Example theme={null}
/emoji set key:success emoji:✅
```

```headless-command Syntax theme={null}
/emoji reset [key:<key>]
```

```headless-command Example theme={null}
/emoji reset key:success
```

## Entradas válidas

Los emojis personalizados deben ser accesibles por el bot. La copia descarga el recurso desde Discord y crea una copia en este servidor; no transforma el emoji en una asignación de rol ni conserva el ID original.

## Lotes y nombres

El lote presenta por separado los emojis copiados y los fallidos; un fallo no revierte las copias que sí se crearon. Empieza con pocos elementos, usa nombres válidos y claros, evita duplicados y revisa el resultado final antes de repetir el lote.

## Tema visual Headless

`.emoji headless status` muestra el estado del tema y los espacios disponibles en el servidor actual. `install` instala el pack Core de 24 emojis; `extend` añade hasta 76 iconos opcionales y permite una instalación parcial si se agotan los espacios. La instalación requiere `Manage Emojis` para quien invoca y `Manage Emojis and Stickers` para el bot. El mapa visual se persiste a nivel del bot y registra el servidor de instalación. `extend`, `rollback`, `refresh CONFIRMAR` y `purge CONFIRMAR` solo se aceptan desde ese servidor. `rollback` vuelve al mapeo genérico sin borrar archivos; `refresh` sustituye los PNGs registrados; `purge` exige rollback previo y elimina solo IDs rastreados por el pack. La X roja y los avisos amarillos permanecen protegidos.

> [!NOTE]
>
> Las instalaciones antiguas sin `guild_id` guardado rechazan el mantenimiento por seguridad. Ejecuta `.emoji headless install` en el servidor que contiene el pack para registrar su ámbito antes de usar esos comandos.

```headless-command Syntax theme={null}
.emoji headless status
```

```headless-command Example theme={null}
.emoji headless status
```

```headless-command Syntax theme={null}
.emoji headless install
```

```headless-command Example theme={null}
.emoji headless install
```

```headless-command Syntax theme={null}
.emoji headless extend
```

```headless-command Example theme={null}
.emoji headless extend
```

```headless-command Syntax theme={null}
.emoji headless rollback
```

```headless-command Example theme={null}
.emoji headless rollback
```

```headless-command Syntax theme={null}
.emoji headless refresh [confirmation]
```

```headless-command Example theme={null}
.emoji headless refresh CONFIRMAR
```

```headless-command Syntax theme={null}
.emoji headless purge [confirmation]
```

```headless-command Example theme={null}
.emoji headless purge CONFIRMAR
```

## Mantenimiento del tema

> **Rollback, refresh y purge**
>
> `rollback` apaga el tema y vuelve al respaldo genérico sin borrar archivos. `refresh CONFIRMAR` elimina y recrea solo los emojis registrados por este pack. `purge CONFIRMAR` requiere rollback y elimina solo los IDs rastreados; si Discord rechaza un borrado o no puede resolver un ID, Headless conserva ese mapeo para que puedas corregir permisos o caché y volver a intentarlo.

> **Alcance del pack**
>
> El estado y el mapeo del tema se guardan a nivel del bot. `extend`, `rollback`, `refresh` y `purge` comparan el servidor actual con el `guild_id` de instalación antes de cambiar estado o emojis. Si el ID falta o no coincide, el comando falla sin cambios.

## Referencia de comandos

> **Referencia completa de comandos**
>
> * **`.emoji` (`.emojis`, `.em`)** — **Permiso de la persona:** Manage Emojis · **Resultado:** Muestra los subcomandos para copiar emojis.
> * **`.emoji copy <emoji> [name]` (`clonar`, `import`)** — **Permiso de la persona:** Manage Emojis · **Resultado:** Copia un emoji accesible al servidor actual; Headless necesita Manage Emojis and Stickers.
> * **`.emoji copy-batch <emojis>` (`batch`, `multi`)** — **Permiso de la persona:** Manage Emojis · **Resultado:** Intenta copiar cada emoji y separa los éxitos de los fallos; Headless necesita Manage Emojis and Stickers.
> * **`.emoji headless` (`orange`, `tema`)** — **Permiso de la persona:** Manage Emojis · **Resultado:** Muestra la ayuda del pack visual.
> * **`.emoji headless status`** — **Permiso de la persona:** Manage Emojis · **Resultado:** Informa del estado y espacio disponible en el servidor actual.
> * **`.emoji headless install` (`apply`, `activar`)** — **Permiso de la persona:** Manage Emojis · **Resultado:** Instala los 24 emojis Core y activa el pack; Headless necesita Manage Emojis and Stickers.
> * **`.emoji headless extend` (`extended`, `extras`)** — **Permiso de la persona:** Manage Emojis · **Resultado:** Instala hasta 76 iconos opcionales; puede dejar una instalación parcial si faltan slots.
> * **`.emoji headless refresh [confirmation]` (`update`, `actualizar`)** — **Permiso de la persona:** Manage Emojis · **Resultado:** Solo actúa con `CONFIRMAR`; reemplaza los PNG rastreados. Headless necesita Manage Emojis and Stickers.
> * **`.emoji headless rollback` (`disable`, `desactivar`, `generic`)** — **Permiso de la persona:** Manage Emojis · **Resultado:** Desactiva el pack y vuelve al mapeo genérico sin borrar los PNG.
> * **`.emoji headless purge [confirmation]`** — **Permiso de la persona:** Manage Emojis · **Resultado:** Exige rollback y `CONFIRMAR`; elimina solo IDs rastreados. Headless necesita Manage Emojis and Stickers.
> * **`/emoji view`** — **Permiso de la persona:** Manage Server · **Resultado:** Lee las claves actuales de emojis de respuesta del bot.
> * **`/emoji set key:<key> emoji:<emoji>`** — **Permiso de la persona:** Administrator · **Resultado:** Cambia una clave editable y guarda el ajuste global del bot.
> * **`/emoji reset [key:<key>]`** — **Permiso de la persona:** Administrator · **Resultado:** Restaura una clave o todos los emojis editables; el pack visual Headless se conserva.

El grupo de prefijo está limitado al servidor. Las rutas `/emoji` son comandos de aplicación propios; no usan el puente genérico de prefijo. Solo la instalación y el mantenimiento que crean/eliminan emojis requieren Manage Emojis and Stickers del bot; la lectura, rollback y cambio de mapeo de respuesta no suben permisos del bot.

## Pasos

**1. Elige el tipo de tarea**

Usa `.emoji copy` para importar un emoji al servidor, o `/emoji set` para cambiar la apariencia de respuestas de Headless.

**2. Comprueba permisos y cuota**

Confirma Manage Emojis/Administrator según el comando y que haya espacio para un emoji nuevo.

**3. Verifica o revierte**

Inspecciona el resultado; con `/emoji reset key:<clave>` puedes restaurar el valor por defecto de una clave editable.

> [!WARNING]
>
> `refresh CONFIRMAR` y `purge CONFIRMAR` son operaciones destructivas sobre los emojis rastreados. Revisa primero `.emoji headless status`; el bot solo ejecuta estas operaciones en el servidor de instalación y no borra emojis ajenos al pack.

## Páginas relacionadas

* [Reaction Roles](/docs/server/roles/reaction-roles.md)
* [Branding](/docs/server/branding.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.