=============================================
  SLEEP REWORKER - Datapack para Minecraft
  Version: 1.2.0
  Compatible: Java Edition 26.1+ (pack format 101)
=============================================

=== NOVEDADES EN v1.2.0 ===

[SUEÑOS PLACENTEROS]
- Ahora tienes un 20% de probabilidad de tener un sueño placentero cada noche
- Al despertar de un sueño placentero recibes: Velocidad, Salto, Saciedad y Regeneracion
- Aparece un titulo dorado en pantalla: "Sueño Placentero"

[LOGROS]
- Se añadio un nuevo tab de logros "Sleep Reworker" en la pantalla de avances
- Las Sombras te Encontraron — sobrevive tu primera pesadilla
- Inmune al Miedo — sobrevive 10 pesadillas en total
- Sueños Dorados — ten tu primer sueño placentero
- Durmiente Tranquilo — duerme 7 noches seguidas sin pesadillas

[CORRECCIONES]
- Los nombres de los monstruos de pesadilla ahora se muestran correctamente con sus colores
- Solucionado un fallo que podia corromper el estado de un jugador si dormia durante un /reload

=== INSTALACION ===

1. Copia la carpeta "SleepReworker" (o el .zip) en:
   [tu_mundo]/datapacks/

2. En el juego:
   /reload
   Deberias ver: [Sleep Reworker] Cargado correctamente.

=== CARACTERISTICAS ===

[ANIMACION DE SUEÑO]
- Al acostarse: efecto de "ojos cerrándose" (darkness effect)
- Partículas de sueño flotantes en fases ciclicas (end_rod, enchant, warped_spore, etc.)
- Textos "Zzz" que flotan hacia arriba usando text_display entities con interpolacion
- Sonidos ambientales al acostarse (notas de arpa y campana)

[DESPERTAR NORMAL]
- Breve efecto de "ojos abriendose" (night_vision sutil)
- Regeneracion al despertar
- Particulas y sonido suave de despertar

[SISTEMA DE PESADILLAS]
- 25% de probabilidad de tener pesadilla cada noche
- 4 tipos de pesadillas:
    Tipo 1 (30%): Phantoms - 3 "Sombras Nocturnas" sobrevuelan al jugador
    Tipo 2 (30%): Arañas - 4+1 arañas rodean al jugador
    Tipo 3 (20%): Creepers - 2 cargados + 1 normal
    Tipo 4 (20%): Husks - 3 husks + 1 zombie
- Durante la pesadilla: particulas oscuras (humo, ceniza, crimson_spore, soul_fire_flame)
- Pulsos de darkness y sonidos de phantoms/cueva mientras duerme
- Al despertar: blindness breve, nausea, slowness, weakness + titulo dramatico
- Monstruos spawnan con PersistenceRequired (no despawnean naturalmente)

=== COMPATIBILIDAD GEYSER MC ===

La MECANICA del datapack funciona completamente para jugadores Bedrock via Geyser:
  - Todos los efectos de estado (darkness, nausea, etc.) aplican igual
  - Los monstruos de pesadilla spawnan igual
  - Las particulas son compatibles cross-platform
  - Los scoreboards y tags funcionan igual server-side

LO QUE NO FUNCIONA para jugadores Bedrock:
  - Las entidades text_display (ZZZ flotantes) NO se renderizan en Bedrock Edition
    -> Los jugadores Java ven los "Zzz" pero los Bedrock no
    -> Todo lo demas funciona perfectamente
  - Efectos de overlay de resource pack personalizados (si se añaden en el futuro)

=== AJUSTE DE PROBABILIDAD DE PESADILLAS ===

Para cambiar la probabilidad de pesadilla (default: 25%):
Edita la linea en data/sleep_reworker/function/sleep/on_sleep.mcfunction:
  "execute if score @s sr_roll matches 1..25"
  Cambia 25 por el numero deseado (1-100).
  Ejemplo: 1..50 = 50%, 1..10 = 10%, 0 = nunca

=== COMANDOS UTILES ===

Recargar el datapack:
  /reload

Forzar pesadilla en ti mismo:
  /tag @s add sr.nightmare

Quitar todos los efectos del datapack:
  /tag @s remove sr.sleeping
  /tag @s remove sr.nightmare
  /effect clear @s

=== NOTAS TECNICAS ===

- Usa advancement "slept_in_bed" para detectar entrada a cama (se revoca y re-otorga automaticamente)
- Deteccion de despertar via NBT: unless entity @s[nbt={Sleeping:1b}]
- Grace period de 30 ticks evita falsos positivos de deteccion
- ZZZ entities tienen lifetime de 100 ticks (5 segundos), luego se eliminan automaticamente
- Todos los monstruos de pesadilla tienen PersistenceRequired para que no despawneen

=== CREDITOS ===

Desarrollado para Minecraft Java Edition 26.1+
