Mascotes

Estrutura de arquivos

Os mascotes são configurados individualmente em arquivos YAML dentro da pasta mascots/.

gorilla.yml

Exemplo completo de configuração

Aqui está um exemplo completo de como configurar um mascote:

# Nome padrão do mascote
name: '&eMascote Gorilla'

# Entidade do mascote
entity: 'ZOMBIE'

# Item ativável
item:
  material: '20a969b6ec7deae807cc362e5aca5a35b36b0f9c76514767bb5ca4bb3d7f2b9d'
  name: '&eMascote Gorilla'
  lore:
    - '&7Considerado um dos mais fortes,'
    - '&7este mascote irá trazer aos membros'
    - '&7do seu clan vários buffs.'
    - ''
    - '&8> &fBônus venda &8(spawners)&f: &b10%'
    - '&8> &5Força 1 ∞'
    - '&8> &bSpeed 1 ∞'
    - ''
    - '&aClique para ativar.'

# Entidade customizada do MiniturePets
custom-entity:
  # Ativar a entidade custom. Precisa do MiniaturePets
  enabled: true
  # Arquivo da entidade da pasta de pets do MiniaturePets
  entity: 'Boxer.mpet'

# Holograma do mascote
hologram:
  enabled: true
  # Altura em relação ao spawner
  off-set: 2.0
  lines:
    - '{name}'
    - '&eMascote do clan: {clan_colortag}'

# Buffs que irá dar aos jogadores
# Se o mascote for de clan, irá dar os bônus para todos os membros
buffs:
  # Bônus de Venda de drops de Spawners -> ySpawners
  bonus-spawners: 10.0
  # Bônus de Venda de drops de Máquinas -> yMaquinas e yMaquinasVirtuais
  bonus-machines: 10.0
  # Bônus de Venda na mina -> yMinas
  bonus-mines: 10.0
  # Bônus de Venda no armazém -> yArmazem
  bonus-storage: 10.0
  # Bônus de Venda nas plantas -> yCampo, yPlantacoes
  bonus-farm: 10.0
  # Bônus de Venda na floresta -> yFloresta
  bonus-forest: 0.0
  # Bônus de Venda -> yVender
  bonus-sell: 0.0
  # Bônus de Venda na pesca -> yPesca
  bonus-fish: 10.0
  # Desconto na compra de spawners -> ySpawnersShop
  discount-spawners: 5.0
  # Desconto na compra de máquinas -> yMaquinas e yMaquinasVirtuais
  discount-machines: 5.0
  # Lista de efeitos que o jogador irá ter
  # effect:level
  effect-list: [ 'INCREASE_DAMAGE:1', 'SPEED:1' ]
  # Mundos que o jogador irá ter fly
  fly-worlds: [ 'PlotWorld' ]
  # Comandos que será executado ao renascer
  # Caso queira dar um "kit", por exemplo.
  respawn-commands: []

# Preços para comprar o mascote
costs:
  cost1:
    provider: 'money'
    amount: 1000.0

# Itens que irão ficar no menu
displays:
  buy:
    material: '20a969b6ec7deae807cc362e5aca5a35b36b0f9c76514767bb5ca4bb3d7f2b9d'
    name: '&eMascote Gorilla'
    lore:
      - '&7Considerado um dos mais fortes,'
      - '&7este mascote irá trazer aos membros'
      - '&7do seu clan vários buffs.'
      - ''
      - '&f* Preço: &a{money} coins'
      - ''
      - '&8> &fBônus venda &8(spawners)&f: &b10%'
      - '&8> &5Força 1 ∞'
      - '&8> &bSpeed 1 ∞'
      - ''
      - '&aClique para comprar.'
  equipped:
    material: '20a969b6ec7deae807cc362e5aca5a35b36b0f9c76514767bb5ca4bb3d7f2b9d'
    name: '&eMascote Gorilla'
    lore:
      - '&7Considerado um dos mais fortes,'
      - '&7este mascote irá trazer aos membros'
      - '&7do seu clan vários buffs.'
      - ''
      - '&8> &fBônus venda &8(spawners)&f: &b10%'
      - '&8> &5Força 1 ∞'
      - '&8> &bSpeed 1 ∞'
      - ''
      - '&f* Nome Atual: &b{name}'
      - ''
      - '&aClique para editar o nome.'
  active:
    material: '20a969b6ec7deae807cc362e5aca5a35b36b0f9c76514767bb5ca4bb3d7f2b9d'
    name: '&eMascote Gorilla'
    lore:
      - '&7Considerado um dos mais fortes,'
      - '&7este mascote irá trazer aos membros'
      - '&7do seu clan vários buffs.'
      - ''
      - '&8> &fBônus venda &8(spawners)&f: &b10%'
      - '&8> &5Força 1 ∞'
      - '&8> &bSpeed 1 ∞'
      - ''
      - '&aClique para equipar.'

Opções de configuração

name

Nome padrão do mascote.

Exemplo:

name: '&eMascote Gorilla'

entity

Tipo de entidade do Minecraft que será usada caso o MiniaturePets esteja desabilitado.

Exemplo:

entity: 'ZOMBIE'

Use os tipos de entidade válidos do Minecraft (ZOMBIE, CHICKEN, COW, etc.)

item

Item que será dado ao jogador para ativar o mascote.

Exemplo:

item:
  material: '20a969b6ec7deae807cc362e5aca5a35b36b0f9c76514767bb5ca4bb3d7f2b9d'
  name: '&eMascote Gorilla'
  lore:
    - '&7Descrição do mascote'
    - ''
    - '&aClique para ativar.'

Para usar cabeças customizadas, use o valor da texture em base64 como material.

custom-entity

Configuração da entidade customizada do MiniaturePets.

Exemplo:

custom-entity:
  enabled: true
  entity: 'Boxer.mpet'

Requer o plugin MiniaturePets instalado para funcionar.

hologram

Configuração do holograma acima do mascote.

Exemplo:

hologram:
  enabled: true
  off-set: 2.0
  lines:
    - '{name}'
    - '&eMascote do clan: {clan_colortag}'

Placeholders disponíveis: {name}, {clan_colortag}

buffs

Bônus e efeitos que o mascote concede aos jogadores.

Bônus de venda

buffs:
  bonus-spawners: 10.0
  bonus-machines: 10.0
  bonus-mines: 10.0
  bonus-storage: 10.0
  bonus-farm: 10.0
  bonus-forest: 0.0
  bonus-sell: 0.0
  bonus-fish: 10.0

Os valores são em porcentagem. 10.0 = 10% de bônus adicional

Descontos

buffs:
  discount-spawners: 5.0
  discount-machines: 5.0

Os valores são em porcentagem de desconto. 5.0 = 5% de desconto

Efeitos de poção

buffs:
  effect-list: [ 'INCREASE_DAMAGE:1', 'SPEED:1' ]

Formato: EFFECT_TYPE:LEVEL. Use os nomes de efeitos do Minecraft.

Fly em mundos

buffs:
  fly-worlds: [ 'PlotWorld' ]

Lista de mundos onde o jogador terá fly permanente enquanto o mascote estiver ativo.

Comandos ao renascer

buffs:
  respawn-commands: []

Lista de comandos executados quando o jogador renascer. Use {player} para o nome do jogador.

costs

Preços para comprar o mascote.

Exemplo:

costs:
  cost1:
    provider: 'money'
    amount: 1000.0
  cost2:
    provider: 'points'
    amount: 500

O provider deve corresponder a uma economia configurada em economies.yml

displays

Configuração de como o mascote aparece no menu em diferentes estados.

buy

Aparência quando o mascote pode ser comprado.

Exemplo:

displays:
  buy:
    material: '20a969b6ec7deae807cc362e5aca5a35b36b0f9c76514767bb5ca4bb3d7f2b9d'
    name: '&eMascote Gorilla'
    lore:
      - '&7Descrição'
      - ''
      - '&f* Preço: &a{money} coins'
      - ''
      - '&aClique para comprar.'

Placeholder disponível: {money} - Preço do mascote

equipped

Aparência quando o mascote está equipado.

Exemplo:

displays:
  equipped:
    material: '20a969b6ec7deae807cc362e5aca5a35b36b0f9c76514767bb5ca4bb3d7f2b9d'
    name: '&eMascote Gorilla'
    lore:
      - '&7Descrição'
      - ''
      - '&f* Nome Atual: &b{name}'
      - ''
      - '&aClique para editar o nome.'

Placeholder disponível: {name} - Nome customizado do mascote

active

Aparência quando o mascote está na posse do jogador mas não equipado.

Exemplo:

displays:
  active:
    material: '20a969b6ec7deae807cc362e5aca5a35b36b0f9c76514767bb5ca4bb3d7f2b9d'
    name: '&eMascote Gorilla'
    lore:
      - '&7Descrição'
      - ''
      - '&aClique para equipar.'

Criando um novo mascote

Crie o arquivo

Crie um novo arquivo .yml dentro da pasta mascots/. O nome do arquivo será o ID do mascote.

Configure as propriedades básicas

Defina o nome, entidade e item do mascote.

Configure os bônus

Adicione os bônus e efeitos que o mascote concederá.

Configure os preços

Defina quanto custará para adquirir o mascote.

Configure as aparências

Configure como o mascote aparecerá no menu em cada estado.

Teste no servidor

Reinicie o servidor e teste o novo mascote com /mascotes.

O nome do arquivo (sem extensão .yml) será usado como ID do mascote nos comandos.

Integrações com plugins

O sistema de bônus funciona automaticamente com os seguintes plugins quando instalados:

ySpawners - Aplica bonus-spawners
ySpawnersShop - Aplica discount-spawners
yMaquinas / yMaquinasVirtuais - Aplica bonus-machines e discount-machines
yPesca - Aplica bonus-fish
yCampo / yPlantacoes - Aplica bonus-farm
yFloresta - Aplica bonus-forest
yArmazem - Aplica bonus-storage

Os bônus são aplicados automaticamente quando os plugins correspondentes estão instalados. Não é necessária configuração adicional.

Nesta página