yStoreCategorias
Configure as categorias de itens do mercado.
Exemplo completo de configuração
Aqui está um exemplo de como configurar as categorias do mercado:
categories:
weapons:
# Ordem de verificação da categoria
order: 1
# Nome da categoria nas mensagens
name: '&fArmas'
# Ícone da categoria nos menus
icon:
slot: 20
material: 'DIAMOND_SWORD'
name: '&aArmas'
lore:
- '&7A categoria de armas permite a'
- '&7venda de itens de ataque e poções.'
- ''
- '&f* &7Esta categoria possui &f&n{amount}'
- '&7itens(s) no momento. :)'
- ''
- '&eClique para abrir a categoria.'
# Itens permitidos na categoria
items:
# Permitir todos os DEMAIS itens (que não estiverem na BlackList da config.yml)
all: false
nbts: []
names: []
types:
- 'DIAMOND_SWORD'
- 'GOLD_SWORD'
- 'IRON_SWORD'
- 'STONE_SWORD'
- 'WOOD_SWORD'
- 'BOW'
- 'ARROW'Estrutura de uma categoria
Cada categoria possui uma configuração específica que define quais itens podem ser vendidos nela.
order
Define a ordem de verificação da categoria. Quando um item é colocado para venda, o plugin verifica as categorias em ordem crescente.
Exemplo:
categories:
weapons:
order: 1Categorias com menor número de ordem são verificadas primeiro. Isso é útil para priorizar categorias específicas sobre categorias genéricas.
name
Nome da categoria usado nas mensagens do plugin.
Exemplo:
categories:
weapons:
name: '&fArmas'icon
Configuração do ícone da categoria no menu principal.
Exemplo:
categories:
weapons:
icon:
slot: 20
material: 'DIAMOND_SWORD'
name: '&aArmas'
lore:
- '&7A categoria de armas permite a'
- '&7venda de itens de ataque e poções.'
- ''
- '&f* &7Esta categoria possui &f&n{amount}'
- '&7itens(s) no momento. :)'
- ''
- '&eClique para abrir a categoria.'Placeholder disponível: {amount} - Quantidade de itens na categoria
slot
Define em qual slot do menu principal a categoria aparecerá.
Exemplo:
icon:
slot: 20material
Define o material do item que representará a categoria.
Exemplo:
icon:
material: 'DIAMOND_SWORD'Use o formato MATERIAL:DATA para materiais com data value, como LOG:0.
name
Nome do item exibido no menu.
Exemplo:
icon:
name: '&aArmas'lore
Descrição do item exibida no menu.
Exemplo:
icon:
lore:
- '&7A categoria de armas permite a'
- '&7venda de itens de ataque e poções.'
- ''
- '&eClique para abrir a categoria.'items
Define quais itens são permitidos nesta categoria.
Exemplo:
categories:
weapons:
items:
all: false
nbts: []
names: []
types:
- 'DIAMOND_SWORD'
- 'GOLD_SWORD'
- 'IRON_SWORD'all
Se true, permite todos os itens que não estão na blacklist do config.yml.
Exemplo:
items:
all: trueQuando all está ativo, as listas nbts, names e types são ignoradas. Use isso apenas para categorias genéricas como "Outros".
nbts
Lista de NBT tags que identificam itens permitidos. Útil para itens customizados de outros plugins.
Exemplo:
items:
nbts:
- 'ySpawnersV2-Item'
- 'yMaquinas-MaquinaItem'
- 'yMaquinasVirtuais-Item'Esta opção é especialmente útil para permitir itens de plugins como ySpawners, yMaquinas, etc.
names
Lista de nomes de itens permitidos. Verifica o display name do item.
Exemplo:
items:
names:
- 'Espada Lendária'
- 'Arco Mágico'types
Lista de tipos de materiais permitidos.
Exemplo:
items:
types:
- 'DIAMOND_SWORD'
- 'GOLD_SWORD'
- 'IRON_SWORD'
- 'STONE_SWORD'
- 'WOOD_SWORD'Use o formato MATERIAL:DATA para materiais específicos, como LOG:0 para carvalho.
Exemplo de categoria que aceita todos os itens
Para criar uma categoria genérica que aceita todos os itens não classificados:
categories:
others:
order: 8
name: '&fOutros'
icon:
slot: 32
material: 'CHEST'
name: '&aOutros'
lore:
- '&7A categoria "outros" permite a'
- '&7venda de itens em geral.'
- ''
- '&eClique para abrir a categoria.'
items:
all: true
nbts: []
names: []
types: []Categorias com all: true devem ter ordem maior (número mais alto) para serem verificadas por último.
Exemplo de categoria por NBT
Para criar uma categoria de itens customizados baseada em NBT tags:
categories:
spawners:
order: 6
name: '&fGeradores'
icon:
slot: 30
material: 'MOB_SPAWNER'
name: '&aGeradores'
lore:
- '&7A categoria de geradores permite a'
- '&7venda de spawners de mobs.'
- ''
- '&eClique para abrir a categoria.'
items:
all: false
nbts: [ 'ySpawnersV2-Item' ]
names: []
types: []Esta configuração permite apenas itens que possuem a NBT tag ySpawnersV2-Item.
Exemplo de categoria mista
Você pode combinar múltiplos tipos de verificação:
categories:
machines:
order: 7
name: '&fMáquinas'
icon:
slot: 31
material: 'EMERALD_BLOCK'
name: '&aMáquinas'
lore:
- '&7A categoria de máquinas permite a'
- '&7venda de geradores de minérios.'
- ''
- '&eClique para abrir a categoria.'
items:
all: false
nbts:
- 'yMaquinas-MaquinaItem'
- 'yMaquinasVirtuais-Item'
names: []
types: []Quando múltiplas NBT tags são especificadas, o item será aceito se possuir qualquer uma delas.
Personalizando categorias
Escolha um ID único
Defina um identificador único para sua categoria (ex: custom_items).
Configure a ordem
Defina a ordem de verificação. Use números menores para categorias específicas e maiores para genéricas.
Personalize o ícone
Configure o material, nome, lore e slot do ícone no menu.
Defina os itens permitidos
Configure as listas types, nbts e names conforme necessário, ou use all: true para aceitar todos os itens.
Teste no servidor
Reinicie o servidor e teste se os itens estão sendo categorizados corretamente.
Após alterar as categorias, é necessário reiniciar o servidor para aplicar as mudanças.