Adventure API component serializer inspired by MineDown and MiniMessage projects. An attempt to make legacy-friendly serializer with modern features.
InkyMessage supports legacy format codes, e.g. &l
, &6
, &a
, etc.
Besides that, we also have a special format for the modern features like interactable chat components.
It's very simple to follow: &[My special text](key:parameter value)(otherkey:otherparam)
.
Those are its possible modifiers:
Key | Parameter | Value | Effect | Example |
---|---|---|---|---|
hover |
Only text ATM |
Rich hover text | Add hover effect to chat component | Stop. &[Hover time](hover:text What a meme)! |
click |
url , run , suggest , copy , insert (same as suggest , but requires shift-click) |
Plain action parameters | Add click functionality to chat component | &[Get 100 robux!](click:url https://youtu.be/dQw4w9WgXcQ) |
decor |
bold , obfuscated , strikethrough , underlined , italic |
true , unset , false |
Force decorator on the text | &cThat's a &[bold](decor:bold) move! |
font |
Namespaced key of a font | None | Change fonts of a text | Wow, &[almost HD fonts](font:minecraft:uniform)! |
color |
Named color (lower case) or hex (#123456 ) |
pastel for pastel colors |
Colorize colorless text | &[This text is green](color:green) |
color (gradient) |
spectrum or color1-color2-colorN (see the original color modifier) |
pastel for pastel colors |
Colorize colorless text with gradient | &aLook!&r &[Fancy!](color:spectrum)(decor:bold) |
- Placeholders (for keybinds, selectors)
- Better symbolic styles stacking on serialization
- Some actual useful API
- More tests
Versions in dependency sections may be outdated. Check the badge above for the latest one.
Add to repositories
<repository>
<id>glowing-ink</id>
<url>https://repo.glowing.ink/releases</url> <!-- https://repo.glowing.ink/snapshots for snapshots -->
</repository>
Add to dependencies
<dependency>
<groupId>ink.glowing</groupId>
<artifactId>inkymessage</artifactId>
<version>0.11.0</version>
</dependency>
repositories {
maven {
url = uri("https://repo.glowing.ink/releases") // https://repo.glowing.ink/snapshots for snapshots
}
}
dependencies {
implementation("ink.glowing:inkymessage:0.11.0")
}