Utilisation détaillée

1. Prix globaux

DT_MerchantPrice, dans Content/DataTable, fournit les prix que les boutiques peuvent partager. Une entrée de boutique peut utiliser ce prix global ou son propre prix local.

Paramètres

Paramètre	Description détaillée
`ItemID`	Identifiant de l’article. C’est la valeur utilisée pour retrouver son prix global.
`BuyCurrencyID`	Identifiant de la monnaie demandée pour l’achat.
`BuyAmount`	Montant demandé pour l’achat. Zéro rend l’article gratuit.
`SellCurrencyID`	Identifiant de la monnaie remise au joueur à la vente.
`SellAmount`	Montant remis au joueur à la vente.
`AutoSellCurrencyID`	Identifiant de la monnaie de vente automatique.
`AutoSellAmount`	Montant remis pendant une vente automatique.

2. Le subsystem

Accès au subsystem

Dans un Blueprint, utilisez directement la fonction Get_ADS_MerchantSubsystem. Get ADS Merchant Subsystem

Fonctions

Fonction	Description détaillée
`Can Open Store`	Vérifie qu’une boutique existe et n’est pas verrouillée avant d’ouvrir l’interface.
`Get Current Store`	Retourne les listes d’articles du niveau actif.
`Get Current Store Level`	Retourne le niveau actif.
`Set Current Store Level`	Change le niveau dans les limites configurées.
`Refresh Store`	Synchronise une boutique et notifie un rafraîchissement.
`Get Store State`	Retourne l’état sauvegardable d’une boutique.
`Set Store State`	Restaure l’état d’une boutique.
`Get All Store States`	Retourne tous les états pour le SaveGame.
`Set All Store States`	Restaure tous les états après chargement.
`Buy From Store`	Exécute un achat ; le prix est résolu par le système.
`Sell To Store`	Exécute une vente au marchand.
`Auto Sell Item`	Exécute une vente sans boutique.
`Get Max Item`	Calcule la quantité maximale possible sans lancer l’échange.
`Get Final Price`	Retourne le prix final d’affichage, promotion et arrondi inclus.
`Get Promotion`	Retourne le multiplicateur de promotion d’achat.
`Set Promotion`	Modifie le multiplicateur de promotion d’achat.
`Get Price Rounding Mode`	Retourne le mode d’arrondi des promotions.
`Set Price Rounding Mode`	Modifie le mode d’arrondi.
`Get Stock`	Retourne le stock ; `-1` signifie illimité.
`Update Stock`	Modifie un stock fini.
`Get Locked`	Lit le verrouillage global.
`Set Locked`	Modifie le verrouillage global.
`Get Item Locked`	Lit le verrouillage d’un article.
`Set Item Locked`	Modifie le verrouillage d’un article.
`Get Total Spent By Player`	Retourne les dépenses par monnaie.
`Set Total Spent By Player`	Remplace les dépenses mémorisées.
`Add Spent Amount`	Ajoute un montant aux dépenses.
`Clear Total Spent By Player`	Efface les dépenses.
`Get Donated Items`	Retourne les dons reçus.
`Set Donated Items`	Remplace les dons reçus.
`Add Donation`	Ajoute un don.
`Remove Donation`	Retire un don.
`Clear Donations`	Efface les dons.
`Get Price DT`	Retourne la table de prix active.
`Set Price DT`	Remplace la table de prix active.
`Reset Price DT To Default`	Restaure la table fournie par le plugin.
`Get Logic Context`	Retourne la logique Blueprint active.
`Set Logic Context Class`	Définit la classe de logique Blueprint.

Event Dispatchers

Dispatcher	Description détaillée
`On Buy`	Diffusé après chaque tentative d’achat.
`On Sell`	Diffusé après chaque tentative de vente.
`On Auto Sell`	Diffusé après chaque tentative de vente automatique.
`On Store Changed`	Diffusé après un changement de niveau, don, dépense, verrouillage, restauration ou rafraîchissement.

3. Actor Component de boutique

Brancher le composant

Ajoutez AC Merchant Store à l’acteur marchand. Il s’enregistre automatiquement au démarrage. Dans Details, renseignez StoreID puis configurez ses niveaux.

Ajout du composant marchand

Paramètres

(Voir panneau amélioré.)

Fonctions

Fonction	Description détaillée
`Get Store ID`	Retourne l’identifiant de boutique.
`Get Store Display Name`	Retourne le nom affichable.
`Set Store Display Name`	Change le nom affichable.
`Get Current Store Level`	Retourne le niveau actif.
`Set Current Store Level`	Change le niveau actif.
`Get Max Store Level`	Retourne le nombre de niveaux.
`Get Store Locked`	Retourne le verrouillage global.
`Set Store Locked`	Modifie le verrouillage global.
`Initialize Store Logic`	Crée la logique propre à la boutique.

4. La logique Blueprint

Créez un enfant de ADS Merchant Logic Base et définissez-le avec Set Logic Context Class. Il relie les échanges à vos inventaires et monnaies. Pour des règles propres à un marchand, créez un enfant de ADS Merchant Store Logic Base et assignez-le à StoreLogicClass.

Fonctions de ADS Merchant Logic Base

Fonction	Description détaillée
`On Initialized`	Initialise les références de votre projet.
`Get Item Quantity`	Retourne la quantité possédée.
`Add Item`	Ajoute ou retire un objet.
`Has Enough Item`	Vérifie la quantité possédée.
`Can Receive Item`	Vérifie la capacité d’inventaire.
`Get Currency Amount`	Retourne le montant d’une monnaie.
`Add Currency`	Ajoute ou retire une monnaie.
`Has Enough Currency`	Vérifie le montant disponible.
`On Buy Hook`	Réagit à un achat.
`On Sell Hook`	Réagit à une vente.
`On Auto Sell Hook`	Réagit à une vente automatique.

Fonctions de ADS Merchant Store Logic Base

Fonction	Description détaillée
`On Initialized`	Initialise la logique associée à la boutique.
`Get Store Component`	Retourne le composant marchand.
`Get Store ID`	Retourne son identifiant.
`Get Current Store Level`	Retourne le niveau.
`Set Current Store Level`	Change le niveau.
`Get Max Store Level`	Retourne le nombre de niveaux.
`Get Store Locked`	Retourne le verrouillage.
`Set Store Locked`	Modifie le verrouillage.

5. Panneau de détails amélioré

Paramètres

Paramètre	Description détaillée
`Store ID`	Identifiant unique de la boutique ; le panneau signale les doublons.
`Display Name`	Nom localisé destiné à l’interface.
`Data Table`	Table source synchronisée automatiquement dans les listes de chaque niveau.
`ItemID Column`	Colonne contenant l’identifiant ; `ItemID` est la valeur par défaut.
`Item Filter`	Affiche tous les articles, ceux `In Store` ou ceux qui ne le sont pas.
`Context`	Classe de logique Blueprint propre à ce marchand.
`Store Lock`	Verrouillage global de la boutique.
`Reason` (boutique)	Raison du verrouillage global.
`Store Levels`	Niveaux contenant les listes `Buy` et `Sell`.
`Item ID`	Identifiant de l’article de l’entrée.
`In Store`	Détermine si l’article est réellement proposé.
`Global Price`	Utilise la table de prix globaux.
`Price`	Monnaie et montant du prix local.
`Stock`	Entrée `Buy` : `-1` illimité, `0` épuisé ou quantité finie.
`Price scale (promo)`	Entrée `Buy` : multiplicateur de prix.
`Locked`	Verrouille l’entrée pour son type de transaction.
`Reason` (article)	Raison du verrouillage ou du déverrouillage de l’article.

Le panneau Details du composant est adapté au système marchand. Il évite la tâche fastidieuse d’ajouter les articles un par un : le système ajoute automatiquement tous les articles de la DataTable sélectionnée. Il permet également de filtrer les articles. Pour proposer réellement un article dans une boutique, il suffit de cocher sa case In Store.

Il regroupe les informations d’identité, le choix de la DataTable et du contexte, le verrouillage et les niveaux de boutique. Les listes d’achat et de vente utilisent des codes couleurs distincts et présentent directement le prix global ou local, le stock, la promotion et le verrouillage.

Identité et table de données

Articles à acheter

Articles à vendre