MineAcademy Docs

Appearance

JSON ​

Minecraft uses JSON for interactive chat components (hover text, click events, etc.). ChatControl supports JSON in several ways.

Tip

To create JSON, you can use this JSON generator. It is a very handy tool that will produce interactive chat messages, for example with elements displaying on clicking or hovering on the message.

JSON in formats ​

Starting ChatControl 11, JSON in format parts is no longer supported. Use MiniMessage format instead.

JSON in .yml Files ​

Files such as settings.yml or localization files support JSON just where a normal message would be. There are two ways of using it.

Warning

If you need to use legacy colors, use the § character because the & will not work anymore.

a) Prepending the message with [JSON] and then write JSON code directly.

Tip

Pay attention to brackets! If you use double brackets " " inside the JSON, use single brackets ' ' in the entire expression (see the example below).

yaml
Warn_Message: '[JSON] {"text": "Hello World"}'

b) Using multiple lines with the '|-' line delimiter, placing the [JSON] prefix on one line and the JSON code itself on the rest. An example:

yaml
Example_Message: |-
  [JSON]
  {"text": "Hover Me","hoverEvent": {"action": "show_text","value": {"text": "Hey there!"}}}

JSON in rules ​

You can use then warn <format> operator and reference to a format without the need for raw JSON.

For raw JSON, due to server's limitations, you can use the 'then console' operator and send a 'tellraw' command to the player:

rs
match ^This area is now protected.
dont verbose
then console tellraw {player} {"text": "This area is now protected."}