Configuración

Todo se configura en config.lua, que no está cifrado con escrow. Cada opción está comentada también en el propio archivo.

Manda el editor de estilo

Lo que los admins guardan en el editor de estilo del juego (/slinteract_style) se guarda en data/style.json y gana a Config.Points, Config.Reveal, Config.Shape y Config.Colors. El editor tiene un botón para volver a los valores del config.lua.

General

Opción	De serie	Descripción
Config.Framework	'auto'	'auto', 'qb', 'qbx', 'esx' o 'standalone'. Para las condiciones de trabajo y banda y los avisos
Config.Inventory	'auto'	'auto', 'ox', 'qs', 'qb', 'esx' o 'none'. Para las condiciones de items y sus imágenes
Config.Bridge	'auto'	Si SL-Interact responde por ox_target, qb-target y qtarget. 'auto': solo si ese sistema no está arrancado en el servidor. true: siempre. false: nunca. También uno por sistema: { ox_target = 'auto', ['qb-target'] = false }. Ver scripts de target
Config.Locale	'en'	Idioma: 'es' o 'en'. Lo que falte sale en inglés
Config.Debug	false	Herramientas de desarrollo (/slinteract_perf, /slinteract_test) y mensajes de más en F8. Apagado en un servidor abierto

Teclas

Opción	De serie	Descripción
Config.Keys	{ 'E', 'G', 'H' }	Teclas de la etiqueta, en orden. Las opciones sin key cogen la primera libre
Config.BackKey	'BACK'	Vuelve un paso atrás en un menú, o cierra la etiqueta. En un menú, la segunda tecla (G) y Esc hacen lo mismo
Config.Reveal.key	'LMENU'	Tecla de mostrar (Alt izquierdo). Ver cuándo salen los puntos

Son las teclas por defecto. Cada jugador puede cambiarlas en Ajustes > Asignación de teclas > FiveM. FiveM solo aplica una tecla por defecto nueva a quien nunca la ha cambiado.

Cuándo salen los puntos

Config.Reveal dice cuándo sale un punto, según el tipo de interacción:

Modo	Significa
'always'	Al acercarse el jugador
'look'	Solo cuando el jugador lo mira casi de frente
'key'	Solo mientras el jugador mantiene la tecla de mostrar (Alt), como un target de siempre

Opción	De serie	Para
default	'always'	Puntos, entidades y modelos (addCoords, addEntity, addLocalEntity, addModel)
globals	'key'	Todos los vehículos, NPC u objetos (addGlobalVehicle, addGlobalPed, addGlobalObject) y las opciones globales de los scripts de ox_target, qb-target o qtarget
players	'key'	Los demás jugadores (addGlobalPlayer)
force	nil	Un modo para todo, pidan lo que pidan los scripts. 'key' obliga a usar Alt en todo
mode	'hold'	Cómo funciona Alt: 'hold' (como ox_target) o 'toggle'. Ver la tecla Alt: hold o toggle
closeDelay	300	Solo en 'toggle': lo que espera una etiqueta abierta antes de cerrarse al apartar la mira, en milisegundos
lookRadius	0.10	Para 'look': lo cerca del centro de la pantalla que tiene que estar, en partes del alto de la pantalla

Un script puede pedir su propio modo con reveal en cada interacción. Los admins también pueden elegir un modo por script o por interacción en el panel de interacciones. Quién manda, de más a menos:

1. La interacción, en el panel.
2. Su script, en el panel.
3. force (o Para todo en el editor de estilo).
4. Lo que pide el script (reveal).
5. Lo de su tipo, en la tabla de arriba.

Así puedes obligar a usar Alt en todo y dejar que los scripts que elijas salgan directamente, con los jugadores pulsando su tecla de siempre.

La tecla Alt: hold o toggle

Config.Reveal.mode dice cómo se usa Alt con los puntos que solo salen con él (de serie, los vehículos y los demás jugadores). No cambia nada en los puntos que salen solos al acercarse o al mirarlos.

	'hold' (de serie)	'toggle'
Cómo se usa	Mantienes Alt, apuntas y pulsas la tecla de la opción (E, G…) sin soltar Alt	Tocas Alt apuntando a algo y la etiqueta se queda abierta al soltarlo; pulsas la tecla de la opción cuando quieras
Cuándo se cierra	En cuanto sueltas Alt	Al volver a pulsar Alt, al apartar la mira (closeDelay) o al alejarte
Menús con submenús o cantidades	Se navegan con Alt mantenido	Se navegan con las manos libres
Parecido a	ox_target y qb-target	La 1.0.0 de SL-Interact

'hold' es lo que esperan los jugadores que vienen de ox_target o qb-target. 'toggle' es más cómodo para menús largos, porque no hay que mantener nada mientras se elige.

Cambio en la 1.0.1

Hasta la 1.0.0, Alt funcionaba como 'toggle'. Desde la 1.0.1, de serie es 'hold'. Si tus jugadores ya están acostumbrados a lo de antes, pon mode = 'toggle' en el config.lua.

Config.Reveal = {
    -- ...
    mode = 'hold',      -- o 'toggle'
    closeDelay = 300,   -- solo para 'toggle'
}

El modo solo se cambia en el config.lua (el editor de estilo no lo toca) y vale para todos los jugadores. Reinicia el servidor para aplicarlo. La tecla en sí (Alt) la puede cambiar cada jugador en Ajustes > Asignación de teclas > FiveM.

Puntos y etiqueta

Config.Points:

Opción	De serie	Descripción
distance	2.0	Metros hasta los que se ve un punto. Cada interacción puede poner la suya
focusRadius	0.15	Lo cerca del centro de la pantalla que tiene que estar un punto para enfocarse
stickiness	1.3	El punto enfocado no lo pierde hasta que otro esté este número de veces más centrado. 1 = siempre el más cercano
scale	1.0	Tamaño de los puntos y la etiqueta
sounds	true	Sonidos de la etiqueta
volume	0.12	Volumen, de 0.0 a 1.0
hideDelay	1000	Milisegundos mirando el mismo punto hasta que se esconden los demás
fade	ver archivo	Cómo se funden los puntos según lo lejos que estén de la mira: inner, outer, shade y min
easy.angle	28.0	Grados desde el centro de la vista para las interacciones marcadas como easy
highlight	'outline'	Cómo se resalta lo enfocado: 'outline', 'box', 'both' o false. El contorno solo se dibuja en objetos
outline	{ 255, 255, 255, 255 }	Color del contorno y de la caja (r, g, b, a)
outlineShader	1	Grosor del contorno del juego (0 o 1)
focusScale	1.12	Cuánto crecen al mirarlos los objetos con grow = true

Admins

Config.StyleEditor dice quién puede usar el editor de estilo y el panel de interacciones:

Opción	De serie	Descripción
ace	'sl_interact.style'	Permiso ACE: add_ace group.admin sl_interact.style allow
admins	{}	Identificadores con permiso sin el ACE: 'license:...', 'discord:...', 'fivem:...'

Aspecto

Config.Shape y Config.Colors son el aspecto de serie. El editor de estilo cambia lo mismo en directo, que es más cómodo.

Config.Shape	De serie	Descripción
radius	10	Esquinas, en px. 0 = cuadradas
border	1.5	Grosor del borde, en px
edge	2	Canto 3D debajo de las piezas, en px. 0 = plano
glow	0	Brillo suave alrededor, en px
dot	'round'	'round' o 'square'
font	'geist'	'geist', 'system' o 'mono'
uppercase	true	Textos de teclas y opciones en mayúsculas

Config.Colors	Para
ink	Bordes y sombras
panel	Fondo de la etiqueta y las teclas
paper	Puntos, iconos, teclas y sus textos
paperEdge	Canto 3D de las partes claras
text	Nombre en la etiqueta
label	Textos de teclas y opciones
dim	Textos secundarios
warn	Esperando confirmación
deny	Tecla que no se puede usar, estado en rojo
ok	Estado en verde

Vale cualquier color CSS: '#rrggbb', 'rgb(r, g, b)'…

Archivos abiertos

Además de config.lua, esto no está cifrado:

Ruta	Para qué
bridge/framework/	Trabajos, bandas y avisos de cada framework
bridge/inventory.lua	Items e imágenes de items de cada inventario
bridge/server.lua	Dinero, items y trabajos en el servidor, para el creador
locales/	Textos. Copia en.json para añadir un idioma
sl_interact_demo (carpeta aparte)	El recurso de ejemplo