> ## 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.

# Starboard

> Destaca mensajes públicos con reacciones ⭐ y un umbral por servidor.

Un tablero ⭐ por servidor destaca mensajes públicos cuando alcanzan un mínimo configurable de reacciones humanas.

## Conteo de estrellas

Headless observa ⭐ cuando alguien añade, quita o limpia esa reacción después de configurar el tablero. El autor del mensaje y las cuentas bot no cuentan; se cuentan usuarios únicos. El umbral inicial es **3** y acepta valores de **1 a 100**. Al habilitarlo no se procesan reacciones anteriores de forma retroactiva.

### `.starboard threshold`

```headless-command Syntax theme={null}
.starboard threshold <threshold>
```

```headless-command Example theme={null}
.starboard threshold 5
```

## Publicación y sincronización

Al alcanzar el umbral, Headless publica un embed con el texto del mensaje, su autor, la hora y un enlace al original. Los cambios en el conteo actualizan el embed. Si el conteo queda por debajo del umbral, Headless elimina su publicación del tablero, pero conserva el mensaje original. Los adjuntos no se copian.

## Configuración y permisos

Configurar requiere el permiso de Discord **Manage Server**. Headless necesita:

* En los canales de origen: **View Channel** y **Read Message History**.
* En el destino: **View Channel**, **Read Message History**, **Send Messages** y **Embed Links**. El historial permite recuperar y sincronizar las publicaciones existentes.

Solo se admiten canales de texto visibles para `@everyone`; no se leen canales privados ni hilos. La configuración y los IDs de las publicaciones se guardan por servidor en PostgreSQL.

> [!NOTE]
>
> Si un canal de origen deja de ser visible para `@everyone`, Headless elimina su copia guardada de Starboard incluso si la función está apagada. Para borrarla, necesita **View Channel** y **Read Message History** en el destino; si esos permisos faltan, el staff debe retirar la publicación manualmente.

**1. Elige el canal de destino**

Usa un canal de texto público distinto de los canales de origen y concede a Headless los permisos de lectura y publicación indicados arriba.

**2. Activa Starboard**

Ejecuta `.starboard channel #destacados`. Headless guarda el canal y activa la función para este servidor.

**3. Ajusta el umbral**

El valor inicial es tres. Para cambiarlo, usa un entero entre 1 y 100, por ejemplo `.starboard threshold 5`.

**4. Prueba el ciclo completo**

Añade ⭐ a un mensaje público hasta alcanzar el umbral; revisa el enlace al original y quita reacciones para confirmar que el embed se actualiza y desaparece bajo el mínimo.

### `.starboard`

```headless-command Syntax theme={null}
.starboard
```

```headless-command Example theme={null}
.starboard
```

### `.starboard channel`

```headless-command Syntax theme={null}
.starboard channel <channel>
```

```headless-command Example theme={null}
.starboard channel #destacados
```

## Cambios y desactivación

Cambiar el canal de destino afecta a nuevas publicaciones. Las entradas ya guardadas siguen actualizándose en su canal original y no se trasladan automáticamente. Un cambio de umbral se aplica cuando llega otro evento de reacción para el mensaje. `.starboard off` detiene la sincronización y conserva las publicaciones existentes.

> **Un solo tablero y una sola reacción**
>
> Headless admite un tablero ⭐ por servidor. No hay varios tableros, emoji alternativo, filtros de canales/roles/miembros, autoestrella, bloqueo temporal ni formato configurable.

> **Adjuntos y canales no compatibles**
>
> Los adjuntos no se vuelven a publicar. Si el mensaje no tiene texto, el embed indica que se debe abrir el original. No se procesan canales privados ni hilos.

> **Mensajes largos**
>
> El texto del embed se limita a 3800 caracteres; si el original es más largo, Headless lo recorta y añade puntos suspensivos. El enlace permite abrir el mensaje completo.

> **Si desaparece el original o la publicación**
>
> Si Headless pierde acceso al mensaje de origen, el evento no crea ni cambia una entrada. Si la publicación del tablero ya no existe, un siguiente evento que cumpla el umbral puede crearla de nuevo.

### `.starboard off`

```headless-command Syntax theme={null}
.starboard off
```

```headless-command Example theme={null}
.starboard off
```

**Nota:**

`.stars` también funciona como alias del comando raíz. Los ajustes pertenecen únicamente al servidor donde ejecutas el comando.

## Páginas relacionadas

* [Roles por reacción](/docs/server/roles/reaction-roles.md)
* [Mensajes](/docs/server/messages.md)
* [Headless Permissions](/docs/permissions.md)


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