Placeholders

Todo o texto entre os sinais de menor e maior (<>) é um espaço reservado/variável, substitua-o pelo valor solicitado sem os sinais de menor e maior (<>).

Este documento lista as placeholders internas do yArmazem e onde cada uma pode ser usada.

Economias das plantações

As economias das plantações são configuradas em common/src/main/resources/plantacoes.yml, dentro de Precos.

Exemplo:

Plantacoes:
  cacto:
    Preco: 10.0
    Precos:
      preco1:
        Provider: 'Money'
        Amount: 10.0
      preco2:
        Provider: 'Coins'
        Amount: 5.0
      preco3:
        Provider: 'Cash'
        Amount: 2.0

O valor de Provider define o nome da economia. Nas placeholders dinâmicas, o plugin usa o provider em minúsculo.

Provider	Mensagem de venda	Menu de plantação total	Menu de plantação unitário
`Money`	`{money}`	`{money_total}`	`{money_unitario}`
`Coins`	`{coins}`	`{coins_total}`	`{coins_unitario}`
`Cash`	`{cash}`	`{cash_total}`	`{cash_unitario}`

Mensagens de venda

Use {provider} em minúsculo para mostrar o valor recebido em cada economia.

Exemplo em config.yml:

Mensagens:
  Vendeu: '&aVocê vendeu &7x{quantia} {display}&a e ganhou &6{money}&a money, &e{coins}&a coins e &b{cash}&a cash! {bonus}'
  Vendeu tudo: '&aVocê vendeu &7x{quantia} plantações&a e ganhou &6{money}&a money, &e{coins}&a coins e &b{cash}&a cash! {bonus}'

Também funciona em:

Title.Vendeu
Title.Vendeu tudo
Actionbar.Vendeu
Actionbar.Vendeu tudo
Plantacoes.<plantacao>.Mensagens.Vendeu
Plantacoes.<plantacao>.Title.Vendeu
Plantacoes.<plantacao>.Actionbar.Vendeu

Menus de plantações

Use {provider_total} e {provider_unitario} em minúsculo para mostrar valores de economias secundárias no item da plantação.

Exemplo em menus/principal.yml, menus/categoria.yml, menus/plantacao.yml ou plantacoes.yml em ItemDisplay.Lore:

Plantacao:
  Nome: '&b{display}'
  Lore:
    - '&fQuantia: &a{quantia}&f.'
    - '&fMoney unitário: &a{money_unitario}&f.'
    - '&fMoney total: &a{money_total}&f.'
    - '&fCoins unitário: &e{coins_unitario}&f.'
    - '&fCoins total: &e{coins_total}&f.'
    - '&fCash unitário: &b{cash_unitario}&f.'
    - '&fCash total: &b{cash_total}&f.'

Placeholders de menus de plantações

Funcionam nos itens de plantação dos menus principal, categoria, plantacao e no ItemDisplay da plantação.

Placeholder	Descrição
`{display}`	Nome configurado da plantação.
`{quantia}`	Quantia armazenada da plantação.
`{total}`	Valor total da venda usando o preço padrão, com bônus/bolsa aplicados.
`{total_raw}`	Valor total bruto usando o preço padrão, sem bônus/bolsa.
`{unitario}`	Valor unitário usando o preço padrão, com bônus/bolsa aplicados.
`{unitario_raw}`	Valor unitário bruto usando o preço padrão, sem bônus/bolsa.
`{bonus}`	Bônus de venda do jogador.
`{bolsa}`	Valor atual da bolsa.
`{booster}`	Bônus do booster ativo do jogador.
`{booster_time}`	Tempo restante do booster ativo.
`{limite_venda}`	Limite de venda do jogador.
`{limite_armazem}`	Limite de armazenamento do armazém.
`{<provider>_total}`	Valor total de uma economia configurada em `Precos`.
`{<provider>_unitario}`	Valor unitário de uma economia configurada em `Precos`.

Funcionam nos itens de informações e vender tudo dos menus menus/principal.yml e menus/categoria.yml.

Placeholder	Descrição
`{itens}`	Total de itens armazenados.
`{tipos}`	Quantidade de tipos de plantações no armazém.
`{armazenado}`	Total de plantações armazenadas.
`{limite_venda}`	Limite de venda do jogador.
`{limite_armazem}`	Limite de armazenamento do armazém.
`{bonus}`	Bônus de venda do jogador.
`{bolsa}`	Valor atual da bolsa.
`{booster}`	Bônus do booster ativo do jogador.
`{booster_time}`	Tempo restante do booster ativo.

Local	Placeholder	Descrição
Recompensas	`{rewards}`	Quantidade de recompensas pendentes no armazém.
Auto-Sell	`{status}`	Status do auto-sell, como sim/não.
Upgrade de capacidade	`{limite_armazem_atual}`	Limite atual do armazém.
Upgrade de capacidade	`{limite_armazem_maximo}`	Limite máximo configurado.
Upgrade de capacidade	`{limite_armazem_addperlevel}`	Quantia adicionada por nível.
Upgrade de capacidade	`{Money}` ou `{money}`	Custo do upgrade para o provider configurado em `limite_armazem.yml`.

Para providers de upgrade, a placeholder é o nome do provider configurado em Prices-PerLevel, aceitando maiúsculo ou minúsculo.

Exemplo:

Prices-PerLevel:
  price1:
    provider: 'Coins'
    display: 'Coins'
    price: 10000.0

No menu:

lore:
  - ' &fCusto: &e{Coins} coins&f.'
  - ' &fCusto: &e{coins} coins&f.'

Placeholders de mensagens

Venda

Funcionam em Mensagens.Vendeu, Mensagens.Vendeu tudo, Title.Vendeu, Title.Vendeu tudo, Actionbar.Vendeu, Actionbar.Vendeu tudo e nas mensagens por plantação.

Placeholder	Descrição
`{quantia}`	Quantia vendida.
`{display}`	Nome da plantação vendida. Disponível em venda de uma plantação.
`{bonus}`	Texto formatado do bônus aplicado.
`{<provider>}`	Valor recebido na economia configurada. Exemplo: `{money}`, `{coins}`, `{cash}`.

Coleta

Funcionam em Mensagens.Coletou, Title.Coletou, Actionbar.Coletou e nas mensagens por plantação.

Placeholder	Descrição
`{quantia}`	Quantia coletada.
`{display}`	Nome da plantação coletada.

Limites e comandos administrativos

Local	Placeholder	Descrição
`Mensagens.Deu`	`{player}`	Jogador que recebeu o limite.
`Mensagens.Deu`	`{quantia}`	Quantia de limite entregue.
`Mensagens.Alterou`	`{player}`	Jogador que teve o limite alterado.
`Mensagens.Alterou`	`{quantia}`	Novo valor ou valor alterado.
`Mensagens.Coletar`	`{quantia}`	Quantia disponível para coleta.
`Mensagens.SellAll-Delay`	`{time}`	Tempo restante para vender tudo novamente.
`Mensagens.no-balance`	`{provider_display}`	Nome exibido da economia do upgrade.
`Mensagens.no-balance`	`{provider_balance}`	Saldo atual do jogador nessa economia.

Placeholders de comandos de coleta da plantação

Funcionam em Plantacoes.<plantacao>.Comando.Comandos.

Placeholder	Descrição
`{player}`	Nome do jogador.
`{quantia}`	Quantia coletada ou valor calculado quando `UsarQuantia` está ativo.

Exemplo:

Comando:
  Ativar: true
  UsarQuantia: true
  MultiplicarQuantiaPreco: true
  InvBypass: true
  Comandos:
    - 'points give {player} {quantia}'

Placeholders de boosters

Local	Placeholder	Descrição
`boosters.yml` item do booster	`{bonus}`	Bônus do booster.
`boosters.yml` item do booster	`{time}`	Duração formatada do booster.
`Mensagens.booster-give`	`{player}`	Jogador que recebeu o booster, ou `Todos`.
`Mensagens.booster-give`	`{amount}`	Quantia de boosters entregue.
`Mensagens.booster-received`	`{amount}`	Quantia de boosters recebida.
`Mensagens.booster-activated`	`{bonus}`	Bônus do booster ativado.
`Mensagens.booster-activated`	`{time}`	Duração formatada do booster ativado.

Placeholders de recompensas

Local	Placeholder	Descrição
`rewards.yml` em `collect.lore`	`{amount}`	Quantia pendente dessa recompensa.
`rewards.yml` em `command.list`	`{player}`	Nome do jogador.
`rewards.yml` em `command.list`	`{amount}`	Quantia configurada em `placeholder-amount`, multiplicada ou não por `multiply-placeholder`.
Item entregue da recompensa	`{player}`	Nome do jogador, quando usado na lore do item.

Exemplo:

command:
  give: true
  placeholder-amount: 1
  multiply-placeholder: true
  list:
    - 'give {player} diamond {amount}'

PlaceholderAPI Placeholders

Se o PlaceholderAPI estiver instalado, o yArmazem registra o identificador %yarmazem_<placeholder>%.

PlaceholderAPI	Valor Retornado	Descrição
`%yarmazem_limite%`	Texto	Limite de venda formatado do jogador.
`%yarmazem_limite_raw%`	Número	Limite de venda bruto do jogador.
`%yarmazem_armazenado%`	Texto	Total armazenado formatado do jogador no terreno atual/cache temporário.
`%yarmazem_armazenado_raw%`	Número	Total armazenado bruto do jogador no terreno atual/cache temporário.
`%yarmazem_limite_armazem%`	Texto	Limite do armazém formatado no terreno atual/cache temporário.
`%yarmazem_limite_armazem_raw%`	Número	Limite do armazém bruto no terreno atual/cache temporário.

Observações importantes

Nem toda placeholder funciona em todos os arquivos. Use cada placeholder apenas no contexto indicado nesta documentação.
Providers de economias de venda sempre viram placeholders em minúsculo.
A economia Money não é especial na mensagem de venda; {money} funciona porque o provider configurado é Money.
Para mostrar valores no menu da plantação, use {<provider>_total} e {<provider>_unitario}.
Para mostrar valores na mensagem de venda, use apenas {<provider>}.

Economias das plantações

Mensagens de venda

Menus de plantações

Placeholders de menus de plantações

Placeholders do menu principal e categoria

Placeholders de itens especiais do menu

Placeholders de mensagens

Venda

Coleta

Limites e comandos administrativos

Placeholders de comandos de coleta da plantação

Placeholders de boosters

Placeholders de recompensas

PlaceholderAPI Placeholders

Observações importantes

Nesta página