MiguelkiCore

EN:

MiguelkiCore is a mod that implements various (currently one) tools for mapmakers or event creators.

Requires ArchitecturyAPI

The subtitle system implemented in MiguelkiCoreMod is a complete solution for displaying custom-formatted text.

Demo video: https://streamable.com/eparkh

Subtitle Creation

• Subtitles are defined in JSON files located at config/miguelkicoremod/subtitles/

• Each file represents a full subtitle sequence that can be played with the command /subtitles run [user] [file_name] (without the .json extension)

• To stop subtitles: /subtitles clear [user]

JSON File Structure

• Global Configuration: Settings that apply to all subtitles
• Subtitle Entries: List of individual subtitles or pauses

Entry Types

• 1 Standard Subtitles: Display text on screen
  • Fields: text, duration, config (optional)

• 2 Pauses: Create a delay without showing text
  • Fields: pause (true), duration

Text Formatting and Colors

Supports two methods for formatting text:

• 1 Minecraft Codes: Using § followed by a code
  • Example: §cThis text is red §aThis text is green

• 2 Custom Tags: Using [color]text[/]
  • Example: [red]This text is red[/] [green]This text is green[/]
  • Allows line breaks within tags: [red]Line 1\nLine 2[/]

• 3 Available Colors:
  • Names: black, darkblue, red, green, blue, gold, aqua, etc.
  • Hex code: [#FF0000]This text is red[/]

Customization

Subtitles can be customized with various parameters:

• 1 Screen Position:
  • "position": "top" (top)
  • "position": "mid" (center)
  • "position": "bottom" (bottom)

• 2 Appearance:
  • "backgroundColor": Background color in RGBA format (e.g., "rgba(0, 0, 0, 0.5)")
  • "textColor": Default text color
  • "textScale": Text size (1.0 is normal)

• 3 Commands:
  • "runCommand": Executes a command when the subtitle appears

Multi-language Support

• Text can be defined for different languages
• The system automatically detects the client’s language
• Format:

"text": {
  "en_us": "Welcome to our server!",
  "es_es": "¡Bienvenido a nuestro servidor!",
  "default": "Welcome to our server!"
}

Disclaimer: This mod will attempt to connect to node1.miguelkinetwork.info in order fetch if the mod is on evaluation or not as well as enabling or disabling any upcoming Donator exclusive features.

ES:

MiguelkiCore es un mod que implementa diversas (actualmente una) herramientas para mapmakers o creadores de eventos.

Requiere ArchitecturyAPI

El sistema de subtítulos implementado en MiguelkiCoreMod es una solución completa para mostrar texto con formato custom.

Video de demostración: https://streamable.com/eparkh

Creación de Subtítulos

• Los subtítulos se definen en archivos JSON ubicados en config/miguelkicoremod/subtitles/

• Cada archivo representa una secuencia completa de subtítulos que puede reproducirse con el comando /subtitles run [usuario] [nombre_archivo] (sin la extensión .json)

• Para detener subtítulos: /subtitles clear [usuario]

Estructura del Archivo JSON

• Configuración Global: Ajustes que aplican a todos los subtítulos
• Entradas de Subtítulos: Lista de subtítulos individuales o pausas

Tipos de Entradas

• 1 Subtítulos Estándar: Muestran texto en pantalla
  • Campos: text, duration, config (opcional)

• 2 Pausas: Crean un retraso sin mostrar texto
  • Campos: pause (true), duration

Formato de Texto y Colores

Soporta dos métodos para dar formato al texto:

• 1 Códigos de Minecraft: Usando § seguido de un código
  • Ejemplo: §cEste texto es rojo §aEste texto es verde

• 2 Etiquetas Personalizadas: Usando [color]texto[/]
  • Ejemplo: [red]Este texto es rojo[/] [green]Este texto es verde[/]
  • Permite saltos de línea dentro de las etiquetas: [red]Línea 1\nLínea 2[/]

• 3 Colores Disponibles:
  • Nombres: black, darkblue, red, green, blue, gold, aqua, etc.
  • Código hexadecimal: [#FF0000]Este texto es rojo[/]

Personalización

Los subtítulos pueden personalizarse con diversos parámetros:

• 1 Posición en Pantalla:
  • "position": "top" (parte superior)
  • "position": "mid" (centro)
  • "position": "bottom" (parte inferior)

• 2 Apariencia:
  • "backgroundColor": Color de fondo en formato RGBA (ej. "rgba(0, 0, 0, 0.5)")
  • "textColor": Color del texto por defecto
  • "textScale": Tamaño del texto (1.0 es normal)

• 3 Comandos:
  • "runCommand": Ejecuta un comando cuando aparece el subtítulo

Soporte Multiidioma

• Los textos pueden definirse para diferentes idiomas
• El sistema detecta automáticamente el idioma del cliente
• Formato:

"text": {
  "en_us": "Welcome to our server!",
  "es_es": "¡Bienvenido a nuestro servidor!",
  "default": "Welcome to our server!"
}

Aviso: Este mod intentará conectarse a node1.miguelkinetwork.info para saber si el mod está en evaluación o no, así como para activar o desactivar cualquier función exclusiva para Donantes.