Webhooks

Tous les scripts Twinded supportent le logging par webhook Discord nativement, avec une option pour les handlers webhook personnalisés.

Webhooks Discord

Configuration

1. Copiez config/_default.lock/settings.lua → config/custom/settings.lua
2. Définissez votre URL de webhook :

Config.Webhook = {
    type = 'discord',
    url = 'https://discord.com/api/webhooks/...',
}

C'est tout — le script enverra automatiquement des embeds Discord formatés.

Ce qui est enregistré

Chaque script enregistre différents événements. Consultez la page de documentation du script pour savoir quelles actions déclenchent des webhooks.

Webhooks personnalisés

Si vous utilisez un système de logging autre que Discord (ex : un panel custom, une base de données, ou une API externe), vous pouvez surcharger le handler webhook.

Configuration

1. Copiez config/_default.lock/webhook.lua → config/custom/webhook.lua
2. Changez le type de webhook :

-- config/custom/settings.lua
Config.Webhook = {
    type = 'custom',
    url = '',  -- non utilisé avec le type custom
}

3. Implémentez votre handler dans config/custom/webhook.lua :

function SendScriptWebhook(data)
    -- data contient le payload complet au format Discord :
    -- data.username    - Nom du bot
    -- data.avatar_url  - Avatar du bot
    -- data.embeds      - Tableau d'objets embed
    --   .title         - Titre de l'embed
    --   .description   - Corps de l'embed
    --   .color         - Code couleur
    --   .fields        - Tableau de {name, value, inline}
    --   .footer        - {text}
    --   .timestamp     - ISO 8601

    -- Exemple : transférer vers votre API personnalisée
    PerformHttpRequest('https://your-api.com/logs', function() end,
        'POST', json.encode(data),
        { ['Content-Type'] = 'application/json' })
end

WARNING

La structure du payload data correspond au format webhook de Discord. Chaque script documente ses champs spécifiques dans les commentaires de webhook.lua.