Arenas

Localização dos arquivos

As arenas são configuradas individualmente em arquivos YAML localizados na pasta plugins/yArenas/arenas/. Cada arquivo representa uma arena diferente.

Para criar uma nova arena, copie um arquivo existente e renomeie-o com o nome desejado.

Exemplo completo de configuração

Aqui está um exemplo de como configurar uma arena:

# Nome da arena
display-name: '&cArena couro'

# Permissão para entrar na arena
permission: ''

# Ordem da arena na lista
# os jogadores começam na arena de ordem ("order") 1
order: 1

# Lista de comandos que será possível executar na arena
command-whitelist: [ '/g', '/.' ]

# Sistema de desbloqueio de arena
unlock:
  # Pontos mínimos necessários para desbloquear essa arena
  need-points: 0.0
  # Habilitar a compra dessa arena
  buy: false
  # Preços para comprar o acesso a esta arena
  prices:
    price1:
      provider: 'money'
      amount: 0.0

Configurações básicas

display-name

Nome de exibição da arena.

Exemplo:

display-name: '&cArena couro'

Use códigos de cor do Minecraft com & para colorir o nome.

permission

Permissão necessária para acessar a arena.

Exemplo:

permission: 'yarenas.arena.vip'

Deixe vazio ('') para não exigir permissão.

order

Ordem da arena na lista de progressão.

Exemplo:

order: 1

Os jogadores começam na arena de order 1. Arenas com order maior são desbloqueadas conforme o jogador ganha pontos.

command-whitelist

Lista de comandos que podem ser executados dentro da arena.

Exemplo:

command-whitelist: [ '/g', '/.' ]

Comandos não listados aqui serão bloqueados quando o jogador estiver na arena.

Sistema de desbloqueio

unlock

Configurações para desbloquear a arena.

Exemplo:

unlock:
  need-points: 100.0
  buy: true
  prices:
    price1:
      provider: 'money'
      amount: 5000.0

Opções:

need-points: Pontos mínimos necessários para desbloquear
buy: Define se a arena pode ser comprada antes de ter os pontos
prices: Lista de preços para comprar o acesso

Mensagens e ações

private

Mensagens e ações enviadas apenas para o jogador.

Exemplo:

private:
  # Mensagens e ações ao entrar
  entry:
    sound: 'ORB_PICKUP'
    title: '&bBem vindo à<nl>&cArena Couro'
    actionbar: '&bVocê entrou na &cArena Couro&b.'
    chat: '<nl>&bBem vindo à &cArena Couro.<nl>&bLute bravamente.<nl>'
  # Mensagens e ações ao sair
  exit:
    sound: 'ORB_PICKUP'
    title: ''
    actionbar: '&bVocê saiu da &cArena Couro&b.'
    chat: '<nl>&bVocê saiu da &cArena Couro&b.<nl>'
  # Mensagens e ações ao morrer
  death:
    sound: 'ORB_PICKUP'
    title: ''
    actionbar: '&bVocê morreu na &cArena Couro&b.'
    chat: '<nl>&bVocê morreu na &cArena Couro&b.<nl>'

Use <nl> para quebrar linha nas mensagens. Deixe vazio ('') para não enviar.

broadcast

Mensagens e ações enviadas para todos os jogadores online.

Exemplo:

broadcast:
  # Mensagens e ações ao entrar
  entry:
    sound: ''
    title: ''
    actionbar: ''
    chat: ''
  # Mensagens e ações ao sair
  exit:
    sound: ''
    title: ''
    actionbar: ''
    chat: ''
  # Mensagens e ações ao morrer
  death:
    sound: ''
    title: ''
    actionbar: ''
    chat: '&f{killer}&b matou &f{dead}&b.'
  # Mensagens e ações ao obter kill-streak
  kill-streak:
    sound: ''
    title: ''
    actionbar: '&aO jogador &f{player}&a está com um &nkillstreak&a de &6{killstreak} &a&nkills&a.'
    chat: ''

Placeholders disponíveis: {player}, {killer}, {dead}, {killstreak}

Sistema de kill-streak

kill-streak

Configurações do sistema de sequência de abates.

Exemplo:

kill-streak:
  enabled: true
  minimum: 2
  rewards:
    - '100.0,reward1'
    - '50.0,reward2'

Opções:

enabled: Ativa ou desativa o sistema de kill-streak
minimum: Número mínimo de kills seguidas para ativar
rewards: Lista de recompensas no formato CHANCE,ID_RECOMPENSA

A chance é uma porcentagem (100.0 = 100%, 50.0 = 50%, etc).

Scoreboard

scoreboard

Configurações da scoreboard exibida na arena.

Exemplo:

scoreboard:
  enabled: true
  title: '&b&lyStore'
  lines:
    - '&7     Área de batalha'
    - ''
    - '&f &cArena Couro'
    - '&f Rank: &7{rank}'
    - ''
    - '&e Dados'
    - '&8  ❘&f Abates: &a{kills}'
    - '&8  ❘&f Mortes: &c{deaths}'
    - ''
    - '&f A. KillStreak&f: &e{killstreak}'
    - '&f M. KillStreak&f: &e{highest_killstreak}'
    - ''
    - '&b    ystoreplugins.com.br'

Placeholders disponíveis: {rank}, {kills}, {deaths}, {killstreak}, {highest_killstreak}

icons

Configurações dos ícones exibidos nos menus.

access

Ícone quando o jogador pode acessar a arena.

Exemplo:

icons:
  access:
    material: 'LEATHER_CHESTPLATE'
    name: '&cArena couro'
    lore:
      - '&7Esta é a Arena Inicial. Aqui você'
      - '&7poderá incrementar suas skills'
      - '&7e avançar para a demais arenas.'
      - ''
      - ' &8▶ &fAbates: &a{kills}'
      - ' &8▶ &fMortes: &c{deaths}'
      - ''
      - ' &8▶ &fKill-Streak: &c{killstreak}'
      - ' &8▶ &fMaior Kill-Streak: &c{highest_killstreak}'
      - ''
      - '&f> &aVocê pode acessar essa arena.'
      - ''

unlock

Ícone quando o jogador pode desbloquear a arena.

Exemplo:

icons:
  unlock:
    material: 'LEATHER_CHESTPLATE'
    name: '&cArena couro'
    lore:
      - '&7Esta é a Arena Inicial. Aqui você'
      - '&7poderá incrementar suas skills'
      - '&7e avançar para a demais arenas.'
      - ''
      - ' &fPontos necessários: &a{points}'
      - ' &fRank necessário: &b[ÁguaI]'
      - ''
      - '&f> &aVocê já pode desbloquear essa arena.'
      - ''

Placeholder disponível: {points}

already

Ícone quando o jogador já está dentro da arena.

Exemplo:

icons:
  already:
    material: 'LEATHER_CHESTPLATE'
    name: '&cArena couro'
    lore:
      - '&7Esta é a Arena Inicial. Aqui você'
      - '&7poderá incrementar suas skills'
      - '&7e avançar para a demais arenas.'
      - ''
      - ' &8▶ &fAbates: &a{kills}'
      - ' &8▶ &fMortes: &c{deaths}'
      - ''
      - ' &8▶ &fKill-Streak: &c{killstreak}'
      - ' &8▶ &fMaior Kill-Streak: &c{highest_killstreak}'
      - ''
      - '&f> &cVocê já está dentro desta arena.'
      - ''

permission

Ícone quando o jogador não tem permissão para acessar.

Exemplo:

icons:
  permission:
    material: 'LEATHER_CHESTPLATE'
    name: '&cArena couro'
    lore:
      - '&7Esta é a Arena Inicial. Aqui você'
      - '&7poderá incrementar suas skills'
      - '&7e avançar para a demais arenas.'
      - ''
      - ' &fRank necessário: &b[ÁguaI]'
      - ''
      - '&f> &cVocê não tem permissão para'
      - '&c  entrar nesta arena.'
      - ''

points

Ícone quando o jogador não tem pontos suficientes.

Exemplo:

icons:
  points:
    material: 'LEATHER_CHESTPLATE'
    name: '&cArena couro'
    lore:
      - '&7Esta é a Arena Inicial. Aqui você'
      - '&7poderá incrementar suas skills'
      - '&7e avançar para a demais arenas.'
      - ''
      - ' &fPontos necessários: &a{points}'
      - ''
      - '&f> &cVocê não tem pontos suficientes'
      - '&c  para entrar nesta arena.'
      - ''
      - '&f> &7Adquira o acesso pagando:'
      - '&2  $&a{money} coins&7.'
      - ''

Placeholders disponíveis: {points}, {money}

top

Ícone no menu de TOP jogadores.

Exemplo:

icons:
  top:
    material: 'LEATHER_CHESTPLATE'
    name: '&cArena couro'
    lore:
      - ''
      - ' &7Líderes:'
      - '  &f> 1º {player_1}: &a{amount_1}'
      - '  &f> 2º {player_2}: &a{amount_2}'
      - '  &f> 3º {player_3}: &a{amount_3}'
      - '  &f> 4º {player_4}: &a{amount_4}'
      - '  &f> 5º {player_5}: &a{amount_5}'
      - ''

Placeholders disponíveis: {player_1} até {player_5} e {amount_1} até {amount_5}

Sistema de kits

kit

Configurações do sistema de kits.

Exemplo:

kit:
  # Ativar o sistema itens setados
  enabled: true

Os kits são configurados através do menu de gerenciamento no jogo usando /arena edit <arena>.

Sistema de player-kill

player-kill

Configurações de recompensas ao matar um jogador.

Exemplo:

player-kill:
  # Regenerar a vida ao matar um jogador
  # a vida total do jogador é 20 (10 corações)
  # deixe 0 para não usar
  heal: 5.0
  # Resetar o kit do inventário do jogador ao matar um jogador
  reset-kit: true
  # Pontos que serão dados por kill
  give-points: 1.0
  # Dar algum item ao matar um jogador
  give-items: {}
  # Dar algum comando ao matar um jogador
  give-commands: []
  # Efeitos que serão dados ao matar um jogador
  give-effects:
    - 'SPEED:1-15'

Opções:

heal: Quantidade de vida regenerada (máximo 20)
reset-kit: Define se o kit será resetado após matar
give-points: Quantidade de pontos ganhos por kill
give-items: Itens dados ao matar (formato de item)
give-commands: Comandos executados ao matar
give-effects: Efeitos dados ao matar (formato: EFEITO:NIVEL-DURACAO)

Exemplos de give-items

give-items:
  item1:
    material: 'GOLDEN_APPLE:0'
    name: '&6Maçã Dourada'
    amount: 1
    lore: []
    enchants: []

Exemplos de give-commands

give-commands:
  - 'eco give {player} 100'
  - 'give {player} diamond 1'

Exemplos de give-effects

give-effects:
  - 'SPEED:1-15'
  - 'REGENERATION:2-10'
  - 'ABSORPTION:1-30'

Lista de efeitos comuns:

SPEED - Velocidade
REGENERATION - Regeneração
ABSORPTION - Absorção
STRENGTH - Força
RESISTANCE - Resistência
FIRE_RESISTANCE - Resistência ao fogo
JUMP - Pulo

O formato é: EFEITO:NIVEL-DURACAO_EM_SEGUNDOS

Criando uma nova arena

Copie um arquivo existente

Vá até plugins/yArenas/arenas/ e copie um arquivo de arena existente.

Renomeie o arquivo

Renomeie o arquivo copiado com o nome da nova arena (ex: diamond.yml).

Edite as configurações

Abra o arquivo e altere as configurações básicas:

display-name: '&bArena Diamante'
order: 3
unlock:
  need-points: 500.0

Configure os ícones

Altere o material e descrições dos ícones para representar a nova arena.

Configure a scoreboard

Personalize a scoreboard com as cores e informações da arena.

Reinicie o servidor

Reinicie o servidor para carregar a nova arena.

Configure no jogo

Use /arena edit <nome_do_arquivo> para adicionar locais de spawn e kits.

O nome do arquivo (sem a extensão .yml) é o ID da arena usado nos comandos.

Nesta página