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 (<>).

PlaceholderAPI Placeholders

O plugin fornece Placeholders do PlaceholderAPI que você pode usar em qualquer plugin que suporte PlaceholderAPI.

Identificador: %yplots_<placeholder>%
Booleanos retornam true / false. Ilimitado aparece como ∞.

Stats do jogador

Placeholder	Valor Retornado	Descrição
`%yplots_count%`	Número	Quantidade de terrenos que o jogador possui.
`%yplots_owned%`	Número	Alias de `count`.
`%yplots_plots%`	Número	Alias de `count`.
`%yplots_count_grouped%`	Número	Terrenos contando merge como 1 grupo.
`%yplots_owned_grouped%`	Número	Alias de `count_grouped`.
`%yplots_max%`	Número / ∞	Limite máximo de terrenos do jogador.
`%yplots_remaining%`	Número / ∞	Terrenos restantes que ainda pode claimar.
`%yplots_left%`	Número / ∞	Alias de `remaining`.
`%yplots_has_plot%`	Boolean	Se o jogador possui algum terreno.
`%yplots_has_plots%`	Boolean	Alias de `has_plot`.
`%yplots_merge_max%`	Número / ∞	Limite máximo de plots no merge.
`%yplots_merge_bought%`	Número	Slots de merge comprados.
`%yplots_members_max%`	Número / ∞	Limite máximo de membros.
`%yplots_max_members%`	Número / ∞	Alias de `members_max`.
`%yplots_members_bought%`	Número	Slots de membro comprados.
`%yplots_member_slots_bought%`	Número	Alias de `members_bought`.
`%yplots_favorites%`	Número	Quantidade de favoritos.
`%yplots_favorites_count%`	Número	Alias de `favorites`.
`%yplots_fav_count%`	Número	Alias de `favorites`.
`%yplots_market_count%`	Número	Quantidade de terrenos à venda no mercado.
`%yplots_for_sale_count%`	Número	Alias de `market_count`.

Localização / mundo

Placeholder	Valor Retornado	Descrição
`%yplots_is_plot_world%`	Boolean	Se está em mundo de plots.
`%yplots_in_plot_world%`	Boolean	Alias de `is_plot_world`.
`%yplots_on_plot%`	Boolean	Se está em cima de uma célula de plot.
`%yplots_on_road%`	Boolean	Se está na rua (mundo de plot, fora da célula).
`%yplots_on_path%`	Boolean	Alias de `on_road`.
`%yplots_on_claimed%`	Boolean	Se está em terreno claimado.
`%yplots_on_free%`	Boolean	Se está em terreno livre (não claimado).
`%yplots_on_unclaimed%`	Boolean	Alias de `on_free`.
`%yplots_world%`	Texto	Nome do mundo atual.
`%yplots_free_x%`	Número	Coordenada X da célula sob os pés.
`%yplots_free_z%`	Número	Coordenada Z da célula sob os pés.
`%yplots_free_coords%`	Texto	Coordenadas `x;z` da célula.
`%yplots_free_id%`	Texto	Alias de `free_coords`.

Terreno atual (sob os pés)

Prefixos equivalentes: current_, plot_current_ ou campos curtos (owner, id, name…).

Placeholder	Valor Retornado	Descrição
`%yplots_current_claimed%`	Boolean	Se o terreno sob os pés está claimado.
`%yplots_current_exists%`	Boolean	Alias de `claimed`.
`%yplots_current_free%`	Boolean	Se a célula está livre.
`%yplots_current_unclaimed%`	Boolean	Alias de `free`.
`%yplots_current_owner%`	Texto	Nome do dono.
`%yplots_owner%`	Texto	Alias curto de dono do terreno atual.
`%yplots_current_owner_name%`	Texto	Alias de `owner`.
`%yplots_current_owner_uuid%`	Texto	UUID do dono.
`%yplots_current_id%`	Texto	ID de exibição do terreno.
`%yplots_id%`	Texto	Alias curto.
`%yplots_current_display_id%`	Texto	Alias de `id`.
`%yplots_current_cell_id%`	Texto	ID bruto da célula.
`%yplots_current_raw_id%`	Texto	Alias de `cell_id`.
`%yplots_current_number%`	Número	Índice do terreno do dono.
`%yplots_number%`	Número	Alias curto.
`%yplots_current_index%`	Número	Alias de `number`.
`%yplots_current_name%`	Texto	Nome customizado do terreno.
`%yplots_name%`	Texto	Alias curto.
`%yplots_current_displayname%`	Texto	Alias de `name`.
`%yplots_current_name_raw%`	Texto	Nome bruto (sem fallback).
`%yplots_current_description%`	Texto	Descrição do terreno.
`%yplots_current_desc%`	Texto	Alias de `description`.
`%yplots_current_biome%`	Texto	Nome de exibição do bioma.
`%yplots_biome%`	Texto	Alias curto.
`%yplots_current_biome_raw%`	Texto	ID bruto do bioma.
`%yplots_current_world%`	Texto	Mundo do terreno.
`%yplots_current_x%`	Número	Coordenada X do plot.
`%yplots_current_z%`	Número	Coordenada Z do plot.
`%yplots_current_coords%`	Texto	Coordenadas `x;z`.
`%yplots_current_members%`	Número	Quantidade de membros.
`%yplots_current_member_count%`	Número	Alias de `members`.
`%yplots_current_members_list%`	Texto	Lista de membros (nomes).
`%yplots_current_denied_list%`	Texto	Lista de negados (nomes).
`%yplots_current_status%`	Texto	Status formatado do terreno.
`%yplots_status%`	Texto	Alias curto.
`%yplots_current_selling%`	Boolean	Se está à venda.
`%yplots_current_for_sale%`	Boolean	Alias de `selling`.
`%yplots_current_price%`	Texto	Preço formatado de venda.
`%yplots_current_price_raw%`	Número	Preço numérico.
`%yplots_current_economy%`	Texto	Economia da venda.
`%yplots_current_merged%`	Boolean	Se faz parte de um merge.
`%yplots_current_merge_id%`	Texto	ID do grupo de merge.
`%yplots_current_merge_size%`	Número	Tamanho do merge.
`%yplots_current_size%`	Número	Alias de `merge_size`.
`%yplots_current_role%`	Texto	Cargo do jogador no terreno (display).
`%yplots_role%`	Texto	Alias curto.
`%yplots_current_role_raw%`	Texto	Cargo bruto (enum).
`%yplots_current_is_owner%`	Boolean	Se o jogador é dono.
`%yplots_current_is_member%`	Boolean	Se o jogador é membro.
`%yplots_current_is_denied%`	Boolean	Se o jogador está negado.
`%yplots_current_can_build%`	Boolean	Se o jogador pode construir.
`%yplots_current_can_manage%`	Boolean	Se o jogador pode gerenciar.
`%yplots_current_is_favorite%`	Boolean	Se está nos favoritos do jogador.
`%yplots_current_fly%`	Boolean	Se o voo está ativo no terreno.
`%yplots_current_fly_unlocked%`	Boolean	Se o voo foi desbloqueado.
`%yplots_current_title%`	Boolean	Se mostra title ao entrar.
`%yplots_current_actionbar%`	Boolean	Se mostra actionbar ao entrar.
`%yplots_current_pvp%`	Boolean	Se night-pvp está ativo.
`%yplots_current_night_pvp%`	Boolean	Alias de `pvp`.
`%yplots_current_wall%`	Texto	Bloco da parede.
`%yplots_current_border%`	Texto	Bloco da borda.
`%yplots_current_created%`	Texto	Data de criação formatada.
`%yplots_current_created_raw%`	Número	Timestamp de criação.
`%yplots_current_modified%`	Texto	Data de modificação formatada.
`%yplots_current_modified_raw%`	Número	Timestamp de modificação.
`%yplots_flag_<flag>%`	Boolean	Valor da flag no terreno atual (ex: `flag_pvp`).
`%yplots_current_flag_<flag>%`	Boolean	Alias de `flag_<flag>`.

Terreno próprio por índice

Formato: %yplots_plot_<n>_<campo>% (n começa em 1)
Atalho do primeiro: %yplots_first_<campo>%

Exemplos:

%yplots_plot_1_owner% — dono do 1º terreno
%yplots_plot_2_id% — id do 2º terreno
%yplots_first_name% — nome do primeiro terreno
%yplots_plot_1_flag_pvp% — flag pvp do 1º terreno

Campos disponíveis: os mesmos de fieldOf (owner, id, name, biome, price, merged, role, can_build, flag_<nome>, etc.).

Placeholders Internos

Placeholders internos que você pode usar dentro dos menus e mensagens.

Placeholder	Valor Retornado	Descrição
`{player}`	Texto	Nome do jogador.
`{owner}`	Texto	Nome do dono do terreno.
`{name}`	Texto	Nome do terreno.
`{id}`	Texto	ID do terreno.
`{number}`	Número	Número/índice do terreno.
`{world}`	Texto	Nome do mundo.
`{x}`	Número	Coordenada X.
`{z}`	Número	Coordenada Z.
`{biome}`	Texto	Bioma do terreno.
`{members}`	Número	Quantidade de membros.
`{status}`	Texto	Status formatado.
`{price}`	Número / Texto	Preço de venda ou claim.
`{economy}`	Texto	Economia utilizada.
`{role}`	Texto	Cargo no terreno.
`{flag}`	Texto	Nome da flag.
`{value}`	Texto	Valor de uma flag ou configuração.
`{permission}`	Texto	Permissão relacionada.
`{time}`	Número	Tempo de delay/cooldown.
`{seconds}`	Número	Segundos de teleporte.
`{count}`	Número	Contagem (plots, purge, etc.).
`{max}`	Número	Limite máximo.
`{current}`	Número / Texto	Valor atual.
`{cmd}`	Texto	Comando base.
`{command}`	Texto	Nome do comando.
`{syntax}`	Texto	Sintaxe do comando.
`{balance}`	Número	Saldo do jogador.
`{required}`	Número	Valor necessário.
`{provider}`	Texto	Provider de economia.
`{seller}`	Texto	Vendedor do terreno.
`{buyer}`	Texto	Comprador do terreno.
`{description}`	Texto	Descrição do terreno ou da flag.
`{created}`	Texto	Data de criação.
`{merge_size}`	Número	Tamanho do grupo de merge.
`{merge_max}`	Número	Limite de merge.
`{merge_bought}`	Número	Slots de merge comprados.
`{merge_money}`	Número	Custo do merge.
`{merge_economy}`	Texto	Economia do merge.
`{members_max}`	Número	Limite de membros.
`{members_bought}`	Número	Slots de membro comprados.
`{fly}`	Texto	Status do voo.
`{fly_unlocked}`	Texto	Se o voo foi desbloqueado.
`{fly_cost}`	Número	Custo do voo.
`{fly_economy}`	Texto	Economia do voo.
`{selling}`	Texto	Se está à venda.
`{favorite}`	Texto	Se está nos favoritos.
`{title}`	Texto	Status do title ao entrar.
`{actionbar}`	Texto	Status da actionbar ao entrar.
`{pvp}`	Texto	Status do PvP noturno.
`{money}`	Número	Valor em dinheiro / custo.
`{size}`	Número	Tamanho do terreno.
`{filter}`	Texto	Filtro atual de membros.
`{next_filter}`	Texto	Próximo filtro de membros.
`{info}`	Texto	Informação da confirmação.
`{key}`	Texto	Chave do cosmético (parede/borda).
`{type}`	Texto	Tipo de schematic.
`{file}`	Texto	Arquivo de schematic.
`{error}`	Texto	Mensagem de erro.