Entidades

Exemplo completo de configuração

Aqui está um exemplo de como configurar as entidades do plugin:

entities:
  creeper:
    entity: 'CREEPER'
    custom-name: '&aCreeper'
    entity-options:
      wither-skeleton: false
      baby-zombie: false
      slime-size: 1
    display:
      selected:
        material: 'MONSTER_EGG:50'
        name: '&aCreeper'
        lore: [ '&fVocê está usando: &aCreeper&f.', '', '&7Clique para alterar a entidade.' ]
      select:
        material: 'MONSTER_EGG:50'
        name: '&aCreeper'
        lore: [ '&7Clique para usar esta entidade.' ]

Estrutura de entidades

Cada entidade possui configurações específicas para customização.

Configuração básica

entity

Define o tipo de entidade do Minecraft.

Exemplo:

entities:
  zombie:
    entity: 'ZOMBIE'

Consulte a lista de tipos de entidades do Minecraft para valores válidos.

Integração com MythicMobs

O yBossArena suporta integração com MythicMobs, permitindo usar mobs customizados como bosses e minions!

Como Usar

Para usar um mob do MythicMobs, utilize o prefixo mythic: seguido do ID do mob:

entities:
  skeleton_king:
    entity: 'mythic:SkeletonKing'
    custom-name: '&4&lSkeleton King'
    display:
      selected:
        material: 'SKULL_ITEM:1'
        name: '&4&lSkeleton King'
        lore: [ '&fVocê está usando: &4Skeleton King&f.' ]
      select:
        material: 'SKULL_ITEM:1'
        name: '&4&lSkeleton King'
        lore: [ '&7Clique para usar esta entidade.' ]

Requisitos

Para usar mobs do MythicMobs:

Plugin MythicMobs instalado no servidor
Addon yMythicMobsAddon ativado no BukkitBootstrap
O mob deve existir na configuração do MythicMobs

Se o MythicMobs não estiver disponível ou o mob não existir, o sistema automaticamente usará spawn vanilla como fallback.

Exemplos de Uso

Boss usando MythicMob:

bosses:
  dungeon-boss:
    arena: 'arena1'
    entity: 'mythic:SkeletonKing'
    minions:
      - entity: 'mythic:UndeadWarrior'
        amount: 5

Múltiplos Minions MythicMobs:

bosses:
  final-boss:
    arena: 'arena_final'
    entity: 'mythic:DarkLord'
    minions:
      - entity: 'mythic:DarkKnight'
        amount: 3
      - entity: 'mythic:ShadowMage'
        amount: 2
      - entity: 'ZOMBIE'  # Também aceita mobs vanilla
        amount: 5

Sistema de Fallback

Se algum problema ocorrer (MythicMobs não instalado, mob não encontrado), o sistema automaticamente:

Tenta usar a entidade vanilla equivalente
Usa uma entidade padrão como fallback final
Registra um aviso no console

Isso garante que o servidor continue funcionando mesmo com configurações de MythicMobs inválidas!

custom-name

Define o nome customizado da entidade.

Exemplo:

entities:
  zombie:
    custom-name: '&cZombie Boss'

entity-options

Opções específicas para certas entidades.

wither-skeleton

Define se o esqueleto será wither skeleton (apenas para SKELETON).

Exemplo:

entity-options:
  wither-skeleton: true

baby-zombie

Define se o zombie será bebê (apenas para ZOMBIE e PIG_ZOMBIE).

Exemplo:

entity-options:
  baby-zombie: true

slime-size

Define o tamanho do slime ou magma cube (apenas para SLIME e MAGMA_CUBE).

Exemplo:

entity-options:
  slime-size: 5

display

Configurações de exibição da entidade no menu de seleção.

selected

Item exibido quando a entidade está selecionada.

Exemplo:

display:
  selected:
    material: 'MONSTER_EGG:50'
    name: '&aCreeper'
    lore: [ '&fVocê está usando: &aCreeper&f.', '', '&7Clique para alterar a entidade.' ]

select

Item exibido quando a entidade não está selecionada.

Exemplo:

display:
  select:
    material: 'MONSTER_EGG:50'
    name: '&aCreeper'
    lore: [ '&7Clique para usar esta entidade.' ]

Adicionando novas entidades

Escolha a entidade

Escolha uma entidade válida do Minecraft para adicionar.

Crie a configuração

Adicione uma nova seção no arquivo entities.yml seguindo o padrão.

entities:
  nova_entidade:
    entity: 'TIPO_ENTIDADE'
    custom-name: '&eNome da Entidade'
    entity-options:
      wither-skeleton: false
      baby-zombie: false
      slime-size: 1
    display:
      selected:
        material: 'MONSTER_EGG:0'
        name: '&eNova Entidade'
        lore: [ '&fVocê está usando: &eNova Entidade&f.', '', '&7Clique para alterar a entidade.' ]
      select:
        material: 'MONSTER_EGG:0'
        name: '&eNova Entidade'
        lore: [ '&7Clique para usar esta entidade.' ]

Configure as opções

Ajuste as opções específicas da entidade conforme necessário.

Salve e reinicie

Reinicie o servidor para aplicar as mudanças.

Após alterar as entidades, é necessário reiniciar o servidor para aplicar as mudanças.

Exemplo completo com múltiplas entidades

entities:
  creeper:
    entity: 'CREEPER'
    custom-name: '&aCreeper'
    entity-options:
      wither-skeleton: false
      baby-zombie: false
      slime-size: 1
    display:
      selected:
        material: 'MONSTER_EGG:50'
        name: '&aCreeper'
        lore: [ '&fVocê está usando: &aCreeper&f.', '', '&7Clique para alterar a entidade.' ]
      select:
        material: 'MONSTER_EGG:50'
        name: '&aCreeper'
        lore: [ '&7Clique para usar esta entidade.' ]
  
  zombie:
    entity: 'ZOMBIE'
    custom-name: '&2Zombie'
    entity-options:
      wither-skeleton: false
      baby-zombie: false
      slime-size: 1
    display:
      selected:
        material: 'MONSTER_EGG:54'
        name: '&2Zombie'
        lore: [ '&fVocê está usando: &2Zombie&f.', '', '&7Clique para alterar a entidade.' ]
      select:
        material: 'MONSTER_EGG:54'
        name: '&2Zombie'
        lore: [ '&7Clique para usar esta entidade.' ]
  
  skeleton:
    entity: 'SKELETON'
    custom-name: '&fEsqueleto'
    entity-options:
      wither-skeleton: false
      baby-zombie: false
      slime-size: 1
    display:
      selected:
        material: 'MONSTER_EGG:51'
        name: '&fEsqueleto'
        lore: [ '&fVocê está usando: &fEsqueleto&f.', '', '&7Clique para alterar a entidade.' ]
      select:
        material: 'MONSTER_EGG:51'
        name: '&fEsqueleto'
        lore: [ '&7Clique para usar esta entidade.' ]
  
   wither_skeleton:
     entity: 'SKELETON'
     custom-name: '&8Wither Skeleton'
     entity-options:
       wither-skeleton: true
       baby-zombie: false
       slime-size: 1
     display:
       selected:
         material: 'MONSTER_EGG:51'
         name: '&8Wither Skeleton'
         lore: [ '&fVocê está usando: &8Wither Skeleton&f.', '', '&7Clique para alterar a entidade.' ]
       select:
         material: 'MONSTER_EGG:51'
         name: '&8Wither Skeleton'
         lore: [ '&7Clique para usar esta entidade.' ]

Exemplo com MythicMobs

Aqui está um exemplo de como usar entidades do MythicMobs junto com vanilla:

entities:
  # Boss Boss personalizado do MythicMobs
  skeleton_king:
    entity: 'mythic:SkeletonKing'
    custom-name: '&4&lSkeleton King'
    entity-options:
      wither-skeleton: false
      baby-zombie: false
      slime-size: 1
    display:
      selected:
        material: 'SKULL_ITEM:1'
        name: '&4&lSkeleton King'
        lore: [ '&fVocê está usando: &4Skeleton King&f.', '', '&7Clique para alterar a entidade.' ]
      select:
        material: 'SKULL_ITEM:1'
        name: '&4&lSkeleton King'
        lore: [ '&7Clique para usar esta entidade.' ]
  
  # Guerreiro morto-vivo do MythicMobs
  undead_warrior:
    entity: 'mythic:UndeadWarrior'
    custom-name: '&8&lGuerreiro Morto-Vivo'
    entity-options:
      wither-skeleton: false
      baby-zombie: false
      slime-size: 1
    display:
      selected:
        material: 'DIAMOND_SWORD'
        name: '&8&lGuerreiro Morto-Vivo'
        lore: [ '&fVocê está usando: &8Guerreiro Morto-Vivo&f.', '', '&7Clique para alterar a entidade.' ]
      select:
        material: 'DIAMOND_SWORD'
        name: '&8&lGuerreiro Morto-Vivo'
        lore: [ '&7Clique para usar esta entidade.' ]
  
  # Mob vanilla para fallback
  creeper:
    entity: 'CREEPER'
    custom-name: '&aCreeper'
    entity-options:
      wither-skeleton: false
      baby-zombie: false
      slime-size: 1
    display:
      selected:
        material: 'MONSTER_EGG:50'
        name: '&aCreeper'
        lore: [ '&fVocê está usando: &aCreeper&f.', '', '&7Clique para alterar a entidade.' ]
      select:
        material: 'MONSTER_EGG:50'
        name: '&aCreeper'
        lore: [ '&7Clique para usar esta entidade.' ]

Nesta página