Inicio › Documentación › Configuración · origen_graffiti

Configuración · origen_graffiti

La configuración está repartida en dos ficheros:

config.lua — ajustes esenciales para los dueños del servidor (idioma, administradores, tienda)
config.advanced.lua — ajuste técnico (renderizado, sincronización, límites de frecuencia, distancias)

Toca config.advanced.lua solo si estás midiendo el impacto (TPS, latencia, carga de red). Cambia un valor cada vez y prueba con más de 10 jugadores. Si empeora, revierte el cambio.

config.lua

General

Variable	Por defecto	Descripción
`Config.Language`	`'en'`	Idioma de la interfaz — coincide con un fichero de `locales/*.json`
`Config.AdminGroups`	`{'admin','god','superadmin'}`	Grupos con acceso al panel de administración y a sus comandos
`Config.AdminCommand`	`'graffiti_admin'`	Comando de chat para abrir el panel de administración

Tienda

Variable	Por defecto	Descripción
`Config.Shop.enterRadius`	`2.5`	Radio de proximidad en metros para abrir la tienda
`Config.Shop.sprayItem`	`'graffiti_spray'`	Nombre del objeto de inventario para los botes de spray
`Config.Shop.eraserItem`	`'graffiti_eraser'`	Nombre del objeto de inventario para los borradores
`Config.Shop.defaultDurability`	`100`	Durabilidad inicial asignada en la compra
`Config.Shop.durabilityUvThreshold`	`0.3`	Distancia UV acumulada (0–1) necesaria para consumir 1 punto de durabilidad
`Config.Shop.eraserDurabilityPerUse`	`25`	Durabilidad que cuesta borrar un tag completo

Ubicaciones de la tienda — añade tantas entradas vector4(x, y, z, heading) como necesites:

lua

Config.Shop.locations = {
    vector4(-1123.5, -1440.04, 5.19, 304.08),
}

Catálogo de la tienda por defecto:

ID	Tipo	Nombre	Precio	Color
`borrador`	eraser	Borrador	$150	—
`spray_custom`	spray_custom	Spray de color libre	$350	cualquiera
`spray_negro`	spray_preset	Spray negro	$200	`#111111`
`spray_blanco`	spray_preset	Spray blanco	$200	`#F0F0F0`
`spray_rojo`	spray_preset	Spray rojo	$220	`#CC2222`
`spray_azul`	spray_preset	Spray azul	$220	`#2255CC`
`spray_amarillo`	spray_preset	Spray amarillo	$220	`#DDC000`
`spray_verde`	spray_preset	Spray verde	$220	`#228822`
`spray_naranja`	spray_preset	Spray naranja	$220	`#CC6600`
`spray_violeta`	spray_preset	Spray violeta	$220	`#8822CC`
`spray_rosa`	spray_preset	Spray rosa	$220	`#CC3388`
`spray_celeste`	spray_preset	Spray azul claro	$220	`#33AADD`

Purga automática

Opcionalmente, elimina los grafitis antiguos al arrancar el recurso:

lua

Config.AutoPurge = {
    enabled = false,
    days    = 30,   -- delete graffiti older than this many days
}

Límite de grafitis por zona

Opcionalmente, limita cuántos grafitis pueden existir dentro de un radio antes de bloquear las nuevas sesiones:

lua

Config.ZoneGraffitiLimit = {
    enabled = false,
    radius  = 60.0,  -- meters
    maxTags = 8,
}

config.advanced.lua

Pintura

Variable	Por defecto	Descripción
`Config.PaintMaxDistance`	`8.0`	Distancia máxima en metros para pintar sobre un lienzo
`Config.BrushRadiusMin`	`0.002`	Tamaño mínimo del pincel (UV)
`Config.BrushRadiusMax`	`0.08`	Tamaño máximo del pincel (UV)
`Config.BrushRadiusDefault`	`0.012`	Tamaño del pincel por defecto al iniciar la sesión
`Config.SprayDistMin`	`0.4`	Distancia mínima de cámara para el escalado del spray
`Config.SprayDistMax`	`7.0`	Distancia máxima de cámara para el escalado del spray
`Config.SprayRadiusMulClose`	`0.78`	Multiplicador del radio con la cámara cerca (spray más cerrado)
`Config.SprayRadiusMulFar`	`1.45`	Multiplicador del radio con la cámara lejos (spray más ancho)
`Config.SprayIntensityMulClose`	`1.15`	Multiplicador de intensidad de cerca
`Config.SprayIntensityMulFar`	`0.4`	Multiplicador de intensidad de lejos

Trazos y límite de frecuencia

Variable	Por defecto	Descripción
`Config.MaxStrokesPerTag`	`4000`	Máximo de trazos por tag (carga de datos + base de datos)
`Config.MinStrokesPerSave`	`700`	Se rechazan los guardados con menos trazos que este valor
`Config.CollaborationMaxStrokesPerSecond`	`90`	Límite de frecuencia por jugador en el servidor (ventana de 1 s)

Colaboración y streaming

Variable	Por defecto	Descripción
`Config.CollaborationSessionTimeout`	`1800`	La sesión se cierra automáticamente tras estos segundos de inactividad
`Config.CollaborationJoinDistance`	`8.0`	Distancia máxima en metros para unirse a una sesión activa
`Config.SpectatorDistance`	`28.0`	Radio para ver los trazos en directo sin unirse
`Config.SyncLoadRadius`	`200.0`	Radio de búsqueda de tags del servidor por jugador
`Config.SyncMaxTagsPerQuery`	`180`	Máximo de tags devueltos por consulta de sincronización
`Config.StreamDistance`	`70.0`	Distancia en metros para crear o destruir un DUI por cada grafiti
`Config.ServerCellCheckIntervalMs`	`3000`	Intervalo en ms del hilo de detección de cambio de zona

Visual

Variable	Por defecto	Descripción
`Config.DuiResolution`	`256`	Resolución del lienzo DUI en píxeles — debe ser potencia de 2 (256, 512, 1024)
`Config.TagAlpha`	`190`	Opacidad del lienzo renderizado (0–255)
`Config.TagTimeBrightnessEnabled`	`true`	Brillo dinámico según la hora del juego
`Config.TagNightStartHour`	`21`	Hora de inicio del modo noche
`Config.TagNightEndHour`	`6`	Hora de fin del modo noche
`Config.TagDayBrightness`	`1.00`	Multiplicador de brillo durante el día (1.0 = original)
`Config.TagNightBrightness`	`0.40`	Multiplicador de brillo durante la noche
`Config.EraseTagDuration`	`15000`	Duración en ms que hay que mantener pulsado para borrar un tag
`Config.CanvasOffsetStep`	`0.005`	Paso de ajuste del desplazamiento del lienzo en metros por pulsación
`Config.CanvasOffsetMin`	`-0.30`	Desplazamiento máximo hacia dentro (30 cm dentro de la pared)
`Config.CanvasOffsetMax`	`0.50`	Desplazamiento máximo hacia fuera (50 cm separado de la pared)