# Produtos Cadastre produtos com preço fixo e moedas vendidas por quantidade, com imagem, estoque, limites e entrega automática na cidade. Source: https://fivedash.fivex.gg/docs/pt/store/products Os produtos são o que a sua cidade vende: VIPs, carros, itens, dinheiro, moedas como diamantes ou coins. Cada produto fica dentro de uma categoria, tem preço, imagem e diz o que o jogador recebe no jogo quando o pagamento é aprovado. Esta página é para quem monta o catálogo da loja. [Vídeo: como fazer em menos de 20 segundos](https://fivedash.fivex.gg/docs/videos/store-products-pt.mp4) ## Antes de começar * **Plano:** a Loja existe nos planos Plus, Pro e Ultra. O número de produtos por loja depende do plano: | Plano | Produtos por loja | | ----- | ----------------- | | Plus | até 50 | | Pro | até 500 | | Ultra | ilimitados | * **Permissão:** página **Loja → Produtos**. | Ação | Nível | | ---------------------------------------------------------------- | ----------------------------- | | Produtos e moedas | **Ver** | | Criar, editar, ordenar e excluir | **Configurar** | | Dar um produto de presente a um cliente (em **Loja → Clientes**) | **Gerenciar** em **Clientes** | * **Categorias:** os produtos ficam dentro das categorias. Se a loja ainda não tem nenhuma, a página mostra **Crie as categorias primeiro** e o botão **Criar categorias**. Veja [Categorias](https://fivedash.fivex.gg/docs/pt/store/categories). * **Entrega:** a loja só vende com o recurso do FiveDash rodando no servidor e a entrega ligada no `loja.lua`. Veja [Entrega no jogo](https://fivedash.fivex.gg/docs/pt/store/in-game-delivery). ## Tipos de produto Ao clicar em **Novo produto**, você escolhe o **Tipo de produto**: | Tipo | Para que serve | Como o preço funciona | | ----------- | ----------------------------------------- | --------------------------------------------------------------------------- | | **Produto** | VIP, carro, item: um preço fixo. | Um preço por unidade, com promoção opcional. | | **Moeda** | Diamantes, coins: vendida por quantidade. | Um preço base, pacotes prontos, desconto por quantidade e quantidade livre. | ## Como a página se organiza * **Loja → Produtos** abre a lista de categorias, com quantos produtos cada uma tem e quantos estão à venda (**todos à venda**, **nenhum à venda** ou "N à venda"). Escolha uma categoria para ver e editar. * Dentro da categoria, os produtos aparecem em cartões, com busca (**Buscar produto**) e filtro (**Filtrar por status**): **Todos**, **À venda**, **Rascunhos**, **Esgotados**. * Cada cartão mostra o preço (ou **a partir de**, nas moedas), quantas entregas no jogo ele tem (ou **Sem entrega configurada**) e, com estoque limitado, **Restam N**. * **Sem categoria** reúne produtos de categorias que foram excluídas (**De categorias excluídas**). Eles não aparecem na loja até você mover cada um para uma categoria. ## Cadastrar um produto ### Abra a categoria Vá em **Loja → Produtos** e escolha a categoria. Se ela estiver vazia, clique em **Cadastrar produto**. Se já tiver produtos, clique em **Novo produto** e escolha **Produto**. ### Preencha as informações Em **Informações**, escreva o **Nome** (ex.: VIP Ouro) e, se quiser, a **Descrição**: o que o jogador ganha, por quanto tempo e qualquer regra que valha a pena saber. A descrição aceita formatação. ### Defina o preço Em **Preço**, digite o valor. Para mostrar uma promoção, preencha o **Preço anterior** (ele aparece riscado ao lado do preço) ou troque para **Digitar o desconto em porcentagem**. ### Configure a entrega no jogo Em **Entrega no jogo**, clique em **Adicionar entrega** e escolha o que a cidade entrega. As entregas rodam na ordem da lista. ### Escolha status, imagem, categoria e limites Na coluna da direita: **Status** (**À venda** ou **Rascunho**), **Destaque**, **Imagem**, **Categoria** e **Estoque e limites**. ### Salve Clique em **Salvar**. Salvo como **À venda**, o produto aparece na loja na hora. > Sem entrega configurada, o pagamento é aprovado, mas o jogador não recebe nada na cidade. ## Campos do produto ### Informações e preço | Campo | O que faz | Padrão | | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | | **Nome** | Nome do produto na loja. Até 60 caracteres. | Vazio (obrigatório) | | **Descrição** | Texto com formatação na página do produto. Até 1.000 caracteres. | Vazio (opcional) | | **Preço** | Valor cobrado por unidade, de R$ 0,50 a R$ 50.000,00. | Vazio (obrigatório) | | **Preço anterior** | Preço "de", maior que o **Preço**, mostrado riscado. Na loja aparece como "de X por Y". | **Sem promoção** | | **Como digitar o preço anterior** | **Digitar o preço anterior** (em reais) ou **Digitar o desconto em porcentagem** (de 1% a 90%; o preço anterior é calculado a partir do preço). | Preço anterior | ### Status e destaque | Campo | O que faz | Padrão | | --------------------- | -------------------------------------------------------------------------------------- | ----------- | | **Status → À venda** | Os jogadores veem e compram. Se a categoria estiver oculta, ninguém vê até ela voltar. | **À venda** | | **Status → Rascunho** | Só a equipe vê. Bom para preparar antes de lançar. | — | | **Destaque** | Aparece primeiro na loja, com o selo. | Desligado | Um produto com estoque limitado que chega a zero aparece como **Esgotado** e para de vender sozinho. ### Imagem | Campo | O que faz | Padrão | | ---------- | ---------------------------------------------------------------------------------------------------------------- | ------------ | | **Imagem** | Foto do produto. Use PNG, JPG ou WebP de até 10 MB; você recorta antes de salvar. | Sem imagem | | Formato | Deitada (4:3, 800 × 600) ou em pé (3:4, 900 × 1200), conforme o site da loja. O formato muda em **Loja → Site**. | Deitada, 4:3 | Clique ou arraste a imagem para enviar. Para trocar, use **Trocar imagem**; para tirar, **Remover**. ### Categoria | Campo | O que faz | Padrão | | ------------- | -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ | | **Categoria** | Em qual categoria o produto fica. Categorias ocultas aparecem com um ícone de olho cortado. Cada categoria tem até 200 produtos. | A categoria em que você clicou | ### Estoque e limites | Campo | O que faz | Padrão | | ---------------------- | --------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- | | **Estoque limitado** | Ligado, o produto esgota quando chegar a zero. Desligado, vende sem limite. Vai de 0 a 100.000 unidades. | Desligado (ao ligar, começa em 10) | | **Limite por jogador** | Ligado, conta as compras de cada jogador, no total. Desligado, cada um compra quantas vezes quiser. Vai de 1 a 1.000 vezes. | Desligado (ao ligar, começa em 1) | Nas moedas, este painel se chama **Limites** e só tem o **Limite por jogador**: moedas não têm estoque. ## Entregas no jogo Cada produto pode ter até 10 entregas. Elas viram ações que o recurso do FiveDash roda no servidor quando o pedido é pago. Depois que um pedido é feito, editar o produto não muda o que esse pedido entrega. | Tipo | O que faz | Campos | | ---------------------- | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | | **VIP ou cargo** | Coloca o jogador num grupo do framework. | **Grupo no framework** (sem espaços, ex.: `vip_ouro`) e **Duração** em dias (1 a 3.650) ou **Permanente**. Padrão: 30 dias. | | **Veículo** | Um carro, moto ou barco na garagem. | **Nome de spawn**: o mesmo do `/car`, sem espaços (ex.: `zentorno`). | | **Dinheiro** | Valor no banco ou na carteira. | **Valor** (1 a 1.000.000.000; padrão 100.000) e **Onde cai**: **Banco** ou **Carteira**. Padrão: **Banco**. | | **Item** | Algo no inventário, com quantidade. | **Item no inventário** (ex.: `water`) e **Quantidade** (1 a 100.000; padrão 1). | | **Comando** | Um comando no console do servidor. | **Comando no console**, até 200 caracteres. **Variáveis:** `{id}`, `{discord}` e `{pedido}` (ID no jogo, Discord e número do pedido). | | **Escolha do jogador** | Uma lista, como vários carros: ele escolhe na compra. | Veja a tabela abaixo. | Quando o jogador compra mais de uma unidade, os dias de VIP e as quantidades de dinheiro e de item somam (os dias até 3.650), e um comando roda uma vez por unidade. ### Escolha do jogador | Campo | O que faz | Padrão | | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | | **Pergunta na compra** | O que o checkout pergunta. Até 60 caracteres. | "Escolha seu veículo", "Escolha seu item" ou "Escolha seu plano" | | **O que o jogador escolhe** | **Veículos**, **Itens** ou **Grupos**. | **Veículos** | | **Quantos ele escolhe** | Quantas opções o jogador marca: de 1 até 5, e sempre menos que o número de opções. | 1 | | **Quantidade de cada** | Só para itens: quantas unidades de cada item escolhido. | 1 | | **Duração** | Só para grupos: dias (1 a 3.650) ou **Permanente**. | 30 dias | | Opções | Cada opção tem o **Nome na loja** (até 40 caracteres) e o valor que a cidade recebe (**Nome de spawn**, **Item no inventário** ou **Grupo no framework**, sem espaços e sem repetir). De 2 a 40 opções. | 2 opções vazias | > Para adicionar várias opções de uma vez, cole uma lista, um por linha, no formato `Nome; valor` (ex.: `Pegassi Zentorno; zentorno`). Para saber como cada tipo é entregue em cada framework, com o jogador online ou offline, veja [Entrega no jogo](https://fivedash.fivex.gg/docs/pt/store/in-game-delivery). ## Moedas Uma moeda é vendida por quantidade: diamantes, coins, gemas. Para criar, clique em **Novo produto** e escolha **Moeda**, ou em **Cadastrar moeda** numa categoria vazia. O editor de moeda tem os mesmos **Informações**, **Status**, **Destaque**, **Imagem**, **Categoria** e **Limites** do produto, mais os painéis abaixo. ### Moeda | Campo | O que faz | Padrão | | ------------------ | ----------------------------------------------------------------------------------------------------- | ------------------ | | **Nome da moeda** | Como a moeda se chama na cidade, no plural. De 2 a 24 caracteres. | Diamantes | | **Ícone da moeda** | Um dos 10 ícones prontos, ou o seu com **Enviar ícone** (SVG, PNG, WebP ou JPG, até 512 KB). | Diamante | | **Cor da moeda** | **Dourado**, **Azul**, **Roxo**, **Verde**, **Rosa** ou **Escolher outra cor**. | **Azul** | | **Preço base** | Quanto custa **a cada** 1, 10, 100 ou 1.000 unidades, antes dos descontos. De R$ 0,01 a R$ 10.000,00. | R$ 5,00 a cada 100 | ### Pacotes Quantidades prontas na loja. O bônus vem de graça, por cima do que o jogador paga. Até 8 pacotes. | Campo | O que faz | Padrão | | ------------------------ | --------------------------------------------------------------------------------------------- | ---------------- | | **Quantidade do pacote** | Quantas unidades o jogador paga. Não pode repetir. | — | | **Bônus do pacote** | Unidades grátis, de 0 até a própria quantidade. | 0 | | **Destaque do pacote** | **Sem destaque**, **Mais popular** ou **Melhor custo**. Cada destaque vale para um pacote só. | **Sem destaque** | Pacotes que vêm prontos numa moeda nova: 100; 500 (+25); 1.000 (+100, **Mais popular**); 2.500 (+300); 5.000 (+750, **Melhor custo**). O botão **Sugerir pacotes** monta uma lista a partir do preço base. Cada pacote precisa custar pelo menos R$ 0,50. ### Desconto por quantidade Quanto mais o jogador leva, menos paga por unidade. Vale para os pacotes e para a quantidade livre. Até 5 faixas. | Campo | O que faz | Padrão | | --------------- | ------------------------------------------------------------------------------------ | ------ | | **A partir de** | A partir de quantas unidades a faixa vale (2 ou mais). | — | | **% off** | Desconto da faixa, de 1% a 80%. Cada faixa precisa dar mais desconto que a anterior. | — | Faixas de uma moeda nova: 1.000+ com 5% off e 5.000+ com 10% off. ### Quantidade livre | Campo | O que faz | Padrão | | ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- | ------ | | **Deixar o jogador escolher a quantidade** | Além dos pacotes, o jogador digita quanto quer. Aparece como **Outra quantidade** na loja. Desligado, só os pacotes ficam à venda. | Ligado | | **Mínimo** | Menor quantidade aceita. Precisa custar pelo menos R$ 0,50. | 100 | | **Máximo** | Maior quantidade, até 10.000.000. | 50.000 | | **De quanto em quanto** | O passo da quantidade. | 50 | A moeda precisa ter pelo menos um pacote ou a quantidade livre ligada. ### Entrega no jogo (moeda) Como a cidade dá a moeda: o que foi comprado mais o bônus. O editor mostra um exemplo do que a cidade vai rodar. | Opção de **Como entregar** | O que faz | Padrão | | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- | | **Comando** | Roda o **Comando de entrega** no console. Precisa ter `{quantidade}`, que vira o total comprado. Também aceita `{id}` e `{pedido}`. Até 200 caracteres. | `darmoedas {id} {quantidade}` | | **Item** | Coloca o total em **Item no inventário** (sem espaços, ex.: `diamante`). | — | | **Dinheiro** | Deposita o total **No banco** ou **Na carteira** (**Onde o dinheiro cai**). | **No banco** | ## Organizar e editar ### Mudar a ordem Dentro da categoria, arraste o cartão pela alça. A ordem daqui é a ordem na loja. ### Pôr à venda ou pausar No menu de ações do cartão, use **Pôr à venda** ou **Mover para rascunho**. ### Duplicar No menu do cartão, ou em **Mais opções do produto** no editor, clique em **Duplicar**. A cópia é criada como rascunho, com "(cópia)" no nome e a própria cópia da imagem. Salve as alterações antes de duplicar. ### Excluir No menu, clique em **Excluir** e confirme em **Excluir produto**. O produto sai da loja na hora. > Para tirar um produto de venda sem perder nada, deixe como **Rascunho** em vez de excluir. ## Dar um produto de presente A equipe pode dar um produto a um cliente sem cobrança. Vira um pedido de presente: a cidade entrega como uma compra, mas não conta como venda. ### Abra o cliente Vá em **Loja → Clientes** e abra o cliente. ### Escolha o produto Clique em **Dar produto** e escolha o produto. Se ele tiver **Escolha do jogador**, marque as opções. Para moedas, escolha um pacote ou **Outra** quantidade. ### Diga quem recebe Em **ID na cidade**, digite o ID do personagem. Vazio, vai para o personagem ligado ao Discord do cliente. A cidade confere o ID e mostra o nome do personagem. ### Envie Se quiser, escreva o **Motivo (só a equipe vê)** e clique em **Dar de presente**. | Campo | O que faz | Limite | | --------------------------- | ----------------------------------------------------- | -------------- | | Quantidade | Quantas unidades do produto. | 1 a 20 | | **Quanto dar** | Para moedas: um pacote ou outra quantidade. | Até 10.000.000 | | **ID na cidade** | Para quem vai. Vazio: o personagem ligado ao Discord. | — | | **Motivo (só a equipe vê)** | Anotação interna do pedido. | 200 caracteres | Só dá para presentear produtos que entregam algo na cidade. ## Mais vendidos no checkout Na página **Loja → Ofertas** você liga **Mais vendidos no checkout**, que sugere os produtos que mais vendem nos últimos 30 dias. Veja [Ofertas](https://fivedash.fivex.gg/docs/pt/store/offers). ## Perguntas frequentes **Mudei o produto. Pedidos já pagos mudam também?** Não. Cada pedido guarda as entregas do momento da compra. **O produto está À venda, mas não aparece na loja. Por quê?** A categoria dele pode estar oculta, ou ele está esgotado. O editor avisa quando a categoria está oculta. **Cheguei no limite de produtos do plano. E agora?** Novos produtos e cópias são recusados até você excluir algum ou mudar de plano. Veja [Planos e cobrança](https://fivedash.fivex.gg/docs/pt/getting-started/plans-and-billing). **Posso vender sem entrega configurada?** Pode, mas o jogador paga e não recebe nada na cidade. Use para algo que a equipe entrega à mão e marque o pedido como entregue em **Loja → Pedidos**. ## Próximos passos [Entrega no jogo](https://fivedash.fivex.gg/docs/pt/store/in-game-delivery)Como cada tipo de entrega chega no personagem. [Categorias](https://fivedash.fivex.gg/docs/pt/store/categories)Organize as seções da loja. [Cupons](https://fivedash.fivex.gg/docs/pt/store/coupons)Descontos para sorteios e parcerias. [Pedidos](https://fivedash.fivex.gg/docs/pt/store/orders)Acompanhe pagamentos e entregas.