Configuración de ItemFinder

ItemFinder es altamente personalizable a través de su archivo de configuración principal config.yml

A continuación, desglosamos todas las secciones del archivo de configuración para que puedas adaptar el plugin exactamente a las necesidades de tu servidor.

Idiomas y Ajustes Básicos

lang: es # Idioma del plugin (es/en).
difficulty: easy # Dificultad por defecto del juego.

Al instalar el plugin por primera vez, el idioma predeterminado es el inglés (en). Puedes cambiarlo a español estableciendo lang: es o usando el comando /itemfinder lang es en el juego. La difficulty define qué nivel se seleccionará automáticamente si inicias el juego sin especificar una dificultad (ej. si solo usas /itemfinder start).

Selección de Ítems (Aleatoria vs. Dificultades)

El corazón de ItemFinder es cómo decide qué ítems deben buscar los jugadores. Tienes dos enfoques:

difficulties: false # true = usa los items de 'levels' en vez de la clasificación automática aleatoria.

1. Sistema Aleatorio (Por defecto)

Si difficulties: false, ItemFinder ignora las listas predefinidas y selecciona ítems completamente al azar del catálogo del juego para que los jugadores los busquen. Este modo asegura que ninguna partida sea igual a la anterior.

Para evitar que el sistema asigne bloques imposibles de conseguir en supervivencia (como Bedrock o Bloques de Comandos), existe la lista negra:

ban-items:
  - bedrock
  - barrier
  - end_portal_frame
  # ...

2. Sistema por Niveles de Dificultad

Si cambias difficulties: true, el plugin usará la sección levels. Aquí puedes definir listas exactas de ítems para cada dificultad (easy, medium, hard).

levels:
  easy:
    display-name: "Fácil"
    items:
      - OAK_LOG
      - COBBLESTONE
  medium:
    display-name: "Media"
    items:
      - IRON_INGOT
      - DIAMOND

Asegúrate de usar los nombres oficiales de los materiales en mayúsculas (ej. DIAMOND).

Límite de Tiempo (Timer)

Puedes hacer que la partida tenga una duración específica. Cuando el tiempo expira, el jugador que haya encontrado más ítems es declarado ganador.

timer: false
time: 1h # Formatos válidos: 1h, 2m, 120s

• Si timer: false, la partida durará hasta que alguien la detenga manualmente con /itemfinder stop.
• Si timer: true, se iniciará una cuenta atrás. Puedes usar formatos amigables como 1h (1 hora), 30m (30 minutos) o 120s (120 segundos).

Escaneo de Inventarios

check-inventory: false
check-crafted-items: true

• check-inventory: Si se activa (true), si un jugador ya tiene en su inventario el ítem que se pide al empezar la partida, se le contará como encontrado inmediatamente.
• check-crafted-items: Si se activa (true), fabricar el ítem en una mesa de crafteo contará como haberlo “encontrado”.

Recompensas (Rewards)

Puedes ejecutar comandos desde la consola para premiar a los jugadores. Usa {player} para sustituirlo por el nombre del jugador en el comando.

reward-commands:
  - "give {player} diamond 1"

reward-commands-most:
  - "give {player} netherite_ingot 1"

• reward-commands: Comandos que se ejecutan inmediatamente cada vez que un jugador encuentra uno de los ítems de la lista.
• reward-commands-most: Comandos que se ejecutan al finalizar el minijuego, entregados únicamente al ganador general de la partida.

Desempates (Tiebreakers)

Si el tiempo límite acaba y dos o más jugadores tienen la misma cantidad de ítems encontrados, ItemFinder puede iniciar una ronda súbita de desempate.

tiebreaker: true
tiebreaker-time: 3m

En el desempate, el sistema pedirá un último ítem específico. El primero en encontrarlo gana. Si el tiebreaker-time expira sin que nadie lo encuentre, todos los empatados reciben el premio final (reward-commands-most). También ganará automáticamente el último jugador conectado si sus rivales abandonan el servidor.

Interfaz y Experiencia (Scoreboard y Sonidos)

ItemFinder incluye opciones para personalizar la experiencia visual y auditiva.

Sonidos

sounds:
  found_item: "entity.player.levelup"
  countdown_tick: "block.note_block.hat"

Puedes modificar todos los efectos de sonido (inicio, término, cuenta atrás, al encontrar ítems) usando los nombres internos de sonido de Minecraft.

Scoreboard

El marcador lateral (Scoreboard) muestra el progreso en tiempo real de la partida.

scoreboard:
  title: "&e&lItemFinder"
  player_format: "&b{player} &7- &e{found}"
  footer_timer: "&bTiempo: &f{time}"

Soporta códigos de color (con &) y variables como {player}, {found} (ítems encontrados) y {time} (tiempo restante).

Mundos Permitidos

allowed-worlds:
  - world
  #- world_nether

Define en qué dimensiones/mundos el plugin rastreará el progreso de los jugadores. Por defecto, solo funciona en el mundo normal (world). Si deseas que funcione en el Nether o el End, simplemente borra el # para descomentarlos.