Um Plugin de Cosméticos Simples, Conveniente e Amigável

Cosméticos que Parecem Parte do Minecraft

StarCosmetic adiciona slots dedicados para mochilas e balões diretamente ao inventário do jogador. Os jogadores podem gerenciar seus cosméticos de forma natural, sem navegar em menus adicionais ou memorizar comandos complicados.

• Clique com o botão direito para equipar

• Shift + clique com o botão esquerdo para desequipar

• Arraste e solte itens diretamente em seus slots de cosméticos

• Nenhum mod do lado do cliente é necessário

• Compatível com clientes e pacotes de recursos do Minecraft vanilla

• Suporta Paper 1.21.4 e versões mais recentes

Mochilas se movem com o jogador, enquanto balões apresentam cordas visíveis, movimento flutuante e animações baseadas em momentum.

---

Principais Recursos

• Slots separados para mochilas e balões

• Ícones de espaço reservado personalizáveis para cada slot

• Suporte para Dados de Modelo Personalizados e Modelos de Itens

• Compatível com itens vanilla e itens personalizados de outros plugins

• Impede que itens regulares ou digitados incorretamente entrem nos slots de cosméticos

• Movimento responsivo da mochila sem rastros visíveis

• Balões animados com cordas e física de movimento

• Cosméticos são visíveis para jogadores próximos

• Modelos, posições e animações configuráveis

---

Guia do Jogador

Equipando um Cosmético

Segure um item cosmético registrado e clique com o botão direito. O plugin move automaticamente para o slot de equipamento correto.

Os jogadores também podem abrir seu inventário e arrastar o item para seu slot de cosmético correspondente. Itens inválidos ou cosméticos do tipo errado serão rejeitados com uma notificação.

---

Desequipando um Cosmético

Shift + clique com o botão esquerdo em um cosmético equipado para movê-lo de volta para o inventário do jogador.

Se o inventário estiver cheio, o cosmético permanecerá equipado para evitar perda de itens.

Slots de Cosméticos

• Slot A — Mochila

• Slot B — Balão

Cada slot tem seu próprio espaço reservado configurável. Os proprietários de servidores podem personalizar seu material, Dados de Modelo Personalizados, Modelo de Item e visibilidade de tooltip.

---

Registrando Itens Cosméticos

Apenas operadores de servidor podem registrar novos itens cosméticos.

\/scos save cosmetic [nome]
\/scos save balloon [nome]

Exemplos:

\/scos save cosmetic mochila_vermelha
\/scos save balloon balão_rosa

O nome é opcional. Se omitido, StarCosmetic gera automaticamente um identificador único.

O mesmo item não pode ser registrado mais de uma vez ou atribuído a múltiplos tipos de cosméticos. Se um item já foi registrado, o plugin exibirá seu nome existente.

---

Comandos

Registrar um Item

\/scos save cosmetic [nome]
\/scos save balloon [nome]

Dar um Cosmético a um Jogador

\/scos give <jogador> cosmetic <nome>
\/scos give <jogador> balloon <nome>

Excluir um Cosmético Registrado

\/scos delete cosmetic <nome>
\/scos delete balloon <nome>

Comandos Adicionais

\/scos list
\/scos reload

Todos os comandos incluem conclusão de tabulação para argumentos disponíveis, nomes de jogadores, tipos de cosméticos e itens registrados.

---

Permissões

starcosmetic.use

Permite que os jogadores usem os slots de cosméticos e equipem itens registrados. Concedido a todos os jogadores por padrão.

starcosmetic.admin

Permite acesso a comandos administrativos. Concedido a operadores de servidor por padrão.

Registrar novos itens com \/scos save é restrito diretamente a operadores de servidor.

---

Sistema de Mochilas

• Renderizado usando um Armário Invisível

• Move e gira com o jogador

• Ajusta sua posição enquanto o jogador está agachado

• Visível para jogadores próximos

• Posição e tamanho do Armário configuráveis

Sistema de Balões

• Renderiza o modelo usando um Armário Invisível

• Inclui uma corda visível conectada ao jogador

• Apresenta movimento baseado em arrasto e momentum

• Usa uma animação de flutuação natural

• Visível para jogadores próximos

• Posição e comportamento de animação configuráveis

Compatibilidade com o Minecraft Vanilla

Os jogadores podem se conectar usando um cliente vanilla do Minecraft não modificado. Nenhum mod do lado do cliente é necessário.

Os recursos suportados incluem:

• Itens do Minecraft vanilla

• Dados de Modelo Personalizados

• Modelos de Itens Modernos

• Pacotes de recursos

• Itens personalizados que armazenam seus dados dentro do ItemStack

• Paper 1.21.4 e versões mais recentes (Teste 1.21.4-26.1.2)

Gerenciamento de Estado do Jogador

StarCosmetic gerencia automaticamente os cosméticos quando um jogador:

• Entra no servidor

• Sai do servidor

• É desconectado do servidor

• Morre ou renasce

• Muda de mundos

• Teleporta

Isso ajuda a evitar que Armários ou entidades de balões restantes permaneçam no mundo.

Arquivos de Configuração

config.yml

Controla slots de cosméticos, espaços reservados, modelos, posicionamento de mochilas, animações de balões e mensagens do plugin.

cosmetics.yml

Armazena os dados completos do ItemStack de mochilas e balões registrados.

Gerenciar itens registrados através dos comandos do plugin é recomendado em vez de editar este arquivo manualmente.

Pronto para Desenvolvimento Futuro

StarCosmetic está ativamente aberto a feedback da comunidade, relatórios de bugs e sugestões de recursos.

Atualizações futuras podem ser moldadas pelas necessidades dos jogadores e proprietários de servidores, ajudando StarCosmetic a permanecer fácil de usar, flexível e adequado para uma ampla gama de servidores do Minecraft.

---

Complemento Opcional de Pacote de Recursos

StarCosmetic inclui um complemento opcional de pacote de recursos contendo a GUI do inventário e ícones de slots de cosméticos mostrados no vídeo de apresentação.

Por favor, note que a coleção de modelos de mochila e balão apresentada no vídeo não está incluída.

O pacote de complemento inclui:

• Ativos da GUI do Inventário

• Ícones de slots de mochila e balão

• Arquivos de configuração do ItemsAdder

• Arquivos de configuração do Nexo

Este complemento é opcional. StarCosmetic ainda pode ser usado com seu próprio pacote de recursos, Dados de Modelo Personalizados, Modelos de Itens e designs de cosméticos personalizados.