KS-Progressbar

Installation

1. Décompressez l’archive livrée dans votre dossier resources/, sous le nom ks-progressbar.
2. Importez le fichier install.sql fourni dans votre base de données.
3. Ajoutez ensure ks-progressbar dans votre server.cfg, après oxmysql et qb-core.
4. Redémarrez votre serveur.

Configuration

Config.DefaultPosition = "bottom"
Config.CancelOnMove = true
Config.CancelOnDamage = true

Désactivez CancelOnMove pour les actions compatibles avec un déplacement (comme marcher en portant un objet) — l’annulation reste possible action par action via le paramètre canMove.

Lancer une progression

Depuis n’importe quel script :

exports['ks-progressbar']:Start({
  label = "Réparation en cours...",
  duration = 8000,
  icon = "fa-solid fa-wrench",
  canMove = false,
}, function(completed)
  if completed then
    -- réparation terminée normalement
  end
end)

Le callback reçoit true si la progression est allée à son terme, false si elle a été annulée avant la fin.

Problèmes fréquents

La barre reste bloquée à l’écran après une déconnexion. Vérifiez que votre version est à jour — KS-Progressbar nettoie automatiquement toute progression active sur l’évènement onResourceStop, un ancien script en conflit peut empêcher ce nettoyage.

Deux barres de progression s’affichent en même temps. Utilisez la file d’attente (queue = true dans les options) plutôt que deux appels Start simultanés — sans cela, le second appel interrompt le premier par défaut.