twinded_libs

Bibliothèque utilitaire partagée gratuite pour tous les scripts Twinded. Fournit un système de modules léger (global tw) et des exports communs utilisés par tous les scripts.

Ressource gratuite

twinded_libs est gratuit et requis par tous les scripts Twinded. Téléchargez-le depuis la boutique Tebex.

Installation

Placez twinded_libs dans votre dossier resources et assurez-le avant tout script Twinded :

ensure twinded_libs

Système de modules

Les scripts incluent la bibliothèque via leur fxmanifest.lua :

shared_scripts {
    '@twinded_libs/init.lua',
}

Cela crée un objet global tw avec des modules chargés paresseusement.

Modules disponibles

Module	Côté	Description
tw.fw	shared	Abstraction cross-framework (VORP, RSG, QBCore, etc.)
tw.callback	shared	Callbacks bidirectionnels client-serveur
tw.emit	shared	Émission d'événements optimisée avec contrôle de bande passante
tw.blip	client	Blips sur la carte avec nettoyage automatique
tw.prompt	client	Prompts d'interaction natifs RedM (maintenir pour compléter)
tw.entity	shared	Création, suppression, fondu d'entités
tw.notif	shared	Notifications natives RedM (droite, gauche, haut)
tw.timeout	shared	Timeouts, boucles, debounce, anti-spam
tw.progressbar	client	Barre de progression NUI avec thèmes (linear, circle, innercircle)
tw.menu	client	Menu interactif NUI (cross-framework)
tw.player	client	Infos joueur auto-mises à jour (ped, coords, serverId)
tw.text3d	client	Texte 3D flottant au-dessus de coordonnées monde
tw.input	client	Clavier natif RedM onscreen
tw.animation	client	Lecture et gestion d'animations
tw.database	server	Gestion de tables/colonnes MySQL via oxmysql
tw.webhook	server	Logging Discord par webhook
tw.witness	server	Alertes témoins — diffusion par métier + blip temporaire

Exemples d'utilisation

-- Callback prêt (attendre l'initialisation de la lib)
tw.ready(function()
    -- votre code d'initialisation
end)

-- Nettoyage à l'arrêt de la ressource
tw.stopped(function()
    -- code de nettoyage
end)

Blips

tw.blip.create(vec3(x, y, z), "Label", "blip_sprite")

Prompts

tw.prompt.create(group, "Label", 'INPUT_INTERACT_OPTION1', false)
tw.prompt.displayGroup(group, "Title")  -- appeler chaque frame
if tw.prompt.isCompleted(group, 'INPUT_INTERACT_OPTION1') then
    -- gérer l'interaction
end

Entités

local entity = tw.entity.create("model_name", coords, heading, networked)
tw.entity.delete(entity)

Notifications

tw.notif.rightSuccess("Vous avez trouvé 3x Pomme")
tw.notif.rightError("Pas assez de place")
tw.notif.right(text, dict, icon, color, duration)
tw.notif.left(title, text, dict, icon, color, duration)
tw.notif.simpleTop(title, subtitle, duration)

Exports

Shared

HasJobAccess(jobs, current_job) → boolean

Vérifie si un métier est dans la liste autorisée. Retourne true si jobs est nil ou vide.

local allowed = exports['twinded_libs']:HasJobAccess({"doctor", "sheriff"}, player_job)

Client

AttachProp(prop_name, offset, bone) → entity | nil

Attache un modèle de prop à un os du joueur avec un décalage.

local prop = exports['twinded_libs']:AttachProp(
    "p_axe02x",
    { x = 0, y = 0, z = 0.5, rx = 0, ry = 0, rz = 0 },
    "SKEL_R_Finger12"
)

DeleteProp(prop)

Détache et supprime un prop en toute sécurité.

exports['twinded_libs']:DeleteProp(prop)

Server

SendWebhook(url, data)

Envoie un message vers un webhook Discord. Restreint aux ressources twinded_* uniquement.

exports['twinded_libs']:SendWebhook(Config.Webhook.url, {
    username = "Mon Script",
    embeds = {{
        title = "Événement",
        description = "Détails",
        color = 3066993,
    }},
})

IsRateLimited(key, min_time) → boolean

Rate limiting par clé. Retourne true si l'action doit être bloquée.

if exports['twinded_libs']:IsRateLimited(source, 3) then return end

ClearRateLimit(key) / ClearRateLimitsByPrefix(prefix)

Nettoyage des entrées de rate limit (appeler dans playerDropped).

exports['twinded_libs']:ClearRateLimit(source)