Un plugin de cosméticos simple, conveniente y fácil de usar

Cosméticos que se sienten como parte de Minecraft

StarCosmetic agrega ranuras dedicadas para mochilas y globos directamente al inventario del jugador. Los jugadores pueden gestionar sus cosméticos de manera natural sin navegar por menús adicionales o memorizar comandos complicados.

• Clic derecho para equipar

• Shift + clic izquierdo para desequipar

• Arrastra y suelta elementos directamente en sus ranuras de cosméticos

• No se requieren mods del lado del cliente

• Compatible con clientes y paquetes de recursos de Minecraft vanilla

• Compatible con Paper 1.21.11+ y versiones más recientes

Las mochilas se mueven con el jugador, mientras que los globos presentan cuerdas visibles, movimiento flotante y animaciones basadas en la inercia.

---

Características Clave

• Ranuras separadas para mochilas y globos

• Iconos de marcador personalizables para cada ranura

• Soporte para Datos de Modelo Personalizados y Modelos de Elementos

• Compatible con elementos de vanilla y elementos personalizados de otros plugins

• Previene que elementos regulares o mal escritos entren en las ranuras de cosméticos

• Movimiento de mochila receptivo sin rastro notable

• Globos animados con cuerdas y física de movimiento

• Los cosméticos son visibles para los jugadores cercanos

• Modelos, posiciones y animaciones configurables

---

Guía del Jugador

Equipando un Cosmético

Sostén un elemento cosmético registrado y haz clic derecho. El plugin lo mueve automáticamente a la ranura de equipo correcta.

Los jugadores también pueden abrir su inventario y arrastrar el elemento a su ranura de cosmético correspondiente. Los elementos inválidos o cosméticos del tipo incorrecto serán rechazados con una notificación.

---

Desequipando un Cosmético

Shift + clic izquierdo en un cosmético equipado para moverlo de vuelta al inventario del jugador.

Si el inventario está lleno, el cosmético permanecerá equipado para evitar la pérdida de elementos.

Ranuras de Cosméticos

• Ranura A — Mochila

• Ranura B — Globo

Cada ranura tiene su propio marcador configurable. Los propietarios del servidor pueden personalizar su material, Datos de Modelo Personalizados, Modelo de Elemento y visibilidad de la información sobre herramientas.

---

Registro de Elementos Cosméticos

Solo los operadores del servidor pueden registrar nuevos elementos cosméticos.

/scos save cosmetic [nombre]
/scos save balloon [nombre]

Ejemplos:

/scos save cosmetic mochila_roja
/scos save balloon globo_rosado

El nombre es opcional. Si se omite, StarCosmetic genera automáticamente un identificador único.

El mismo elemento no puede ser registrado más de una vez o asignado a múltiples tipos de cosméticos. Si un elemento ya ha sido registrado, el plugin mostrará su nombre existente.

---

Comandos

Registrar un Elemento

/scos save cosmetic [nombre]
/scos save balloon [nombre]

Dar un Cosmético a un Jugador

/scos give <jugador> cosmetic <nombre>
/scos give <jugador> balloon <nombre>

Eliminar un Cosmético Registrado

/scos delete cosmetic <nombre>
/scos delete balloon <nombre>

Comandos Adicionales

/scos list
/scos reload

Todos los comandos incluyen autocompletado para argumentos disponibles, nombres de jugadores, tipos de cosméticos y elementos registrados.

---

Permisos

starcosmetic.use

Permite a los jugadores usar las ranuras de cosméticos y equipar elementos registrados. Concedido a todos los jugadores por defecto.

starcosmetic.admin

Permite el acceso a comandos administrativos. Concedido a los operadores del servidor por defecto.

Registrar nuevos elementos con /scos save está restringido directamente a los operadores del servidor.

---

Sistema de Mochilas

• Renderizado usando un soporte de armadura invisible

• Se mueve y rota con el jugador

• Ajusta su posición mientras el jugador está agachado

• Visible para los jugadores cercanos

• Posición y tamaño del soporte de armadura configurables

Sistema de Globos

• Renderiza el modelo usando un soporte de armadura invisible

• Incluye una cuerda visible conectada al jugador

• Presenta movimiento basado en arrastre e inercia

• Utiliza una animación de flotación natural

• Visible para los jugadores cercanos

• Posición y comportamiento de animación configurables

Compatibilidad con Minecraft Vanilla

Los jugadores pueden conectarse usando un cliente de Minecraft vanilla sin modificar. No se requieren mods del lado del cliente.

Las características compatibles incluyen:

• Elementos de Minecraft vanilla

• Datos de Modelo Personalizados

• Modelos de Elementos Modernos

• Paquetes de recursos

• Elementos personalizados que almacenan sus datos dentro del ItemStack

• Paper 1.21.4 y versiones más recientes (Prueba 1.21.4-26.1.2)

Gestión del Estado del Jugador

StarCosmetic gestiona automáticamente los cosméticos cuando un jugador:

• Se une al servidor

• Deja el servidor

• Se desconecta del servidor

• Muere o respawnea

• Cambia de mundos

• Se teletransporta

Esto ayuda a prevenir que queden soportes de armadura o entidades de globos en el mundo.

Archivos de Configuración

config.yml

Controla las ranuras de cosméticos, marcadores, modelos, posicionamiento de mochilas, animaciones de globos y mensajes del plugin.

cosmetics.yml

Almacena los datos completos del ItemStack de mochilas y globos registrados.

Se recomienda gestionar los elementos registrados a través de los comandos del plugin en lugar de editar este archivo manualmente.

Listo para el Desarrollo Futuro

StarCosmetic está abierto activamente a comentarios de la comunidad, informes de errores y sugerencias de características.

Las futuras actualizaciones pueden ser moldeadas por las necesidades de los jugadores y propietarios de servidores, ayudando a que StarCosmetic siga siendo fácil de usar, flexible y adecuado para una amplia gama de servidores de Minecraft.

---

Complemento Opcional de Paquete de Recursos

StarCosmetic incluye un complemento opcional de paquete de recursos que contiene la GUI de inventario y los iconos de ranuras de cosméticos mostrados en el video de demostración.

Ten en cuenta que la colección de modelos de mochila y globo presentada en el video no está incluida.

El paquete de complemento incluye:

• Activos de la GUI de inventario

• Iconos de ranuras de mochila y globo

• Archivos de configuración de ItemsAdder

• Archivos de configuración de Nexo

Este complemento es opcional. StarCosmetic aún se puede usar con tu propio paquete de recursos, Datos de Modelo Personalizados, Modelos de Elementos y diseños de cosméticos personalizados.