Shop
A extensão Shops simula uma economia viva. Os preços podem oscilar conforme a oferta e a demanda, as configurações de estoque permitem criar escassez, e o reabastecimento automático mantém o mercado em movimento.
Recursos
- Precificação dinâmica — Os preços oscilam conforme os níveis de estoque.
- Controle de estoque — Oferta máxima e limites de reposição.
- Limites de compra — Restrinja itens por jogador.
- Independente de moeda — Funciona com Vault, pontos ou itens.
Entradas
- Definição — Shop Def: configurar itens e preços.
Início rápido
- 1. Configurar as definições — Comece pela entrada de configuração: shop_definition. Ela define as configurações globais da extensão. → shop_definition
- 2. Acionar ações — Use as entradas de ação para interagir com a extensão: open_shop. Acione-as a partir de comandos, NPCs, eventos ou outras entradas. → open_shop
Placeholders
Prefixo: %typewriter_shop:<id>:%
| Placeholder | Descrição |
|---|---|
%typewriter_shop:<id>:name% | Nome da loja |
%typewriter_shop:<id>:cooldown% | Temporizador de reposição |
%typewriter_shop:<id>:<index>:buy_price% | Preço de compra atual |
%typewriter_shop:<id>:<index>:stock% | Estoque atual |
Comandos
| Comando | Descrição |
|---|---|
/shop | Abrir um menu de loja. |
Permissões
| Permission | Descrição |
|---|---|
typewriter.shop.open | Abrir um menu de loja. |
Referência atual
ShopDefinitionEntry conecta ShopItemConfig a ShopInteractionConfig e depois a ShopClickAction ou ShopButtonType. Os serviços são ShopGuiService, ShopTransactionHandler e ShopButtonActionHandler.
BUY_1 / SELL_1 usam uma unidade; BUY_STACK / SELL_STACK usam um stack; BUY_MAX / SELL_ALL usam o máximo possível; BUY_CUSTOM / SELL_CUSTOM abrem a entrada. BUY_1:10 e SELL_1:10 criam botões de quantidade fixa em um submenu.
Os campos do diálogo são buyAmountPrompt, sellAmountPrompt, amountConfirmButton, amountInputLabel, amountInputPlaceholder, amountInputWidth, amountInputMaxLength e invalidAmountMessage.
Versão e compatibilidade
| Elemento | Referência |
|---|---|
| Versão | Nenhuma release oficial publicada foi confirmada. |
TypeWriter | Use a release oficial esperada pela extensão. |
| GUI | Dependência de menu que deve coincidir com a release publicada. |