Accueil › Documentation › Configuration · origen_graffiti

Configuration · origen_graffiti

La configuration est répartie en deux fichiers :

config.lua — paramètres essentiels pour les propriétaires de serveur (langue, administrateurs, boutique)
config.advanced.lua — réglages techniques (rendu, synchronisation, limites de débit, distances)

Ne touche à config.advanced.lua que si tu mesures l’impact (TPS, latence, charge réseau). Modifie une valeur à la fois et teste avec plus de 10 joueurs. Si la situation empire, reviens en arrière.

config.lua

Général

Variable	Par défaut	Description
`Config.Language`	`'en'`	Langue de l’interface — correspond à un fichier de `locales/*.json`
`Config.AdminGroups`	`{'admin','god','superadmin'}`	Groupes ayant accès au panneau d’administration et à ses commandes
`Config.AdminCommand`	`'graffiti_admin'`	Commande de chat pour ouvrir le panneau d’administration

Boutique

Variable	Par défaut	Description
`Config.Shop.enterRadius`	`2.5`	Rayon de proximité en mètres pour ouvrir la boutique
`Config.Shop.sprayItem`	`'graffiti_spray'`	Nom de l’objet d’inventaire pour les bombes de peinture
`Config.Shop.eraserItem`	`'graffiti_eraser'`	Nom de l’objet d’inventaire pour les effaceurs
`Config.Shop.defaultDurability`	`100`	Durabilité initiale attribuée à l’achat
`Config.Shop.durabilityUvThreshold`	`0.3`	Distance UV cumulée (0–1) nécessaire pour consommer 1 point de durabilité
`Config.Shop.eraserDurabilityPerUse`	`25`	Durabilité consommée pour effacer un tag complet

Emplacements de la boutique — ajoute autant d’entrées vector4(x, y, z, heading) que nécessaire :

lua

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

Catalogue de la boutique par défaut :

ID	Type	Nom	Prix	Couleur
`borrador`	eraser	Effaceur	$150	—
`spray_custom`	spray_custom	Bombe de couleur libre	$350	au choix
`spray_negro`	spray_preset	Bombe noire	$200	`#111111`
`spray_blanco`	spray_preset	Bombe blanche	$200	`#F0F0F0`
`spray_rojo`	spray_preset	Bombe rouge	$220	`#CC2222`
`spray_azul`	spray_preset	Bombe bleue	$220	`#2255CC`
`spray_amarillo`	spray_preset	Bombe jaune	$220	`#DDC000`
`spray_verde`	spray_preset	Bombe verte	$220	`#228822`
`spray_naranja`	spray_preset	Bombe orange	$220	`#CC6600`
`spray_violeta`	spray_preset	Bombe violette	$220	`#8822CC`
`spray_rosa`	spray_preset	Bombe rose	$220	`#CC3388`
`spray_celeste`	spray_preset	Bombe bleu clair	$220	`#33AADD`

Purge automatique

Supprime éventuellement les anciens graffitis au démarrage de la ressource :

lua

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

Limite de graffitis par zone

Limite éventuellement le nombre de graffitis pouvant exister dans un rayon avant de bloquer les nouvelles sessions :

lua

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

config.advanced.lua

Peinture

Variable	Par défaut	Description
`Config.PaintMaxDistance`	`8.0`	Distance maximale en mètres pour peindre sur une toile
`Config.BrushRadiusMin`	`0.002`	Taille minimale du pinceau (UV)
`Config.BrushRadiusMax`	`0.08`	Taille maximale du pinceau (UV)
`Config.BrushRadiusDefault`	`0.012`	Taille du pinceau par défaut au début de la session
`Config.SprayDistMin`	`0.4`	Distance minimale de la caméra pour la mise à l’échelle de la bombe
`Config.SprayDistMax`	`7.0`	Distance maximale de la caméra pour la mise à l’échelle de la bombe
`Config.SprayRadiusMulClose`	`0.78`	Multiplicateur du rayon quand la caméra est proche (jet plus serré)
`Config.SprayRadiusMulFar`	`1.45`	Multiplicateur du rayon quand la caméra est loin (jet plus large)
`Config.SprayIntensityMulClose`	`1.15`	Multiplicateur d’intensité de près
`Config.SprayIntensityMulFar`	`0.4`	Multiplicateur d’intensité de loin

Traits et limitation de débit

Variable	Par défaut	Description
`Config.MaxStrokesPerTag`	`4000`	Nombre maximal de traits par tag (charge des données + base de données)
`Config.MinStrokesPerSave`	`700`	Les sauvegardes comportant moins de traits que cette valeur sont rejetées
`Config.CollaborationMaxStrokesPerSecond`	`90`	Limite de débit côté serveur par joueur (fenêtre de 1 s)

Collaboration et streaming

Variable	Par défaut	Description
`Config.CollaborationSessionTimeout`	`1800`	La session se ferme automatiquement après ce nombre de secondes d’inactivité
`Config.CollaborationJoinDistance`	`8.0`	Distance maximale en mètres pour rejoindre une session active
`Config.SpectatorDistance`	`28.0`	Rayon pour voir les traits en direct sans rejoindre
`Config.SyncLoadRadius`	`200.0`	Rayon de recherche des tags côté serveur pour chaque joueur
`Config.SyncMaxTagsPerQuery`	`180`	Nombre maximal de tags renvoyés par requête de synchronisation
`Config.StreamDistance`	`70.0`	Distance en mètres pour créer ou détruire un DUI pour chaque graffiti
`Config.ServerCellCheckIntervalMs`	`3000`	Intervalle en ms du thread de détection de changement de zone

Visuel

Variable	Par défaut	Description
`Config.DuiResolution`	`256`	Résolution de la toile DUI en pixels — doit être une puissance de 2 (256, 512, 1024)
`Config.TagAlpha`	`190`	Opacité de la toile rendue (0–255)
`Config.TagTimeBrightnessEnabled`	`true`	Luminosité dynamique selon l’heure en jeu
`Config.TagNightStartHour`	`21`	Heure de début du mode nuit
`Config.TagNightEndHour`	`6`	Heure de fin du mode nuit
`Config.TagDayBrightness`	`1.00`	Multiplicateur de luminosité en journée (1.0 = original)
`Config.TagNightBrightness`	`0.40`	Multiplicateur de luminosité la nuit
`Config.EraseTagDuration`	`15000`	Durée en ms de maintien pour effacer un tag
`Config.CanvasOffsetStep`	`0.005`	Pas de réglage du décalage de la toile en mètres par pression de touche
`Config.CanvasOffsetMin`	`-0.30`	Décalage maximal vers l’intérieur (30 cm dans le mur)
`Config.CanvasOffsetMax`	`0.50`	Décalage maximal vers l’extérieur (50 cm du mur)