ComponentBuilder (Waterfall-Chat 1.14-SNAPSHOT API)

java.lang.Object
- net.md_5.bungee.api.chat.ComponentBuilder

```
public final class ComponentBuilder
extends Object
```
ComponentBuilder simplifies creating basic messages by allowing the use of a chainable builder.
```
 new ComponentBuilder("Hello ").color(ChatColor.RED).
 append("World").color(ChatColor.BLUE). append("!").bold(true).create();
 
```
All methods (excluding append(String) and create() work on the last part appended to the builder, so in the example above "Hello " would be ChatColor.RED and "World" would be ChatColor.BLUE but "!" would be bold and ChatColor.BLUE because append copies the previous part's formatting

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`ComponentBuilder.FormatRetention`
`static interface`	`ComponentBuilder.Joiner` Functional interface to join additional components to a ComponentBuilder.

Constructor Summary

Constructors
Constructor and Description
`ComponentBuilder(BaseComponent component)` Creates a ComponentBuilder with the given component as the first part.
`ComponentBuilder(ComponentBuilder original)` Creates a ComponentBuilder from the other given ComponentBuilder to clone it.
`ComponentBuilder(String text)` Creates a ComponentBuilder with the given text as the first part.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`ComponentBuilder`	`append(BaseComponent component)` Appends a component to the builder and makes it the current target for formatting.
`ComponentBuilder`	`append(BaseComponent[] components)` Appends the components to the builder and makes the last element the current target for formatting.
`ComponentBuilder`	`append(BaseComponent[] components, ComponentBuilder.FormatRetention retention)` Appends the components to the builder and makes the last element the current target for formatting.
`ComponentBuilder`	`append(BaseComponent component, ComponentBuilder.FormatRetention retention)` Appends a component to the builder and makes it the current target for formatting.
`ComponentBuilder`	`append(ComponentBuilder.Joiner joiner)` Allows joining additional components to this builder using the given `ComponentBuilder.Joiner` and `ComponentBuilder.FormatRetention.ALL`.
`ComponentBuilder`	`append(ComponentBuilder.Joiner joiner, ComponentBuilder.FormatRetention retention)` Allows joining additional components to this builder using the given `ComponentBuilder.Joiner`.
`ComponentBuilder`	`append(String text)` Appends the text to the builder and makes it the current target for formatting.
`ComponentBuilder`	`append(String text, ComponentBuilder.FormatRetention retention)` Appends the text to the builder and makes it the current target for formatting.
`ComponentBuilder`	`appendLegacy(String text)` Parse text to BaseComponent[] with colors and format, appends the text to the builder and makes it the current target for formatting.
`ComponentBuilder`	`bold(boolean bold)` Sets whether the current part is bold.
`ComponentBuilder`	`color(ChatColor color)` Sets the color of the current part.
`BaseComponent[]`	`create()` Returns the components needed to display the message created by this builder.
`ComponentBuilder`	`event(ClickEvent clickEvent)` Sets the click event for the current part.
`ComponentBuilder`	`event(HoverEvent hoverEvent)` Sets the hover event for the current part.
`ComponentBuilder`	`insertion(String insertion)` Sets the insertion text for the current part.
`ComponentBuilder`	`italic(boolean italic)` Sets whether the current part is italic.
`ComponentBuilder`	`obfuscated(boolean obfuscated)` Sets whether the current part is obfuscated.
`ComponentBuilder`	`reset()` Sets the current part back to normal settings.
`ComponentBuilder`	`retain(ComponentBuilder.FormatRetention retention)` Retains only the specified formatting.
`ComponentBuilder`	`strikethrough(boolean strikethrough)` Sets whether the current part is strikethrough.
`ComponentBuilder`	`underlined(boolean underlined)` Sets whether the current part is underlined.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - ComponentBuilder
```
public ComponentBuilder(ComponentBuilder original)
```
    Creates a ComponentBuilder from the other given ComponentBuilder to clone it.
    
    Parameters:
    
    original - the original for the new ComponentBuilder.
  - ComponentBuilder
```
public ComponentBuilder(String text)
```
    Creates a ComponentBuilder with the given text as the first part.
    
    Parameters:
    
    text - the first text element
  - ComponentBuilder
```
public ComponentBuilder(BaseComponent component)
```
    Creates a ComponentBuilder with the given component as the first part.
    
    Parameters:
    
    component - the first component element
- Method Detail
  - append
```
public ComponentBuilder append(BaseComponent component)
```
    Appends a component to the builder and makes it the current target for formatting. The component will have all the formatting from previous part.
    
    Parameters:
    
    component - the component to append
    
    Returns:
    
    this ComponentBuilder for chaining
  - append
```
public ComponentBuilder append(BaseComponent component,
                               ComponentBuilder.FormatRetention retention)
```
    Appends a component to the builder and makes it the current target for formatting. You can specify the amount of formatting retained from previous part.
    
    Parameters:
    
    component - the component to append
    
    retention - the formatting to retain
    
    Returns:
    
    this ComponentBuilder for chaining
  - append
```
public ComponentBuilder append(BaseComponent[] components)
```
    Appends the components to the builder and makes the last element the current target for formatting. The components will have all the formatting from previous part.
    
    Parameters:
    
    components - the components to append
    
    Returns:
    
    this ComponentBuilder for chaining
  - append
```
public ComponentBuilder append(BaseComponent[] components,
                               ComponentBuilder.FormatRetention retention)
```
    Appends the components to the builder and makes the last element the current target for formatting. You can specify the amount of formatting retained from previous part.
    
    Parameters:
    
    components - the components to append
    
    retention - the formatting to retain
    
    Returns:
    
    this ComponentBuilder for chaining
  - append
```
public ComponentBuilder append(String text)
```
    Appends the text to the builder and makes it the current target for formatting. The text will have all the formatting from previous part.
    
    Parameters:
    
    text - the text to append
    
    Returns:
    
    this ComponentBuilder for chaining
  - appendLegacy
```
public ComponentBuilder appendLegacy(String text)
```
    Parse text to BaseComponent[] with colors and format, appends the text to the builder and makes it the current target for formatting. The component will have all the formatting from previous part.
    
    Parameters:
    
    text - the text to append
    
    Returns:
    
    this ComponentBuilder for chaining
  - append
```
public ComponentBuilder append(String text,
                               ComponentBuilder.FormatRetention retention)
```
    Appends the text to the builder and makes it the current target for formatting. You can specify the amount of formatting retained from previous part.
    
    Parameters:
    
    text - the text to append
    
    retention - the formatting to retain
    
    Returns:
    
    this ComponentBuilder for chaining
  - append
```
public ComponentBuilder append(ComponentBuilder.Joiner joiner)
```
    Allows joining additional components to this builder using the given ComponentBuilder.Joiner and ComponentBuilder.FormatRetention.ALL. Simply executes the provided joiner on this instance to facilitate a chain pattern.
    
    Parameters:
    
    joiner - joiner used for operation
    
    Returns:
    
    this ComponentBuilder for chaining
  - append
```
public ComponentBuilder append(ComponentBuilder.Joiner joiner,
                               ComponentBuilder.FormatRetention retention)
```
    Allows joining additional components to this builder using the given ComponentBuilder.Joiner. Simply executes the provided joiner on this instance to facilitate a chain pattern.
    
    Parameters:
    
    joiner - joiner used for operation
    
    retention - the formatting to retain
    
    Returns:
    
    this ComponentBuilder for chaining
  - color
```
public ComponentBuilder color(ChatColor color)
```
    Sets the color of the current part.
    
    Parameters:
    
    color - the new color
    
    Returns:
    
    this ComponentBuilder for chaining
  - bold
```
public ComponentBuilder bold(boolean bold)
```
    Sets whether the current part is bold.
    
    Parameters:
    
    bold - whether this part is bold
    
    Returns:
    
    this ComponentBuilder for chaining
  - italic
```
public ComponentBuilder italic(boolean italic)
```
    Sets whether the current part is italic.
    
    Parameters:
    
    italic - whether this part is italic
    
    Returns:
    
    this ComponentBuilder for chaining
  - underlined
```
public ComponentBuilder underlined(boolean underlined)
```
    Sets whether the current part is underlined.
    
    Parameters:
    
    underlined - whether this part is underlined
    
    Returns:
    
    this ComponentBuilder for chaining
  - strikethrough
```
public ComponentBuilder strikethrough(boolean strikethrough)
```
    Sets whether the current part is strikethrough.
    
    Parameters:
    
    strikethrough - whether this part is strikethrough
    
    Returns:
    
    this ComponentBuilder for chaining
  - obfuscated
```
public ComponentBuilder obfuscated(boolean obfuscated)
```
    Sets whether the current part is obfuscated.
    
    Parameters:
    
    obfuscated - whether this part is obfuscated
    
    Returns:
    
    this ComponentBuilder for chaining
  - insertion
```
public ComponentBuilder insertion(String insertion)
```
    Sets the insertion text for the current part.
    
    Parameters:
    
    insertion - the insertion text
    
    Returns:
    
    this ComponentBuilder for chaining
  - event
```
public ComponentBuilder event(ClickEvent clickEvent)
```
    Sets the click event for the current part.
    
    Parameters:
    
    clickEvent - the click event
    
    Returns:
    
    this ComponentBuilder for chaining
  - event
```
public ComponentBuilder event(HoverEvent hoverEvent)
```
    Sets the hover event for the current part.
    
    Parameters:
    
    hoverEvent - the hover event
    
    Returns:
    
    this ComponentBuilder for chaining
  - reset
```
public ComponentBuilder reset()
```
    Sets the current part back to normal settings. Only text is kept.
    
    Returns:
    
    this ComponentBuilder for chaining
  - retain
```
public ComponentBuilder retain(ComponentBuilder.FormatRetention retention)
```
    Retains only the specified formatting. Text is not modified.
    
    Parameters:
    
    retention - the formatting to retain
    
    Returns:
    
    this ComponentBuilder for chaining
  - create
```
public BaseComponent[] create()
```
    Returns the components needed to display the message created by this builder.
    
    Returns:
    
    the created components

Class ComponentBuilder

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

ComponentBuilder

ComponentBuilder

ComponentBuilder

Method Detail

append

append

append

append

append

appendLegacy

append

append

append

color

bold

italic

underlined

strikethrough

obfuscated

insertion

event

event

reset

retain

create