# Text Formation

nightcore features lightweight MiniMessage-like format for in-game text based on Spigot components with legacy colors support.

It's recommended to always close your tags to avoid possible issues due to tag clashing.

While legacy colors are still supported, it's highy recommended to replace them with proper color tags.

# Tags

Here is a list of all tags currently supported by nightcore.

# Color

Color the next parts

Format: <color_name> where color_name is any color from the colors.yml in /nightcore/ directory or HEX code.

Default Colors:

black
white
gray
green
yellow
orange
red
blue
cyan
purple
pink
dark_gray
light_gray
light_green
light_yellow
light_orange
light_red
light_blue
light_cyan
light_purple
light_pink

Examples:

<red>Hello <blue>world</blue>!</red>
<green>Hello world!</green>
<#00ff00>R G B!

# Color (verbose)

A more verbose way of defining colors

Format: <color:hex> where hex is color HEX code like #ff0000.

Aliases: colour, c

Examples:

<color:#ff0000>Hello world!</color>
<c:#ff00ff>Hello world!</c>

# Decoration

Decorate the next parts

Format: <decoration> where decoration is decoration name.

Allowed Values:

Bold: bold, b
Italic: italic, i, em
Underlined: underlined, u
Strikethrough: strikethrough, st, s
Obfuscated: obfuscated, obf, o

Examples:

<underlined>This is <bold>important</bold>!

# Reset

Close all currently open tags, resetting color/decoration/etc.

Format: <reset>

Aliases: r

Examples:

<yellow><bold>Hello <reset>world!

# Click

Allows doing multiple things when clicking on the component.

Format: <click:action:"value"> where action is action name, value is the argument for that particular event.

Examples:

<click:run_command:"/seed">Click</click> to show the world seed!
Click <click:copy_to_clipboard:"Haha you suck"> this </click>to copy your score!

Since the introduction of chat signatures in 1.19.1, the client no longer executes commands that require signed arguments like the /say or /tell command to prevent the server from sending signed messages on the client’s behalf.

# Hover

Allows doing multiple things when hovering on the component.

Format: <hover:action:"value"> where action is action name, value is the argument for that particular event.

Supported Actions:

show_text - A nightcore formatted text.
show_item - Item material name or NBT string.

Examples:

<hover:show_text:"<red>test">TEST

# Translatable

Allows displaying minecraft messages using the player locale.

Format: <lang:key> where key is the translation key.

Aliases: translation, translate, tr

Examples:

You got a <lang:block.minecraft.diamond_block>!

# Gradient

Gradient colored text

Format: <gradient:from:to> where from is the start color HEX code, to is the end color HEX code.

Examples:

<gradient:#00ff00:#00ffff>Hello world!</gradient>

# Font

Allows to change the font of the text.

Format: <font:key> where key is the namespaced key of the font, defaulting to minecraft.

Examples:

Nothing <font:uniform>Uniform <font:alt>Alt </font> Uniform
<font:myfont:custom_font>Uses a custom font from a resource pack</font>

# Newline

Insert a newline character.

Format: <newline>

Aliases: br

Examples:

Let me insert a <newline>line break here.
<hover:show_text:"<red>Hover with a<br><green>line break">Text with<br>line break</hover>