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.

default.yml

commands.yml

config.yml

economies.yml

menus.yml

messages.yml

Configuração do plugin (config.yml)

O arquivo config.yml é o coração do plugin, onde você controla todos os aspectos do funcionamento dos bundles. 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 dos bundles 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/yBundles/data.db.

redis

Configurações do servidor Redis para sincronização multi-servidor (BungeeCord/Velocity).

redis:
  # Ativar a conexão com o redis
  enabled: false
  # Endereço de conexão. [EX: 127.0.0.1]
  host: 'localhost'
  # Porta de conexão. [EX: 6379]
  port: 6379
  # Usuário de conexão. [EX: root]
  username: ''
  # Senha do usuário de conexão: [EX: 123]
  password: ''

Quando usar Redis:

Rede BungeeCord/Velocity com múltiplos servidores
Sincronização em tempo real de bundles entre servidores
Bundles comprados em um servidor ficam disponíveis em todos

O Redis é essencial para redes multi-servidor. Sem ele, os bundles não sincronizarão entre os servidores.

general

Configurações gerais do sistema de bundles.

general:
  # Lista de blocos que não poderá colocar no chão
  blocked-place-blocks:
    - 'CACTUS'

Uso prático:

Esta lista impede que jogadores coloquem determinados blocos no chão, útil para evitar exploits ou proteger áreas específicas. Adicione os materiais que deseja bloquear.

Exemplo expandido:

general:
  blocked-place-blocks:
    - 'CACTUS'
    - 'TNT'
    - 'OBSIDIAN'
    - 'BEDROCK'

blocks

Sistema de blocos customizados que podem ser distribuídos nos bundles.

blocks:
  cactus:
    # Nome nas mensagens
    display-name: '&aCacto Customizado'
    # Item customizado
    item:
      material: 'CACTUS'
      name: '&aCacto Customizado'
      lore:
        - '&7Um cacto especial que'
        - '&7pode ser plantado no chão.'

Como funciona:

Este sistema permite criar blocos especiais com nomes e descrições customizadas que podem ser incluídos como recompensa nos bundles. Cada bloco pode ter suas próprias propriedades visuais.

Exemplo de uso múltiplo:

blocks:
  cactus:
    display-name: '&aCacto Customizado'
    item:
      material: 'CACTUS'
      name: '&aCacto Customizado'
      lore:
        - '&7Um cacto especial que'
        - '&7pode ser plantado no chão.'
  
  special_diamond:
    display-name: '&bDiamante Especial'
    item:
      material: 'DIAMOND'
      name: '&bDiamante Especial'
      lore:
        - '&7Um diamante raro do'
        - '&7bundle premium!'

Use blocos customizados para criar itens exclusivos e diferenciados nos seus bundles, aumentando o valor percebido das ofertas.