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

# Conteo

> Counting es un juego persistente por servidor y canal. La comunidad envía el siguiente entero; también se aceptan expresiones aritméticas simples validadas sin ejecutar código del usuario.

## Reglas

El canal conserva el valor actual y el siguiente esperado. Por defecto la misma persona no puede contar dos veces seguidas; una respuesta incorrecta puede reiniciar la cadena según `reset-on-fail`. La configuración también controla borrado de errores, reacciones y avisos por hitos.

> [!NOTE]
>
> Las respuestas integradas y el texto inicial del panel usan inglés. Si personalizaste el texto del panel, Headless conserva tu versión sin traducirla.

## Configuración y permisos

`.counting setup` requiere `Manage Server`; `.counting create` requiere `Manage Channels` para crear un canal. El estado y estadísticas se guardan por servidor y se conservan al pausar el módulo.

### `.counting setup`

```headless-command Syntax theme={null}
.counting setup [channel] [start=1]
```

```headless-command Example theme={null}
.counting setup #counting 1
```

### `.counting create`

```headless-command Syntax theme={null}
.counting create [name=counting]
```

```headless-command Example theme={null}
.counting create counting
```

### `.counting reset`

```headless-command Syntax theme={null}
.counting reset [start]
```

```headless-command Example theme={null}
.counting reset 1
```

### `.counting config`

```headless-command Syntax theme={null}
.counting config
```

```headless-command Example theme={null}
.counting config
```

### `.counting config same-user`

```headless-command Syntax theme={null}
.counting config same-user <value>
```

```headless-command Example theme={null}
.counting config same-user off
```

### `.counting config reset-on-fail`

```headless-command Syntax theme={null}
.counting config reset-on-fail <value>
```

```headless-command Example theme={null}
.counting config reset-on-fail on
```

### `.counting config delete-wrong`

```headless-command Syntax theme={null}
.counting config delete-wrong <value>
```

```headless-command Example theme={null}
.counting config delete-wrong off
```

### `.counting config reactions`

```headless-command Syntax theme={null}
.counting config reactions <value>
```

```headless-command Example theme={null}
.counting config reactions on
```

### `.counting config milestone`

```headless-command Syntax theme={null}
.counting config milestone <interval>
```

```headless-command Example theme={null}
.counting config milestone 50
```

### `.counting off`

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

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

### `.counting on`

```headless-command Syntax theme={null}
.counting on
```

```headless-command Example theme={null}
.counting on
```

## Estadísticas

`.counting top [cantidad]` muestra hasta 15 participantes y `.counting stats [@miembro]` presenta el perfil. Solo se permiten operaciones aritméticas admitidas; expresiones no enteras, negativas, divisiones por cero o demasiado grandes se rechazan.

> [!NOTE]
>
> Counting se configura con comandos de prefijo; sus comandos no tienen equivalentes slash. El bot valida la expresión con una lista limitada de operaciones aritméticas y nunca ejecuta código Python enviado por miembros.

### `.counting top`

```headless-command Syntax theme={null}
.counting top [limit=10]
```

```headless-command Example theme={null}
.counting top 10
```

### `.counting stats`

```headless-command Syntax theme={null}
.counting stats [member]
```

```headless-command Example theme={null}
.counting stats @miembro
```

> [!WARNING]
>
> `reset` borra el progreso de la cadena y es una acción administrativa. Las operaciones se analizan con una gramática aritmética limitada, no con Python ni otro intérprete general.

## Comandos

> **Referencia completa de comandos**
>
> * **`.counting`** — **Descripción:** Muestra el estado actual del juego. · **Acceso:** Miembros del servidor
> * **`.counting setup [#canal] [inicio=1]`** — **Descripción:** Activa el juego en un canal existente y fija el primer valor esperado. · **Acceso:** Manage Server
> * **`.counting create [nombre=counting]`** — **Descripción:** Crea y configura un canal dedicado. · **Acceso:** Manage Channels; el bot también necesita Manage Channels
> * **`.counting on`** — **Descripción:** Reactiva el módulo si hay un canal configurado. · **Acceso:** Manage Server
> * **`.counting off`** — **Descripción:** Pausa el juego y conserva el progreso. · **Acceso:** Manage Server
> * **`.counting reset [inicio]`** — **Descripción:** Reinicia la secuencia, opcionalmente desde otro valor. · **Acceso:** Manage Server
> * **`.counting channel <#canal>`** — **Descripción:** Cambia el canal de juego y lo activa. · **Acceso:** Manage Server
> * **`.counting config`** — **Descripción:** Muestra el estado y las reglas actuales. · **Acceso:** Manage Server
> * **`.counting config delete-wrong <on|off>`** — **Descripción:** Decide si se eliminan las respuestas incorrectas. · **Acceso:** Manage Server
> * **`.counting config reset-on-fail <on|off>`** — **Descripción:** Decide si un error reinicia la secuencia. · **Acceso:** Manage Server
> * **`.counting config same-user <on|off>`** — **Descripción:** Permite o impide turnos consecutivos de una misma persona. · **Acceso:** Manage Server
> * **`.counting config reactions <on|off>`** — **Descripción:** Activa o desactiva las reacciones automáticas. · **Acceso:** Manage Server
> * **`.counting config milestone <intervalo>`** — **Descripción:** Publica hitos cada N números; `0` los desactiva. El límite es 1 000 000. · **Acceso:** Manage Server
> * **`.counting top [cantidad=10]`** — **Descripción:** Muestra el ranking; la cantidad se limita a 1–15. · **Acceso:** Miembros del servidor
> * **`.counting stats [@miembro]`** — **Descripción:** Consulta estadísticas propias o de otra persona. · **Acceso:** Miembros del servidor

## Reglas y almacenamiento

> **Valores iniciales y errores**
>
> El primer número predeterminado es `1`. No se permite repetir usuario en turnos consecutivos; un fallo reinicia la secuencia por defecto, pero no elimina el mensaje incorrecto por defecto. Cada comportamiento se puede cambiar con `.counting config`. El progreso y las estadísticas se guardan separados por servidor y se conservan al pausar.

> **Expresiones válidas**
>
> Se aceptan enteros y expresiones de hasta 160 caracteres con suma, resta, multiplicación, división exacta, división entera, módulo, potencia entera de exponente entre -8 y 8, signos unarios y paréntesis. El resultado debe ser un entero no negativo. Se rechazan división por cero, sintaxis no admitida y resultados excesivamente grandes.

> **Historial y clasificación**
>
> Las estadísticas se almacenan por miembro y servidor. El historial reciente conserva hasta 30 entradas; `.counting top` nunca muestra más de 15 posiciones.

## Consejos de uso

> **Cómo jugar**
>
> Cada usuario continúa el número. También puede enviar operaciones simples; el bot valida el resultado antes de avanzar.

> **Moderación**
>
> El staff puede reiniciar una cadena rota y consultar el ranking. Mantén el canal dedicado para no mezclar el juego con la conversación general.

> **Configuración**
>
> Publica reglas claras, ajusta los hitos y limita quién puede editar o borrar conteos para que el progreso sea confiable.

## Pasos

**1. Elige o crea el canal**

Usa setup con canal y valor inicial, o crea un canal dedicado si el bot tiene permisos.

**2. Configura reglas**

Revisa `same-user`, `reset-on-fail`, `delete-wrong`, `reactions` y `milestone` antes de abrir el juego.

**3. Prueba y monitorea**

Envía el número esperado, prueba una operación simple como `1+0` y revisa el ranking.

## Páginas relacionadas

* [Logs](/docs/server/logging.md)
* [Comunidad](/docs/community/utilities.md)


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