twinded_trashbin

Un script de fouille de poubelles pour RedM. Les joueurs peuvent fouiller les poubelles dispersees sur la carte pour trouver du butin aleatoire, ou regarder a l'interieur pour acceder a un inventaire partage.

Dependances

Ressource	Requise	Notes
jo_libs	Oui	Librairie partagee gratuite

Compatibilite

Cross-framework — fonctionne avec VORP, RSG, QBCore RedM, QRCore, RedEM:RP, RPX, TPZ-CORE et FRP. Le framework est auto-detecte par jo_libs.

Installation

ensure jo_libs
ensure twinded_trashbin

Fichiers de configuration

Fichier	Description
settings.lua	Parametres principaux, emplacements des poubelles, tables de loot, cooldowns
lang.lua	Chaines de traduction
webhook.lua	Handler de webhook personnalise (quand Config.Webhook.type = 'custom')

Consultez le guide de configuration pour savoir comment surcharger ces fichiers.

Reference de configuration

settings.lua

Option	Type	Defaut	Description
Config.SearchTime	number	10000	Duree de fouille (millisecondes)
Config.TrashbinBlip	boolean	false	Afficher les blips sur la carte pour les emplacements de poubelles
Config.TimeToRefill	table	{ 300, 600 }	Plage de cooldown aleatoire (secondes) entre les fouilles { min, max }
Config.TrashSlots	number	500	Slots d'inventaire par stash partage
Config.ClearCommand	string	"cleartrash"	Commande admin pour vider tous les inventaires de poubelles
Config.AdminGroups	table	{ ["superadmin"]=true, ["admin"]=true }	Groupes autorises a utiliser la commande admin (format hash table)
Config.Webhook.type	string	"discord"	'discord' ou 'custom'
Config.Webhook.url	string	""	URL du webhook Discord

Format de la table de loot

Chaque item dans la table de loot utilise ce format :

["item_name"] = {
    Label = "Display Name",
    Amount = { 1, 3 },    -- { min, max } plage de quantite aleatoire
    Chance = 40,           -- Chance de drop (pourcentage 1-100)
}

Champs des emplacements de poubelles

Chaque entree dans Config.TrashBins :

Champ	Type	Description
Prop	string ou false	Modele de prop a faire apparaitre (false = utiliser l'objet du monde existant)
Pos	table	Coordonnees : { x, y, z }
Items	table	Table de loot pour cet emplacement (utilisez une variable partagee DefaultLoot ou definissez-en une personnalisee)

Fonctionnalites

• Poubelles fouillables — Maintenez le prompt pour fouiller avec animation et barre de progression
• Stash partage — Chaque poubelle a son propre inventaire partage
• Loot aleatoire — Items configurables avec chances de drop individuelles et plages de quantite
• Systeme de cooldown — Temps de reapprovisionnement aleatoire entre les fouilles pour prevenir le farming
• 94 emplacements preconfigures — Valentine, Saint Denis, Rhodes, Blackwater, Armadillo, et plus
• Spawn de props — Fait apparaitre automatiquement les props de poubelles aux emplacements configures
• Blips optionnels — Activez/desactivez les blips sur la carte pour les emplacements de poubelles
• Loot personnalise par emplacement — Chaque poubelle peut avoir sa propre table de loot
• Commande admin — /cleartrash pour vider tous les inventaires de poubelles et reinitialiser les cooldowns
• Logging webhook — Logging Discord ou handler personnalise

Depannage

Probleme	Solution
Le script ne demarre pas	Assurez-vous que jo_libs est demarre avant twinded_trashbin
Pas de blips sur la carte	Definissez Config.TrashbinBlip = true dans vos parametres personnalises
Impossible d'interagir	Verifiez que vous etes assez proche de la poubelle
"Quelqu'un a deja fouille"	La poubelle est en cooldown — attendez Config.TimeToRefill
Les props n'apparaissent pas	Verifiez que le champ Prop est defini (pas false) dans la config de la poubelle