Описание
# 🎬 Luxfiro Subtitles (Roleplay, Cinematic & Dialog Mod)
¡Lleva la inmersión de tu servidor, mapa de aventuras o serie de Roleplay a un nivel que nunca creíste posible en Minecraft! **Luxfiro Subtitles** es un mod avanzado de interfaz (GUI) que te permite mostrar diálogos, escenas cinemáticas y anuncios en pantalla con un nivel de personalización masivo.
Desde textos estilo RPG o novela visual (como Undertale) con retratos de personajes, hasta anuncios gigantes con animaciones, soporte para **Text-To-Speech (TTS)** y **Traducción automática en tiempo real**.
---
## ✨ Características Principales
* 🌍 **Traducción Automática en Tiempo Real:** Ideal para servidores internacionales. El mod detecta automáticamente el idioma del juego de cada jugador y traduce el texto en tiempo real usando Google Translate. ¡Si escribes en español, un jugador inglés lo leerá en inglés al instante, sin lag en el servidor!
* 🖼️ **Imágenes y Retratos 3D Dinámicos:** Carga archivos `.png` o `.jpg` directamente desde tu PC (carpeta `config`) para usarlos como fondos o rostros. ¡Si el archivo empieza con la palabra "skin" (ej. `skinSteve.png`), el mod aísla automáticamente la cabeza de la skin, extrae la capa 3D (pelo/casco) y la dibuja perfectamente escalada junto al texto!
* 🎞️ **Sistema de Secuencias (Cinemáticas):** Crea escenas enteras con múltiples diálogos que se reproducen uno tras otro usando un sistema interno de colas. ¡Dirige tu propia película sin tocar una línea de código!
* 🎨 **Múltiples Estilos Visuales:** Desde estilos retro como `undertale` o `rpg`, hasta temáticas modernas como `cyberpunk`, `hologram`, `neon`, `bubble` o estilo `cinematic` (con barras negras).
* 🏃♂️ **Animaciones de Entrada y Texto:** Haz que tus textos reboten, se escriban letra por letra (`typewriter`), parpadeen (`glitch`, `neon`), brillen (`glow`) o se muevan en olas.
* 📏 **Sintaxis Mágica:** Cambia colores, tamaños y añade iconos (corazones, calaveras, etc.) en la misma línea de texto. El traductor inteligente respetará tus colores.
* 🗣️ **Voces y Sonidos:** Haz que el juego lea los diálogos en voz alta (TTS usando el narrador de tu PC), emita pitidos retro, o reproduzca efectos de sonido nativos de Minecraft.
---
## ⚙️ Primeros Pasos (Instalación y Setup)
1. Inicia el servidor o tu juego con el mod instalado por primera vez.
2. Ve a la carpeta `config` de tu servidor (o en tu `.minecraft`). Verás que se ha creado una nueva carpeta llamada **`subtitle_images`**.
3. Arrastra ahí cualquier imagen `.png` o `.jpg` que quieras usar de fondo o retrato.
4. **Para usar skins de jugadores (cabezas 3D):** Asegúrate de que el nombre del archivo de la skin empiece por "skin" (Ejemplo: `skin_Rey.png` o `skinVillano.png`).
5. Escribe `/subtitle reload` dentro del juego ¡y listo para usar!
---
## 💻 Guía Completa de Comandos
*(Todos los comandos requieren permisos de administrador de Nivel 4 o ejecutarse desde bloques de comandos / consola).*
### 1. Comandos de Texto Rápido
Útiles para mensajes directos, alertas o subtítulos simples en pantalla.
* **`/sub`** (Texto normal): Muestra un subtítulo a los jugadores elegidos.
```mcfunction
/sub
Para una mejor guia recuerda unirte a nuestro servidor de discord. [NUESTRA COMUNIDAD](https://discord.gg/YREzvTNxFB)