Antes de empezar#
Antes de instalar Sit Everywhere, asegúrate de que tu servidor cumple los requisitos mínimos. Solo un recurso es obligatorio; todo lo demás es opcional y se detecta por sí solo.
Requisito | Estado | Notas |
|---|---|---|
| Obligatorio | Callbacks, el puente de interfaz y utilidades compartidas. Debe iniciarse antes que Sit Everywhere. |
| Recomendado | Conserva lo que cambias en |
Framework | Opcional |
|
Third eye | Opcional |
|
| Opcional | Notificaciones con su estilo, y el HUD oculto mientras el panel de ajustes está abierto. |
| Opcional | Dibuja los avisos flotantes sobre los asientos predefinidos. Sin él, se usa el texto 3D propio del juego. |
El recurso elige cada capa mirando lo que ya está en ejecución:
Capa | Orden de detección |
|---|---|
Framework |
|
Third eye |
|
Notificaciones |
|
Texto flotante |
|
Cada integración opcional se degrada en silencio. Si falta un recurso, esa parte simplemente se retira — nada da error. Integraciones tiene los detalles y cómo forzar una a mano.
github.comReleases · overextended/ox_libA FiveM resource and script library for Lua and JS.github.comReleases · overextended/oxmysqlMySQL resource for FXServer.Descargar Sit Everywhere#
Después de comprar Sit Everywhere, el recurso se vincula automáticamente a tu cuenta de CFX Portal.
Inicia sesión en CFX Portal con la misma cuenta que usaste al finalizar la compra, abre Granted Assets y descarga Sit Everywhere.
Después de extraer la descarga, deberías tener la siguiente carpeta:
qs-siteverywhere/
├── config/ -- framework and third-eye detection (editable)
├── custom/ -- framework, notification and floating-text bridges (editable)
├── client/custom/ -- the HUD bridge (editable)
├── server/custom/ -- your own server-side additions (editable)
├── locales/ -- 41 languages, one JSON file each (editable)
├── sql/ -- database.sql, only if your database user cannot create tables
├── web/build/ -- the interface, already built
├── web/images/ -- the picture of every animation
└── fxmanifest.luaMantén la carpeta con el nombre
qs-siteverywhere. La comprobación de actualizaciones al arrancar busca el recurso por ese nombre, y todos los mensajes de consola y respuestas de soporte se refieren a él.
Instalar el recurso#
Mueve la carpeta qs-siteverywhere al directorio de recursos de tu servidor. Puede estar en cualquier lugar dentro de él, incluida una carpeta de categoría:
resources/
└── [qs]/
└── qs-siteverywhere/Una vez copiada, abre tu server.cfg y asegúrate de que cada dependencia — y todo lo que deba detectar — se inicia antes que Sit Everywhere:
ensure oxmysql
ensure ox_lib
# Framework (optional)
ensure es_extended
# ensure qb-core
# ensure qbx_core
# Third eye (optional, only one)
ensure ox_target
# ensure qb-target
# ensure qtarget
# Optional extras
ensure qs-interface
ensure qs-textui
ensure qs-siteverywhereEl orden de carga importa. El framework se detecta en el momento en que Sit Everywhere se inicia, así que un framework que se inicia después no se encuentra y el recurso funciona en standalone. El third eye se busca unos segundos más tarde; uno que se inicie después de eso no se detecta hasta que se reinicie Sit Everywhere.
La base de datos#
No hay ningún archivo SQL que importar. Cuando oxmysql está en ejecución, Sit Everywhere crea su única tabla en el primer inicio y escribe en ella cada vez que un administrador guarda el panel.
Tabla | Contiene |
|---|---|
| Una fila por cada ajuste que cambiaste en |
Solo se guardan los ajustes que cambias. Todo lo demás viene de los valores por defecto que incluye el recurso, así que una actualización nunca borra tu configuración, y un ajuste añadido en una versión posterior simplemente empieza con su valor por defecto.
Nada que hacer. La tabla se crea en el primer inicio y cada guardado se escribe al instante.
Si tu usuario de base de datos no tiene permiso para crear tablas, la consola lo indica al iniciar. Ejecuta sql/database.sql una vez en tu base de datos — es la misma sentencia CREATE TABLE IF NOT EXISTS que ejecuta el propio recurso — y reinicia.
El panel sigue abriéndose, guardando y aplicándose a todos los jugadores, pero los valores solo existen en memoria y vuelven a los valores por defecto en el siguiente reinicio. La consola lo advierte la primera vez.
Obtener acceso de administrador#
/sitconfig es donde se configura todo, así que está protegido por un permiso ACE: command.sitconfig. Quien no lo tenga recibe "You do not have permission to do that." y la consola del servidor registra el intento con la línea exacta para concederlo. Cualquiera de estas vías da acceso:
La vía habitual. Concede el permiso a tu grupo de administradores en server.cfg, y añade a tu staff a ese grupo:
add_ace group.admin command.sitconfig allow
add_principal identifier.license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx group.adminConcédelo a un solo identificador, sin tocar tus grupos:
add_ace identifier.license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx command.sitconfig allow¿Ya tienes un ace para tu staff? Abre /sitconfig → Commands → Settings permission y escríbelo ahí (por ejemplo qs.admin). Entonces el panel responde a ese ace en lugar de command.sitconfig.
Reinicia el servidor después de editar server.cfg, o escribe la misma línea add_ace en la consola del servidor para aplicarla al instante. El permiso se comprueba cuando se abre el panel y de nuevo en cada guardado, así que un jugador que lo pierde no puede seguir guardando desde un panel abierto.
Renombrar el comando en Commands → Settings command no renombra el permiso.
/chairsen lugar de/sitconfigsigue necesitandocommand.sitconfig, a menos que también cambies Settings permission.
Configurar el recurso#
Casi nada se configura en archivos. Las distancias, las teclas, el solucionador de asientos, la colocación manual, el menú, los asientos predefinidos, el idioma e incluso los nombres de los comandos están en el panel del juego, /sitconfig, se cambian en vivo y se aplican a todos los jugadores a la vez. Los archivos son para la parte técnica:
Archivo | Contenido |
|---|---|
| Detección del framework y del third eye — solo lo que hay que saber antes de que arranque el servidor. |
| Cada texto que ven los jugadores y el panel, un archivo por idioma. |
| Cómo se dibujan las notificaciones y los avisos flotantes. |
| Qué HUD se oculta mientras hay un menú abierto. |
| Los puentes de framework. |
Los ajustes que conviene revisar primero, todos en /sitconfig:
Ajuste | Sección | Por defecto |
|---|---|---|
Language | General |
|
Target system | General | Detect automatically |
Interaction distance | Interaction |
|
Stand up key | Interaction |
|
Preset locations | Preset locations | Solo los mapas del juego base están activados |
El catálogo de animaciones, las listas de props y los datos de asientos predefinidos forman parte del propio recurso, no de la configuración. Uso enumera todo lo que contienen.
Verificar la instalación#
Después de completar la instalación, reinicia tu servidor y lee la consola. Sit Everywhere muestra lo que eligió y cuántos ajustes guardados cargó:
[qs-siteverywhere] framework resolved: esx
[qs-siteverywhere] server adapter loaded: esx
[qs-siteverywhere] loaded 0 saved settings, 125 fields in total
You are using the latest version of qs-siteverywhere!framework resolved: standalone significa que no había ningún framework en ejecución cuando se inició — si tienes uno, muévelo por encima de ensure qs-siteverywhere. (memory only, no oxmysql) al final de la línea de ajustes significa que nada de lo que guardes sobrevivirá a un reinicio.
Después entra en tu servidor y recorre el primer ciclo:
Siéntate en un banco
Acércate a cualquier banco público y usa el third eye sobre él. Sit down ocupa el asiento colocado a mano del banco con una sola pulsación; Choose pose abre el selector de animaciones. Sin un recurso de third eye, aparece en su lugar un aviso flotante sobre el banco — pulsa
E.Siéntate en el suelo
Lejos de cualquier asiento, escribe
/sit. Elige una pose, mira la vista previa de tu propio personaje haciéndola y pulsa Sit here. PulsaEpara cambiar de pose sin levantarte, yXpara levantarte.Abre el panel
/sitconfigabre los ajustes. En Preset locations, activa los mapas que tiene instalados tu servidor y luego reinicia el recurso. A partir de ahí, Uso cubre cada sección.
A partir de aquí nada necesita un reinicio, excepto los pocos ajustes marcados como Needs restart en el panel — los nombres de los comandos, las teclas de levantarse y de aviso, el third eye, las opciones de asientos predefinidos y los interruptores de ubicaciones.