Accueil › Documentation › Configuration · origen_reports

Configuration · origen_reports

La configuration partagée se trouve dans config.lua. Les webhooks Discord sont réservés au serveur et se trouvent dans svconfig.lua.

Config.Framework, Config.Inventory, Config.Clothing et Config.Ambulance sont détectés automatiquement dans init.lua. Ne les définis pas dans le fichier de configuration.

Général

Variable Par défaut Description
Config.Debug false Affiche des informations de débogage dans la console
Config.Language 'en' Langue de la ressource — 'es' ou 'en'
Config.maxActiveReports 1 Nombre maximal de signalements ouverts qu’un joueur peut avoir en même temps
Config.anonymousStaffMessages true Masque le nom du membre du staff dans les messages reçus par le joueur
Config.notificationPosition 'top-right' Position des notifications de l’interface. top-left, top-center, top-right, center-left, center, center-right, bottom-left, bottom-center, bottom-right
Config.uiSounds true Sons au survol, au clic et lors des transitions de l’interface

maxActiveReports et anonymousStaffMessages ne sont que des valeurs initiales. Au premier démarrage, elles sont écrites dans la table origen_reports_config et, ensuite, c’est la base de données qui fait foi. Modifie-les depuis le panneau d’administration, ou supprime leurs lignes dans origen_reports_config pour les réinitialiser depuis config.lua.

Commandes

Clé Commande par défaut Description
userpannel /report Ouvre le panneau du joueur pour créer et suivre des signalements
adminpannel /adminreport Ouvre le panneau du staff. Seuls les membres du staff obtiennent une réponse
lua
Config.Commands = {
    ['userpannel'] = {
        name = 'report',
        helpKey = 'commands.user_help',
    },
    ['adminpannel'] = {
        name = 'adminreport',
        helpKey = 'commands.admin_help',
    },
}
Champ Type Description
name string Nom de la commande de chat, sans la barre oblique
helpKey string Clé de langue utilisée comme texte de suggestion de la commande

Accès du staff

Permissions qui donnent accès au staff. Consulte Installation pour voir comment chaque entrée est résolue par rapport à l’ACE et au framework.

lua
Config.StaffFullAccess = {
    'superadmin',
    'admin',
    'god'
}
 
Config.StaffBasicAccess = {
    'mod',
    'moderator',
}
Variable Description
Config.StaffFullAccess Permissions qui donnent un accès complet : toutes les actions rapides et le panneau d’administration
Config.StaffBasicAccess Permissions qui donnent un accès basique : l’ensemble de permissions basiques par défaut

Si un joueur correspond aux deux listes, l’accès complet l’emporte.

Types de signalement

Catégories que le joueur choisit lors de la création d’un signalement.

lua
Config.reportTypes = {
    { id = 1, labelKey = 'report_types.support_general', icon = 'help' },
    { id = 2, labelKey = 'report_types.report_player',   icon = 'user' },
    { id = 3, labelKey = 'report_types.report_bug',      icon = 'bug'  },
}
Champ Type Description
id number Identifiant unique du type
labelKey string Clé de langue du libellé. Utilise label à la place pour définir un texte littéral
icon string Icône affichée dans l’interface. Par défaut 'help'

Les types de signalement sont insérés dans origen_reports_types au premier démarrage, uniquement lorsque la table est vide. Ensuite, ils sont gérés depuis le panneau d’administration et les modifications de config.lua sont ignorées.

Points de téléportation

Destinations disponibles dans l’action rapide de téléportation.

lua
Config.teleportPoints = {
    { id = 1, nameKey = 'teleports.mrpd',             coords = { x = 425.2, y = -980.5, z = 30.7 } },
    { id = 2, nameKey = 'teleports.hospital_pillbox', coords = { x = 295.8, y = -584.3, z = 43.3 } },
    { id = 3, nameKey = 'teleports.legion_square',    coords = { x = 192.4, y = -939.2, z = 30.7 } },
}
Champ Type Description
id number Identifiant unique du point
nameKey string Clé de langue du nom. Utilise name à la place pour définir un texte littéral
coords table Coordonnées de destination { x, y, z }

Comme pour les types de signalement : ils sont insérés dans origen_reports_teleports uniquement lorsque la table est vide, puis gérés depuis le panneau d’administration.

Partage d’écran en direct

Paramètres de l’action rapide vidéo. Le joueur signalé diffuse son écran en WebRTC au membre du staff qui traite le ticket.

lua
Config.videoStream = {
    frameRate   = 24,
    width       = 1280,
    height      = 720,
    bitrateKbps = 1500,
 
    notifyTarget = false,
 
    maxStaffPerTarget = 1,
 
    iceServers = {
        { urls = 'stun:stun.l.google.com:19302' },
    },
}
Champ Par défaut Description
frameRate 24 Images par seconde (5-60). Des valeurs plus élevées consomment plus de CPU/GPU chez le joueur qui diffuse
width 1280 Largeur maximale de la piste vidéo (320-3840)
height 720 Hauteur maximale de la piste vidéo (180-2160)
bitrateKbps 1500 Débit maximal par flux en kbps (250-12000)
notifyTarget false Prévient le joueur lorsqu’un membre du staff commence à regarder son écran
maxStaffPerTarget 1 Nombre maximal de membres du staff qui regardent le même joueur en même temps
iceServers Google STUN Serveurs ICE utilisés pour négocier la connexion entre pairs

Le STUN seul échoue derrière un NAT symétrique, donc certains joueurs ne pourront jamais se connecter. Pour couvrir tout le monde, ajoute ton propre serveur TURN :

lua
iceServers = {
    { urls = 'stun:stun.l.google.com:19302' },
    { urls = 'turn:turn.example.com:3478', username = 'user', credential = 'pass' },
},

Joueurs à proximité

Liste de joueurs affichée sous les actions rapides d’un ticket pris en charge.

lua
Config.nearbyPlayers = {
    radius          = 30.0,
    maxResults      = 20,
    refreshInterval = 0,
    showIp          = false,
}
Champ Par défaut Description
radius 30.0 Mètres autour du joueur signalé, et non du membre du staff (1-500)
maxResults 20 Nombre maximal de joueurs renvoyés par requête
refreshInterval 0 Actualisation automatique tant que la section est ouverte, en millisecondes. 0 la désactive et ne laisse que le bouton d’actualisation manuelle
showIp false Inclut le point de connexion (IP) dans les identifiants. Seul le staff avec accès complet le reçoit

Webhooks

svconfig.lua contient tous les webhooks Discord. Mets enabled = false pour désactiver tous les logs.

Clé Journalisé lorsque
report-created Un joueur crée un signalement
report-claimed Un membre du staff prend un signalement en charge
report-resolved Un signalement est résolu
report-released Un membre du staff libère un signalement qu’il avait pris en charge
staff-duty Un membre du staff prend ou quitte son service
admin-config-general Les paramètres généraux sont modifiés depuis le panneau d’administration
admin-config-tp-add / -update / -delete Un point de téléportation est créé, modifié ou supprimé
admin-config-type-add / -update / -delete Un type de signalement est créé, modifié ou supprimé
admin-group-add / -update / -delete Un groupe de staff est créé, modifié ou supprimé
admin-add-staff / admin-remove-staff / admin-update-staff Un membre du staff est ajouté, supprimé ou modifié
quick-bring · quick-goto · quick-bringback · quick-back · quick-teleport Actions rapides de téléportation
quick-inventory · quick-giveitems Actions rapides d’inventaire
quick-revive · quick-ropa · quick-bucket Actions rapides de réanimation, de vêtements et de routing bucket
quick-espectar · quick-video · quick-nearby Spectate, partage d’écran en direct et joueurs à proximité
quick-screenshot-request · quick-screenshot-result Une capture d’écran est demandée, puis son résultat
screenshot-upload Ce n’est pas un log : le webhook vers lequel screenshot-basic envoie les captures

Toute clé laissée à YOUR_WEBHOOK_URL ou vide est ignorée sans avertissement.