QsHeads icon

QsHeads -----

plugin de busqueda de cabezas para obtener una recompensa.

Download Now
88.6 KB .jar


QsHeads - Plugin de Spigot

QsHeads es un plugin avanzado para Spigot/Paper que permite crear colecciones de cabezas o bloques personalizadas.
Los jugadores buscan estos ítems en el mundo, y al encontrarlos reciben recompensas configurables.
Cada colección soporta skins personalizadas, ubicaciones múltiples, efectos visuales, sonidos dinámicos y recompensas.

Tabla de Contenidos

  • Instalación
  • Permisos
  • Comandos
  • Configuración
  • Funciones Clave
  • Interfaz Gráfica
  • Guía de Uso
  • Notas Técnicas

Instalación

Requisitos
  • Servidor: Spigot 1.21+ o Paper 1.21+
  • Java: 8 o superior
  • Permisos: Acceso a la carpeta plugins

Pasos de Instalación
  1. Descarga el archivo QsHeads.jar
  2. Colócalo en la carpeta plugins de tu servidor
  3. Reinicia el servidor: /reload o reinicia el proceso
  4. Se creará la carpeta plugins/QsHeads/ con la configuración

Permisos

Permiso Descripción
qsheads.admin Acceso a todos los comandos administrativos


⚡ Comandos

Comando Principal
Uso: /qsheads <subcomando> [parámetros]
Permiso: qsheads.admin
Descripción: Acceso a todas las funciones del plugin.

Subcomandos Disponibles

reload
Recarga la configuración del plugin sin reiniciar el servidor.

Code (Text):
/qsheads reload
Ejemplo:
Code (Text):
/qsheads reload
save <colección>
Guarda el item en tu mano como parte de una colección. El item debe ser un PLAYER_HEAD o bloque válido.

Code (Text):
/qsheads save <colección>
Ejemplos:
Code (Text):
/qsheads save dragon
/qsheads save rare-heads
give <colección> [jugador]
Da una cabeza de una colección a un jugador. Si no especificas jugador, se te da a ti.

Code (Text):
/qsheads give <colección> [jugador]
Ejemplos:
Code (Text):
/qsheads give dragon
/qsheads give dragon Steve
/qsheads give rare-heads @a
reset <jugador> [colección]
Resetea el progreso de un jugador en una colección o en todas.

Code (Text):
/qsheads reset <jugador> [colección]
Ejemplos:
Code (Text):
/qsheads reset Steve
/qsheads reset Steve dragon
list <colección>
Lista todas las ubicaciones registradas de una colección con coordenadas clickeables.

Code (Text):
/qsheads list <colección>
Ejemplo:
Code (Text):
/qsheads list dragon
tpnear <colección> <índice>
Teletransporta al jugador cerca de una ubicación específica de la colección.

Code (Text):
/qsheads tpnear <colección> <índice>
Ejemplo:
Code (Text):
/qsheads tpnear dragon 1
️ gui
Abre la interfaz gráfica principal para administrar colecciones, efectos, sonidos y recompensas.

Code (Text):
/qsheads gui
⚙️ Archivo de Configuración

La configuración se guarda en plugins/QsHeads/config.yml. Puedes editarla manualmente o usar el comando /qsheads gui.

Code (Text):

heads:
  '1': # Identificador de la colección
    item: rO0ABXNyABpvcmcuYnVra2l0LnV0aWwuaW8uV3JhcHBlcvJQR+zxEm8FAgABTAADbWFwdAAPTGphdmEvdXRpbC9NYXA7eHBzcgA1Y29tLmdvb2dsZS5jb21tb24uY29sbGVjdC5JbW11dGFibGVNYXAkU2VyaWFsaXplZEZvcm0AAAAAAAAAAAIAAkwABGtleXN0ABJMamF2YS9sYW5nL09iamVjdDtMAAZ2YWx1ZXNxAH4ABHhwdXIAE1tMamF2YS5sYW5nLk9iamVjdDuQzlifEHMpbAIAAHhwAAAABHQAAj09dAABdnQABHR5cGV0AARtZXRhdXEAfgAGAAAABHQAHm9yZy5idWtraXQuaW52ZW50b3J5Lkl0ZW1TdGFja3NyABFqYXZhLmxhbmcuSW50ZWdlchLioKT3gYc4AgABSQAFdmFsdWV4cgAQamF2YS5sYW5nLk51bWJlcoaslR0LlOCLAgAAeHAAAA9zdAALUExBWUVSX0hFQURzcQB+AABzcQB+AAN1cQB+AAYAAAAGcQB+AAh0AAltZXRhLXR5cGV0AAxkaXNwbGF5LW5hbWV0AARsb3JldAASUHVibGljQnVra2l0VmFsdWVzdAALc2t1bGwtb3duZXJ1cQB+AAYAAAAGdAAISXRlbU1ldGF0AAVTS1VMTHQAlHsidGV4dCI6IiIsImV4dHJhIjpbeyJ0ZXh0IjoiUmVjb21wZW5zYXMiLCJvYmZ1c2NhdGVkIjpmYWxzZSwiaXRhbGljIjpmYWxzZSwidW5kZXJsaW5lZCI6ZmFsc2UsInN0cmlrZXRocm91Z2giOmZhbHNlLCJjb2xvciI6ImdyZWVuIiwiYm9sZCI6ZmFsc2V9XX1zcgATamF2YS51dGlsLkFycmF5TGlzdHiB0h2Zx2GdAwABSQAEc2l6ZXhwAAAAAXcEAAAAAXQAnXsidGV4dCI6IiIsImV4dHJhIjpbeyJ0ZXh0IjoiUmVjb21wZW5zYSBkZSByYW5nb3MiLCJvYmZ1c2NhdGVkIjpmYWxzZSwiaXRhbGljIjpmYWxzZSwidW5kZXJsaW5lZCI6ZmFsc2UsInN0cmlrZXRocm91Z2giOmZhbHNlLCJjb2xvciI6ImdyZWVuIiwiYm9sZCI6ZmFsc2V9XX14dAAhewogICAgInpoZWFkOnpoZWFkLWl0ZW0iOiAiMzM1Igp9c3EAfgAAc3EAfgADdXEAfgAGAAAAA3EAfgAIdAAIdW5pcXVlSWR0AApwcm9wZXJ0aWVzdXEAfgAGAAAAA3QADVBsYXllclByb2ZpbGV0ACQ5Mjg2NDQ0NS01MWM1LTRjM2ItOTAzOS01MTdjOTkyN2QxYjRzcQB+AB4AAAABdwQAAAABc3IAF2phdmEudXRpbC5MaW5rZWRIYXNoTWFwNMBOXBBswPsCAAFaAAthY2Nlc3NPcmRlcnhyABFqYXZhLnV0aWwuSGFzaE1hcAUH2sHDFmDRAwACRgAKbG9hZEZhY3RvckkACXRocmVzaG9sZHhwP0AAAAAAAAx3CAAAABAAAAACdAAEbmFtZXQACHRleHR1cmVzdAAFdmFsdWV0ALBleUowWlhoMGRYSmxjeUk2ZXlKVFMwbE9JanA3SW5WeWJDSTZJbWgwZEhBNkx5OTBaWGgwZFhKbGN5NXRhVzVsWTNKaFpuUXVibVYwTDNSbGVIUjFjbVV2TldRMll6WmxaR0U1TkRKbU4yWTFaamN4WXpNeE5qRmpOek13Tm1ZMFlXVmtNekEzWkRneU9EazFaamxrTW1Jd04yRmlORFV5TlRjeE9HVmtZelVpZlgxOXgAeA== # (base64)
    locations: {} # Lista de coordenadas donde están las cabezas
    sound: BLOCK_NOTE_BLOCK_PLING # Sonido específico para esta colección al acercarse
    particle: FLAME #particula cuando no a encontrado la cabeza
    reward: # Recompensas al completar la colección
      message: # Mensajes que se muestran al jugador
        - §a¡Felicidades {player}! Has completado la colección recompensas.
      title: # Mensaje en título
        title: ¡Colección Completada!
        subtitle: Has encontrado todas las cabezas.
      commands: # Comandos que se ejecutan automáticamente al completar
        - give {player} diamond 1
        - say {player} ha recibido su recompensa por completar la colección

  '2': # Otra colección
    item: rO0ABXNyABpvcmcuYnVra2l0LnV0aWwuaW8uV3JhcHBlcvJQR+zxEm8FAgABTAADbWFwdAAPTGphdmEvdXRpbC9NYXA7eHBzcgA1Y29tLmdvb2dsZS5jb21tb24uY29sbGVjdC5JbW11dGFibGVNYXAkU2VyaWFsaXplZEZvcm0AAAAAAAAAAAIAAkwABGtleXN0ABJMamF2YS9sYW5nL09iamVjdDtMAAZ2YWx1ZXNxAH4ABHhwdXIAE1tMamF2YS5sYW5nLk9iamVjdDuQzlifEHMpbAIAAHhwAAAABHQAAj09dAABdnQABHR5cGV0AARtZXRhdXEAfgAGAAAABHQAHm9yZy5idWtraXQuaW52ZW50b3J5Lkl0ZW1TdGFja3NyABFqYXZhLmxhbmcuSW50ZWdlchLioKT3gYc4AgABSQAFdmFsdWV4cgAQamF2YS5sYW5nLk51bWJlcoaslR0LlOCLAgAAeHAAAA9zdAALUExBWUVSX0hFQURzcQB+AABzcQB+AAN1cQB+AAYAAAAFcQB+AAh0AAltZXRhLXR5cGV0AAxkaXNwbGF5LW5hbWV0ABJQdWJsaWNCdWtraXRWYWx1ZXN0AAtza3VsbC1vd25lcnVxAH4ABgAAAAV0AAhJdGVtTWV0YXQABVNLVUxMdACOeyJ0ZXh0IjoiIiwiZXh0cmEiOlt7InRleHQiOiJJVEVNUyIsIm9iZnVzY2F0ZWQiOmZhbHNlLCJpdGFsaWMiOmZhbHNlLCJ1bmRlcmxpbmVkIjpmYWxzZSwic3RyaWtldGhyb3VnaCI6ZmFsc2UsImNvbG9yIjoiZ3JlZW4iLCJib2xkIjpmYWxzZX1dfXQAIHsKICAgICJ6aGVhZDp6aGVhZC1pdGVtIjogIjkwIgp9c3EAfgAAc3EAfgADdXEAfgAGAAAAA3EAfgAIdAAIdW5pcXVlSWR0AApwcm9wZXJ0aWVzdXEAfgAGAAAAA3QADVBsYXllclByb2ZpbGV0ACQ5Mjg2NDQ0NS01MWM1LTRjM2ItOTAzOS01MTdjOTkyN2QxYjRzcgATamF2YS51dGlsLkFycmF5TGlzdHiB0h2Zx2GdAwABSQAEc2l6ZXhwAAAAAXcEAAAAAXNyABdqYXZhLnV0aWwuTGlua2VkSGFzaE1hcDTATlwQbMD7AgABWgALYWNjZXNzT3JkZXJ4cgARamF2YS51dGlsLkhhc2hNYXAFB9rBwxZg0QMAAkYACmxvYWRGYWN0b3JJAAl0aHJlc2hvbGR4cD9AAAAAAAAMdwgAAAAQAAAAAnQABG5hbWV0AAh0ZXh0dXJlc3QABXZhbHVldACwZXlKMFpYaDBkWEpsY3lJNmV5SlRTMGxPSWpwN0luVnliQ0k2SW1oMGRIQTZMeTkwWlhoMGRYSmxjeTV0YVc1bFkzSmhablF1Ym1WMEwzUmxlSFIxY21Vdk5XSmtNR05tT0RjME9EazJZelE1TXpnd016QXlaR0pqWVRBMVlUWTFNMlJoTWprNU16aGxZbU5tTkdVMVpUQTBNRGN6WmpWak9UazJNbUZrTTJVaWZYMTl4AHg= # (base64)
    locations: {}
    sound: BLOCK_NOTE_BLOCK_PLING
    particle: SOUL_FIRE_FLAME #particula cuando no a encontrado la cabeza
    reward:
      message:
        - §a¡Felicidades {player}! Has completado la colección recompensas.
      title:
        title: ¡Colección Completada!
        subtitle: Has encontrado todas las cabezas.
      commands:
        - give {player} diamond 1
        - say {player} ha recibido su recompensa por completar la colección

# ===============================
# MENSAJES Y SONIDOS GLOBALES
# ===============================
global_messages:
  already_found: # Mensaje al intentar recolectar una cabeza ya encontrada
    - §c¡Ya encontraste esta cabeza, {player}!
  completed: # Mensaje al completar cualquier colección
    - §6¡Colección completada!
  already_completed: # Mensaje al interactuar con una colección ya completada
    - §aYa completaste esta colección.

global_sounds:
  found_sound: ENTITY_PLAYER_LEVELUP # Sonido al encontrar una cabeza nueva
  completed_sound: ENTITY_FIREWORK_ROCKET_LAUNCH # Sonido al completar colección
  already_found_sound: ENTITY_VILLAGER_NO # Sonido al clickear una cabeza ya encontrada
  already_completed_sound: ENTITY_VILLAGER_AMBIENT # Sonido al clickear una colección completada

# ===============================
# PROGRESO DE LAS COLECCIONES
# ===============================
progress_display:
  type: # Lugares donde mostrar progreso
    - actionbar
    - chat
    - title
  formats:
    actionbar: '§aProgreso de {type}: §f{found}/{total}'
    # {type} = nombre de la colección
    # {found} = cabezas encontradas
    # {total} = total de cabezas en la colección
    chat: # Mensajes detallados por línea
      - '§eProgreso de {type}:'
      - '§fEncontradas: {found}/{total}'
      - §a¡Sigue buscando las restantes!
    title:
      title: '§6✦ {type} §aProgreso: {found}/{total} ✦'
      subtitle: §b{progress_bar} # {progress_bar} = barra de progreso visual (opcional)

# ===============================
# ALERTA DE PROXIMIDAD A CABEZAS
# ===============================
proximity_alert:
  alert_distance: 20.0 # Distancia máxima en bloques para activar la alerta
  alert_sound: BLOCK_NOTE_BLOCK_PLING # Sonido por defecto si la colección no tiene uno definido
  actionbar_enabled: true # Mostrar mensaje en ActionBar
  actionbar_message: '§aCabeza cercana de colección §f{type} §a: {distance} bloques'
  # {type} = colección, {distance} = bloques al jugador
  sound_interval: 20 # Intervalo en ticks entre sonidos (20 ticks = 1 segundo)

  # ---------------------------
  # Opciones de BossBar
  # ---------------------------
  bossbar_enabled: true # Activar BossBar para mostrar proximidad
  bossbar_style: SOLID # Estilo de BossBar: SOLID, SEGMENTED_6, SEGMENTED_10, etc.
  bossbar_color: GREEN # Color de BossBar por defecto (RED, BLUE, GREEN, YELLOW, etc.)

  # ---------------------------
  # Ajuste de sonido según distancia
  # ---------------------------
  min_sound_pitch: 0.5 # Pitch mínimo cuando estás lejos
  max_sound_pitch: 2.0 # Pitch máximo cuando estás muy cerca
  min_sound_volume: 0.3 # Volumen mínimo cuando estás lejos
  max_sound_volume: 1.0 # Volumen máximo cuando estás muy cerca


 
Funciones Clave

  • Colecciones Personalizadas
  • Ubicaciones Múltiples
  • Reemplazo Automático
  • GUI Intuitiva
  • Teletransporte Seguro
  • Recompensas Completas
  • Alertas de Proximidad
  • Sistema de Progreso

️ GUI (Interfaz Gráfica)

La interfaz de administración permite:

  • Cambiar el item de la colección
  • Gestionar ubicaciones en el mundo
  • Configurar partículas y sonidos
  • Configurar recompensas (mensajes, títulos, comandos)
  • Ver estadísticas de la colección
  • Navegar entre menús fácilmente
  • Volver al menú principal o cerrar inventario

Ejemplo de Flujo de Uso

Paso 1: Crear Colección
Code (Text):

Admin: /qsheads save dragon
(con una cabeza de dragón en la mano)
 
Paso 2: Configurar Colección
Code (Text):

Admin: /qsheads gui
- Selecciona la colección "dragon"
- Configura sonidos, partículas y recompensas
- Guarda cambios
 
Paso 3: Agregar Ubicaciones
Code (Text):

Admin: Coloca bloques de cabeza en ubicaciones específicas
Admin: /qsheads list dragon
(Las ubicaciones se registran automáticamente)
 
Paso 4: Jugadores Buscan
Code (Text):

Jugador: Explora el mundo y busca las cabezas
Jugador: Al acercarse, escucha sonidos y ve partículas
Jugador: Al clickear la cabeza, la colecciona
 
Paso 5: Recompensa Final
Code (Text):

Al encontrar todas las cabezas:
- Recibe mensajes de celebración
- Ve un título grande
- Se ejecutan comandos (recompensas)
- Recibe dinero (si está configurado)
 
Notas Técnicas

  • Cabezas con Skin Personalizada: Base64 de propiedades NBT de Minecraft
  • Estructura de Colecciones: Cada colección representa una categoría de búsqueda
  • Recomendaciones de Uso: /qsheads save, /qsheads gui, configurar sonidos y partículas
  • Compatibilidad: Spigot 1.16.5+, Paper 1.17+, compatible con Vault
  • Almacenamiento de Datos: plugins/QsHeads/data/players.yml y config.yml

Solución de Problemas

Las cabezas no aparecen en el mundo
  • Verifica que las ubicaciones están correctamente guardadas: /qsheads list <colección>
  • Comprueba que los chunks estén cargados
  • Reinicia el plugin: /qsheads reload

Los sonidos no se escuchan
  • Verifica que los sonidos están disponibles en tu versión de Minecraft
  • Comprueba el volumen de sonido del jugador
  • Verifica la configuración de alert_distance

El progreso no se guarda
  • Comprueba los permisos del servidor sobre la carpeta plugins/QsHeads/
  • Verifica que hay espacio en disco
  • Revisa los logs del servidor

Contacto y Soporte

Para reportar bugs, sugerir mejoras o pedir soporte, únete a mi servidor de Discord:
Haz clic aquí para unirte


Última actualización: Diciembre 2025
Versión del Plugin: 1.0+
View on SpigotMC
Resource Information
Author:
----------
Total Downloads: 2
First Release: Yesterday at 6:08 PM
Last Update: Yesterday at 6:08 PM
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings