exchange

Échanges, banque et stockage

Méthodes

putItem

Depose un objet specifique dans le stockage ou l'echange en cours. Recherche l'objet dans l'inventaire par son GID et envoie une demande de transfert au serveur. Attend la confirmation du serveur avant de continuer. Affiche un message d'erreur si l'objet n'est pas trouve dans l'inventaire.

Signature: exchange:putItem(objectGID, quantity)

Paramètres:

Nom	Type	Description
objectGID	number	L'ID general de l'objet (GID) - identifiant du type d'objet
quantity	number	Quantite a deposer

Exemple:

-- Deposer 50 bles (GID 289) dans la banque
exchange:putItem(289, 50)

-- Deposer plusieurs ressources
local ressources = {
    {gid = 289, qty = 100},  -- Ble
    {gid = 400, qty = 50},   -- Orge
    {gid = 533, qty = 25},   -- Chanvre
}
for _, res in ipairs(ressources) do
    exchange:putItem(res.gid, res.qty)
end

Note: Le script est suspendu jusqu'a confirmation du serveur. Si l'objet n'existe pas dans l'inventaire, un message d'erreur est affiche dans le chat du bot.

---

getItem

Recupere un objet depuis le stockage (banque) ou l'echange. Recherche l'objet dans le stockage par son GID et envoie une demande de recuperation au serveur. Attend le delai specifie (defaut 1000ms) avant de continuer.

Signature: exchange:getItem(objectGID, quantity, delay)

Paramètres:

Nom	Type	Description
objectGID	number	L'ID general de l'objet (GID)
quantity	number	Quantite a recuperer
delay	number	Delai en millisecondes apres l'operation (defaut: 1000ms)

Retourne: void

Exemple:

-- Recuperer 10 bles de la banque
exchange:getItem(289, 10)

-- Recuperer avec delai personnalise (500ms)
exchange:getItem(289, 10, 500)

-- Recuperer toutes les ressources necessaires pour un craft
local ingredientsCraft = {
    {gid = 289, qty = 5},   -- Ble
    {gid = 350, qty = 3},   -- Eau
}
for _, item in ipairs(ingredientsCraft) do
    if exchange:storageItemQuantity(item.gid) >= item.qty then
        exchange:getItem(item.gid, item.qty, 300)
    end
end

Note: ATTENTION: Cette fonction n'attend pas de confirmation du serveur, seulement un delai fixe. Pour des operations critiques, ajoutez un delai supplementaire avec global:delay().

---

getAllItems

Recupere TOUS les objets presents dans le stockage (banque) vers l'inventaire du personnage. Envoie une demande de transfert complet au serveur et attend la confirmation avant de continuer. Affiche le message "le bot prend les objets presents en banque" dans le chat.

Signature: exchange:getAllItems()

Retourne: void

Exemple:

-- Vider completement la banque
exchange:getAllItems()
global:printSuccess("Tous les objets ont ete recuperes!")

-- Verifier l'inventaire apres recuperation
local items = inventory:inventoryContent()
global:printMessage("Objets en inventaire: " .. #items)

Note: Attention: assurez-vous d'avoir assez de place dans l'inventaire. Si l'inventaire est plein, seuls les objets qui peuvent etre transferes le seront.

---

putAllItems

Depose TOUS les objets de l'inventaire dans le stockage (banque). Envoie une demande de transfert complet au serveur et attend la confirmation avant de continuer. Affiche le message "le bot vide tous les objets presents en inventaire" dans le chat.

Signature: exchange:putAllItems()

Retourne: void

Exemple:

-- Vider completement l'inventaire dans la banque
exchange:putAllItems()
global:printSuccess("Inventaire vide dans la banque!")

-- Workflow typique de depot en banque
if map:currentMapId() == 88081177 then  -- Map de la banque
    npc:npc(-20001)  -- Parler au banquier
    npc:reply(-1)    -- Ouvrir le coffre
    exchange:putAllItems()
    exchange:leave()
end

Note: Cette fonction depose TOUS les objets, sans filtrer par position. Pour exclure certains objets, utilisez putAllItemsExcept().

---

getAllItemsExcept

Recupere tous les objets du stockage SAUF ceux dont le GID est dans la liste d'exception. Parcourt les objets en banque et transfere uniquement ceux qui ne sont pas dans la liste d'exclusion. Attend la confirmation du serveur avant de continuer.

Signature: exchange:getAllItemsExcept(except)

Paramètres:

Nom	Type	Description
except	table	Liste des GID (table Lua) des objets a ne PAS recuperer

Retourne: void

Exemple:

-- Recuperer tout sauf les pods (GID 1234) et les parchemins (GID 5678)
exchange:getAllItemsExcept({1234, 5678})

-- Garder certaines ressources en banque pour plus tard
local aGarder = {
    289,   -- Ble (pour farm plus tard)
    400,   -- Orge
}
exchange:getAllItemsExcept(aGarder)

-- Recuperer tout sauf les consommables rares
local consommablesRares = {692, 693, 694}  -- Potions precieuses
exchange:getAllItemsExcept(consommablesRares)

Note: Affiche le message "Le bot prend les objets presents dans l'espace de stockage (getAllItemsExcept)." dans le chat.

---

putAllItemsExcept

Depose tous les objets de l'inventaire SAUF ceux dont le GID est dans la liste d'exception. Parcourt l'inventaire et transfere uniquement les objets non equipes qui ne sont pas dans la liste d'exclusion. Attend la confirmation du serveur avant de continuer.

Signature: exchange:putAllItemsExcept(except)

Paramètres:

Nom	Type	Description
except	table	Liste des GID (table Lua) des objets a garder dans l'inventaire

Retourne: void

Exemple:

-- Deposer tout sauf les potions de vie (GID 289)
exchange:putAllItemsExcept({289})

-- Garder les consommables essentiels pour le combat
local aGarder = {
    289,   -- Potion de vie
    548,   -- Pain
    6965,  -- Rappel de position
}
exchange:putAllItemsExcept(aGarder)

-- Workflow pour deposer les ressources mais garder l'equipement de rechange
local equipementRechange = {12345, 12346, 12347}
exchange:putAllItemsExcept(equipementRechange)

Note: Seuls les objets en position 63 (inventaire non equipe) sont consideres. Les objets equipes (positions 0-15) sont automatiquement exclus. Affiche le message "Le bot vide tous les objets presents en inventaire (putAllItemsExcept)."

---

putKamas

Depose des kamas dans le stockage (banque) ou l'echange. Si kamas = 0, depose TOUS les kamas du personnage. Attend la confirmation du serveur avant de continuer.

Signature: exchange:putKamas(kamas)

Paramètres:

Nom	Type	Description
kamas	number	Montant de kamas a deposer (0 = tout deposer)

Retourne: void

Exemple:

-- Deposer 100000 kamas
exchange:putKamas(100000)

-- Deposer TOUS les kamas
exchange:putKamas(0)

-- Deposer tout en gardant 10000 kamas sur soi
local kamasActuels = character:kamas()
if kamasActuels > 10000 then
    exchange:putKamas(kamasActuels - 10000)
end

Note: Passer 0 comme parametre depose automatiquement tous les kamas disponibles sur le personnage.

---

getKamas

Recupere des kamas depuis le stockage (banque). Si kamas = 0, recupere TOUS les kamas de la banque. Attend la confirmation du serveur avant de continuer.

Signature: exchange:getKamas(kamas)

Paramètres:

Nom	Type	Description
kamas	number	Montant de kamas a recuperer (0 = tout recuperer)

Retourne: void

Exemple:

-- Recuperer 50000 kamas de la banque
exchange:getKamas(50000)

-- Recuperer TOUS les kamas de la banque
exchange:getKamas(0)

-- Recuperer juste assez pour un achat
local prixAchat = 25000
local kamasActuels = character:kamas()
if kamasActuels < prixAchat then
    local manque = prixAchat - kamasActuels
    exchange:getKamas(manque)
end

Note: Passer 0 comme parametre recupere automatiquement tous les kamas disponibles en banque.

---

LaunchExchangeWithPlayer

Lance une demande d'echange avec un joueur specifique via son ID de contexte. NECESSITE UN ABONNEMENT PREMIUM. Envoie la demande d'echange au joueur et attend jusqu'a 50 secondes sa reponse (acceptation ou refus), puis attend l'ouverture de l'interface d'echange.

Signature: exchange:LaunchExchangeWithPlayer(PlayerId)

Paramètres:

Nom	Type	Description
PlayerId	number	L'ID de contexte du joueur (contextualId, type Double)

Retourne: boolean - true si l'echange a ete accepte et ouvert, false si refuse ou timeout

Exemple:

-- Lancer un echange avec un joueur specifique
local success = exchange:LaunchExchangeWithPlayer(123456789)
if success then
    global:printSuccess("Echange ouvert!")
    -- Mettre des objets dans l'echange
    exchange:putItem(289, 10)
    exchange:Ready()
else
    global:printError("L'echange a ete refuse ou a expire")
end

-- Trouver un joueur sur la map et echanger avec lui
local players = map:players()
if #players > 0 then
    local success = exchange:LaunchExchangeWithPlayer(players[1].contextualId)
end

Note: Necessite un abonnement premium. Affiche "Vous n'avez pas d'abonnement pour les echanges avances." si non autorise. Timeout de 50 secondes pour chaque etape.

---

launchExchangeWithPlayerByName

Lance une demande d'echange avec un joueur via son nom. Recherche le joueur sur la map actuelle par son nom exact, puis lance l'echange avec lui.

Signature: exchange:launchExchangeWithPlayerByName(name)

Paramètres:

Nom	Type	Description
name	string	Le nom exact du joueur (sensible a la casse)

Retourne: boolean - true si le joueur a ete trouve et l'echange accepte, false sinon

Exemple:

-- Echanger avec un joueur par son nom
local success = exchange:launchExchangeWithPlayerByName("MonAmi")
if success then
    global:printSuccess("Echange avec MonAmi ouvert!")
    exchange:putItem(289, 100)  -- Donner 100 bles
    exchange:Ready()
else
    global:printError("Joueur non trouve ou echange refuse")
end

-- Script de transfert automatique vers un mule
local muleNom = "MonMule"
if exchange:launchExchangeWithPlayerByName(muleNom) then
    exchange:putAllItems()
    exchange:putKamas(0)  -- Tout donner
    exchange:Ready()
    global:delay(5000)  -- Attendre validation
    exchange:leave()
end

Note: Le nom doit etre exactement identique (sensible a la casse). Le joueur doit etre present sur la meme map. Necessite un abonnement premium.

---

storageItems

Retourne la liste des GID de tous les objets presents dans le stockage (banque). Retourne une liste d'entiers representant les identifiants des types d'objets.

Signature: exchange:storageItems()

Retourne: table - Liste (table Lua) des GID des objets en stockage

Exemple:

-- Lister tous les types d'objets en banque
local items = exchange:storageItems()
for _, gid in ipairs(items) do
    local nom = d2data:getItemName(gid)
    global:printMessage("En banque: " .. nom .. " (GID: " .. gid .. ")")
end

-- Verifier si un objet est en banque
local gidRecherche = 289  -- Ble
local items = exchange:storageItems()
local trouve = false
for _, gid in ipairs(items) do
    if gid == gidRecherche then
        trouve = true
        break
    end
end
if trouve then
    global:printSuccess("Ble trouve en banque!")
end

Note: Retourne uniquement les GID, pas les quantites. Utilisez storageItemQuantity() pour obtenir la quantite d'un objet specifique.

---

storageItemQuantity

Retourne la quantite d'un objet specifique dans le stockage (banque). Recherche l'objet par son GID et retourne la quantite stockee. Retourne 0 si l'objet n'est pas trouve.

Signature: exchange:storageItemQuantity(GID)

Paramètres:

Nom	Type	Description
GID	number	L'ID general de l'objet recherche

Retourne: number - Quantite de l'objet en stockage (0 si absent)

Exemple:

-- Verifier la quantite de ble en banque
local qtyBle = exchange:storageItemQuantity(289)
global:printMessage("Ble en banque: " .. qtyBle)

-- Recuperer seulement si assez en stock
local besoin = 100
if exchange:storageItemQuantity(289) >= besoin then
    exchange:getItem(289, besoin)
else
    global:printWarning("Pas assez de ble en banque!")
end

-- Inventaire de la banque avec quantites
local items = exchange:storageItems()
for _, gid in ipairs(items) do
    local nom = d2data:getItemName(gid)
    local qty = exchange:storageItemQuantity(gid)
    global:printMessage(nom .. ": " .. qty)
end

---

storageKamas

Retourne le nombre de kamas presents dans le stockage (banque).

Signature: exchange:storageKamas()

Retourne: number - Montant de kamas en banque

Exemple:

-- Afficher les kamas en banque
local kamas = exchange:storageKamas()
global:printMessage("Kamas en banque: " .. kamas)

-- Verifier si assez de kamas pour un achat
local prixAchat = 50000
if exchange:storageKamas() >= prixAchat then
    exchange:getKamas(prixAchat)
    global:printSuccess("Kamas recuperes pour l'achat!")
else
    global:printWarning("Pas assez de kamas en banque")
end

-- Afficher le total des kamas (personnage + banque)
local kamasTotal = character:kamas() + exchange:storageKamas()
global:printMessage("Fortune totale: " .. kamasTotal .. " kamas")

---

storageItemCount

Retourne le nombre de types d'objets differents dans le stockage (banque). Compte le nombre de stacks differents (pas la quantite totale d'objets).

Signature: exchange:storageItemCount()

Retourne: number - Nombre de types d'objets differents en stockage

Exemple:

-- Verifier l'espace utilise en banque
local nbTypes = exchange:storageItemCount()
global:printMessage("Types d'objets en banque: " .. nbTypes)

-- Verifier si la banque est presque pleine (max ~300 slots)
if exchange:storageItemCount() > 280 then
    global:printWarning("Banque presque pleine!")
end

Note: Compte le nombre de stacks/types differents, pas la quantite totale. Par exemple, 100 bles et 50 orges comptent pour 2 types.

---

Ready

Valide l'echange en cours (equivalent a cliquer sur le bouton "Pret"). Attend 3 secondes avant d'envoyer la validation, puis attend jusqu'a 50 secondes que l'echange soit finalise.

Signature: exchange:Ready()

Retourne: void

Exemple:

-- Workflow d'echange complet
if exchange:launchExchangeWithPlayerByName("MonAmi") then
    -- Mettre des objets dans l'echange
    exchange:putItem(289, 100)
    exchange:putKamas(10000)

    -- Valider l'echange
    exchange:Ready()

    global:printSuccess("Echange termine!")
end

-- Echange avec validation conditionnelle
exchange:putItem(289, 50)
-- Attendre que l'autre joueur mette quelque chose...
global:delay(5000)
exchange:Ready()

Note: L'echange ne sera effectif que lorsque les DEUX parties auront valide (clique sur Pret). Le script attend que l'echange soit finalise avant de continuer. Delai initial de 3 secondes pour eviter les validations trop rapides.

---

leave

Quitte l'echange ou le stockage en cours. Ferme proprement le dialogue actuel (banque, echange joueur, coffre, etc.).

Signature: exchange:leave()

Retourne: void

Exemple:

-- Workflow complet avec la banque
npc:npc(-20001)  -- Parler au banquier
npc:reply(-1)    -- Ouvrir le coffre

-- Deposer les ressources
exchange:putAllItems()
exchange:putKamas(0)

-- Fermer la banque
exchange:leave()
global:printSuccess("Depot en banque termine!")

-- Annuler un echange en cours
if exchange:launchExchangeWithPlayerByName("Joueur") then
    -- On change d'avis...
    exchange:leave()
    global:printMessage("Echange annule")
end

Note: Peut etre utilise pour fermer n'importe quel type de dialogue (banque, echange joueur, coffre de maison, etc.).

---