Shop
L'extension Shops simule une économie vivante. Les prix peuvent fluctuer selon l'offre et la demande, les paramètres de stock permettent de créer de la rareté, et le réapprovisionnement automatique maintient le marché en mouvement.
Fonctionnalités
- Tarification dynamique — Les prix fluctuent selon les niveaux de stock.
- Contrôle du stock — Offre maximale et limites de réapprovisionnement.
- Limites d'achat — Restreignez les objets par joueur.
- Indépendant de la monnaie — Fonctionne avec Vault, des points ou des objets.
Entrées
- Définition — Shop Def : configurer les objets et les prix.
Démarrage rapide
- 1. Configurer les paramètres — Commencez par l'entrée de configuration : shop_definition. Elle définit les paramètres globaux de l'extension. → shop_definition
- 2. Déclencher des actions — Utilisez les entrées d'action pour interagir avec l'extension : open_shop. Déclenchez-les depuis des commandes, des PNJ, des événements ou d'autres entrées. → open_shop
Placeholders
Préfixe : %typewriter_shop:<id>:%
| Placeholder | Description |
|---|---|
%typewriter_shop:<id>:name% | Nom de la boutique |
%typewriter_shop:<id>:cooldown% | Minuteur de réapprovisionnement |
%typewriter_shop:<id>:<index>:buy_price% | Prix d'achat actuel |
%typewriter_shop:<id>:<index>:stock% | Stock actuel |
Commandes
| Commande | Description |
|---|---|
/shop | Ouvrir un menu de boutique. |
Permissions
| Permission | Description |
|---|---|
typewriter.shop.open | Ouvrir un menu de boutique. |
Référence actuelle
ShopDefinitionEntry relie un ShopItemConfig à un ShopInteractionConfig, puis à ShopClickAction ou ShopButtonType. Les services concernés sont ShopGuiService, ShopTransactionHandler et ShopButtonActionHandler.
BUY_1 / SELL_1 utilisent une unité; BUY_STACK / SELL_STACK un stack; BUY_MAX / SELL_ALL le maximum possible; BUY_CUSTOM / SELL_CUSTOM ouvrent une saisie. BUY_1:10 et SELL_1:10 créent des boutons de quantité fixe dans un sous-menu.
Les champs du dialogue sont buyAmountPrompt, sellAmountPrompt, amountConfirmButton, amountInputLabel, amountInputPlaceholder, amountInputWidth, amountInputMaxLength et invalidAmountMessage.
Version et compatibilité
| Élément | Référence |
|---|---|
| Version | Aucune release officielle publiée confirmée. |
TypeWriter | Utilisez la release officielle attendue par l’extension. |
| GUI | Dépendance de menu à vérifier avec la release publiée. |