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.

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 das lojas de jogadores. 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 das lojas 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/yPlayerShop/data.db.

Define o atraso em ticks para carregar os dados do jogador após o login. Essencial para servidores com lobby separado ou rede BungeeCord/Velocity.

# Delay para carregar os dados depois do login
# Necessário para usar em servidor de mina separado
# Recomendado: 20 ticks
login-delay: 20

Por que usar:

Em redes multi-servidor, os dados podem não estar sincronizados imediatamente
20 ticks (1 segundo) é geralmente suficiente
Evita erros de dados não carregados

slots

Sistema de slots que determina quantos itens diferentes um jogador pode vender em sua loja.

slots:
  # Quantia padrão de slots que o jogador irá ter
  default: 1
  # Quantia máxima de slots que o jogador poderá ter
  max: 20
  # Item do slot que será ativável
  item:
    material: 'HOPPER'
    name: '&bSlots'
    lore:
      - ''
      - '&fQuantia: &a{amount}'
      - ''
      - '&7Clique com botão direito para ativar.'

Como funciona:

Jogadores começam com o número de slots definido em default
Podem expandir até o limite de max slots
Use /playershop giveslot <player> <quantia> para dar slots extras
Jogadores podem ativar slots extras clicando com o botão direito no item configurado

Exemplo de uso:

Para um servidor VIP:

slots:
  default: 3   # Jogadores normais começam com 3 slots
  max: 50      # VIPs podem ter até 50 slots

Configure permissões por grupo (VIP, MVP, etc) para dar diferentes quantidades de slots iniciais usando o comando giveslot.

rating

Configuração do sistema de avaliação de lojas com estrelas.

# Configuração da barra de avaliação
rating:
  symbol-full: '&e★'
  symbol-empty: '&f☆'

Como funciona:

Jogadores podem avaliar lojas de outros jogadores de 0 a 5 estrelas
symbol-full representa estrelas preenchidas (avaliação dada)
symbol-empty representa estrelas vazias (avaliação não dada)
A média de avaliações é exibida na loja

Exemplo visual:

5 estrelas: &e★★★★★
3 estrelas: &e★★★&f☆☆
0 estrelas: &f☆☆☆☆☆

Personalizando símbolos:

Você pode usar qualquer caractere Unicode:

rating:
  symbol-full: '&6⭐'
  symbol-empty: '&7○'