StarCosmeticos

Nove categorias de cosmetico num menu so, com caixa misteriosa, fragmentos e raridades. Um jar unico da 1.8 a 1.21: material, som e particula sao traduzidos entre as versoes, e o que so existe nas mais novas passa por uma camada de compatibilidade — nada de baixar um arquivo diferente por versao do servidor.

As nove categorias

• Cabecas — qualquer item ou bloco no lugar do capacete, e cabecas com textura propria (base64, URL ou hash)
• Emojis — carinha animada flutuando acima da cabeca, por particula ou por textura desenhada
• Roupas — conjuntos completos de armadura, com couro tingido e cor de arco-iris animada
• Brinquedos — itens de brincadeira usados com o botao direito, em 25 acoes prontas
• Efeitos — particulas que acompanham o jogador, em 12 formas diferentes
• Pets — bichinho que anda atras do dono, com nome escolhido pelo jogador
• Montarias — bichos para montar, guiados pelo jogo ou pelo olhar
• Capas — manto de particulas preso nas costas, que acompanha o corpo e balanca ao andar
• Bandeiras — estandartes montados por desenho e cor, usados na cabeca

Cada categoria pode ser desligada inteira no config, e cada cosmetico e criado, copiado ou apagado por arquivo — sem limite de quantidade.

Os 25 brinquedos

Trampolim, anti gravidade, morcegos, frangado, festa, festa fantasma, perola, gancho, melojato, arma de portal, arma de tinta, thor, esmagador, foguete, foguetes, tsunami, dinamite, paraquedas, arminha, arvore de natal, buraco negro, canhao de congelamento, bola de neve, craquelamento e bomba de cor.

Cada um tem item, tempo de espera, alcance e forca proprios — e a mesma acao pode virar dois brinquedos diferentes, um comum e um de vip.

As 12 formas de efeito

Normal, trilha, anel, orbita, helice, espiral, vortice, aura, asas, coroa, nuvem e chuva. Todas aceitam varias particulas ao mesmo tempo, cor propria, raio, altura e densidade, e podem aparecer so parado, so andando ou sempre.

Caixa misteriosa

• Marque qualquer bloco do mundo como caixa (/starcosmeticos caixa add); o holograma em cima e feito pelo proprio plugin, sem depender de plugin de holograma
• Roleta que desacelera ate parar, com o premio sorteado antes da animacao — fechar a janela no meio nao custa o premio
• Sorteio por peso de raridade, com preferencia pelo que o jogador ainda nao tem
• Premio repetido vira fragmento, e fragmento vira caixa de novo no menu de fabricar
• Quantos tipos de caixa voce quiser, cada um com a sua lista de premios (cabeca:*, pet:zumbi, ...) e comandos ao abrir
• Aviso no chat do servidor inteiro quando sai um premio das raridades que voce escolher

Feito para nao dar problema

• Nenhum brinquedo altera o mundo: o que parece bloco e pacote enviado so para o cliente, a dinamite nao quebra nem machuca e os bichos somem sozinhos — roda em lobby protegido sem exceção de terreno nenhuma
• A peca de armadura do jogador e guardada e devolvida quando o cosmetico sai, inclusive se ele morrer vestindo a roupa
• Cosmetico nao vira drop, nao sai do slot pelo inventario e nao cai no chao
• Banco em SQLITE ou MYSQL, com toda ida ao banco fora da thread do servidor, numa fila propria — nada de travar o servidor na entrada do jogador
• Uma unica tarefa de animacao para o servidor inteiro, e cada cosmetico com o proprio intervalo: um efeito de 5 em 5 ticks nao roda cinco vezes mais do que precisa

Personalizacao

• Todos os menus em menus.yml: titulo, tamanho, slots, itens, sons e fundo
• Modelo de icone por arquivo — cada cosmetico so escreve o que for diferente
• Quatro estados por cosmetico: desbloqueado, a venda, bloqueado e em uso
• Raridades com nome, cor, valor em fragmentos e peso no sorteio
• Precos em coins (Vault ou comando proprio) e em cash (placeholder + comando)
• Tres formas de liberar um cosmetico, combinaveis: para todos, por permissao ou pelo que saiu na caixa
• Restricao por mundo, limpeza ao morrer e ao trocar de mundo
• Nome do pet escolhido pelo jogador, com minimo, maximo e lista de palavras proibidas
• Todas as mensagens em mensagens.yml; mensagem vazia simplesmente nao e enviada
• Nomes e aliases dos comandos trocaveis em comandos.yml

Integracoes

• PlaceholderAPI — nove placeholders proprios
• Vault — para os precos em coins
• Plugins de mobs customizados — um pet ou montaria pode ser um mob de outro plugin, com o tipo comum como reserva

Como comecar

1. Instale e reinicie. Os arquivos nascem prontos, com mais de 130 cosmeticos de fabrica.
2. /cosmeticos ja abre o menu completo.
3. Coloque uma caixa no spawn: olhe para o bloco e use /starcosmeticos caixa add.
4. De caixas aos jogadores por comando, pela loja ou por evento: /starcosmeticos caixa dar <jogador> <caixa> <quantidade>.

Requisitos

Spigot, Paper ou Purpur da 1.8 a 1.21. PlaceholderAPI e Vault sao opcionais.