Planetas

Exemplo completo de configuração

Aqui está um exemplo completo de como criar um planeta (Marte):

# Identificador único do planeta (sem espaços). Usado em comandos e PlaceholderAPI.
key: marte

# ID interno para integração com yTops / rankings (geralmente yplanetas-<key>).
ypluginsId: yplanetas-marte

# Ícone do planeta nos menus (formato SetupItem completo).
icon:
  material: 'NETHER_STAR'
  name: '&c&lMarte'
  lore:
    - ''
    - ' &7O planeta vermelho.'
    - ' &7Conquiste e obtenha benefícios exclusivos.'
    - ''

# Ícone específico no seletor de TOP (/planetas top e botão TOP).
top-icon:
  material: 'GOLD_BLOCK'
  name: '&e&lTOP &cMarte'
  lore:
    - ''
    - ' &7Ranking de conquistas do'
    - ' &7planeta &cMarte&7.'
    - ''
    - ' &eClique para ver o TOP'
    - ''

# Nome colorido exibido em hologramas, BossBar e mensagens.
displayName: '&c&lMarte'

# Formato de cada linha do ranking no holograma durante a captura.
indexFormat: '&c{index}º - &7[&r{clan_color_tag}&7] &7{clan_name}&c: {value_time}'

# Centro da esfera de captura. Formato: mundo,x,y,z,yaw,pitch
center: 'world,0.5,64.0,0.5,0.0,0.0'

# Raio (em blocos) da zona de captura a partir do center.
radius: 10

# Local de entrada (teleporte do menu de detalhes).
entry: 'world,0.5,65.0,8.5,180.0,0.0'

# Duração padrão do evento de captura, em segundos.
time: 600

# Quantidade máxima de posições exibidas no holograma de ranking durante a captura.
maxIndex: 5

# Offset vertical do holograma em relação ao center (blocos para cima).
hologramOffset: 3.5

# Lista de chaves de benefícios (definidos em benefits.yml).
benefits:
  - economy
  - xp
  - farm

# Tag da facção/clan proprietária atual.
ownerClanTag: ''

# Anúncios e mensagens
messageStart: | 
  &c&l[PLANETAS]
  &cA conquista de &f{planet} &ccomeçou!
  &7Duração: &f{value_time}
  &7Use &f/planetas &7para ver detalhes e teleportar.

messageStop: |
  &c&l[PLANETAS]
  &aO planeta &f{planet} &afoi conquistado!
  &7Vencedor: &7[&r{clan_color_tag}&7] &f{clan_name}
  &7Tempo de domínio: &f{value_time}
  &7Benefícios: &e{benefits}

messageCanceled: |
  &c&l[PLANETAS]
  &cO evento de &f{planet} &cfoi cancelado.

messageDominating: |
  &c&l[PLANETAS]
  &7[&r{clan_color_tag}&7] &f{clan_name} &cestá dominando &f{planet}&c!

actionbarBattling: '&cBatalha entre &f{amount} &cclans em &f{planet}&c!'
actionbarDominating: '&c&7[&r{clan_color_tag}&7] &f{clan_name} &cdomina &f{planet}'
actionbarYourDominating: '&aSeu clan está dominando &f{planet}&a!'

# Hologramas
hologramLinesNone:
  - '[item]NETHER_STAR'
  - '&c&lMARTE'
  - '&fStatus: &7Nenhum clan dominando.'
  - ''
  - '&cTempo restante: &f{time}'

hologramLinesBattling:
  - '[item]NETHER_STAR'
  - '&c&lMARTE'
  - '&fStatus: &cClans batalhando.'
  - ''
  - '{format}'
  - ''
  - '&cTempo restante: &f{time}'

hologramLines:
  - '[item]NETHER_STAR'
  - '&c&lMARTE'
  - '&fStatus: &cClan &7[&r{clan_color_tag}&7] &7{clan_name}&c dominando.'
  - ''
  - '{format}'
  - ''
  - '&cTempo restante: &f{time}'

hologramLinesOwned:
  - '[item]NETHER_STAR'
  - '&c&lMARTE'
  - '&fProprietário: &7[&r{owner_color_tag}&7] &7{owner_name}'
  - '&fBenefícios: &e{benefits}'
  - ''
  - '&7Aguarde o próximo evento para capturar.'

# BossBar
bossBarTitle: '&c{planet} &8| &7{clan} &8| &f{time}'
bossBarColor: RED
bossBarStyle: NOTCHED_10

# Partículas
particlesBattling: FLAME
particlesEmpty: ASH
particlesDominated: GLOW

# Recompensas (formato: "chance,id")
rewards:
  - '100,reward1'
  - '50,reward2'

# Horários automáticos de início
autostart:
  - 'sabado-20:0:0'

# Ranking histórico
top: []

# Minions
minions:
  guard:
    entity-type: 'ZOMBIE'
    mythic-mob: ''
    custom-name: '&c&lGuardiao de Marte'
    custom-name-visible: true
    health: 60.0
    damage: 6.0
    speed: 0.28
    amount: 4
    baby: false
    remove-when-far-away: false
    spawn-locations: []
    equipment:
      helmet: 'IRON_HELMET'
      chestplate: 'IRON_CHESTPLATE'
      leggings: 'IRON_LEGGINGS'
      boots: 'IRON_BOOTS'
      hand: 'IRON_SWORD'
      off-hand: 'SHIELD'
      drop-chance:
        helmet: 0
        chestplate: 0
        leggings: 0
        boots: 0
        hand: 0
        off-hand: 0
    effects:
      - 'SPEED:0'
      - 'FIRE_RESISTANCE:0'

Opções disponíveis na configuração

key

Identificador único do planeta (sem espaços). Usado em comandos e PlaceholderAPI.

key: marte

ypluginsId

ID interno para integração com yTops / rankings (geralmente yplanetas-<key>).

ypluginsId: yplanetas-marte

icon

Ícone do planeta nos menus (formato SetupItem completo).

Placeholders no name/lore da lista: {planet}, {owner}, {owner_color_tag}, {status}, {benefits}

icon:
  material: 'NETHER_STAR'
  name: '&c&lMarte'
  lore:
    - ''
    - ' &7O planeta vermelho.'
    - ''

top-icon

Ícone específico no seletor de TOP (/planetas top e botão TOP). Se omitido, usa o icon normal.

top-icon:
  material: 'GOLD_BLOCK'
  name: '&e&lTOP &cMarte'
  lore:
    - ''
    - ' &eClique para ver o TOP'
    - ''

displayName

Nome colorido exibido em hologramas, BossBar e mensagens.

displayName: '&c&lMarte'

indexFormat

Formato de cada linha do ranking no holograma durante a captura.

Placeholders: {index}, {clan_tag}, {clan_color_tag}, {clan_name}, {value}, {value_time}, {value_formatted}

indexFormat: '&c{index}º - &7[&r{clan_color_tag}&7] &7{clan_name}&c: {value_time}'

center

Centro da esfera de captura. Formato: mundo,x,y,z,yaw,pitch.

Altere in-game com: /planetas alterarloc <planeta>

center: 'world,0.5,64.0,0.5,0.0,0.0'

radius

Raio (em blocos) da zona de captura a partir do center.

radius: 10

entry

Local de entrada (teleporte do menu de detalhes). Formato: mundo,x,y,z,yaw,pitch.

Altere in-game com: /planetas setentry <planeta>

entry: 'world,0.5,65.0,8.5,180.0,0.0'

time

Duração padrão do evento de captura, em segundos. Pode ser sobrescrita com /planetas iniciar <planeta> <tempo>.

time: 600

maxIndex

Quantidade máxima de posições exibidas no holograma de ranking durante a captura.

maxIndex: 5

hologramOffset

Offset vertical do holograma em relação ao center (blocos para cima).

hologramOffset: 3.5

benefits

Lista de chaves de benefícios (definidos em benefits.yml) concedidos à facção dona deste planeta até o próximo evento.

benefits:
  - economy
  - xp
  - farm

ownerClanTag

Tag da facção/clan proprietária atual. Preenchido automaticamente ao fim do evento. Deixe vazio se ninguém for dono.

ownerClanTag: ''

Mensagens do planeta

Use <nl> para quebrar linha.

Placeholders comuns: {planet}, {value_time}, {clan_tag}, {clan_color_tag}, {clan_name}, {benefits}, {owner_tag}, {owner_color_tag}, {owner_name}, {amount}

messageStart

Anúncio global ao iniciar o evento.

messageStart: | 
  &c&l[PLANETAS]
  &cA conquista de &f{planet} &ccomeçou!
  &7Duração: &f{value_time}

messageStop

Anúncio global ao encerrar com vencedor (define o dono).

messageStop: |
  &c&l[PLANETAS]
  &aO planeta &f{planet} &afoi conquistado!
  &7Vencedor: &7[&r{clan_color_tag}&7] &f{clan_name}

messageCanceled

Anúncio global se o evento for cancelado ou terminar sem vencedor.

messageCanceled: |
  &c&l[PLANETAS]
  &cO evento de &f{planet} &cfoi cancelado.

messageDominating

Mensagem periódica (config.yml → message-time) enquanto alguém domina.

messageDominating: |
  &c&l[PLANETAS]
  &7[&r{clan_color_tag}&7] &f{clan_name} &cestá dominando &f{planet}&c!

actionbarBattling / actionbarDominating / actionbarYourDominating

Actionbars para jogadores na zona.

actionbarBattling: '&cBatalha entre &f{amount} &cclans em &f{planet}&c!'
actionbarDominating: '&c&7[&r{clan_color_tag}&7] &f{clan_name} &cdomina &f{planet}'
actionbarYourDominating: '&aSeu clan está dominando &f{planet}&a!'

Hologramas

Linhas do holograma. Prefixo [item]MATERIAL define o ícone no topo. {format} é substituído pelas linhas do ranking (indexFormat × maxIndex).

Placeholders: {time}, {clan_tag}, {clan_color_tag}, {clan_name}, {format}, {owner_tag}, {owner_color_tag}, {owner_name}, {benefits}, {planet}

hologramLinesNone

Evento ativo, ninguém dominando.

hologramLinesNone:
  - '[item]NETHER_STAR'
  - '&c&lMARTE'
  - '&fStatus: &7Nenhum clan dominando.'
  - ''
  - '&cTempo restante: &f{time}'

hologramLinesBattling

Evento ativo, 2+ clans na zona (batalha).

hologramLinesBattling:
  - '[item]NETHER_STAR'
  - '&c&lMARTE'
  - '&fStatus: &cClans batalhando.'
  - ''
  - '{format}'
  - ''
  - '&cTempo restante: &f{time}'

hologramLines

Evento ativo, um clan dominando sozinho.

hologramLines:
  - '[item]NETHER_STAR'
  - '&c&lMARTE'
  - '&fStatus: &cClan &7[&r{clan_color_tag}&7] &7{clan_name}&c dominando.'
  - ''
  - '{format}'
  - ''
  - '&cTempo restante: &f{time}'

hologramLinesOwned

Evento inativo — mostra o dono atual do planeta.

hologramLinesOwned:
  - '[item]NETHER_STAR'
  - '&c&lMARTE'
  - '&fProprietário: &7[&r{owner_color_tag}&7] &7{owner_name}'
  - '&fBenefícios: &e{benefits}'
  - ''
  - '&7Aguarde o próximo evento para capturar.'

BossBar

BossBar via Adventure/kyori (mesmo padrão do yMinasPackets).

Placeholders: {planet}, {clan}, {clan_tag}, {clan_color_tag}, {clan_name}, {time}, {owner_tag}, {owner_color_tag}, {owner_name}

bossBarTitle: '&c{planet} &8| &7{clan} &8| &f{time}'

# Cor (Adventure): PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE
bossBarColor: RED

# Overlay (Adventure): PROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12, NOTCHED_20
# Legado Bukkit aceito: SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20
bossBarStyle: NOTCHED_10

Partículas

Exibidas na esfera de captura durante o evento (se particles: true na config.yml).

particlesBattling: FLAME
particlesEmpty: ASH
particlesDominated: GLOW

Recompensas

Formato: "chance,id" — chance de 0 a 100, id definido em rewards.yml.

rewards:
  - '100,reward1'
  - '50,reward2'

Auto-start

Horários automáticos de início do evento.

Formato: dia-hora:minuto:segundo
Dias: domingo, segunda, terca, quarta, quinta, sexta, sabado, todos

autostart:
  - 'sabado-20:0:0'

Ranking histórico (top)

Preenchido automaticamente pelo plugin. Deixe [] na criação.

top: []

Minions

Protegem o planeta durante o evento. Spawnam ao iniciar e são removidos ao terminar ou cancelar.

Comandos in-game (na posição do jogador):

/planetas addspawn <planeta> [minion] — adiciona spawn
/planetas removespawn <planeta> [minion] [n|all] — remove spawn
/planetas listspawn <planeta> [minion] — lista spawns

Estrutura de um minion

minions:
  guard:
    # Tipo vanilla (EntityType). Ignorado se mythic-mob estiver preenchido.
    entity-type: 'ZOMBIE'

    # Nome interno do MythicMobs. Deixe '' para usar vanilla.
    mythic-mob: ''

    # Nome colorido acima da cabeça.
    custom-name: '&c&lGuardiao de Marte'
    custom-name-visible: true

    health: 60.0
    damage: 6.0
    speed: 0.28
    amount: 4
    baby: false
    remove-when-far-away: false

    # Locais de spawn. Lista vazia = gera pontos em círculo ao redor do center.
    spawn-locations: []

    equipment:
      helmet: 'IRON_HELMET'
      chestplate: 'IRON_CHESTPLATE'
      leggings: 'IRON_LEGGINGS'
      boots: 'IRON_BOOTS'
      hand: 'IRON_SWORD'
      off-hand: 'SHIELD'
      drop-chance:
        helmet: 0
        chestplate: 0
        leggings: 0
        boots: 0
        hand: 0
        off-hand: 0

    # Formato curto: 'TIPO:amplifier' ou 'TIPO:amplifier:duration_em_ticks'
    effects:
      - 'SPEED:0'
      - 'FIRE_RESISTANCE:0'

MythicMobs

Soft-depend. Defina mythic-mob com o nome interno do mob. Se vazio, usa entity-type vanilla.

minions:
  elite:
    entity-type: 'ZOMBIE'
    mythic-mob: 'SkeletonKing'
    custom-name: '&4&lElite de Marte'
    custom-name-visible: true
    health: 120.0
    damage: 10.0
    speed: 0.30
    amount: 1
    baby: false
    remove-when-far-away: false
    spawn-locations:
      - 'world,0.5,65.0,0.5,0.0,0.0'
    equipment:
      hand:
        material: 'DIAMOND_SWORD'
        name: '&cLamina de Marte'
        lore:
          - '&7Espada do guardiao.'
      drop-chance:
        hand: 0
    effects:
      strength:
        type: 'INCREASE_DAMAGE'
        amplifier: 1
        duration: 999999
        ambient: false
        particles: true

/planetas alterarloc marte
/planetas setentry marte

Adicione benefícios

Referencie as chaves de benefits.yml:

benefits:
  - economy
  - xp

Configure recompensas e auto-start

rewards:
  - '100,reward1'
autostart:
  - 'sabado-20:0:0'

Configure minions (opcional)

Adicione spawns com /planetas addspawn marte guard.

Reinicie ou recarregue

Use /planetas reload ou reinicie o servidor.

O nome do arquivo e o campo key devem ser consistentes. A key é usada em comandos e placeholders (%yplanetas_marte_owner%).

Nesta página