Guía YAML rewards

Recompensas

Las recompensas se entregan automáticamente cuando un jugador completa todos los objetivos de un evento. Se definen en el bloque rewards de cada archivo de evento y soportan tres tipos: XP, ítems y comandos.

Tipos disponibles

Tipo	Descripción
`xp`	Otorga puntos de experiencia al jugador.
`item`	Entrega uno o varios ítems de Minecraft vanilla al inventario del jugador.
`command`	Ejecuta un comando desde consola con el nombre del jugador como variable.

XP

Otorga experiencia directamente al jugador. El valor es la cantidad exacta de puntos de XP, no niveles.

Ejemplo

rewards:
  xp: 500

Al recibir la recompensa, el jugador ve el mensaje §a+ 500 XP en el chat.

Ítems

Entrega una lista de ítems al inventario del jugador. El formato de cada ítem es "namespace:id cantidad". Si no se especifica cantidad, se entrega 1 unidad.

Ejemplos

rewards:
  items:
    - "minecraft:diamond 5"
    - "minecraft:golden_apple 1"
    - "minecraft:cooked_beef 32"
    - "minecraft:iron_sword"       # sin cantidad = 1 unidad

Inventario lleno: si el jugador no tiene espacio, los ítems que no caben se dropean en el suelo en su posición actual. No se pierden.

Comandos

Ejecuta uno o varios comandos desde la consola del servidor al completar el evento. El placeholder {player} se reemplaza automáticamente por el nombre del jugador.

Sintaxis

rewards:
  commands:
    - "comando {player} argumentos"

Los comandos se ejecutan con permisos de consola, no del jugador. Esto significa que puedes usar cualquier comando de cualquier plugin sin restricciones de permisos.

Ejemplos prácticos

EssentialsX — dar dinero

rewards:
  commands:
    - "eco give {player} 5000"

LuckPerms — dar rango temporalmente

rewards:
  commands:
    - "lp user {player} parent addtemp vip 7d"

Vanilla — dar ítem con NBT o encantamiento

rewards:
  commands:
    - "give {player} minecraft:diamond_sword{Enchantments:[{id:sharpness,lvl:5}]} 1"

Múltiples comandos a la vez

rewards:
  commands:
    - "eco give {player} 1000"
    - "lp user {player} parent addtemp vip 30d"
    - "minecraft:title {player} title {\"text\":\"¡Misión completada!\",\"color\":\"gold\"}"

Combinar tipos

Los tres tipos se pueden combinar libremente en el mismo evento:

Recompensa completa con los tres tipos

rewards:
  xp: 1000
  items:
    - "minecraft:diamond 3"
    - "minecraft:enchanted_golden_apple 1"
    - "minecraft:experience_bottle 16"
  commands:
    - "eco give {player} 2500"
    - "lp user {player} parent addtemp elite 14d"

Eventos sin recompensa

El bloque rewards es completamente opcional. Si no lo incluyes, el evento se completa normalmente sin entregar nada. El jugador verá el mensaje de completado pero no recibirá ítems ni XP.

Evento sin recompensa

id: "tutorial-bienvenida"
displayName: "Bienvenida"
description: "Completa el tutorial inicial."

objectives:
  - id: "hablar-aldeano"
    type: INTERACT
    description: "Habla con el aldeano de bienvenida"
    parameters:
      target_type: "entity"
      target_id: "minecraft:villager"
      target_amount: 1

# Sin bloque rewards — evento de progresión pura

Mensajes al recibir recompensas

Al completar un evento con recompensas, el jugador recibe automáticamente estos mensajes en el chat:

Mensajes generados automáticamente

# Por cada punto de XP:
§a+ 1000 XP

# Por cada ítem:
§a+ 3x diamond

# Por cada ítem de mods entregado vía comando:
# (depende del plugin externo)

# Al final, resumen:
§6✓ ¡Recibiste 3 recompensa(s)!

Los mensajes de completado del evento (§6[EventUI] ¡Evento completado: nombre!) y los mensajes de recompensa son independientes. Ambos se muestran siempre — actualmente no hay forma de desactivar los mensajes de recompensa individualmente desde el YAML.