Shop
Die Shops-Erweiterung simuliert eine lebendige Wirtschaft. Preise können je nach Angebot und Nachfrage schwanken, Lagereinstellungen erzeugen Knappheit, und automatisches Auffüllen hält den Markt in Bewegung.
Funktionen
- Dynamische Preise — Preise schwanken je nach Lagerbestand.
- Bestandskontrolle — Maximales Angebot und Auffüllgrenzen.
- Kauflimits — Beschränke Gegenstände pro Spieler.
- Währungsunabhängig — Funktioniert mit Vault, Punkten oder Gegenständen.
Einträge
- Definition — Shop Def: Gegenstände und Preise konfigurieren.
Schnellstart
- 1. Einstellungen konfigurieren — Beginne mit dem Konfigurationseintrag: shop_definition. Er legt die globalen Einstellungen der Erweiterung fest. → shop_definition
- 2. Aktionen auslösen — Verwende Aktionseinträge, um mit der Erweiterung zu interagieren: open_shop. Löse sie über Befehle, NPCs, Ereignisse oder andere Einträge aus. → open_shop
Platzhalter
Präfix: %typewriter_shop:<id>:%
| Platzhalter | Beschreibung |
|---|---|
%typewriter_shop:<id>:name% | Name des Shops |
%typewriter_shop:<id>:cooldown% | Auffüll-Timer |
%typewriter_shop:<id>:<index>:buy_price% | Aktueller Kaufpreis |
%typewriter_shop:<id>:<index>:stock% | Aktueller Bestand |
Befehle
| Befehl | Beschreibung |
|---|---|
/shop | Ein Shop-Menü öffnen. |
Berechtigungen
| Permission | Beschreibung |
|---|---|
typewriter.shop.open | Ein Shop-Menü öffnen. |
Aktuelle Referenz
ShopDefinitionEntry verbindet ShopItemConfig mit ShopInteractionConfig und danach mit ShopClickAction oder ShopButtonType. Die Services sind ShopGuiService, ShopTransactionHandler und ShopButtonActionHandler.
BUY_1 / SELL_1 verwenden eine Einheit; BUY_STACK / SELL_STACK einen Stack; BUY_MAX / SELL_ALL das mögliche Maximum; BUY_CUSTOM / SELL_CUSTOM öffnen die Eingabe. BUY_1:10 und SELL_1:10 erstellen feste Mengenbuttons im Untermenü.
Die Dialogfelder sind buyAmountPrompt, sellAmountPrompt, amountConfirmButton, amountInputLabel, amountInputPlaceholder, amountInputWidth, amountInputMaxLength und invalidAmountMessage.
Version und Kompatibilität
| Element | Referenz |
|---|---|
| Version | Keine veröffentlichte offizielle Release bestätigt. |
TypeWriter | Verwende die erwartete offizielle Release. |
| GUI | Menüabhängigkeit, die zur veröffentlichten Release passen muss. |