QsAllBalls

---

Descripción

QsAllBalls es un plugin avanzado que introduce un sistema completo de Balls personalizadas, permitiendo capturar mobs como si fueran mon.

El plugin está diseñado con una arquitectura moderna, animaciones visuales, soporte para MiniMessage, y una alta personalización mediante archivos YAML.

---

✨ Características

• Captura de mobs con Balls
• Diferentes tipos de Balls con estadísticas únicas
• Sistema de usos (limitados, infinitos o consumibles)
• Tienda GUI completamente configurable
• Animaciones visuales de lanzamiento y captura
• Persistencia completa del mob (NBT)
• Texturas personalizadas (cabezas)
• Soporte MiniMessage + HEX
• Protección contra stacking y duplicación

---
⚙️ Requisitos

• Servidor: Paper / Purpur
• Versión: 1.20.6+
• Java: 21 o superior

---

Dependencias:

• NBT-API (obligatoria)
• Vault (opcional, para economía)
• WorldGuard (opcional) y proximante en el futuro soporte para más plugins de protección.

---

Archivos

---

Balls (balls.yml)

Cada Ball es totalmente configurable:

Notas:

• max-uses = -1 → usos infinitos
• max-uses = 0 → consumible por intento

---

Tienda (shop.yml)

Sistema de tienda con GUI totalmente editable.

Variables disponibles:

• %chance% → Probabilidad de captura
• %price% → Precio
• %uses% → Usos de la Ball
• %amount% → Cantidad

---

Comandos

/qsallballs
Abre la tienda.

/qsallballs reload
Recarga todas las configuraciones y archivos yml.

/qsallballs give <jugador> <ball_id> [cantidad]
Entrega Balls sin stacking (cada ítem es único).

---

Permisos

• qsallballs.admin → reload y give
• qspokeballs.ball.<id> → comprar en la tienda

---

Cómo capturar un mob

• Sostén una Ball
• Clic derecho sobre un mob
• Se reproduce la animación
• Si la captura tiene éxito, el mob se guarda dentro de la ball
• Si falla, el mob reaparece

---

Sistema de Usos

• Usos independientes por Ball
• No se apilan
• Al llegar a 0 usos, la ball se consume

---

⚠ NOTA IMPORTANTE

Todos los archivos YML del plugin ya incluyen explicaciones y comentarios internos.

• Cada opción está documentada dentro del propio archivo
• No es necesario consultar documentación externa para configurarlos
• Facilita la creación y personalización de PokéBalls
• Ideal tanto para principiantes como para usuarios avanzados

Recomendaciones

• Usar Paper o Purpur.
• No duplicar ítems en creativo
• No apilar Balls manualmente
• Realizar pruebas en un entorno seguro antes de usar en producción
• Antes de modificar cualquier valor, lee los comentarios dentro del archivo YML para entender su función.

---

Próximas mejoras

• Integración completa con WorldGuard
• Nuevas animaciones y efectos visuales en tal caso se requiera
• Más opciones de personalización

---

Comunidad & Soporte

¿Quieres ayuda, compartir ideas o colaborar?
Únete a nuestro Discord:


---

❤️ Créditos

Desarrollado por QUESITO_ECU / QsPlugins

---

¿Tienes sugerencias o bugs? ¡Déjalos en los comentarios!