Accueil › Documentation › Configuration · origen_chat

Configuration · origen_chat

La configuration est répartie dans plusieurs fichiers du dossier config/.

config/_main.lua

Variable Par défaut Description
Config.Language 'en' Langue de l’interface — 'en' | 'es' | 'fr' | 'it'
Config.CustomNotify false Utilise Custom.Notify à la place des notifications d’ox_lib
Config.CommandName 'toggleChat' Commande pour afficher ou masquer l’interface du chat
Config.ShowEmojisOption true Affiche le sélecteur d’émojis dans l’interface du chat
Config.DefaultColor '#850e49f2' Couleur de fond du chat par défaut (hex RGBA)
Config.ShowServerPrints false Affiche dans le chat la sortie de print() du serveur
Config.Debug false Active les logs de débogage

Autoriser la personnalisation par le joueur

lua
Config.AllowEdit = {
    color    = true,   -- player can change chat background color
    position = true,   -- player can reposition the chat box
    size     = true,   -- player can resize the chat box
}

config/commands.lua

Définit toutes les commandes du chat. Chaque commande prend en charge un type de message différent.

Types de message

Type Description
proximity Envoyé aux joueurs situés à moins de distance mètres
global Envoyé à tous les joueurs du serveur
player-to-player Envoyé d’un joueur précis à un autre
global-announcement Envoyé à tous les joueurs, avec une mise en forme d’annonce
job-to-job Envoyé à tous les joueurs qui partagent le même métier
job-to-global Envoyé par un membre d’un métier à tous les joueurs

Champs d’une commande

Champ Description
enabled Active ou désactive la commande
color Couleur du message (hex)
icon Nom de l’icône Lucide (p. ex. 'lucide:user')
command Chaîne de la commande de chat (p. ex. 'me')
distance Rayon en mètres pour le type proximity. false = global
preventCollisions Si true, les murs et les portes bloquent le message
showNameInsteadOfId Affiche le nom du joueur au lieu de l’ID serveur
showGradeAndJob Affiche le métier et le grade dans le préfixe du message
permissions Array des groupes nécessaires pour utiliser la commande
groups Table de job_name = min_grade nécessaire pour utiliser la commande
type Type de message (voir le tableau ci-dessus)
params Définitions de paramètres supplémentaires de la commande

Commandes par défaut

Commande Type Description
/me proximity (15m) Action de roleplay
/do proximity (10m) Description de la scène
/ooc global Message global hors personnage
/msg player-to-player Message privé à un joueur précis
/announcement global-announcement Annonce pour tout le serveur (admin uniquement)
/lspd job-to-job Chat interne de la police (désactivé par défaut)
/ems job-to-job Chat interne des EMS (désactivé par défaut)
/announce-lspd job-to-global Communiqué de la police à tous (désactivé par défaut)
/announce-ems job-to-global Communiqué des EMS à tous (désactivé par défaut)

Ajouter une commande personnalisée

lua
Config.Commands['my_command'] = {
    enabled             = true,
    color               = '#ffffff',
    icon                = 'lucide:user',
    preventCollisions   = false,
    distance            = false,
    command             = 'my_command',
    showNameInsteadOfId = true,
    permissions         = { 'group.admin' },
    groups              = { ['police'] = 0 },
    type                = 'global',
}

config/blacklist.lua

Préfixes de commandes qui n’apparaissent pas dans les suggestions d’autocomplétion :

lua
Config.BlacklistedPrefixes = {
    ['+'] = true,
    ['-'] = true,
    ['_'] = true,
}

config/custom_core.lua

Utilise ce fichier pour fournir ton propre objet core si tu n’utilises pas un framework standard :

lua
return {
    useCustomCore = false,
    events = {
        load   = 'custom:playerLoaded',
        unload = 'custom:playerLogout',
    },
    GetCustomCoreObject = function()
        return nil -- return your core object here
    end,
}