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 de Minecraft vanilla y paquetes de recursos

• Soporta Paper 1.21.4 y versiones más nuevas

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 Custom Model Data y Modelos de Ítems

• Compatible con ítems de vanilla y ítems personalizados de otros plugins

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

• Movimiento de mochila responsivo 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 ítem 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 ítem a su ranura de cosmético correspondiente. Los ítems 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 ítems.

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, Custom Model Data, Modelo de Ítem y visibilidad de la descripción emergente.

---

Registrando Ítems Cosméticos

Solo los operadores del servidor pueden registrar nuevos ítems 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 ítem no puede ser registrado más de una vez o asignado a múltiples tipos de cosméticos. Si un ítem ya ha sido registrado, el plugin mostrará su nombre existente.

---

Comandos

Registrar un Ítem

/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 e ítems registrados.

---

Permisos

starcosmetic.use

Permite a los jugadores usar las ranuras de cosméticos y equipar ítems 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 ítems con /scos save está restringido directamente a los operadores del servidor.

---

Sistema de Mochilas

• Renderizado usando un Armor Stand 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 Armor Stand configurables

Sistema de Globos

• Renderiza el modelo usando un Armor Stand invisible

• Incluye una cuerda visible conectada al jugador

• Presenta movimiento basado en arrastre e inercia

• Usa 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 soportadas incluyen:

• Ítems de Minecraft vanilla

• Custom Model Data

• Modelos de Ítems modernos

• Paquetes de recursos

• Ítems personalizados que almacenan sus datos dentro del ItemStack

• Paper 1.21.4 y versiones más nuevas (Test 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 Armor Stands 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 ítems registrados a través de los comandos del plugin en lugar de editar este archivo manualmente.

Listo para el Desarrollo Futuro

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

Las actualizaciones futuras 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 presentació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 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, Custom Model Data, Modelos de Ítems y diseños de cosméticos personalizados.