Placeholders

O ySkills oferece suporte completo ao PlaceholderAPI e LegendChat, permitindo que você use informações de skills em outros plugins.

Dependência Opcional

Para usar os placeholders, você precisa ter o PlaceholderAPI instalado no servidor.

PlaceholderAPI

Placeholders Gerais

Placeholder	Descrição	Exemplo de Retorno
`%yskills_total_level%`	Nível total (soma de todas as skills)	`250`
`%yskills_total_xp%`	XP total (soma de todas as skills)	`15.5k`
`%yskills_total_xp_raw%`	XP total sem formatação	`15500`

Placeholders por Skill

Substitua [skill] pelo identificador da skill: mining, swords, fishing, woodcutting, excavation, herbalism, axes, archery, alchemy, acrobatics

Informações Básicas

Placeholder	Descrição	Exemplo de Retorno
`%yskills_[skill]_level%`	Nível na skill	`45`
`%yskills_[skill]_xp%`	XP atual na skill (formatado)	`12.3k`
`%yskills_[skill]_xp_raw%`	XP atual na skill (sem formatação)	`12300`
`%yskills_[skill]_xp_next%`	XP necessário para o próximo nível	`5000`
`%yskills_[skill]_xp_progress%`	Progresso em % para próximo nível	`68%`
`%yskills_[skill]_xp_progressbar%`	Barra de progresso visual	`▰▰▰▰▰▰▱▱▱▱`
`%yskills_[skill]_rank%`	Posição no ranking da skill	`3`
`%yskills_[skill]_max_level%`	Nível máximo da skill	`100`
`%yskills_[skill]_is_max%`	Se está no nível máximo	`true`/`false`
`%yskills_[skill]_name%`	Nome da skill	`Mineração`
`%yskills_[skill]_tag%`	TAG para o TOP1	`[⚒]`

Exemplos de Uso

# Exemplo no TAB
tab-format: '%yskills_total_level% &7| &f%player_name%'

# Exemplo no chat
chat-format: '%yskills_mining_tag% &f%player_name%: &7%message%'

# Exemplo em holograma
lines:
  - '&6Seu Nível de Mineração'
  - '&fNível: &b%yskills_mining_level%'
  - '&7%yskills_mining_xp_progressbar%'
  - '&a%yskills_mining_xp_progress%'

Placeholders de Boosters

Boosters Gerais

Placeholder	Descrição	Exemplo de Retorno
`%yskills_booster_active%`	Se tem booster ativo	`true`/`false`
`%yskills_booster_multiplier%`	Multiplicador atual (maior entre global e individual)	`2.5x`
`%yskills_booster_multiplier_[skill]%`	Multiplicador para skill específica	`3.0x`

Boosters Globais

Placeholder	Descrição	Exemplo de Retorno
`%yskills_booster_global_active%`	Se há booster global ativo	`true`/`false`
`%yskills_booster_global_multiplier%`	Multiplicador do booster global	`2.0x`
`%yskills_booster_global_time%`	Tempo restante do booster global	`45m 32s`

Boosters Individuais

Placeholder	Descrição	Exemplo de Retorno
`%yskills_booster_individual_active%`	Se tem booster individual ativo	`true`/`false`
`%yskills_booster_individual_multiplier%`	Multiplicador do booster individual	`1.5x`
`%yskills_booster_individual_time%`	Tempo restante do booster individual	`1h 15m`

Placeholders de Ranking

Substitua [skill] pela skill e [pos] pela posição (1-10).

Placeholder	Descrição	Exemplo de Retorno
`%yskills_top_[skill]_[pos]_name%`	Nome do jogador na posição X	`Steve`
`%yskills_top_[skill]_[pos]_level%`	Nível do jogador na posição X	`87`
`%yskills_top_[skill]_[pos]_xp%`	XP do jogador na posição X	`125.4k`

Exemplos de Uso

# Holograma de TOP Mining
lines:
  - '&6&l▬▬▬▬ TOP MINERAÇÃO ▬▬▬▬'
  - '&f1º &7%yskills_top_mining_1_name% &8- &b%yskills_top_mining_1_level%'
  - '&f2º &7%yskills_top_mining_2_name% &8- &b%yskills_top_mining_2_level%'
  - '&f3º &7%yskills_top_mining_3_name% &8- &b%yskills_top_mining_3_level%'

LegendChat

O ySkills também oferece integração com o LegendChat através de placeholders personalizados.

Formato Diferente

Os placeholders do LegendChat usam chaves {} em vez de %%.

Placeholders Gerais

Placeholder	Descrição	Exemplo de Retorno
`{skills_level}`	Nível total	`250`
`{skills_xp}`	XP total	`15.5k`

Placeholders por Skill

Substitua [skill] pelo identificador da skill.

Placeholder	Descrição	Exemplo de Retorno
`{[skill]_level}`	Nível na skill	`45`
`{[skill]_xp}`	XP na skill	`12.3k`
`{[skill]_name}`	Nome da skill	`Mineração`
`{[skill]_tag}`	TAG para o TOP1	`[⚒]`

Exemplos de Uso no LegendChat

# config.yml do LegendChat
format:
  default: '{mining_tag} &f{player}: &7{message}'

# TAG só aparece para TOP1
tag-format: '&6&l[TOP1] &f{player}'

Exemplos Práticos

Sistema de Prefixos por Nível

# Usando Vault ou LuckPerms com PlaceholderAPI
# Condicional: Se nível mining >= 50, mostrar prefixo especial

prefix:
  - condition: '%yskills_mining_level% >= 50'
    prefix: '&6[Minerador Mestre]'
  - condition: '%yskills_mining_level% >= 25'
    prefix: '&e[Minerador]'
  - default: '&7[Novato]'

Scoreboard com Skills

# Exemplo de scoreboard usando FeatherBoard ou similar
scoreboard:
  title: '&6&lSEU SERVIDOR'
  lines:
    - '&7'
    - '&fNível Total: &b%yskills_total_level%'
    - '&7'
    - '&e⛏ Mining: &f%yskills_mining_level%'
    - '&c⚔ Swords: &f%yskills_swords_level%'
    - '&a✿ Herbalism: &f%yskills_herbalism_level%'
    - '&7'
    - '&6Booster: &f%yskills_booster_multiplier%'
    - '&7'

Holograma de Estatísticas

# Exemplo usando DecentHolograms ou HolographicDisplays
lines:
  - '&6&l⚡ SUAS ESTATÍSTICAS ⚡'
  - '&r'
  - '&fNível Total: &b%yskills_total_level%'
  - '&fXP Total: &a%yskills_total_xp%'
  - '&r'
  - '&7Melhor Skill:'
  - '&e%yskills_mining_name% &8- &fLvl %yskills_mining_level%'
  - '&r'
  - '&7Ranking Mining: &f#%yskills_mining_rank%'
  - '%yskills_mining_xp_progressbar%'
  - '&a%yskills_mining_xp_progress% &7para o próximo nível'

Atualização de Placeholders

Os placeholders são atualizados automaticamente a cada ação que modifica XP/nível. Para placeholders em hologramas ou scoreboards, configure o intervalo de atualização no plugin que os utiliza.

Lista de Skills Válidas

Para usar nos placeholders [skill]:

mining - Mineração
excavation - Escavação
woodcutting - Lenhador
herbalism - Herbalismo
swords - Espadas
axes - Machados
archery - Arquearia
fishing - Pesca
alchemy - Alquimia
acrobatics - Acrobacia

Skills Personalizadas

Se você criar skills personalizadas, use o identificador (key) definido no arquivo de configuração da skill.

Placeholders

Nesta página