Interface TextBundle

public interface TextBundle

Every text capability, for one server version, expressed without naming Adventure.

Implementations live in the nested internal-libs/adventure.jar and are loaded through a child classloader, because they are the classes that touch the relocated Adventure. This interface is the boundary: it lives on the plugin classloader, names only VersionedComponent, Bukkit types and String, and is therefore safe for a module's NmsBundleImpl to reference.

Split out of NmsBundleImpl because an adapter is loaded whenever any capability from its module is used. On 26.2 commandMapModifier dispatches to v1_17_R1, so an adapter that referenced the text implementations directly dragged the relocated Adventure onto a server that has Adventure natively and never touches the shaded copy.

fromJson and toJson are how the native tier crosses the boundary. A JSON string carries a component between the server's own Adventure and the relocated one without either side naming the other's types.

Method Summary

Modifier and Type	Method	Description
@NotNull ItemMeta	addLoreLine(@NotNull ItemMeta meta, @NotNull VersionedComponent component)
default @NotNull ComponentLoggerAdapter	componentLoggerAdapter()	Default-throwing: only v1_16_R3 serves a logger adapter built on the relocated Adventure.
@NotNull VersionedComponent	fromJson(@NotNull String json)	JSON in, component out.
@NotNull VersionedComponent	fromLegacyAmpersand(@NotNull String legacy)
@NotNull VersionedComponent	fromLegacySection(@NotNull String legacy)
@NotNull VersionedComponent	fromMiniMessage(@NotNull String miniMessage)
@NotNull VersionedComponent	fromMiniMessage(@NotNull String miniMessage, @NotNull TextPlaceholder... placeholders)
@NotNull VersionedComponent	fromPlainText(@NotNull String text)
@Nullable VersionedComponent	getDisplayName(@NotNull ItemMeta meta)
@Nullable List<VersionedComponent>	getLore(@NotNull ItemMeta meta)
@NotNull ItemMeta	setDisplayName(@NotNull ItemMeta meta, @Nullable VersionedComponent component)
@NotNull ItemMeta	setLore(@NotNull ItemMeta meta, @Nullable List<VersionedComponent> lore)

Method Details

fromPlainText

@NotNull
@NotNull VersionedComponent fromPlainText(@NotNull
 @NotNull String text)

fromMiniMessage

@NotNull
@NotNull VersionedComponent fromMiniMessage(@NotNull
 @NotNull String miniMessage)

fromMiniMessage

@NotNull
@NotNull VersionedComponent fromMiniMessage(@NotNull
 @NotNull String miniMessage,
 @NotNull
 @NotNull TextPlaceholder... placeholders)

fromLegacyAmpersand

@NotNull
@NotNull VersionedComponent fromLegacyAmpersand(@NotNull
 @NotNull String legacy)

fromLegacySection

@NotNull
@NotNull VersionedComponent fromLegacySection(@NotNull
 @NotNull String legacy)

fromJson

@NotNull
@NotNull VersionedComponent fromJson(@NotNull
 @NotNull String json)

JSON in, component out. The native tier's route across the boundary.

setDisplayName

@NotNull
@NotNull ItemMeta setDisplayName(@NotNull
 @NotNull ItemMeta meta,
 @Nullable
 @Nullable VersionedComponent component)

getDisplayName

@Nullable
@Nullable VersionedComponent getDisplayName(@NotNull
 @NotNull ItemMeta meta)

setLore

@NotNull
@NotNull ItemMeta setLore(@NotNull
 @NotNull ItemMeta meta,
 @Nullable
 @Nullable List<VersionedComponent> lore)

getLore

@Nullable
@Nullable List<VersionedComponent> getLore(@NotNull
 @NotNull ItemMeta meta)

addLoreLine

@NotNull
@NotNull ItemMeta addLoreLine(@NotNull
 @NotNull ItemMeta meta,
 @NotNull
 @NotNull VersionedComponent component)

componentLoggerAdapter

@NotNull
default @NotNull ComponentLoggerAdapter componentLoggerAdapter()

Default-throwing: only v1_16_R3 serves a logger adapter built on the relocated Adventure. From 1.18.2 upward the adapter uses the server's own Adventure and lives in its version module, outside the nested jar entirely.