# MiniMessage Renderer > Parse Adventure MiniMessage format into Minecraft text components with Kore. Supports colors, decorations, click/hover events, gradients, and fonts. Use as a MiniMessage viewer for rich text in datapacks. Updated 2026-10-07. Canonical: https://kore.ayfri.com/docs/helpers/minimessage-renderer The `helpers` module includes a MiniMessage renderer that parses [Adventure MiniMessage](https://docs.advntr.dev/minimessage/format.html) format strings into Kore `ChatComponents`. This lets you write human-readable styled text that compiles into Minecraft's JSON text component format. MiniMessage is part of the [Adventure](https://github.com/KyoriPowered/adventure) library, widely used by Paper, Velocity, and other Minecraft server platforms. You can preview MiniMessage text in the [MiniMessage Web Viewer](https://webui.advntr.dev/) without starting a Minecraft instance. > [!FOOTPRINT] > Nothing at runtime: no objective, storage, entity, forceloaded chunk, tick or load function. The renderer runs while Kore builds the pack and returns `ChatComponents`. ## Basic Usage ```kotlin import io.github.ayfri.kore.text.miniMessageToTextComponents val components = miniMessageToTextComponents("Hello world!") ``` The function returns a `ChatComponents` instance that can be used anywhere Kore expects text components. ## Configuration Pass a configuration lambda to customize defaults: ```kotlin val components = miniMessageToTextComponents("Styled text") { color = Color.AQUA // default color for unstyled text bold = true // default bold state italic = false // default italic state font = "minecraft:alt" // default font strict = true // throw on parse errors } ``` ## Colors ### Named Colors All vanilla formatting colors are supported: ``` Red text Blue text Purple text ``` Aliases `` and `` are also supported: ``` Red text Blue text ``` ### Hexadecimal Colors ``` <#ff0000>Red text Green text Blue text ``` ### Gradients Gradient tags are recognized and apply the first color in the gradient: ``` Gradient text ``` ### Rainbow & Transition Rainbow and transition tags are recognized as style tags: ``` Rainbow text Transition text ``` ## Decorations | Tag | Aliases | Effect | |-------------------|---------------|---------------| | `` | `` | **Bold** | | `` | ``, `` | *Italic* | | `` | `` | Underlined | | `` | `` | Strikethrough | | `` | `` | Obfuscated | All decorations support closing tags to limit their scope: ``` Bold and italic just bold ``` ### Reset The `` (or ``) tag clears all active styles and returns to defaults: ``` Styled textNormal text ``` ## Click Events ``` Click to visit Click to spawn Click to message Next page Click to copy ``` ## Hover Events ``` Tooltip text'>Hover me Hover for item Hover for entity ``` The `show_text` value is itself parsed as MiniMessage, so you can use tags inside hover text. ## Fonts ``` Uniform font text Icon font ``` ## Insertion Shift-clicking the rendered component inserts the specified text into the chat prompt: ``` Shift-click me ``` ## Newlines ``` Line oneLine two Line one
Line two ``` ## Advanced Components ### Translatable (I18n) ``` ``` ### Keybinds ``` ``` ### Selectors ``` ``` ### Scoreboards ``` ``` ### NBT Data ``` ``` ## Escaping & Preformatted Text ### Backslash Escaping Prefix a tag with `\` to render it as literal text: ``` \This is not red ``` ### Preformatted Blocks Everything inside `
...
` is treated as raw text: ```
This renders as literal tags
``` ## Tag Resolvers Custom placeholder tags can be resolved dynamically at render time: ```kotlin val components = miniMessageToTextComponents(" joined the game") { tagResolvers = mapOf( "player_name" to TagResolver { text("Ayfri") { color = Color.GOLD } } ) } ``` The resolved component inherits the current style context (color, bold, italic, font) unless it defines its own. ## Strict Mode Enable strict mode to throw a `MiniMessageParseException` on parse errors: ```kotlin miniMessageToTextComponents("Unclosed tag") { strict = true // throws MiniMessageParseException("Unclosed tags: bold") } ``` Strict mode catches: - Unclosed tags - Unknown/unrecognized tags - Closing tags with no matching opening tag ## References - [MiniMessage Format Specification](https://docs.advntr.dev/minimessage/format.html) - full tag reference from the Adventure docs. - [MiniMessage Web Viewer](https://webui.advntr.dev/) - interactive playground to preview MiniMessage text. - [Adventure GitHub Repository](https://github.com/KyoriPowered/adventure) - the library that defines the MiniMessage format. - [Minecraft Wiki - Raw JSON Text](https://minecraft.wiki/w/Raw_JSON_text_format) - the underlying component format MiniMessage compiles to.