🎬 Luxfiro Subtitles (Roleplay & Cinematic Text Mod)

¡Lleva la inmersión de tu servidor, mapa de aventuras o serie de Roleplay al siguiente nivel! Luxfiro Subtitles es un mod de interfaz (GUI) que te permite mostrar subtítulos, diálogos y anuncios en pantalla con un nivel de personalización masivo.

Desde textos cinematográficos, estilos de juegos clásicos (como Undertale), hasta anuncios gigantes de estilo Roleplay (Eufonía) con animaciones, colores, tamaños personalizados e incluso soporte para Text-To-Speech (TTS) integrado.

---

✨ Características Principales

• 🎨 Múltiples Estilos Visuales: Fondos, barras de colores, difuminados y cajas de texto temáticas.
• 🏃‍♂️ Animaciones de Entrada: Haz que tus textos aparezcan rebotando, deslizándose, con zoom o desvaneciéndose.
• ✨ Efectos de Texto Constantes: Texto arcoíris, máquina de escribir, temblor, neón, olas y más.
• 📏 Sintaxis Avanzada: Cambia colores, tamaños y añade iconos (corazones, calaveras, etc.) en la misma línea de texto.
• 🗣️ Text-To-Speech (Voz): Haz que el juego lea los diálogos en voz alta usando el motor TTS de tu sistema.
• ⚙️ Configurable: Archivo subtitle_colors.json para agregar y modificar todos los códigos de colores hexadecimales.

---

💻 Comandos del Mod

Todos los comandos requieren permisos de administrador (Nivel 2) o ejecutarse desde bloques de comandos / consola.

1. Comando Básico sin voz (/st)

Muestra un subtítulo a los jugadores elegidos sin narración de voz. /st <jugadores> <duración_segundos> <posición> <estilo> <anim_entrada> <anim_texto> <texto_infinito>

2. Comando con Voz TTS (/tts)

Hace exactamente lo mismo que /st, pero el sistema operativo leerá el texto en voz alta a los jugadores. /tts <jugadores> <duración_segundos> <posición> <estilo> <anim_entrada> <anim_texto> <texto_infinito>

3. Comando Especial Roleplay (/euf)

Diseñado para anuncios de servidor. Divide automáticamente el texto en un Título y un Subtítulo. (Nota: Los textos aquí deben ir obligatoriamente entre comillas ""). /euf <jugadores> <duración> <posición> <estilo> <anim_entrada> <anim_texto> "<Título>" "<Subtítulo>"

---

🛠️ Sintaxis de Texto Mágica (¡Personaliza todo!)

¡Puedes mezclar diferentes tamaños, colores y símbolos dentro del mismo comando!

• 🎨 Colores: Enciérralos entre #. Puedes usar nombres o códigos HEX.
  • Ejemplo: #red#¡Hola!# o #electric_blue#Texto# o ##FF0000#Rojo#
• 📏 Tamaños (Escala): Usa la etiqueta [s:X.X] para hacer el texto más grande o pequeño.
  • Ejemplo: [s:2.0]Texto Gigante [s:1.0]Texto normal.
• ↩️ Saltos de Línea: Usa un punto y coma ; para pasar a la siguiente línea.
  • Ejemplo: Línea 1;Línea 2;Línea 3
• 🌟 Iconos Especiales: Escribe estas etiquetas para mostrar símbolos:
  • [heart] = ❤ | [sword] = ⚔ | [star] = ★
  • [skull] = ☠ | [music] = ♫ | [warn] = ⚠
  • [sun] = ☀ | [moon] = ☾ | [king] = ♔

---

📋 Lista de Argumentos Disponibles

Al escribir los comandos, el autocompletado del tabulador te sugerirá estas opciones:

📍 Posiciones (position)

bottom (Abajo), center (Centro), top (Arriba), top_left, top_right, bottom_left, bottom_right, center_left, center_right.

🖼️ Estilos Visuales (style)

• default: Texto simple con sombra delineada.
• eufonia: Caja oscura clásica centrada.
• euf: Caja oscura con barra de color lateral aqua, alineado a la izquierda.
• undertale: Caja negra con bordes blancos gruesos.
• narrator / warning: Cajas con tonos más oscuros o rojizos.
• cinematic: Añade franjas negras cinematográficas gigantes arriba y abajo de la pantalla.
• fade_box: Fondo degradado suave.
• minecraft: Estilo clásico de tooltip del juego (bordes violetas).
• left: Degradado que se desvanece de izquierda a derecha.

🎬 Animaciones de Entrada (entry_animation)

none (Ninguna), fade (Aparecer suavemente), slide_up, slide_down, slide_left, slide_right, zoom_in (Crecer desde el centro), bounce (Rebote), expand, flip.

✨ Animaciones de Texto (text_animation)

• none: Normal.
• typewriter: Escribe letra por letra automáticamente.
• wave: Las letras saltan en forma de ola.
• shake: Temblores constantes (Ideal para gritos).
• wobble: Movimiento circular mareante.
• ✨: Cambia de color por todo el espectro RGB.
• neon: Parpadeos aleatorios.
• pulse: Todo el texto palpita.
• ghost: Se desvanece de forma espectral.

---

📝 Ejemplos de uso para probar ahora mismo:

1. Diálogo de Jefe (Estilo Undertale con máquina de escribir): /st @a 5 bottom undertale fade typewriter "#red#Te estaba esperando...;[skull] Prepárate.#"

2. Anuncio Global de Servidor (Estilo EUF Roleplay): /euf @a 7 center euf bounce none "[s:2.0]#aqua#REINICIO GLOBAL#" "[s:1.2]#white#El servidor se reiniciará en 5 minutos. Guarden sus cosas.#"

3. Título Cinematográfico Gigante (Con colores y escala): /st @a 6 center cinematic zoom_in wave "[s:3.0]#gold#CAPÍTULO 1#;[s:1.5]#white#El Comienzo#"

---

Si encuentras algún bug o tienes sugerencias, no dudes en reportarlo en el issue tracker. ¡Disfruta creando escenas épicas!