Easy Subtitle is a Minecraft mod that adds synchronized subtitles and audio playback, allowing you to display timed dialogue, character lines, lyrics, and other text directly on the screen.

Designed for map makers, server developers, content creators, and Minecraft players who want to create immersive experiences, Easy Subtitle is perfect for cinematic scenes, story-driven adventures, character dialogue, music performances, and interactive events.

• Synchronized Subtitles: Display text at specific timestamps, synchronized with an audio file.

• Built-in Audio Playback: Play OGG audio files alongside your subtitles.

• Multiple Subtitle Formats: Supports custom .lrc and .json subtitle files. The .lrc format is recommended.

• Character Names: Display speaker names alongside subtitle lines.

• Custom Colors: Customize subtitle text and character name colors using predefined colors or hexadecimal color codes.

• Fade Effects: Enable gradual subtitle appearance and disappearance.

• Typewriter Effect: Display text one character at a time, with adjustable typing speed.

• Loop Playback: Repeat audio and subtitles until playback is stopped.

• Subtitle Positioning: Move subtitles on the screen using a configurable keybind.

• Playback Controls: Start, stop, reload, and seek through subtitle playback.

• Flexible Timing: Run subtitles using an internal clock when no audio file is provided.

When you launch Minecraft, Easy Subtitle automatically creates a folder named SubsSounds inside your .minecraft directory.

Inside this folder, create a separate folder for each subtitle track. Each track can contain an audio file named sound.ogg and a subtitle file named sub.lrc or sub.json.

If both subtitle files exist in the same folder, sub.json takes priority.

Once your files are ready, use the mod's commands to start playback for the desired players.

Commands

Play subtitles

/subtitulo play (user or @) (name)

Starts the selected subtitle track for the specified player or target selector.

Stop subtitles

/subtitulo stop (user or @) (name)

Stops the selected subtitle track.

Reload subtitles

/subtitulo reload

Reloads subtitle data so you can test changes to your files.

Seek to a specific time

/subtitulo seek (user or @) (name) (time)

Moves subtitle playback to a specific point in the track.

Setting Up Custom Subtitles
[EN]

1. Create a Subtitle Folder

Launch Minecraft at least once to generate the SubsSounds folder.

Open your .minecraft directory and navigate to SubsSounds.

Create a new folder for your subtitle track. Use a lowercase folder name to avoid naming issues.

For servers, each player must have their own copy of each subtitle folder.

2. Add Your Audio File

Place the audio you want to play inside the new folder and name it:

sound.ogg

Your audio must be in OGG format. You can convert an existing audio file using an online audio converter or export it as an OGG file from your audio editing software.

3. Create Your Subtitle File

Create a text file named:

sub.lrc

You can edit this file using Notepad, Visual Studio Code, or any other text editor.

This file contains your subtitle timestamps, text, speaker names, colors, and animation settings.

Your folder structure should look like this:

.minecraft/
└── SubsSounds/
└── mysubtitle/
├── sound.ogg
└── sub.lrc

Replace mysubtitle with your chosen folder name.

Subtitle Configuration

At the beginning of your sub.lrc file, you can configure the following options.

Fade Effect

fade = true

Set this to false to disable the fade effect.

Typewriter Effect

letra_por_letra = true

Set this to false to disable the effect that displays text one character at a time.

To adjust the typing speed, use:

velocidad = 30

Change the value to adjust the typing speed.

Loop Playback

bucle = true

Set this to true to repeat the audio and subtitles continuously.

Set it to false to play the track only once. When looping is enabled, playback continues until it is stopped manually.

Volume

volumen = 1.0

This option controls the audio playback volume. A value of 1.0 represents the default volume level.

Text Colors

To change the subtitle text color, use:

color = blanco

To change the speaker name color, use:

color_nombre = amarillo

Easy Subtitle supports these predefined colors:

• blanco

• gris

• gris_oscuro

• negro

• rojo

• rojo_oscuro

• naranja

• dorado

• amarillo

• verde

• verde_oscuro

• celeste

• cian

• azul

• azul_oscuro

• morado

• magenta

• rosa

You can also use hexadecimal color codes to choose a custom color.

Example:

color = #FF8800

Complete Configuration Example

fade = false
letra_por_letra = false
velocidad = 30
bucle = false
volumen = 1.0
color = blanco
color_nombre = blanco

You can modify these settings according to your preferences.

Subtitle Synchronization

After configuring your options, add your subtitle lines below the settings.

Each line can contain a timestamp, an optional speaker name, and the text you want to display.

The timestamp determines when the subtitle appears during playback.

Understanding Timestamps

Easy Subtitle supports timestamp formats such as:

[00:07.27]

[00:02.00]

[01:00.00]

The common timestamp format is:

[minutes.centiseconds]

For example, [00:07.27] represents 7.27 seconds, while [01:04.00] represents 1 minute and 4 seconds.

The mod also supports other timestamp formats depending on the duration and precision required. For example, [00:02:00] represents 2 minutes.

Adding Subtitle Text

You can optionally include the speaker's name before the subtitle text.

Example:

[00:10.00] [Narrator] Wait, let me check.

[00:15.00] [Narrator] It's right here.

If you do not want to display a speaker name, write the text directly after the timestamp.

Example:

[00:10.00] Wait, let me check.

Both formats are supported:

• [minutes.centiseconds] Text

• [minutes.centiseconds] [Name] Text

Empty Subtitle Lines

A timestamp without text will not display a subtitle at that moment. This can be useful for creating pauses between dialogue lines.

Example:

[00:10.00] [Narrator] Wait, let me check.

[00:12.00]

[00:15.00] [Narrator] It's right here.

Testing Your Subtitles

Once your files are ready, launch Minecraft and use the mod's commands to test your subtitle track.

You can edit your subtitle file and reload it to test different timings, text, colors, and configuration options.

This makes it easier to fine-tune your subtitles without having to prepare the entire sequence perfectly before testing it.

Using Existing LRC Files

You can use existing .lrc lyric files instead of manually creating every timestamp. This is particularly useful for songs, since many lyric websites provide files with synchronized lyrics.

For example, you can look for timestamped lyrics on websites such as Lyricsify.

Easy Subtitle ignores metadata tags such as [ar:...] and [ti:...], as well as word-level timestamps such as <00:10.50>.

This allows you to reuse compatible LRC files and adapt them for your Minecraft projects.

Additional Resources

That's everything you need to get started with Easy Subtitle!

If you prefer a visual guide, check out the tutorial videos explaining how to set up and use the mod.

Have fun creating your own synchronized dialogue, cinematic scenes, and musical experiences in Minecraft!

[ES]

Configuración de subtítulos personalizados

Cuando inicies Minecraft, Easy Subtitle creará automáticamente una carpeta llamada SubsSounds dentro del directorio .minecraft.

1. Crear la carpeta de subtítulos

Dentro de SubsSounds, crea una carpeta para cada pista de subtítulos que quieras utilizar. El nombre de la carpeta debe estar escrito en minúsculas.

Dentro de esa carpeta, agrega el archivo de audio que quieras reproducir y nómbralo:

sound.ogg

Puedes convertir tu audio al formato OGG utilizando cualquier convertidor de audio en línea o exportarlo directamente como un archivo .ogg desde tu programa de edición de audio.

A continuación, crea un archivo llamado sub.lrc en la misma carpeta. Puedes editarlo con el Bloc de notas, Visual Studio Code o cualquier otro editor de texto.

En este archivo configurarás los subtítulos, las animaciones, los colores y la sincronización.

La estructura de las carpetas debería verse así:

.minecraft/
└── SubsSounds/
    └── missubtitulos/
        ├── sound.ogg
        └── sub.lrc

Reemplaza missubtitulos por el nombre que quieras utilizar para tu pista de subtítulos.

2. Configuración de los subtítulos

Al principio de tu archivo sub.lrc, puedes configurar las siguientes opciones.

Animaciones

Efecto de desvanecimiento

fade = true

Cambia el valor a false si no quieres utilizar el efecto de desvanecimiento.

Efecto de escritura letra por letra

letra_por_letra = true

Cambia el valor a false para desactivar este efecto, que muestra el texto un carácter a la vez.

Puedes ajustar la velocidad de escritura mediante la siguiente opción:

velocidad = 30

Modifica el valor para ajustar la velocidad del efecto letra por letra.

Reproducción en bucle

Para repetir continuamente el audio y los subtítulos, activa el bucle:

bucle = true

Cambia el valor a false si no quieres que la reproducción se repita. Cuando el bucle está activado, la reproducción continuará hasta que la detengas manualmente.

Volumen

Puedes ajustar el volumen del audio mediante la siguiente opción:

volumen = 1.0

Por ejemplo, 1.0 representa el nivel de volumen predeterminado. Puedes modificar este valor para ajustar el volumen de reproducción.

Colores del texto

Para cambiar el color del texto de los subtítulos, utiliza:

color = blanco

Para cambiar el color del nombre del personaje o de la persona que habla, utiliza:

color_nombre = amarillo

Easy Subtitle admite los siguientes colores predefinidos:

• blanco

• gris

• gris_oscuro

• negro

• rojo

• rojo_oscuro

• naranja

• dorado

• amarillo

• verde

• verde_oscuro

• celeste

• cian

• azul

• azul_oscuro

• morado

• magenta

• rosa

También puedes utilizar códigos de color hexadecimales para elegir un color personalizado. Por ejemplo:

color = #FF8800

Ejemplo de configuración completa

Este es un ejemplo de cómo podría quedar la configuración de tu archivo sub.lrc:

fade = false
letra_por_letra = false
velocidad = 30
bucle = false
volumen = 1.0
color = blanco
color_nombre = blanco

Puedes modificar estos valores según tus preferencias.

3. Sincronización de los subtítulos

Después de configurar las opciones, puedes agregar las líneas de tus subtítulos debajo de ellas.

Cada línea puede contener una marca de tiempo, un nombre opcional para quien habla y el texto que quieres mostrar.

La marca de tiempo determina cuándo aparecerá el subtítulo durante la reproducción del audio.

Cómo funcionan las marcas de tiempo

Easy Subtitle admite marcas de tiempo como las siguientes:

[00:07.27]
[00:02:00]
[01:00.00]

El formato habitual de las marcas de tiempo es:

[minutos:segundos.centésimas]

Por ejemplo:

• Los números antes de los dos puntos representan los minutos.

• Los números después de los dos puntos representan los segundos.

• Los números después del punto representan las centésimas de segundo.

Una marca de tiempo como [01:04.00] representa 1 minuto y 4 segundos.

Nota: Las marcas de tiempo pueden utilizar distintos formatos, dependiendo de la precisión y la duración necesarias. Por ejemplo, [00:07.27] representa 7,27 segundos, mientras que [00:02:00] representa 2 minutos.

Cómo agregar texto a los subtítulos

Puedes añadir opcionalmente el nombre de la persona que habla antes del texto del subtítulo. Esto resulta útil para diálogos, escenas narradas o situaciones en las que hablan varios personajes.

Por ejemplo:

[00:10.00] [Narrador] Espera, déjame revisar.
[00:15.00] [Narrador] Está justo aquí.

Si no quieres mostrar el nombre de quien habla, simplemente escribe el texto después de la marca de tiempo:

[00:10.00] Espera, déjame revisar.

Ambos formatos son compatibles:

• [minutos:segundos.centésimas] Texto

• [minutos:segundos.centésimas] [Nombre] Texto

Líneas de subtítulos vacías

Si una marca de tiempo no tiene texto después de ella, no se mostrará ningún subtítulo en ese momento. Esto puede ser útil para crear pausas entre las líneas de un diálogo.

Por ejemplo:

[00:10.00] [Narrador] Espera, déjame revisar.
[00:12.00]
[00:15.00] [Narrador] Está justo aquí.

En este ejemplo, la línea correspondiente al segundo 12 no contiene texto, por lo que no se mostrará ningún subtítulo en ese momento.

Cómo probar tus subtítulos

Una vez que tu archivo esté listo, puedes probar los subtítulos dentro del juego utilizando los comandos del mod.

También puedes modificar el archivo y volver a cargarlo para probar diferentes tiempos, textos y opciones de configuración.

De esta manera, podrás ajustar la sincronización y el aspecto de los subtítulos sin necesidad de preparar toda la secuencia a la perfección antes de probarla.

4. Uso de archivos LRC existentes

También puedes utilizar archivos de letras .lrc existentes en lugar de crear manualmente cada marca de tiempo. Esto resulta especialmente útil para las canciones, ya que muchas páginas de letras ofrecen archivos con los tiempos de cada línea ya incluidos.

Por ejemplo, puedes encontrar letras sincronizadas en páginas como Lyricsify.

Easy Subtitle ignora etiquetas de metadatos como [ar:...] y [ti:...], así como las marcas de tiempo por palabra, por ejemplo <00:10.50>.

Esto te permite reutilizar archivos LRC compatibles y adaptarlos a tus propios proyectos de Minecraft.

5. Recursos adicionales

¡Eso es todo lo que necesitas para comenzar a utilizar Easy Subtitle!

Si prefieres una guía visual, también contamos con videos tutoriales que explican cómo configurar y utilizar el mod. Puedes verlos si necesitas ayuda adicional.

¡Diviértete creando diálogos sincronizados, escenas cinematográficas y experiencias musicales dentro de Minecraft!