ValidatedTriState

open class ValidatedTriState @JvmOverloads constructor(defaultValue: TriState, widgetType: ValidatedTriState.WidgetType = WidgetType.SIDE_BY_SIDE) : ValidatedField<TriState> , TriStateProvider

A validated TriState (True, False, or Default). This validation is itself a TriStateProvider, so can directly act as the stored TriState without needing to call get. TriStateProvider is itself a BooleanSupplier, so this validation can be passed directly into places that use one of those, such as ValidatedField.toCondition (default treated as false in that case)

See the Wiki for more details and examples.

Author

fzzyhmstrs

Since

0.6.5

Parameters

defaultValue

Enum Constant used as the default for this setting

widgetType

WidgetType defines the GUI selection type. Defaults to POPUP

Constructors

Link copied to clipboard
constructor(defaultValue: TriState, widgetType: ValidatedTriState.WidgetType = WidgetType.SIDE_BY_SIDE)

Types

Link copied to clipboard

Determines which type of selector widget will be used for the TriState option, default is SIDE_BY_SIDE

Properties

Link copied to clipboard
open override var translatableEntryKey: String

Functions

Link copied to clipboard
open override fun accept(input: TriState)

updates the wrapped value. NOTE: this method will push updates to an UpdateManager, if any. For in-game updating consider validateAndSet

Link copied to clipboard

Attaches a listener to this field. This listener will be called any time the field is written to ("set"). accept, validateAndSet, setAndUpdate and so on will all call the listener.

Link copied to clipboard
Link copied to clipboard
fun codec(): Codec<TriState>

Provides a Codec representing the value type of this validation, backed by the validators within as applicable

Link copied to clipboard

Copies the stored value and returns it.

Link copied to clipboard
open fun copyValue(input: TriState): TriState

Copies the provided input as deeply as possible.

Link copied to clipboard

Corrects an attempted input, as possible. When correction isn't possible or deterministic, simply validate the entry the same way you would for EntryValidator

Link copied to clipboard
open fun description(fallback: String? = null): MutableText

The translated Text description from the descriptionKey. Falls back to an empty string so no tooltip is rendered.

Link copied to clipboard
open override fun descriptionKey(): String

translation key of this Translatable's description. the "description" in-game, the descriptions Enchantment Descriptions adds to enchantment tooltips are a good example.

Link copied to clipboard
open fun deserializedChanged(old: Any?, new: Any?): Boolean

Specialized equals method for determining if a newly deserialized value is effectively equal to its old counterpart.

Link copied to clipboard
open override fun flags(): Byte
Link copied to clipboard
open override fun get(): TriState

supplies the wrapped value

Link copied to clipboard
open override fun getAsBoolean(): Boolean

Gets the value of the tri-state. Implemented from BooleanSupplier.

Link copied to clipboard
open override fun getBoxed(): Boolean?

Gets the value of the tri-state as a boxed, nullable boolean.

Link copied to clipboard

Provides this validations default value

Link copied to clipboard
abstract fun getEntryKey(): String
Link copied to clipboard

Whether this Translatable has a valid description

Link copied to clipboard
open override fun hasFlag(flag: EntryFlag.Flag): Boolean
Link copied to clipboard
open fun hasPrefix(): Boolean

Whether this Translatable has a valid prefix

Link copied to clipboard

Whether this Translatable has a valid translation

Link copied to clipboard
open override fun instanceEntry(): ValidatedTriState

creates a deep copy of this ValidatedTriState return ValidatedTriState wrapping the currently stored state and widget type

Link copied to clipboard
open override fun listenToEntry(listener: Consumer<Entry<TriState, *>>)

Attaches a listener to this field. This listener will be called any time the field is written to ("set"). accept, validateAndSet, setAndUpdate and so on will all call the listener.

Link copied to clipboard
fun <N> map(to: Function<TriState, out N>, from: Function<in N, TriState>): ValidatedField<N>

Maps this validation to a new convertible type. The default value will be applied from this delegates current storedValue

fun <N> map(defaultValue: N, to: Function<TriState, out N>, from: Function<in N, TriState>): ValidatedField<N>
fun <N> map(to: Function<TriState, out N>, from: Function<in N, TriState>, defaultValue: TriState): ValidatedField<N>

Maps this validation to a new convertible type.

Link copied to clipboard
open override fun orElse(value: Boolean): Boolean

Gets the value of this tri-state. If the value is DEFAULT then use the supplied value.

Link copied to clipboard
open override fun orElseGet(supplier: BooleanSupplier): Boolean
open override fun orElseGet(supplier: Supplier<Boolean>): Boolean

Gets the value of this tri-state. If the value is DEFAULT then use the supplied value.

Link copied to clipboard
fun <B> pairWith(other: Entry<B, *>): ValidatedPair<TriState, B>

Pairs this validation with another validation into one ValidatedPair

Link copied to clipboard
open fun prefix(fallback: String? = null): MutableText

The translated Text description from the descriptionKey. Falls back to an empty string so no tooltip is rendered.

Link copied to clipboard
open override fun prefixKey(): String

translation key of this Translatable's inline prefix text. Unlike descriptions, which are usually displayed in-tooltips, prefixes are displayed inline in the config screen itself

Link copied to clipboard
open fun prepare(scope: String, groups: LinkedList<String>, annotations: List<Annotation>, globalAnnotations: List<Annotation>)

Called in the prepare stage of screen building to perform any necessary pre-entry-creation tasks.

Link copied to clipboard
abstract fun setEntryKey(key: String)
Link copied to clipboard

Convert this field to a ValidatedCondition using the provided validation as a supplier. The provided condition (and any others you append) must pass for the stored value to be provided, otherwise the fallback will be supplied.

open fun toCondition(condition: BooleanSupplier, fallback: Supplier<TriState>, failMessage: Text): ValidatedCondition<TriState>
open fun toCondition(condition: Supplier<Boolean>, failMessage: Text, fallback: Supplier<TriState>): ValidatedCondition<TriState>

Convert this field to a ValidatedCondition. The provided condition (and any others you append) must pass for the stored value to be provided, otherwise the fallback will be supplied.

open fun toCondition(scope: String, failMessage: Text, fallback: Supplier<TriState>): ValidatedCondition<TriState>

Convert this field to a ValidatedCondition using the provided scope with a default boolean provider. The provided condition (and any others you append) must pass for the stored value to be provided, otherwise the fallback will be supplied. The provided scope must point to a valid boolean config scope otherwise the initial condition will never pass.

Link copied to clipboard
fun toList(vararg elements: TriState): ValidatedList<TriState>

Wraps the provided values into a ValidatedList with this field as validation

Wraps the provided collection into a ValidatedList with this field as validation

Link copied to clipboard
fun toSet(vararg elements: TriState): ValidatedSet<TriState>

Wraps the provided values into a ValidatedSet with this field as validation

Wraps the provided collection into a ValidatedSet with this field as validation

Link copied to clipboard
open override fun translationKey(): String

translation key of this Translatable. the "name" in-game

Link copied to clipboard
open override fun trySet(input: Any?)

Attempts to set an arbitrary input into this Entry. Should fail soft if the input is incompatible

Link copied to clipboard
open fun update(updateMessage: Text)
Link copied to clipboard
open override fun validate(input: Boolean): Boolean

Validates a provided boolean input against the current tri-state.

Link copied to clipboard

A setter method for the storedValue that first validates the value being set and then stores the post-validation result.

Link copied to clipboard

A setter method for the storedValue that first validates the value being set and then stores the post-validation result.

Link copied to clipboard

Validates an input per the provided validation type.

Link copied to clipboard
open fun widgetAndTooltipEntry(choicePredicate: ChoiceValidator<TriState> = ChoiceValidator.any()): ClickableWidget

Builds a new ClickableWidget and applies a tooltip to it. This shouldn't need to be overridden in most cases