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.

Estrutura de arquivos

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

Configuração do plugin (config.yml)

O arquivo config.yml é o principal arquivo de configuração do plugin, onde você controla todos os aspectos do funcionamento das lojas. 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

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: ''

sign-buy-menu

Define se ao clicar na placa abrirá um menu de compra ou realizará a transação diretamente.

# Determina se o sistema de menu será usado. Valores válidos: [false, true]
sign-buy-menu: true

• true - Abre menu interativo com opções de quantidade
• false - Realiza a transação diretamente ao clicar

max-item-characters

Define o limite de caracteres permitidos no nome customizado do item na loja.

# Define o máximo de caracteres permitidos no nome do item
max-item-characters: 20

Útil para evitar nomes excessivamente longos que quebram o layout da placa.

translate-names

Traduz automaticamente os nomes dos itens do Minecraft para português.

# Determina se os nomes serão traduzidos. Valores válidos: [false, true]
translate-names: true

Exemplo:

• DIAMOND → Diamante
• IRON_SWORD → Espada de Ferro

shift-sell-all

Permite que jogadores vendam todo o inventário de uma vez usando Shift + Clique.

# Determina se o shift venderá todo o inventário. Valores válidos: [false, true]
shift-sell-all: true

Facilita a venda em massa de itens farm.

shop-clear-task

Executa automaticamente uma limpeza de dados de placas que não existem mais fisicamente no mundo.

# Determina se a task de limpeza será executada. Valores válidos: [false, true]
shop-clear-task: true

A task roda 5 segundos após o servidor iniciar, removendo dados órfãos do banco de dados.

bolsa

Integração com plugins de bolsa de valores que afetam preços dinamicamente.

# Determina se o sistema de bolsa será usado. Valores válidos: [false, true]
bolsa: false

Compatível com: yBolsa, NextEconomy, StormEconomy e HeroBolsa.

just-plot

Restringe a criação de lojas apenas dentro de plots (requer PlotSquared).

# Determina se placas só podem ser colocadas em plots. Valores válidos: [false, true]
just-plot: false

Útil para servidores com economia baseada em plots comerciais.

max-price

Define o preço máximo que pode ser configurado em uma loja.

# Define o preço máximo permitido. Deixe 0 para não ter limite
max-price: 0

Exemplo de uso:

max-price: 1000000

Evita que jogadores definam preços absurdos.

max-amount

Define a quantidade máxima suportada para comprar na loja.

# Quantia máxima suportada para comprar na loja
# deixe 0 para não ter limite.
max-amount: 0

Use 0 para não aplicar limite.

max-friends

Limite de amigos que podem ser adicionados para acessar o baú da loja.

# Define o número máximo de amigos por loja
max-friends: 5

Amigos podem abrir o baú da loja mas não podem modificar suas configurações.

shop-max

Limite máximo de lojas que um jogador pode possuir.

# Quantia máxima de lojas que um jogador pode ter
# Deixe 0 para ser infinito
shop-max: 0

Exemplo de uso:

shop-max: 5  # Cada jogador pode ter no máximo 5 lojas

Quando ativado com um número maior que 0, o jogador receberá mensagens de erro ao tentar criar uma loja após atingir o limite.

black-list

Sistema de lista negra para bloquear itens específicos de serem comercializados.

black-list:
  # Materiais que estarão na black-list
  materials: [ 'STONE', 'LOG:0' ]
  # NBTTags que estarão na black-list
  nbt-tags: []
  # NBTTags que serão ignoradas ao verificar se os itens são idênticos
  nbt-tags-bypass: []
  # Mundos que não poderá criar lojas
  # Bypass: ychestshop.world.bypass
  worlds: [ 'world_nether', 'world_the_end' ]

Exemplo de uso:

black-list:
  materials: [ 'BEDROCK', 'BARRIER', 'COMMAND_BLOCK' ]
  nbt-tags: ['CustomTag']
  nbt-tags-bypass: ['display', 'Lore']
  worlds: [ 'world_nether', 'world_the_end' ]

• materials: Bloqueia materiais específicos
• nbt-tags: Bloqueia itens com NBT tags específicas
• nbt-tags-bypass: Ignora certas tags ao comparar itens
• worlds: Bloqueia a criação de lojas nos mundos listados. Use ychestshop.world.bypass para permitir bypass.

default-type

Define o tipo padrão de comércio ao criar uma nova loja.

# Valores válidos: [BUY, SELL, BUYSELL]
# BUY - Players compram (você vende para eles)
# SELL - Players vendem (você compra deles)
# BUYSELL - Players compram e vendem
default-type: 'SELL'

Tipos explicados:

• BUY: Jogadores compram itens da sua loja (você precisa ter estoque no baú)
• SELL: Jogadores vendem itens para sua loja (você precisa ter espaço no baú e dinheiro)
• BUYSELL: Loja funciona nos dois sentidos

item-select-lore

Texto exibido na lore dos itens durante a configuração da loja.

item-select-lore: [ '&aClique em um item do seu inventário para alterar' ]

mohist-chat

Ativa compatibilidade com plugins de chat específicos no Mohist.

# Compatível apenas com: UltimateChat, nChat e Legendchat
# Valores válidos: [false, true]
mohist-chat: false

sign-hologram

Sistema de hologramas exibidos acima das lojas. Requer DecentHolograms ou HolographicDisplays.

sign-hologram:
  enabled: true
  hologram-buy:
    offset: 3.0
    lines:
      - '{item_name}'
      - '[item][shopitem]'
      - '&fLoja de &b{player}'
      - '&fQuantia comercializada: &b{amount}'
      - '&fEconomia utilizada: &b{provider}'
      - '&fPreço de compra: &b{price_buy} {provider_abbreviated}'

Configurações disponíveis:

• offset: Altura do holograma acima da placa (em blocos)
• lines: Linhas do holograma (suporta placeholders)

Tipos de holograma:

• hologram-buy: Para lojas onde jogadores compram
• hologram-sell: Para lojas onde jogadores vendem
• hologram-buy-sell: Para lojas mistas
• hologram-buy-admin: Para lojas admin de compra
• hologram-sell-admin: Para lojas admin de venda
• hologram-buy-sell-admin: Para lojas admin mistas

Placeholders disponíveis:

sign-definer

Define os textos usados na primeira linha da placa para identificar o tipo de loja.

# Será identificado na primeira linha da placa
sign-definer:
  admin: 'lojaadmin'
  player: 'loja'

Como criar lojas:

• Loja de jogador: Coloque uma placa em um baú e escreva loja na primeira linha
• Loja admin: Escreva lojaadmin na primeira linha (requer permissão)

sign-format

Define como as informações são exibidas nas placas.

sign-format:
  # Outras placeholder de preços: {price_buy_raw}, {price_sell_raw} (sem formatação de letra)
  buy: '&2C &r{price_buy} &7({provider_abbreviated})'
  sell: '&cV &r{price_sell} &7({provider_abbreviated})'
  buy-sell: '&2C &r{price_buy} | &cV &r{price_sell} &7({provider_abbreviated})'
  free: 'Grátis'
  sign:
    admin:
      line-1: '&aLoja Admin'
      line-2: '{format}'
      line-3: '{amount}'
      line-4: '&0Clique para ver'
    player:
      line-1: '&a{owner}'
      line-2: '{format}'
      line-3: '{amount}'
      line-4: '&0Clique para ver'

Exemplo visual de uma placa:

┌──────────────┐
│  §aNomeDono  │
│ §2C §f100 §7$ │
│      64      │
│ §0Clique aqui│
└──────────────┘

bonus

Sistema de bônus percentual ao vender para lojas admin. Funciona com permissões.

bonus:
  member:
    priority: 1
    # Permissão para ser reconhecido
    permission: 'ychestshop.bonus.member'
    # Quantia do bônus em %
    bonus: 10.0

Como funciona:

Jogador vende 64 diamantes por $640 na loja admin + 10% de bônus = recebe $704.

Criando múltiplos níveis:

bonus:
  vip:
    priority: 1
    permission: 'ychestshop.bonus.vip'
    bonus: 10.0
  mvp:
    priority: 2
    permission: 'ychestshop.bonus.mvp'
    bonus: 25.0

O jogador receberá o bônus da maior prioridade que ele tiver permissão.

discounts

Sistema de descontos percentuais ao comprar de lojas admin.

discounts:
  member:
    priority: 1
    # Permissão para ser reconhecido
    permission: 'ychestshop.discount.member'
    # Quantia do desconto em %
    discount: 10.0

Funciona igual ao sistema de bônus, mas reduz o preço de compra.

format

Sistema de formatação de valores numéricos (dinheiro e quantidades).

format:
  type: 'NUMBER' # Tipos: LETTER - NUMBER
  max-decimals: 4
  formats:
    - ''
    - ''
    - 'K'
    - 'M'
    - 'B'
    - 'T'
    - 'Q'
    - 'QQ'
    - 'S'
    - 'SS'
    - 'O'
    - 'N'
    - 'D'

Tipos de formatação:

• NUMBER: Usa números com separadores (ex: 1.000.000)
• LETTER: Usa letras abreviadas (ex: 1M)

Exemplo com LETTER:

• 1000 → 1K
• 1000000 → 1M
• 1000000000 → 1B

max-decimals: Controla quantas casas decimais exibir (ex: 1.5K ou 1.5000K)