> ## Documentation Index
> Fetch the complete documentation index at: https://rust-co.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Solución de problemas

> Problemas comunes de RCO Creator y cómo solucionarlos.

Antes que nada: establece `Config.Debug = true` en `rco-creator/config/config.lua`, reinicia el recurso y reproduce el problema. Creator imprime lo que está haciendo y por qué rechazó algo. La mayoría de problemas se vuelven obvios con esa salida.

Si te quedas atascado, abre un ticket en [Discord](https://discord.gg/j67u6pbnDs) con la salida de la consola, tu framework y lo que esperabas que ocurriera.

## Arranque

<AccordionGroup>
  <Accordion title="Creator no arranca: 'rco-appearance' is not started">
    Creator declara una dependencia de `rco-appearance`. Asegúrate de que Appearance esté instalado y aparezca **por encima** de Creator en tu lista de inicio:

    ```cfg theme={"dark"}
    ensure rco-appearance
    ensure rco-creator
    ```
  </Accordion>

  <Accordion title="'rsg-core must start before rco-creator' or 'vorp_core must start before rco-creator'">
    El core de tu framework está arrancando después de nuestros recursos. Mueve `ensure rsg-core` (o `ensure vorp_core`) por encima de `rco-appearance` y `rco-creator`.
  </Accordion>

  <Accordion title="'both supported cores are started; set Config.Framework explicitly'">
    Tu `server.cfg` está arrancando `rsg-core` y `vorp_core` a la vez. Elimina el `ensure` del framework que **no** uses. RSG: solo `rsg-core`; VORP: solo `vorp_core`.
  </Accordion>

  <Accordion title="'stop the stock vorp_character resource before starting this pack' (VORP)">
    El `vorp_character` del stock sigue en ejecución. Elimina `ensure vorp_character` de tu lista de inicio y reinicia el servidor. La carpeta puede quedarse en disco; solo un recurso del stock *en ejecución* activa este mensaje.
  </Accordion>

  <Accordion title="'Discord slots are enabled, but guildId or botToken is empty'">
    Activaste `CreatorServerConfig.Discord.enabled` sin rellenar el ID del guild y el token del bot en `config/server.lua`. Rellénalos o establece `enabled = false`.
  </Accordion>

  <Accordion title="'starter item N in config/server.lua is invalid'">
    Una de las entradas en `CreatorServerConfig.Starter.items` no tiene `name`, o tiene un `amount` que no es un número entero de al menos 1. Corrige la entrada en esa posición.
  </Accordion>
</AccordionGroup>

## Selección de personajes

<AccordionGroup>
  <Accordion title="Sigo viendo el selector de personajes antiguo">
    El selector del stock sigue en ejecución junto a Creator.

    * **RSG:** elimina `ensure rsg-multicharacter` y `ensure rsg-spawn`.
    * **VORP:** elimina `ensure vorp_character`.

    Reinicia el servidor después de cambiar la lista de inicio.
  </Accordion>

  <Accordion title="La selección se abre dos veces, o se abre sobre un personaje activo">
    Otro script está llamando al flujo de personajes después de que el jugador ya está en el mundo. Creator en sí se niega a apilar pantallas (`OpenCharacterSelection` devuelve `already_open` / `already_active`), así que busca un recurso del stock o un script de terceros que dispare los eventos de login de tu framework una segunda vez. La salida de debug muestra la razón del rechazo.
  </Accordion>

  <Accordion title="No pasa nada después de conectar, la pantalla permanece negra">
    Revisa la consola del servidor por uno de los mensajes de arranque anteriores. Si Creator arrancó limpiamente, activa `Config.Debug` y revisa la consola del cliente (F8) — un problema de locale o carga de NUI aparecerá ahí.
  </Accordion>

  <Accordion title="Un jugador tiene menos slots de los esperados">
    Los slots se resuelven en un orden fijo: función personalizada, Discord, override por jugador, límite del framework, predeterminado. Si Discord está habilitado, los overrides por jugador **no** se consultan. Consulta [Slots de personajes](/es/rco-creator/character-slots) para la lógica completa. El resultado siempre está limitado por `Config.MaxCharacters`.
  </Accordion>

  <Accordion title="La creación de personajes rechaza una fecha de nacimiento válida">
    La edad se comprueba contra `Config.IdentityReferenceDate`, no la fecha real. Con el valor predeterminado `1899-01-01` y edades 18–100, los años de nacimiento válidos son 1799–1881. Ajusta la fecha de referencia o `BirthYearMin` / `BirthYearMax` para tu ambientación. Consulta [Reglas de identidad](/es/rco-creator/configuration#identity-rules).
  </Accordion>
</AccordionGroup>

## Aparición

<AccordionGroup>
  <Accordion title="El selector de aparición nunca aparece">
    Comprueba `Config.Spawn.selectorMode`. Con `new_character_only`, los personajes existentes omiten el selector; con `first_login_after_restart`, cada personaje lo ve una vez por ciclo del servidor. También comprueba `CreatorServerConfig.ForceLastPosition` — por defecto, los personajes encarcelados siempre vuelven a su última posición.
  </Accordion>

  <Accordion title="Edité Config.Spawn.locations pero nada cambió">
    Esa lista solo se usa para llenar la base de datos la primera vez. Después, gestiona las apariciones en el juego con `/rcospawns`, o vacía la tabla `rco_creator_spawn_locations` y reinicia para volver a poblar. Consulta [Puntos de aparición](/es/rco-creator/spawn-locations).
  </Accordion>

  <Accordion title="/rcospawns dice que no tengo permiso">
    Concede el ACE de forma explícita y reinicia:

    ```cfg theme={"dark"}
    add_ace group.admin rco.creator.spawns allow
    ```

    O ajusta `CanManageSpawns` en `config/server.lua`.
  </Accordion>

  <Accordion title="Los personajes nuevos no recibieron el paquete inicial">
    Comprueba que `CreatorServerConfig.Starter.enabled` sea `true` y que cada nombre de ítem exista en el inventario de tu framework. El paquete se concede una vez por personaje y se registra en la base de datos; si la concesión falló, la consola imprime un mensaje y Creator deliberadamente **no** reintenta automáticamente, para evitar duplicar ítems. Corrige la causa y luego concede los ítems manualmente a los jugadores afectados.
  </Accordion>

  <Accordion title="El jugador termina en el routing bucket incorrecto">
    Durante la selección de personajes cada jugador está aislado en su propio bucket. Cuando aparece, Creator lo devuelve al bucket que tenía cuando se abrió la selección — no fija el bucket 0. Si otro script cambia buckets mientras la pantalla de selección está abierta, esa interacción es la causa probable.
  </Accordion>
</AccordionGroup>

## Avisos del version checker

`RCO Identity update available` significa que el paquete instalado es anterior a la release pública actual.

`Resource version mismatch` significa que `rco-creator` y `rco-appearance` vienen de releases diferentes. Sustituye ambos con el mismo paquete; no cambies únicamente el número del manifest.

Si falla la consulta remota, el version checker es **fail-open**: RCO continúa iniciando normalmente.
