Skip to content

Instantly share code, notes, and snippets.

@4drian3d
Last active February 27, 2023 20:24
Show Gist options
  • Star 1 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save 4drian3d/9ccce0ca1774285e38becb09b73728f3 to your computer and use it in GitHub Desktop.
Save 4drian3d/9ccce0ca1774285e38becb09b73728f3 to your computer and use it in GitHub Desktop.

Guia del uso de MiniMessage

Hola, gracias por tu interes en usar este formato, aqui te enseñare las formas de utilizarlo.

Puedes probar todos los formatos mostrados aqui o los tuyos propios antes de usarlos en producción en MiniMessageViewer

Si quieres traducir un texto en formato legacy & o §, puedes usar el conversor https://tehbrian.xyz/legacy-to-minimessage/

Entendiendo el formato

Al usar MiniMessage puedes abrir una etiqueta para que le de formato a todo el texto:

  <red>Mensaje

O darle un limite:

  <red>Mensaje</red>

Las 2 formas son validas, aun asi, se recomienda siempre darle un limite al formato, para evitar que otras palabras sean afectadas por el color accidentalmente.

Recuerda siempre usar la misma etiqueta para empezar y terminar. Por ejemplo, un "Hola, este texto tiene formato" seria impreso como: "Hola, este texto tiene formato" con el formato Bold. Para que funcione correctamente debes escribir el nombre de la etiqueta con un / de prefijo: "Hola, este texto tiene formato".

Además, puedes concatenar diversos formatos para un solo texto:

<hover:show_text:'<rainbow>Holaaa</rainbow>'><click:run_command:/bc Hola a todos!><red><st>Texto Principal</st></red></click></hover>

La explicación y uso de cada etiqueta seran mostrados a continuación.

Formatos

Colores

Las formas de imprimir colores con MiniMessage pueden ser escritas de varias maneras

Por nombre simple

Puedes añadir un color al texto simplemente definiendo el color respectivo en la etiqueta.

Colores Antiguos
<red>Hola, este mensaje sera de color rojo</red>
Colores Hexadecimales
<#00ff00>Hola, este mensaje sera de un color verde puro

Por definicion extensa

Puedes especificar el uso del color en un texto anteponiendo el color:.... Te puede servir para cometer menos errores y tener más ordenado tu formato.

Colores Antiguos
<color:red>Hola, este mensaje sera de color rojo</color:red>
Colores Hexadecimales
<color:#00ff00>Hola, este mensaje sera de un color verde puro

Decoración

Al mismo texto puedes aplicarle tags de decoración para resaltar tu texto o darle formato a palabras especificas

StrikeTrough

Este formato te permite añadir una linea horizontal en frente del texto elegido

<striketrough>Texto en formato Tachado</striketrough>
<st>Texto en formato Tachado</st>

Obfuscated

Este formato te permite hacer textos animados "corruptos".

<obfuscated>Texto Corrupto</obfuscated>
<obf>Texto Corrupto</obf>

Italic

Este formato te permite crear textos inclinados.

<italic>Texto modo torre pisa</italic>
<i>Texto modo torre pisa</i>
<em>Texto modo torre pisa</em>

Underlines

Te permite añadir un subrayado al texto.

<underlined>Texto Subrayado</underlined>

Bold

Uno de los formatos que más utilizaras. Te permite poner un formato robusto al texto.

<bold>Formato robusto de texto</bold>
<b>Formato Robusto de texto</b>

Reset

Deseas quitar completamente el formato del texto que sigue hasta que un nuevo formato sea especificado? Esta es la etiqueta que puedes usar para ello.

En esta etiqueta no puedes contener un texto: <reset></reset>. Esta etiqueta solo puede ser usada para quitar formato: "<reset>"

Este texto sera de color rojo y con decoración robustaEste texto ya no tendra formatoEste texto sera rojo de nuevo. Este texto sera de color rojo y con decoración robustaEste texto ya no tendra formatoEste texto sera rojo de nuevo.

Pre

Esta tag te permite delimitar un area donde las etiquetas de MiniMessage no funcionaran. Muy util en caso de plugins de chat.

  <gold>Tumi</gold> <gray>Pepito</gray> <pre>Mensaje de Pepito, <bold><st>sdsadsd, esto no afectara ni tendra formato</pre>

Degradados

Algo que sobresale mucho al usar MiniMessage, es el uso de los degradados en un formato muy sencillo.

Rainbow

Puedes crear un texto de colores del arcoiris con MiniMessage :O

Formato 1

<rainbow>Texto colorido :o</rainbow>

Formato 2

<rainbow:2>Texto Colorido en diferente orden :O</rainbow>

Formato 3

<rainbow:!2>Texto Colorido inverso :O</rainbow>

Degradado Clasico

Tambien puedes formar degradados con los colores que quieras.

<gradient:red:white>Degradado de rojo a blanco</gradient>
<gradient:green:red:aqua:black>Degradado de multiples colores :o</gradient>
<gradient:#FF0F0F:#FF0000>Degradado con colores hexagesimales :O</gradient>
<gradient:#FF0F0F:red:#F0F0F0:blue:green>Degradado como tu quieras :O</gradient>
<gradient>Degradado simple de blanco a negro</gradient>

Eventos

Las etiquetas en este apartado solo se pueden usar en un número limitado de situaciones, como en los Textos de Chat y Libros. NO puede ser usado en: Titulos, BossBar, MOTD, Scoreboards, Hologramas.

Click Event

Este evento puede ser añadido a un texto, para que al momento de dar click, ejecute una accion

<click:run_command:/broadcast hola!><gold>Dale Click</gold></click> para mandar un mensaje de Hola a todos.

Las Acciones que se pueden poner en el evento de Click son:

Open_Url

Esta accion mandara un link de una pagina web al cliente en el momento que se de click al mensaje.

<click:open_url:https://peruviankkit.tebex.io/><rainbow>Dale Click</rainbow></click> <white>para visitar la tienda de Peruviankkit!</white>
Run_Command

Esta acción ejecutara un comando al momento que el jugador de click en el mensaje,

  <click:run_command:/broadcast hola!><gold>Dale Click</gold></click> para mandar un mensaje de Hola a todos.
Suggest_Command

Esta acción dara una sugerencia en el campo de comandos al momento de hacer click en el texto.

  <click:suggest_command:/tell Juanito>Dale Click</click> para empezar a responder a Juanito.
Insertion

Esta accion tiene un tag diferente, pero guarda relacion con los click events

Te permite insertar un texto en el campo del chat del usuario cuando de click. Es parecido a la funcionalidad de suggest_command, pero funciona para textos.

  <insert:holaaaaa>Dale Click</insert> para copiar un texto en tu chat.
Change_Page

Solo utilizable en libros

Esta accion cambiara a una pagina especifica del libro.

  <click:change_page:2><green>Dale Click</green></click> para cambiar de pagina.
Copy_to_Clipboard

Esto permite copiar un valor al portapapeles en el momento que se de click en el texto.

  <click:copy_to_clipboard:2><green>Dale Click</green></click> para cambiar de pagina.

Hover Event

Al añadir este evento a un texto, le da la posibilidad de mostrar un elemento sobre el mensaje al pasar el cursor sobre el texto.

Show_text

Te permite mostrar un texto al pasar el cursor sobre el texto.

  <hover:show_text:'<rainbow>Texto a mostrar</rainbow>'>Texto donde se mostrara el hover</hover>
Show_item

Te permite mostrar un item al pasar el cursor sobre el texto.

  <hover:show_item:{id:"minecraft:stone"}>Texto donde se mostrara el hover</hover>

Ten en cuenta, si quieres usar items complejos, como el item que tengas en la mano, requieres usar Paper 1.16.5+

Show_entity

Permite mostrar una entidad al pasar el cursor sobre el texto

  <hover:show_entity:{id:"minecraft:zombie"}>Texto donde se mostrara el hover</hover>

Ten en cuenta, si quieres usar mobs complejos, como algun mob que te haya asesinado, o un boss, requieres usar Paper 1.16.5+

Traducibles

Con MiniMessage tambien puedes usar mensajes que se adaptan a la version de jugador que los vea.

Keybind

Puedes poner intrucciones traducibles en tus mensajes, por ejemplo:

  Presiona <key:key.jump>

Mostrara el mensaje Espacio para saltar, pero traducido al idioma que tenga el jugador

Translatable

Este tag es más poderoso, ya que te permite mandar cualquier mensaje del juego segun el idioma del jugador, pero incluso pudiendo personalizar su contenido y poder ser usado para mensajes de Texture Packs

  Rompe este bloque para obtener un <lang:block.minecraft.diamond_block>

Sera igual a: Rompe este bloque para obtener un Bloque de Diamante

  <lang:commands.drop.success.single:'<red>1':'<blue>Piedra'>!

Sera igual a Soltado 1 Piedra

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment