Áreas

Exemplo completo de configuração

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

areas:
  area1:
    # Ordem da área para compra
    order: 1
    # Permissão para comprar a área
    permission: ''
    # NÃO ALTERAR
    location: 'none'
    # Whitelist de flowers (keys da flowers.yml). Vazio = reconhece todas
    flowers: []
    # Preços para comprar a área
    costs:
      price1:
        provider: 'money'
        amount: 1000.0
    # Itens do menu
    icon:
      buy:
        material: 'WHEAT'
        name: '&aÁrea {order} &8(Trigo)'
        lore:
          - '&7Área: &b{order}'
          - '&7Plantação: &bTrigo'
          - ''
          - '&7Preço: &2$&f{money}'
          - ''
          - '&aClique para evoluir'
      # Sem saldo/requisitos suficientes (menu principal e upgrade)
      cant-buy:
        material: 'WHEAT'
        name: '&cÁrea {order} &8(Trigo)'
        lore:
          - '&7Área: &b{order}'
          - '&7Plantação: &bTrigo'
          - ''
          - '&7Preço: &2$&f{money}'
          - ''
          - '&cSaldo insuficiente'
      previous:
        material: 'WHEAT'
        name: '&aÁrea {order} &8(Trigo)'
        lore:
          - '&7Área: &b{order}'
          - '&7Plantação: &bTrigo'
          - ''
          - '&7Preço: &2$&f{money}'
          - ''
          - '&cVocê precisa comprar a anterior'
      has:
        material: 'WHEAT'
        name: '&aÁrea {order} &8(Trigo)'
        lore:
          - '&7Área: &b{order}'
          - '&7Plantação: &bTrigo'
          - ''
          - '&7Preço: &2$&f{money}'
          - ''
          - '&aVocê já possui esta area'
      equipped:
        material: 'WHEAT'
        name: '&aÁrea {order} &8(Trigo)'
        lore:
          - '&7Área: &b{order}'
          - '&7Plantação: &bTrigo'
          - ''
          - '&7Preço: &2$&f{money}'
          - ''
          - '&aVocê está nessa area'

Estrutura de uma área

Cada área possui configurações para ordem, custo e diferentes estados visuais no menu.

order

Define a ordem de compra da área. Os jogadores devem comprar as áreas em sequência.

Exemplo:

areas:
  area1:
    order: 1
  area2:
    order: 2
  area3:
    order: 3

Os jogadores só podem comprar uma área se já possuírem todas as áreas com ordem menor.

permission

Permissão necessária para comprar esta área.

Exemplo:

areas:
  area1:
    permission: 'ycampo.area.vip'

Deixe vazio ('') para permitir que todos possam comprar esta área (desde que tenham as anteriores).

location

Localização do spawn da área. Este campo é gerenciado automaticamente pelo plugin.

Exemplo:

areas:
  area1:
    location: 'none'

NÃO ALTERAR este campo manualmente. Use o comando /campo setareaspawn <area> para definir a localização.

flowers

Whitelist de flowers (keys da flowers.yml) reconhecidas nesta área. Lista vazia = reconhece todas.

areas:
  area1:
    flowers: []
    # flowers: [ 'trigo', 'cenoura' ]

costs

Custos para comprar a área em diferentes economias.

Exemplo:

areas:
  area1:
    costs:
      price1:
        provider: 'money'
        amount: 1000.0
      price2:
        provider: 'cash'
        amount: 500.0

Estados visuais das áreas

Cada área possui estados visuais diferentes no menu:

buy

Exibido quando o jogador pode comprar a área.

cant-buy

Exibido quando o jogador não tem saldo/requisitos suficientes (menu principal e upgrade).

Exemplo:

areas:
  area1:
    icon:
      buy:
        material: 'WHEAT'
        name: '&aÁrea {order} &8(Trigo)'
        lore:
          - '&7Área: &b{order}'
          - '&7Plantação: &bTrigo'
          - ''
          - '&7Preço: &2$&f{money}'
          - ''
          - '&aClique para comprar'

Placeholders disponíveis: {order} - Ordem da área, {money} - Preço formatado

Exibido quando o jogador ainda não tem a área anterior.

Exemplo:

areas:
  area1:
    icon:
      previous:
        material: 'WHEAT'
        name: '&cÁrea {order} &8(Trigo)'
        lore:
          - '&7Área: &b{order}'
          - '&7Plantação: &bTrigo'
          - ''
          - '&7Preço: &2$&f{money}'
          - ''
          - '&cVocê precisa comprar a anterior'

has

Exibido quando o jogador já possui a área mas não está nela.

Exemplo:

areas:
  area1:
    icon:
      has:
        material: 'WHEAT'
        name: '&aÁrea {order} &8(Trigo)'
        lore:
          - '&7Área: &b{order}'
          - '&7Plantação: &bTrigo'
          - ''
          - '&7Preço: &2$&f{money}'
          - ''
          - '&aVocê já possui esta area'
          - '&eClique para ir até ela'

equipped

Exibido quando o jogador está atualmente nesta área.

Exemplo:

areas:
  area1:
    icon:
      equipped:
        material: 'WHEAT'
        name: '&aÁrea {order} &8(Trigo)'
        lore:
          - '&7Área: &b{order}'
          - '&7Plantação: &bTrigo'
          - ''
          - '&7Preço: &2$&f{money}'
          - ''
          - '&aVocê está nessa area'

Exemplos de áreas

Área 1 - Trigo

areas:
  wheat_area:
    order: 1
    permission: ''
    location: 'none'
    costs:
      price1:
        provider: 'money'
        amount: 1000.0
    icon:
      buy:
        material: 'WHEAT'
        name: '&aÁrea 1 &8(Trigo)'
        lore:
          - '&7Plantação inicial de trigo'
          - '&7perfeita para começar!'
          - ''
          - '&7Preço: &2$&f{money}'
          - ''
          - '&aClique para comprar'
      previous:
        material: 'WHEAT'
        name: '&cÁrea 1 &8(Trigo)'
        lore:
          - '&7Esta é a primeira área!'
          - ''
          - '&cVocê não pode comprar ainda'
      has:
        material: 'WHEAT'
        name: '&aÁrea 1 &8(Trigo)'
        lore:
          - '&7Plantação de trigo'
          - ''
          - '&aVocê possui esta área'
          - '&eClique para ir até ela'
      equipped:
        material: 'WHEAT'
        name: '&aÁrea 1 &8(Trigo)'
        lore:
          - '&7Plantação de trigo'
          - ''
          - '&aVocê está nesta área'

Área 2 - Cenoura

areas:
  carrot_area:
    order: 2
    permission: ''
    location: 'none'
    costs:
      price1:
        provider: 'money'
        amount: 5000.0
    icon:
      buy:
        material: 'CARROT_ITEM'
        name: '&aÁrea 2 &8(Cenoura)'
        lore:
          - '&7Plantação de cenoura'
          - '&7com melhores recompensas!'
          - ''
          - '&7Preço: &2$&f{money}'
          - ''
          - '&aClique para comprar'
      previous:
        material: 'CARROT_ITEM'
        name: '&cÁrea 2 &8(Cenoura)'
        lore:
          - '&7Plantação de cenoura'
          - ''
          - '&7Preço: &2$&f{money}'
          - ''
          - '&cVocê precisa comprar a área 1 primeiro'
      has:
        material: 'CARROT_ITEM'
        name: '&aÁrea 2 &8(Cenoura)'
        lore:
          - '&7Plantação de cenoura'
          - ''
          - '&aVocê possui esta área'
          - '&eClique para ir até ela'
      equipped:
        material: 'CARROT_ITEM'
        name: '&aÁrea 2 &8(Cenoura)'
        lore:
          - '&7Plantação de cenoura'
          - ''
          - '&aVocê está nesta área'

Área 3 - Rosa VIP

areas:
  rose_vip_area:
    order: 3
    permission: 'ycampo.area.vip'
    location: 'none'
    costs:
      price1:
        provider: 'money'
        amount: 25000.0
      price2:
        provider: 'cash'
        amount: 1000.0
    icon:
      buy:
        material: 'RED_ROSE'
        name: '&6Área 3 &8(Rosa VIP)'
        lore:
          - '&7Plantação exclusiva VIP'
          - '&7com as melhores recompensas!'
          - ''
          - '&7Preço: &2$&f{money} &7+ &61000 Cash'
          - ''
          - '&6Requer permissão VIP'
          - ''
          - '&aClique para comprar'
      previous:
        material: 'RED_ROSE'
        name: '&cÁrea 3 &8(Rosa VIP)'
        lore:
          - '&7Plantação exclusiva VIP'
          - ''
          - '&7Preço: &2$&f{money} &7+ &61000 Cash'
          - ''
          - '&cVocê precisa comprar a área 2 primeiro'
      has:
        material: 'RED_ROSE'
        name: '&6Área 3 &8(Rosa VIP)'
        lore:
          - '&7Plantação exclusiva VIP'
          - ''
          - '&aVocê possui esta área'
          - '&eClique para ir até ela'
      equipped:
        material: 'RED_ROSE'
        name: '&6Área 3 &8(Rosa VIP)'
        lore:
          - '&7Plantação exclusiva VIP'
          - ''
          - '&aVocê está nesta área'

Configurando o spawn das áreas

Use o comando /campo setareaspawn <area> para definir o local de spawn de cada área.

Exemplo:

/campo setareaspawn wheat_area

Certifique-se de configurar o spawn de todas as áreas antes de disponibilizá-las aos jogadores.

As áreas permitem que diferentes regiões do campo tenham diferentes tipos de plantações e recompensas, aumentando a progressão do jogo.

Nesta página