Configuração

O plugin deve funcionar sem necessidade de configuração adicional, mas se você precisar alterar o comportamento do plugin, você está no lugar certo.

Após alterar a configuração, é necessário reiniciar o servidor.

Estrutura de arquivos

Abaixo está um exemplo de como é a estrutura de arquivos do plugin. Clique em uma pasta para expandi-la.

areas.yml

boosters.yml

bungeecord.yml

commands.yml

config.yml

data.yml

economies.yml

flowers.yml

menus.yml

messages.yml

rewards.yml

skins.yml

Configuração do plugin (config.yml)

O arquivo config.yml é o coração do plugin, onde você controla todos os aspectos do funcionamento do campo. Abaixo estão todas as opções disponíveis com explicações detalhadas.

debug-mode

Ativa ou desativa o modo de depuração. Quando ativado, o plugin registrará informações detalhadas no console para ajudar a identificar problemas.

# Determina o funcionamento da depuração. Valores válidos: [false, true]
debug-mode: false

Mantenha desativado em produção, pois pode gerar muitos logs e afetar a performance.

database

Define como e onde os dados do campo serão armazenados. O plugin suporta três tipos de armazenamento:

SQLITE: Armazena dados em um arquivo local. Ideal para servidores pequenos.
MYSQL: Conecta a um servidor MySQL externo. Recomendado para servidores médios.
HIKARI: Usa pool de conexões para MySQL. Recomendado para servidores grandes por melhor performance.

database:
  # Determina o tipo de banco de dados. Valores válidos: [SQLITE, MYSQL, HIKARI (recomendado)]
  storage-type: SQLITE

  # Dados para conexão ao banco de dados MYSQL.
  data:
    # Endereço de conexão do banco de dados. [EX: 127.0.0.1]
    host: localhost
    # Porta de conexão do banco de dados. [EX: 3306]
    port: 3306
    # Nome do banco de dados a ser conectado. [EX: minecraft]
    database: ''
    # Usuário de conexão. [EX: root]
    username: ''
    # Senha do usuário de conexão: [EX: 123]
    password: ''

Se usar SQLITE, não precisa preencher os dados de conexão. O arquivo será criado automaticamente em plugins/yCampo/data.db.

Delay em ticks para carregar os dados do jogador após o login. Essencial quando o campo está em um servidor separado (BungeeCord/Velocity) para garantir sincronização correta dos dados.

# Delay em ticks (20 ticks = 1 segundo)
# Recomendado: 20 ticks para servidores separados
login-delay: 20

limit

Sistema de limite para recolher recompensas. Serve como proteção contra sobrecarga do servidor.

limit:
  enabled: true
  # Máximo que irá recolher por vez
  max: 1000

Desativar ou aumentar muito o limite pode causar lag intenso ou até crashar o servidor quando jogadores recolherem muitas recompensas de uma vez.

invisibility

Quando ativado, torna todos os jogadores invisíveis uns para os outros na área de campo. Útil para servidores que querem evitar PvP ou distrações durante o farming.

invisibility: false

Define se o menu de evolução abre ao interagir com a tesoura (Shift + Botão direito do mouse).

interact-menu: true

true - Shift + clique direito abre o menu de evolução
false - Desativa a interação com a tesoura

sum-evolute

Quando ativado, soma +1 ao nível exibido nos encantamentos (visual apenas).

sum-evolute: true

Exemplo: Se o jogador tem nível 5, será exibido como nível 6.

q-max

Define o máximo de níveis que podem ser evoluídos ao dropar a tesoura (tecla Q) em um encantamento no menu de evolução. Use 0 para desativar.

q-max: 0

acumulate-bonus

Define se os bônus de permissão são acumuláveis.

acumulate-bonus: false

true - Jogador com múltiplas permissões de bônus soma todos
false - Apenas o bônus de maior prioridade é aplicado

limit-broken-second

Limite de plantações que podem ser quebradas por segundo por jogador. Sistema anti-hack.

limit-broken-second: 5

Ajuste conforme necessário. Valor muito baixo pode limitar jogadores legítimos, valor muito alto pode permitir hacks.

reset-delay

Tempo em segundos para a plantação resetar após ser quebrada.

reset-delay: 5

give-enter

Se ativado, dá automaticamente a tesoura ao jogador quando entra no campo (caso não tenha no inventário).

give-enter: true

void-detect

Altura Y do void do seu servidor. Usado para teleportar jogadores de volta quando caem.

void-detect: 0

Valores comuns:

Minecraft normal: 0
Alguns servidores customizados: -64

skill-identify

Identificador da skill do mcMMO ou AuraSkills que será usada para dar experiência ao quebrar plantas.

skill-identify: 'HERBALISM'

Skills comuns:

HERBALISM - Herbalismo (colher plantas)
FARMING - Agricultura
MINING - Mineração

general

Configurações gerais do sistema de ferramentas e gameplay.

general:
  # Exigir a ferramenta para quebrar as plantas
  tool-need: true
  # Slot da ferramenta no inventário (começa em 0)
  tool-slot: 2
  # Esconder o encantamento na lore da picareta caso o player desative ele
  # false = encantamento fica riscado na lore
  hide-deactivated: false
  # Fazer com que a ferramenta nunca quebre
  tool-unbreakable: true
  # Materiais que irão ser reconhecidos na skin
  skin-materiais:
    - 'WOOD'
    - 'STONE'
    - 'IRON'
    - 'GOLD'
    - 'DIAMOND'
  formatter-bonus-has: '&a+{bonus}% por ser {display}&a.'
  formatter-bonus-no-has: ''

Destaques:

tool-slot: Slot 2 = terceiro slot da hotbar (0 é o primeiro)
skin-materiais: Apenas materiais listados aqui podem ser usados em skins
tool-unbreakable: Recomendado deixar true para ferramentas do campo

pvp

Sistema de PvP dentro do campo com mecânica de recompensas baseadas no risco.

pvp:
  enable: true
  # Lucro com pvp desativado (70% do valor normal)
  off-receiving: 70.0
  # Lucro com pvp ativado (100% do valor normal)
  on-receiving: 100.0
  # Delay para alterar o modo PvP (em segundos)
  delay: 60
  # Actionbar persistente mostrada no campo
  # deixe '' para não usar
  actionbar-off: '&c&lPVP &cdesativado! &8 - &fLucro {receiving}%  &7/pvp {pvp_time}'
  actionbar-on: '&a&lPVP &aativo! &8 - &fLucro {receiving}%  &7/pvp {pvp_time}'
  # Ativar o PVP por padrão assim que entrar no campo
  default: false

Como funciona:

Jogadores com PvP ativado ganham 100% dos lucros
Jogadores com PvP desativado ganham apenas 70% dos lucros
Incentiva os jogadores a arriscarem ativar PvP para ganhar mais

Placeholders:

{receiving} - Porcentagem de lucro atual
{pvp_time} - Tempo restante para poder alterar o modo PvP

scoreboard

Sistema de scoreboard customizada exibida enquanto o jogador está no campo.

scoreboard:
  enabled: true
  title: '&b&lyStore'
  # Delay para atualizar a scoreboard (em segundos)
  delay: 1
  lines:
    - '&7         Área de campo'
    - ''
    - '&f Plantas quebradas: &7{broken}'
    - '&f Tempo no campo: &7{time}'
    - '&f PVP Ativado: &7{pvp}'
    - ''
    - '&f Coins: &2$&a%yeconomy_money%'
    - ''
    - '&b    ystoreplugins.com.br'

Placeholders internos:

{broken} - Plantas quebradas
{time} - Tempo no campo
{pvp} - Status do PvP

Também suporta placeholders do PlaceholderAPI (ex: %yeconomy_money%).

commands

Sistema de controle de comandos dentro do campo.

commands:
  # Lista de comandos permitidos no campo
  allowed: [ '/g', '/l', '/campo' ]
  # Lista de comandos que fazem o jogador sair do campo
  exit: [ '/sair', '/spawn', '/exit' ]
  # Lista de comandos que alternam o modo PvP
  pvp: [ '/pvp' ]

Funcionalidade:

allowed: Apenas comandos nesta lista podem ser usados no campo
exit: Comandos que automaticamente tiram o jogador do campo
pvp: Comandos que alternam o estado de PvP do jogador

Adicione comandos essenciais em allowed como comandos de chat do seu servidor.

bonus

Sistema de bônus por permissão. Jogadores com permissões específicas ganham porcentagens extras nos lucros.

bonus:
  member:
    # Prioridade (maior = mais importante se acumulate-bonus: false)
    priority: 1
    # Permissão para ser reconhecido
    permission: 'ycampo.bonus.member'
    # Quantia do bônus em porcentagem
    bonus: 10.0
    # Nome que irá aparecer nas mensagens
    display: '&7[Membro]'

Exemplo de uso com múltiplos bônus:

bonus:
  member:
    priority: 1
    permission: 'ycampo.bonus.member'
    bonus: 10.0
    display: '&7[Membro]'
  
  vip:
    priority: 2
    permission: 'ycampo.bonus.vip'
    bonus: 25.0
    display: '&6[VIP]'
  
  vip_plus:
    priority: 3
    permission: 'ycampo.bonus.vipplus'
    bonus: 50.0
    display: '&b[VIP+]'

Se acumulate-bonus: false, apenas o bônus de maior prioridade é aplicado.

lore

Lore customizada para itens com chance.

lore:
  chance: ['', '&6Chance: &f{chance}%', '']

Placeholder {chance} é substituído pela chance real do item.

usable-item

Configuração do item de fertilizantes ativável (dado via /fertilizantes give).

usable-item:
  material: '1ba16c3890af39c3f2d576586cff443de07dad32b2315e2ff6f0d5d6a3c663dd'
  name: '&b+{amount} Fertilizantes'
  lore:
    - ''
    - '&fQuantia: &b{amount}'
    - ''
    - '&7Clique com botão direito para ativar.'
    - ''
    - '&7Clique com shift + botão direito para compactar'
    - '&7todos os seus fertilizantes no inventário em 1 só.'
    - ''

Funcionalidades:

Botão direito: Ativa os fertilizantes (adiciona à conta do jogador)
Shift + Botão direito: Compacta todos os fertilizantes do inventário em 1 item só

Placeholder {amount} mostra a quantidade de fertilizantes no item.

tool

Configuração visual da tesoura padrão do campo.

tool:
    material: SHEARS
    name: '&bTesoura &7[{broken}]'
    lore:
      - '&7Inquebrável ∞'
      - '{enchants}'

Placeholders:

{broken} - Quantidade de plantas quebradas com esta tesoura
{enchants} - Lista de encantamentos da tesoura (gerada automaticamente)

Nesta página