Represents a predicate for the light level in an area.

In the base game, the light level in an area can only go from 0 (inclusive) to 16 (exclusive), and is a whole number. Nevertheless, the predicate does not perform any validity checks. Values that go outside these bounds will automatically be clamped to the two limits.

By default, any light level passes this check.

Importing the class

Link to importing-the-class

It might be required for you to import the package if you encounter any issues (like casting an Array), so better be safe than sorry and add the import at the very top of the file.

ZenScript
Copy
import crafttweaker.api.predicate.LightPredicate;

Extending AnyDefaultingVanillaWrappingPredicate

Link to extending-anydefaultingvanillawrappingpredicate

LightPredicate extends AnyDefaultingVanillaWrappingPredicate. That means all methods available in AnyDefaultingVanillaWrappingPredicate are also available in LightPredicate

Link to withBoundedLightLevel

Name: withBoundedLightLevel

Sets both the minimum and maximum value the light level should be to min and max respectively.

If the light level had already some bounds specified, then they will be overwritten with the new values.

Both minimum and maximum values are inclusive, meaning that a value that is equal to either min or max will pass the check.

Returns: This predicate for chaining.
Return Type: LightPredicate

ZenScript
Copy
LightPredicate.withBoundedLightLevel(min as int, max as int) as LightPredicate
ParameterTypeDescription
Parameter
min
Type
int
Description
The minimum value the light level should be.
Parameter
max
Type
int
Description
The maximum value the light level should be.

Link to withMaximumLightLevel

Name: withMaximumLightLevel

Sets the maximum value the light level should be to max.

If the light level had already some bounds specified, then the maximum value of the bound will be overwritten with the value specified in max. On the other hand, if the light level didn't have any bounds set, the maximum is set, leaving the lower end unbounded.

The maximum value is inclusive, meaning that a value that is equal to max will pass the check.

Returns: This predicate for chaining.
Return Type: LightPredicate

ZenScript
Copy
LightPredicate.withMaximumLightLevel(max as int) as LightPredicate
ParameterTypeDescription
Parameter
max
Type
int
Description
The maximum value the light level should be.

Link to withMinimumLightLevel

Name: withMinimumLightLevel

Sets the minimum value the light level should be to min.

If the light level had already some bounds specified, then the minimum value of the bound will be overwritten with the value specified in min. On the other hand, if the light level didn't have any bounds set, the minimum is set, leaving the upper end unbounded.

The minimum value is inclusive, meaning that a value that is equal to min will pass the check.

Returns: This predicate for chaining.
Return Type: LightPredicate

ZenScript
Copy
LightPredicate.withMinimumLightLevel(min as int) as LightPredicate
ParameterTypeDescription
Parameter
min
Type
int
Description
The minimum value the light level should be.