Subtitle+

🎬 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

* 🎨 Configurable: Fondos, barras de colores, difuminados y cajas de texto temáticas. * 🏃‍♂️ Configurable: Haz que tus textos aparezcan rebotando, deslizándose, con zoom o desvaneciéndose. * 🌈 Configurable: Texto arcoíris, máquina de escribir, temblor, neón, olas y más. * 📏 Configurable: Cambia colores, tamaños y añade iconos (corazones, calaveras, etc.) en la misma línea de texto. * 🗣️ Configurable: 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 Subtí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!

* 🎨 Iconos Especiales: Enciérralos entre `#`. Puedes usar nombres o códigos HEX. * *Ejemplo:* `#red#¡Hola!#` o `#electric_blue#Texto#` o `##FF0000#Rojo#` * 📏 Iconos Especiales: 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.` * ↩️ Iconos Especiales: 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. * `rainbow`: 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!*