Configuration

Toute la configuration de Vcord se trouve dans le fichier config.lua, à la racine de la ressource. Ce fichier est ignoré par l'escrow (escrow_ignore), vous pouvez donc le modifier librement.

TIP

Après chaque modification de config.lua, redémarrez la ressource (restart lo_vcord) pour appliquer les changements.

Options principales

Option	Type	Défaut	Description
Config.Locale	string	'en'	Langue de l'application (doit correspondre à un fichier de locales/, ex. 'fr' → locales/fr.json).
Config.Debug	boolean	false	Affiche les logs détaillés dans la console serveur/client.
Config.ThemeColor	string	"FF5865F2"	Couleur du thème (style Discord, Blurple), au format ARGB.
Config.StaffGroups	table	{'owner','admin','superadmin','god'}	Groupes ayant accès aux fonctions admin.
Config.MaxServersPerUser	number	10	Nombre max de serveurs qu'un utilisateur peut créer.
Config.MaxChannelsPerServer	number	50	Nombre max de channels par serveur.
Config.MaxMembersPerServer	number	100	Nombre max de membres par serveur.
Config.MaxMessageLength	number	2000	Longueur max d'un message.
Config.MessageHistoryLimit	number	50	Nombre de messages chargés par défaut dans l'historique.
Config.MaxAttachmentsPerMessage	number	5	Nombre max de pièces jointes par message.
Config.MaxDMsPerUser	number	50	Nombre max de conversations privées (DMs).
Config.MaxFriendsPerUser	number	100	Nombre max d'amis.

Webhooks & logs

Vcord peut journaliser ses événements vers Discord via deux webhooks distincts. Laissez une valeur vide ("") pour désactiver un webhook.

Config.Webhooks = {
    -- Webhook pour les logs des SERVEURS (messages, channels, rôles, catégories)
    Server = "",
    -- Webhook pour les logs des MESSAGES PRIVÉS (DMs)
    DM = "",
}

Le détail des événements journalisés se règle ensuite dans Config.Logs :

Config.Logs = {
    -- Logs serveur
    ServerMessages = true,      -- Messages envoyés dans les serveurs
    ServerChannels = true,      -- Création/suppression de channels
    ServerCategories = true,    -- Création/suppression de catégories
    ServerRoles = true,         -- Création/modification/suppression de rôles
    ServerCreation = true,      -- Création de serveurs

    -- Logs DM
    DMMessages = true,          -- Messages privés envoyés
}

NOTE

Les logs serveur (messages, channels, catégories, rôles, créations) utilisent Config.Webhooks.Server, tandis que les logs DM utilisent Config.Webhooks.DM. Un type de log n'est envoyé que si son webhook correspondant est renseigné et que l'option est à true.

Limites

Ces valeurs encadrent l'usage de l'application par utilisateur et par serveur :

Config.MaxServersPerUser = 10          -- Serveurs créés par utilisateur
Config.MaxChannelsPerServer = 50       -- Channels par serveur
Config.MaxMembersPerServer = 100       -- Membres par serveur

Config.MaxMessageLength = 2000         -- Longueur d'un message
Config.MessageHistoryLimit = 50        -- Messages chargés par défaut
Config.MaxAttachmentsPerMessage = 5    -- Pièces jointes par message

Config.MaxDMsPerUser = 50              -- Conversations privées (DMs)
Config.MaxFriendsPerUser = 100         -- Amis

TIP

Adaptez ces limites à la taille de votre serveur. Des valeurs plus basses limitent la charge en base de données et le volume de messages.

Couleurs de profil & thème

Config.ThemeColor = "FF5865F2" -- Blurple (style Discord), format ARGB

Config.ProfileColors = {
    '#5865F2', -- Blurple
    '#57F287', -- Green
    '#FEE75C', -- Yellow
    '#EB459E', -- Fuchsia
    '#ED4245', -- Red
    '#3498db', -- Blue
    '#9b59b6', -- Purple
    '#e91e63', -- Pink
    '#00bcd4', -- Cyan
    '#ff9800', -- Orange
    '#FFFFFF', -- White
    '#000000'  -- Black
}

• Config.ThemeColor définit la couleur d'accent de l'interface (Blurple par défaut), au format ARGB (alpha + RVB).
• Config.ProfileColors liste les couleurs de profil que les utilisateurs peuvent choisir.

Les statuts disponibles et les avatars par défaut se règlent également ici :

Config.DefaultAvatars = {} -- Vide = initiales du nom (l'utilisateur peut choisir une photo dans la galerie)

Config.UserStatuses = {
    'online',
    'idle',
    'dnd',      -- Ne pas déranger
    'invisible'
}

Groupes staff

Les groupes listés dans Config.StaffGroups ont accès aux fonctions d'administration de l'application :

Config.StaffGroups = {'owner', 'admin', 'superadmin', 'god'}

NOTE

Renseignez ici les noms de groupes (ace/permission) de votre serveur autorisés à utiliser les outils admin de Vcord.

Canaux vocaux

Vcord prend en charge les channels vocaux via le système vocal présent sur votre serveur :

Config.Voice = {
    -- Système vocal : "auto", "pma", "mumble", "salty", "toko"
    -- "auto" détecte automatiquement le système installé
    System = "auto",

    -- Nombre maximum de membres par canal vocal
    MaxMembersPerChannel = 10,

    -- Offset pour les IDs de canaux vocaux (évite les conflits avec les IDs joueurs)
    ChannelOffset = 65535,
}

Les icônes de channels par défaut sont également configurables (classes Font Awesome) :

Config.DefaultChannelIcons = {
    text = 'fa-hashtag',
    announcement = 'fa-bullhorn',
    rules = 'fa-scroll',
    voice = 'fa-microphone'
}

TIP

Laissez System = "auto" pour que Vcord détecte automatiquement PMA-Voice, Mumble, SaltyChat ou TokoVOIP.

Langues

Vcord est fourni avec 6 langues : anglais (en), français (fr), allemand (de), espagnol (es), italien (it) et portugais (pt), via les fichiers locales/*.json.

• Pour changer la langue de l'application, ajustez Config.Locale (ex. 'fr').
• La valeur doit correspondre à un fichier existant dans locales/ (locales/fr.json pour 'fr').
• Vous pouvez personnaliser les textes en éditant directement les fichiers locales/*.json.

Config.Locale = 'fr'

Conseils

• Modifiez toujours config.lua à la racine (ignoré par l'escrow) ; ne touchez pas aux fichiers de la ressource compilée.
• Après chaque changement, relancez restart lo_vcord.
• Laissez les webhooks vides ("") si vous ne souhaitez pas de logs Discord.
• Activez Config.Debug = true uniquement pour diagnostiquer un problème : cela affiche des logs détaillés en console.
• Adaptez les limites (Max...) à la taille de votre serveur pour maîtriser la charge.