Package net.kyori.adventure.text

Interface TextReplacementConfig.Builder

All Superinterfaces:

AbstractBuilder<TextReplacementConfig>, Buildable.Builder<TextReplacementConfig>

Enclosing interface:

TextReplacementConfig

public static interface TextReplacementConfig.Builder
extends AbstractBuilder<TextReplacementConfig>, Buildable.Builder<TextReplacementConfig>

A builder for replacement configurations.

Since:

4.2.0

Method Summary

Modifier and Type	Method	Description
@NotNull TextReplacementConfig.Builder	condition(@NotNull TextReplacementConfig.Condition condition)	Set the function to determine how an individual match should be processed.
default @NotNull TextReplacementConfig.Builder	condition(@NotNull IntFunction2<PatternReplacementResult> condition)	Set the function to determine how an individual match should be processed.
default @NotNull TextReplacementConfig.Builder	match(@NotNull java.lang.String pattern)	Compile the provided input as a Pattern and set it as the match to test against.
@NotNull TextReplacementConfig.Builder	match(@NotNull java.util.regex.Pattern pattern)	Match the provided Pattern.
default TextReplacementConfig.Builder	matchLiteral(java.lang.String literal)	Set this builder to match only the literal string provided.
default @NotNull TextReplacementConfig.Builder	once()	Only replace the first occurrence of the matched pattern.
default @NotNull TextReplacementConfig.Builder	replacement(@NotNull java.lang.String replacement)	Supply a literal replacement for the matched pattern.
@NotNull TextReplacementConfig.Builder	replacement(@NotNull java.util.function.BiFunction<java.util.regex.MatchResult,TextComponent.Builder,@Nullable ComponentLike> replacement)	Supply a function that provides replacements for each match, with access to group information.
default @NotNull TextReplacementConfig.Builder	replacement(@NotNull java.util.function.Function<TextComponent.Builder,@Nullable ComponentLike> replacement)	Supply a function that provides replacements for each match.
default @NotNull TextReplacementConfig.Builder	replacement(@Nullable ComponentLike replacement)	Supply a literal replacement for the matched pattern.
default @NotNull TextReplacementConfig.Builder	times(int times)	Only replace the first times matches of the pattern.

Methods inherited from interface net.kyori.adventure.util.Buildable.Builder

build

Method Detail

matchLiteral

@Contract("_ -> this")
default TextReplacementConfig.Builder matchLiteral(java.lang.String literal)

Set this builder to match only the literal string provided.

This will NOT be parsed as a regular expression.

Parameters:

literal - the literal string to match

Returns:

this builder

Since:

4.2.0

match

@Contract("_ -> this")
@NotNull
default @NotNull TextReplacementConfig.Builder match(@NotNull @RegExp
                                                     @NotNull java.lang.String pattern)

Compile the provided input as a Pattern and set it as the match to test against.

Parameters:

pattern - the regex pattern to match

Returns:

this builder

Since:

4.2.0

match

@Contract("_ -> this")
@NotNull
@NotNull TextReplacementConfig.Builder match(@NotNull
                                             @NotNull java.util.regex.Pattern pattern)

Match the provided Pattern.

Parameters:

pattern - pattern to find in any searched components

Returns:

this builder

Since:

4.2.0

once

@NotNull
default @NotNull TextReplacementConfig.Builder once()

Only replace the first occurrence of the matched pattern.

Returns:

this builder

Since:

4.2.0

times

@Contract("_ -> this")
@NotNull
default @NotNull TextReplacementConfig.Builder times(int times)

Only replace the first times matches of the pattern.

Parameters:

times - maximum amount of matches to process

Returns:

this builder

Since:

4.2.0

condition

@Contract("_ -> this")
@NotNull
default @NotNull TextReplacementConfig.Builder condition(@NotNull
                                                         @NotNull IntFunction2<PatternReplacementResult> condition)

Set the function to determine how an individual match should be processed.

Parameters:

condition - a function of (matchCount, replaced) used to determine if matches should be replaced, where "matchCount" is the number of matches that have been found, including the current one, and "replaced" is the number of successful replacements.

Returns:

this builder

Since:

4.2.0

condition

@Contract("_ -> this")
@NotNull
@NotNull TextReplacementConfig.Builder condition(@NotNull
                                                 @NotNull TextReplacementConfig.Condition condition)

Set the function to determine how an individual match should be processed.

Parameters:

condition - a function that determines whether a replacement should occur

Returns:

this builder

Since:

4.8.0

See Also:

TextReplacementConfig.Condition

replacement

@Contract("_ -> this")
@NotNull
default @NotNull TextReplacementConfig.Builder replacement(@NotNull
                                                           @NotNull java.lang.String replacement)

Supply a literal replacement for the matched pattern.

Parameters:

replacement - the replacement

Returns:

this builder

Since:

4.2.0

replacement

@Contract("_ -> this")
@NotNull
default @NotNull TextReplacementConfig.Builder replacement(@Nullable
                                                           @Nullable ComponentLike replacement)

Supply a literal replacement for the matched pattern.

Parameters:

replacement - the replacement

Returns:

this builder

Since:

4.2.0

replacement

@Contract("_ -> this")
@NotNull
default @NotNull TextReplacementConfig.Builder replacement(@NotNull
                                                           @NotNull java.util.function.Function<TextComponent.Builder,@Nullable ComponentLike> replacement)

Supply a function that provides replacements for each match.

Parameters:

replacement - the replacement function

Returns:

this builder

Since:

4.2.0

replacement

@Contract("_ -> this")
@NotNull
@NotNull TextReplacementConfig.Builder replacement(@NotNull
                                                   @NotNull java.util.function.BiFunction<java.util.regex.MatchResult,TextComponent.Builder,@Nullable ComponentLike> replacement)

Supply a function that provides replacements for each match, with access to group information.

Parameters:

replacement - the replacement function, taking a match result and a text component pre-populated with

Returns:

this builder

Since:

4.2.0