Adventure Series: Common Issues

Note

Learn Paper Dev is not at all an official Adventure documentation. I do not guarantee any information to be accurate. For the official Adventure documentation, please visit https://docs.advntr.dev/.

Why is my item lore in italics?

The Vanilla Minecraft client always wraps the lore in italics and a purple color. Unless you specifically specify otherwise, this style will also be applied to any child elements (our own set lore).

Visual Preview

Lore without explicit styling

ItemType.DIAMOND_SWORD.createItemStack(meta -> {
    meta.lore(List.of(
        Component.text("Component without styling")
    ));
});

In order to circumvent this problem, you have explicitly specify that your component should not have any italics. There are two ways to do this:

• In MiniMessage: You can add a <!i> or <!italic> tag at the start to explicitly disable italics.

• In Code: You can just use Component#decorationIfAbsent(TextDecoration, State):

  final Component noItalics = someComponent.decorationIfAbsent(TextDecoration.ITALIC, TextDecoration.State.FALSE);

Tip

In order to not have to do this on every components that you construct, you can create a small util method to do this for you:

ComponentUtils.java

@NullMarked
public static List<Component> fixItalics(List<Component> componentList) {
    // Replace each component with the non-italicized variant of itself
    return componentList.stream()
        .map(component -> component.decorationIfAbsent(TextDecoration.ITALIC, TextDecoration.State.FALSE))
        .toList();
}

This should now correctly remove the italics from the lore. You can do the same for the purple color using Component#colorIfAbsent(TextColor), if you wish the default lore color to be white.

final List<Component> rawLore = List.of(
    Component.text("Component without styling")
);

final ItemStack item = ItemType.DIAMOND_SWORD.createItemStack(meta -> {
    meta.lore(ComponentUtils.fixItalics(rawLore));
});