AllayaLojas

Autor: Allaya.studios | Versão: 1.3

Descrição

AllayaLojas é um plugin para servidores Minecraft (Paper) que permite a criação de lojas interativas e personalizadas usando menus em GUI. Jogadores podem comprar ou vender itens usando economia Vault. É ideal para servidores que desejam uma loja visualmente organizada, acessível via comandos, blocos ou itens especiais.

Dependências

• Vault (obrigatória): sistema de economia

• PlaceholderAPI (opcional): para uso de placeholders em mensagens, menus e itens

• DecentHolograms (opcional): exibição de hologramas acima de blocos de loja

Comandos

Comando	Função
/lojas abrir	Abre um menu específico
/lojas giveitem	Dá ao jogador um item para abrir o menu
/lojas adicionaritem	Salva o item na mão do jogador no arquivo item.yml
/lojas vincularbloco	Liga o bloco em que o jogador olha a um menu
/lojas desvincularbloco	Remove o vínculo do bloco com o menu
/lojas reload	Recarrega arquivos de configuração e menus

Permissões

Permissão	Descrição
allayalojas.usar	Permite uso básico do comando /lojas
allayalojas.abrir.	Permite abrir um menu específico
allayalojas.abrir.bloco.	Permite abrir um menu ao interagir com bloco vinculado
allayalojas.admin.adicionaritem	Permite adicionar itens personalizados
allayalojas.admin.vincularbloco	Permite vincular blocos a menus
allayalojas.admin.reload	Permite recarregar configurações e menus

PlaceholderAPI

AllayaLojas suporta uso de placeholders em nomes de itens, lores, preços, mensagens e condições de exibição.

Exemplos de Condições Dinâmicas

variavel01:
  compare: "%player_name%"
  valor: "Steve"
  material: STONE

variavel02:
  compare: player.hasperm
  valor: essentials.fly
  material: STONE

Essas condições alteram a aparência do item com base no nome do jogador ou permissões.

Explicação dos Arquivos .yml

config.yml

economia: VAULT

Define o sistema de economia usado. Atualmente só suporta VAULT.

messages.yml

Mensagens personalizáveis, com suporte a cores e placeholders:

sem_permissao: "&cVocê não tem permissão para isso!"
saldo_insuficiente: "&cVocê não tem dinheiro suficiente!"
item_nao_encontrado: "&cVocê não possui o item necessário!"
compra_sucesso: "&aComprado: %quantidade%x %item% por $%preco%!"
venda_sucesso: "&aVendido: %quantidade%x %item% por $%preco%!"
gui_aberta: "&7Abrindo loja: &e%menu%"
item_adicionado: "&aItem '%id%' salvo em item.yml!"
id_ja_existe: "&cJá existe um item com esse ID."
colocar_item_bloqueado: "§cVocê não pode colocar este item no chão."
sem_permissao_item: "§cVocê não tem permissão para usar este item."
compra_permissao_sucesso: "§aVocê comprou o acesso à permissão: §e%permissao%"
ja_possui_permissao: "§cVocê já possui esta permissão."

Menus/menu-principal.yml

nome: "&b&lMenu Principal"
linhas: 3
requer-permissao: false
som_ao_abrir: BLOCK_NOTE_BLOCK_PLING

itens:
  borda:
    slot: 0-9,17,18-26
    material: GRAY_STAINED_GLASS_PANE
    nome: " "

  minerais:
    slot: 11
    material: DIAMOND
    nome: "&bLoja de Minerais"
    lore:
      - "&7Clique para abrir"
    tipo: abrir_gui
    destino: "minerais"

  armas:
    slot: 15
    material: IRON_SWORD
    nome: "&cLoja de Armas"
    lore:
      - "&7Clique para abrir"
    tipo: abrir_gui
    destino: "armas"

Menus/loja-vip.yml

nome: "&dLoja VIP"
linhas: 3
requer-permissao: true

abrir-com-item:
  material: PLAYER_HEAD
  skull-meta:
    texture: "https://textures.minecraft.net/texture/3aa39f7f21955ad4e4c6d872a6cf92f7f1a9462ad88f4b857259482ddcb1c8e9"
  name: "&aClique para abrir a Loja VIP"
  lore:
    - "&7Acesse itens e bônus exclusivos!"
    - "&eDisponível apenas para membros VIP."
  permission: "allayalojas.vip"
  stay-in-inventory: true

itens:
  diamante:
    material: DIAMOND
    nome: "&bPacote de Diamantes"
    lore:
      - "&7Adquira 8 diamantes raros"
      - "&ePreço: &6200 moedas"
    tipo: comprar
    preco-compra: "200"
    quantidade: 8
    slots: [11]

  vip-espada:
    material: DIAMOND_SWORD
    nome: "&cEspada VIP"
    lore:
      - "&7Uma espada lendária para VIPs"
      - "&ePreço: &6400 moedas"
    tipo: comprar
    preco-compra: "400"
    quantidade: 1
    slots: [15]

Menus/loja-acessos.yml

nome: "&dLoja de Acessos"
linhas: 3

itens:
  fly_access:
    slot: 11
    material: FEATHER
    nome: "&bAcesso ao /fly"
    lore:
      - "&7Compra única"
      - "&fComando: &b/fly"
    permission-to-buy: "essentials.fly"
    permission-price: 2500
    quantidade: 1

  vip_group:
    slot: 13
    material: GOLD_INGOT
    nome: "&6Grupo VIP"
    lore:
      - "&7Ganhe acesso ao grupo VIP"
      - "&7Inclui kits e bônus exclusivos"
    permission-to-buy: "group.vip"
    permission-price: 10000
    quantidade: 1

  acesso_warp:
    slot: 15
    material: ENDER_PEARL
    nome: "&9Permissão para usar /warp loja"
    lore:
      - "&7Desbloqueia o comando /warp loja"
    permission-to-buy: "warp.loja"
    permission-price: 1500
    quantidade: 1

Itens/item.yml

# Registro de itens com NBT

Itens personalizados adicionados via comando /lojas adicionaritem. São salvos com dados NBT codificados em Base64.

Economia

• Compra: verifica saldo e remove moedas ao comprar item ou permissão.

• Venda: verifica inventário e adiciona moedas ao vender.

Funcionalidades Avançadas

Sistema de Blocos

• Blocos vinculados abrem menus específicos ao interagir.

• As permissões podem ser exigidas (bloco-requer-permissao).

• Coordenadas configuradas nos menus (bloco.coords).

Hologramas

• Recurso opcional com DecentHolograms.

• Configurável via bloco.holograma no menu .yml

• Recarregados automaticamente com /lojas reload.

Condições Avançadas por Item

• Comportamento dinâmico por player usando %placeholders% ou permissões.

• Ideal para menus exclusivos, bônus VIP ou itens por progresso.

---

Sugestão de ícone para GitBook: store