> ## 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. # Sorteos > Giveaways crea sorteos con botones de participación, duración y uno o más ganadores. Los datos y roles de managers se guardan por servidor; el proceso de cierre continúa al reiniciar el bot. ## Quién puede administrarlos El owner, `Administrator`, `Manage Server` o un rol delegado configurado puede crear, finalizar, rerollear y cancelar. Solo `Manage Server` configura la lista de roles delegados mediante `giveaway roles`. ### `.giveaway roles add` ```headless-command Syntax theme={null} .giveaway roles add [roles]... ``` ```headless-command Example theme={null} .giveaway roles add @Eventos ``` ### `.giveaway roles remove` ```headless-command Syntax theme={null} .giveaway roles remove [roles]... ``` ```headless-command Example theme={null} .giveaway roles remove @Eventos ``` ### `.giveaway roles clear` ```headless-command Syntax theme={null} .giveaway roles clear ``` ```headless-command Example theme={null} .giveaway roles clear ``` ### `.giveaway roles list` ```headless-command Syntax theme={null} .giveaway roles list ``` ```headless-command Example theme={null} .giveaway roles list ``` > [!WARNING] > > Un rol delegado permite acciones de giveaway sin Manage Server; revisa la lista con cuidado. No publiques información de premios o participantes fuera de los canales previstos. ## Duración y participantes La duración debe estar entre 30 segundos y 30 días; el parser acepta valores como `30m`, `1h`, `2d` o `1w`. Se permiten de 1 a 20 ganadores y el valor predeterminado es uno. La creación confirma canal, premio e ID; usa `.glist` para ver sorteos activos. Sin argumentos, `.giveaway` muestra la referencia rápida. > [!NOTE] > > Se requiere una duración y un premio. Puedes añadir la cantidad de ganadores y un canal; si omites el canal se usa el actual. El canal se acepta como mención, `#nombre` o ID. Los comandos solo funcionan en servidores y no tienen comandos slash. El parser de prefijo no expone un argumento para el rol requerido, así que no puede restringir la participación por rol. ### `.giveaway` ```headless-command Syntax theme={null} .giveaway [ganadores] [#canal] ``` ```headless-command Example theme={null} .giveaway 1h Nitro Classic ``` También funciona: `.giveaway 1d 2 #sorteos Nitro Premium` ### `.gstart` ```headless-command Syntax theme={null} .gstart [ganadores] [#canal] ``` ```headless-command Example theme={null} .gstart 30m 1 #sorteos Skin Roblox ``` ## Comandos > **Referencia completa de comandos** > > * **`.giveaway [ganadores] [#canal] `** — **Descripción:** Crea un sorteo en el canal actual o el indicado. · **Acceso:** Owner del servidor, Administrator, Manage Server o rol delegado > * **`.giveaway start [ganadores] [#canal] `** — **Descripción:** Inicia un sorteo con el mismo parser. · **Acceso:** Owner del servidor, Administrator, Manage Server o rol delegado > * **`.giveaway end `** — **Descripción:** Finaliza el sorteo y selecciona ganadores. · **Acceso:** Owner del servidor, Administrator, Manage Server o rol delegado > * **`.giveaway reroll `** — **Descripción:** Selecciona ganadores nuevos excluyendo los anteriores. · **Acceso:** Owner del servidor, Administrator, Manage Server o rol delegado > * **`.giveaway cancel `** — **Descripción:** Cancela el sorteo sin finalizarlo como ganador. · **Acceso:** Owner del servidor, Administrator, Manage Server o rol delegado > * **`.giveaway list`** — **Descripción:** Lista sorteos activos. · **Acceso:** Owner del servidor, Administrator, Manage Server o rol delegado > * **`.giveaway roles`** — **Descripción:** Consulta los roles delegados. · **Acceso:** Manage Server > * **`.giveaway roles add `** — **Descripción:** Añade roles de confianza a la lista de managers. · **Acceso:** Manage Server > * **`.giveaway roles remove `** — **Descripción:** Retira roles delegados. · **Acceso:** Manage Server > * **`.giveaway roles clear`** — **Descripción:** Borra la lista de roles delegados. · **Acceso:** Manage Server > * **`.giveaway roles list`** — **Descripción:** Muestra los roles delegados actuales. · **Acceso:** Manage Server > * **`.gstart [ganadores] [#canal] `** — **Descripción:** Atajo para crear un sorteo. · **Acceso:** Owner del servidor, Administrator, Manage Server o rol delegado > * **`.gend `** — **Descripción:** Atajo para finalizar un sorteo. · **Acceso:** Owner del servidor, Administrator, Manage Server o rol delegado > * **`.greroll `** — **Descripción:** Atajo para volver a elegir ganadores. · **Acceso:** Owner del servidor, Administrator, Manage Server o rol delegado > * **`.gcancel `** — **Descripción:** Atajo para cancelar un sorteo. · **Acceso:** Owner del servidor, Administrator, Manage Server o rol delegado > * **`.glist`** — **Descripción:** Atajo para listar sorteos activos. · **Acceso:** Owner del servidor, Administrator, Manage Server o rol delegado ## Ciclo de vida Los botones, confirmaciones y avisos integrados de Headless usan etiquetas en inglés. El nombre del premio, las notas y las plantillas de ping personalizadas se conservan tal como las escribió el servidor. La plantilla de ping predeterminada anterior se convierte en inglés solo cuando coincide exactamente con el texto integrado anterior; las plantillas personalizadas no se modifican. `.gend` finaliza un sorteo, `.greroll` elige ganadores nuevos y `.gcancel` lo cancela. Al configurar managers, limita los roles a personal confiable: esos miembros pueden operar el sistema sin permisos importantes de servidor. > **Delegación y aislamiento** > > Los IDs de roles de manager se guardan por servidor, con un máximo de 80 IDs de rol. Owner, Administrator y Manage Server siempre pueden administrar sorteos; los roles delegados reciben solo acceso a las operaciones de giveaway, no permisos generales del servidor. Configurar la lista requiere Manage Server. > **Participar y cerrar** > > Los miembros participan con el botón del mensaje. Añadir la reacción de entrada también registra al miembro; al quitarla sales de la lista de participantes. El watcher revisa expiraciones cada cinco segundos, así que un cierre automático puede ocurrir unos segundos después de la hora indicada. > **Ganadores y límites** > > El sistema acepta de 1 a 20 ganadores y elige al azar entre participantes elegibles. Los comandos de prefijo no admiten un rol obligatorio; no existe esa opción en la sintaxis documentada aquí. ### `.glist` ```headless-command Syntax theme={null} .glist ``` ```headless-command Example theme={null} .glist ``` ### `.gend` ```headless-command Syntax theme={null} .gend ``` ```headless-command Example theme={null} .gend ABC123 ``` ### `.greroll` ```headless-command Syntax theme={null} .greroll ``` ```headless-command Example theme={null} .greroll ABC123 ``` ### `.gcancel` ```headless-command Syntax theme={null} .gcancel ``` ```headless-command Example theme={null} .gcancel ABC123 ``` ## Buenas prácticas > **Crear sorteo** > > Define una duración clara, indica un premio concreto y usa el canal dedicado a sorteos. > **Finalizar** > > `gend` termina y elige ganadores; `greroll` reemplaza la selección anterior; `gcancel` cancela y registra la acción. > **Comunidad** > > Haz visibles las reglas y deja tiempo suficiente para participar. Revisa el destino antes de publicar. ## Pasos **1. Configura managers** Con Manage Server usa `.giveaway roles add @Eventos` y comprueba `.giveaway roles list`. **2. Crea un sorteo de prueba** Indica duración, ganadores opcionales, canal opcional y premio; confirma el destino. **3. Verifica y cierra** Revisa `.glist`, prueba el botón de participación y termina o cancela por ID cuando corresponda. ## Páginas relacionadas * [Logs](/docs/server/logging.md) * [Roles](/docs/server/roles.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.