Instalación

Antes de empezar#

Antes de instalar Crosshair Creator, asegúrate de que tu servidor cumple los requisitos mínimos. Solo dos recursos son obligatorios y no se necesita ningún framework.

Descargar Crosshair Creator#

Después de comprar Crosshair Creator, el recurso se vincula automáticamente a tu cuenta de CFX Portal.

Inicia sesión en el CFX Portal con la misma cuenta que usaste al finalizar la compra, abre Granted Assets y descarga Crosshair Creator.

Después de extraer la descarga, deberías tener lo siguiente:

[crosshair]/
├── qs-crosshair/
│   ├── config/          -- what you may edit: main, dynamics, webhooks
│   ├── client/custom/   -- client hooks: gate the panel, custom notifications
│   ├── server/custom/   -- server hooks: audit log, share events, commands
│   ├── locales/         -- 21 language files
│   ├── client/ server/ shared/  -- the script itself
│   └── html/            -- the interface
└── [sql]/
    └── install.sql      -- optional, the tables create themselves

La carpeta debe llamarse qs-crosshair. El script llama a sus propios exports como exports['qs-crosshair'], así que una copia renombrada no puede encontrarse a sí misma y la retícula nunca se aplica.

Instalar el recurso#

Mueve la carpeta qs-crosshair al directorio de recursos de tu servidor. Puede estar en cualquier lugar dentro de él, incluida una carpeta de categoría:

resources/
└── [qs]/
    └── qs-crosshair/

Una vez copiada, abre tu server.cfg e inicia las dos dependencias antes del script:

ensure oxmysql
ensure ox_lib

# Optional notification resource, if you use one
# ensure qs-interface

ensure qs-crosshair

El orden de carga importa. El script espera hasta 30 segundos a que oxmysql llegue al estado iniciado; si nunca lo hace, no se guarda nada y la consola lo indica. ox_lib debe estar en ejecución antes, o el recurso no se carga en absoluto.

La base de datos#

No hay ningún archivo SQL que importar. Crosshair Creator crea sus propias tablas en cada inicio si faltan, todas con el prefijo qs_crosshair_:

La biblioteca de diseños guardados de cada jugador no está en MySQL. Se guarda en el almacén clave-valor de recursos del servidor, también indexado por licencia, así que acompaña al jugador entre personajes y reconexiones.

¿Prefieres crear las tablas tú mismo? [sql]/install.sql contiene las mismas tres sentencias. Ejecutarlo y dejar que el script se inicie después es seguro — cada sentencia es CREATE TABLE IF NOT EXISTS.

Obtener acceso de administrador#

La pestaña Admin es donde se activan y desactivan las funciones para todo el servidor, así que solo la ven los administradores. Los demás ni siquiera ven la pestaña. Un jugador cuenta como administrador si tiene permitido cualquiera de estos aces:

add_ace group.admin command allow
add_principal identifier.license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx group.admin

add_ace identifier.license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx qs-crosshair.admin allow

Config.Admin = {
    AceGroup = 'group.moderator',
    -- ...
}

El servidor comprueba el estado de administrador cada vez que se abre el panel, así que un administrador recién añadido solo tiene que cerrarlo y volver a abrirlo. Cada guardado de administración se vuelve a comprobar en el servidor antes de aplicarse.

Configurar el recurso#

La mayor parte del comportamiento se configura en el juego desde la pestaña Admin y el propio panel del jugador. Los archivos solo contienen lo que hay que saber antes de que entre el primer jugador:

Los valores que conviene revisar primero:

Config.Locale           = 'en'        -- one of the 21 languages in locales/
Config.OpenCommand      = 'crosshair' -- /crosshair opens and closes the panel
Config.OpenKeybind      = 'F4'        -- default key; players can rebind it
Config.EnabledByDefault = true        -- new players start with the crosshair on

Config.Admin = {
    AceGroup          = 'group.admin', -- who sees the Admin tab
    DefaultThemeColor = '#48e0cb',     -- panel colour for players who never picked one
    EnableWebhookLog  = false,         -- post every admin change to Discord
}

Config.Library = {
    MaxBuilds     = 50,  -- saved builds per player
    MaxNameLength = 32,  -- characters in a build name
}

Config.Performance = {
    DefaultTier = 'medium', -- 'high' | 'medium' | 'low', players override it
}

A propósito, no hay ninguna tabla de mira predeterminada en los archivos. La mira con la que empiezan los jugadores nuevos se elige en el juego: créala y luego pulsa Apply as Official en la pestaña Admin. Consulta La pestaña Admin.

Verificar la instalación#

Después de completar la instalación, reinicia tu servidor y busca el banner en la consola del servidor:

┌───────────────────────────────────────────────┐
│  Quasar Crosshair  •  v1.0.0  •  SQL: ready   │
│  Quasar Store                                 │
└───────────────────────────────────────────────┘
You are using the latest version of qs-crosshair!

SQL: ready significa que las tablas existen y el guardado funciona. SQL: n/a significa que oxmysql no estaba disponible: los jugadores siguen teniendo una mira, pero su mira activa, los códigos para compartir y los ajustes de administración no se guardan. Luego entra en tu servidor y recorre el primer ciclo:

1. Apunta con un arma

   Saca una pistola y mantén pulsado el clic derecho. Aparece una cruz blanca en el centro de la pantalla que desaparece cuando dejas de apuntar. Los puños, las armas cuerpo a cuerpo y los rifles de francotirador no muestran nada por defecto.

2. Abre el panel

   Pulsa F4 o escribe /crosshair. Haz clic en cualquier preset: se aplica al instante. Vuelve a apuntar para verlo.

3. Revisa la pestaña Admin

   Como administrador, aparece una quinta pestaña. Pon el nombre de tu servidor en el panel y elige la mira oficial para los jugadores nuevos.

Nada en la pestaña Admin requiere reiniciar. Cada interruptor, la mira oficial y la identidad del servidor se guardan en la base de datos y se envían a todos los jugadores conectados en el momento en que los cambias. Solo los archivos de config/ requieren reiniciar el recurso.