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

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 por 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 a 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 do servidor podem personalizar seu material, Dados de Modelo Personalizados, Modelo de Item e visibilidade da dica.

---

Registrando Itens Cosméticos

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

/scos save cosmetic [name]
/scos save balloon [name]

Exemplos:

/scos save cosmetic red_backpack
/scos save balloon pink_balloon

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 exibe seu nome existente.

---

Comandos

Registrar um Item

/scos save cosmetic [name]
/scos save balloon [name]

Dar um Cosmético a um Jogador

/scos give <player> cosmetic <name>
/scos give <player> balloon <name>

Excluir um Cosmético Registrado

/scos delete cosmetic <name>
/scos delete balloon <name>

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 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 Armor Stand invisível

• Move e rotaciona com o jogador

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

• Visível para jogadores próximos

• Posição e tamanho do Armor Stand configuráveis

Sistema de Balões

• Renderiza o modelo usando um Armor Stand 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 Armor Stands ou entidades de balão 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.