Shop

La extensión Shops simula una economía viva. Los precios pueden fluctuar según la oferta y la demanda, los ajustes de stock permiten crear escasez y el reabastecimiento automático mantiene el mercado en movimiento.

Características

• Precios dinámicos — Los precios fluctúan según los niveles de stock.
  • Control de stock — Oferta máxima y límites de reabastecimiento.
  • Límites de compra — Restringe los objetos por jugador.
  • Independiente de la moneda — Funciona con Vault, puntos u objetos.

Entradas

• Definición — Shop Def: configurar objetos y precios.
  • Acciones — Open Shop: abrir la interfaz de la tienda.
  • Almacenamiento — Storage: base de datos de stock.

Inicio rápido

• 1. Configurar los ajustes — Empieza por la entrada de configuración: shop_definition. Define los ajustes globales de la extensión. → shop_definition
• 2. Activar acciones — Usa las entradas de acción para interactuar con la extensión: open_shop. Actívalas desde comandos, NPC, eventos u otras entradas. → open_shop

Placeholders

Prefijo: %typewriter_shop:<id>:%

Placeholder	Descripción
%typewriter_shop:<id>:name%	Nombre de la tienda
%typewriter_shop:<id>:cooldown%	Temporizador de reabastecimiento
%typewriter_shop:<id>:<index>:buy_price%	Precio de compra actual
%typewriter_shop:<id>:<index>:stock%	Stock actual

Comandos

Comando	Descripción
/shop	Abrir un menú de tienda.

Permisos

Permission	Descripción
typewriter.shop.open	Abrir un menú de tienda.

Referencia actual

ShopDefinitionEntry conecta ShopItemConfig con ShopInteractionConfig y después con ShopClickAction o ShopButtonType. Los servicios son ShopGuiService, ShopTransactionHandler y ShopButtonActionHandler.

BUY_1 / SELL_1 usan una unidad; BUY_STACK / SELL_STACK un stack; BUY_MAX / SELL_ALL el máximo posible; BUY_CUSTOM / SELL_CUSTOM abren una entrada. BUY_1:10 y SELL_1:10 crean botones de cantidad fija en un submenú.

Los campos del diálogo son buyAmountPrompt, sellAmountPrompt, amountConfirmButton, amountInputLabel, amountInputPlaceholder, amountInputWidth, amountInputMaxLength e invalidAmountMessage.

Versión y compatibilidad

Elemento	Referencia
Versión	No se ha confirmado ninguna release oficial publicada.
TypeWriter	Usa la release oficial esperada por la extensión.
GUI	Dependencia de menú que debe coincidir con la release publicada.