Skip to main content

The world

Block At​

world.block_at

The block at a location

InTypeWhat it is
WorldWorldThe world to look in
LocationLocationWhere the block is
OutTypeWhat it is
ResultBlockThe block; on Folia missing when the location is in another region

Create Block Data​

block_type.create_block_data

Creates a new BlockData instance for this block type, with all properties initialized to unspecified defaults.

InTypeWhat it is
Block TypeBlock TypeRepresents a block type.
OutTypeWhat it is
ResultBlock Datanew data instance

Create Dust​

dust.create

Creates a Dust

InTypeWhat it is
ColorColorThe colour of the dust
SizeFloatHow big each particle is, 1 for normal
OutTypeWhat it is
DustDustOptions which can be applied to dust particles - a particle color and size.

Create Dust Transition​

dust_transition.create

Creates a Dust Transition

InTypeWhat it is
FromColorThe colour it starts with
ToColorThe colour it fades to
SizeFloatHow big each particle is, 1 for normal
OutTypeWhat it is
Dust TransitionDust TransitionOptions which can be applied to a color transitioning dust particles.

Create Spell​

spell.create

Creates a Spell

InTypeWhat it is
ColorColorThe colour of the spell
PowerFloatHow strongly it shows
OutTypeWhat it is
SpellSpellOptions which can be applied to effect particles.

Create Trail​

trail.create

Creates a Trail

InTypeWhat it is
TargetLocationWhere the trail leads
ColorColorThe colour of the trail
DurationIntegerHow long it travels, in ticks
OutTypeWhat it is
TrailTrailOptions which can be applied to trail particles - a location, color and duration.

Create Vibration​

vibration.create

Data for the vibration particle: travels to a location within some ticks

InTypeWhat it is
DestinationLocationWhere the vibration travels to
TicksIntegerHow long it travels
OutTypeWhat it is
VibrationVibrationThe vibration, as data for the vibration particle

Entities Near Location​

world.nearby_entities

Entities within a box around a location; x, y and z are half the box size

InTypeWhat it is
LocationLocationThe centre of the search
XNumberHow far to search east and west
YNumberHow far to search up and down
ZNumberHow far to search north and south
OutTypeWhat it is
ResultCollection<Entity>The entities in that box; on Folia empty when the box reaches into another region

Line Trace​

world.line_trace

Follows a line from a location and tells what it meets first, ignoring fluids and passable blocks such as grass

InTypeWhat it is
StartLocationWhere the line starts, e.g. the eyes of the mob
DirectionVectorWhere the line goes, e.g. the direction the mob looks in
DistanceNumberHow far the line goes
Ignore (optional)EntityAn entity the line passes through, e.g. the mob itself
OutTypeWhat it is
HitBooleanWhether the line met a block or entity
LocationLocationWhere it met it; missing without a hit
EntityEntityThe entity it met; missing when it met a block or nothing
BlockBlockThe block it met; missing when it met an entity or nothing
DistanceNumberHow far from the start it met something, the full distance without a hit

Goes on with: Next

Mutate World​

world.mutate

Changes the properties of a World that are given, the others stay as they are, and gives every property's value after the change

InTypeWhat it is
WorldWorldRepresents a world, which may contain entities, chunks and blocks
Allow Monster Spawning (optional)BooleanSets if this world can spawn monsters.
Auto Save (optional)BooleanSets whether or not the world will automatically save
Clear Weather Duration (optional)IntegerSet the clear weather duration.
Difficulty (optional)DifficultySets the Difficulty of the world.
Full Time (optional)LongSets the in-game time on the server Note that this sets the full time of the world, which may cause adverse effects such as breaking redstone clocks and any scheduled events
Hardcore (optional)BooleanSets whether the world is hardcore or not.
Send View Distance (optional)IntegerSets the sending view distance for this world.
Simulation Distance (optional)IntegerSets the simulation distance for this world.
Spawn Location (optional)LocationSets the spawn location of the world.
Storm (optional)BooleanSet whether there is a storm.
Thunder Duration (optional)IntegerSet the thundering duration.
Thundering (optional)BooleanSet whether it is thundering.
Time (optional)LongSets the relative in-game time on the server.
View Distance (optional)IntegerSets the view distance for this world.
Void Damage Amount (optional)FloatSets the damage applied to the entities when they are in the void in this world.
Void Damage Enabled (optional)BooleanSets whether void damage is enabled on this world.
Void Damage Min Build Height Offset (optional)NumberSets the offset applied to getMinHeight() to determine the height at which void damage starts to apply.
Weather Duration (optional)IntegerSet the remaining time in ticks of the current conditions.
OutTypeWhat it is
Allow MonstersBooleanGets whether monsters can spawn in this world.
Auto SaveBooleanGets whether or not the world will automatically save
Bed WorksBooleanGets if beds work in this world.
Chunk CountIntegerThe amount of chunks in this world
Clear WeatherBooleanReturns whether the world has clear weather.
Clear Weather DurationIntegerGet the clear weather duration.
Coordinate ScaleNumberGets the coordinate scaling of this world.
Day TimeBooleanCheck if it is currently daytime in this world
DifficultyDifficultyGets the Difficulty of the world.
EntitiesList<Entity>Get a list of all entities in this World
Entity CountIntegerThe amount of entities in this world
EnvironmentEnvironmentGets the World.Environment type of this world
Fixed TimeBooleanChecks if this world has a fixed time
Full TimeLongGets the full in-game time on this world, or 0 if this world does not have a world clock.
Game TimeLongGets the full in-game time on this world since the world generation
HardcoreBooleanGets whether the world is hardcore or not.
InfiniburnCollection<Material>Gets the collection of materials that burn infinitely in this world.
Listening Plugin ChannelsSet<Text>Gets a set containing all the Plugin Channels that this client is listening on.
Living EntitiesList<Living Entity>Get a list of all living entities in this World
Logical HeightIntegerGets the maximum height to which chorus fruits and nether portals can bring players within this dimension.
Max HeightIntegerGets the maximum height of this world.
Min HeightIntegerGets the minimum height of this world.
Moon PhaseMoonPhasethe current moon phase at the current time in the world
NameTextGets the legacy Bukkit name of this world.
Piglin SafeBooleanGets if this world allow to piglins to survive without shaking and transforming to zombified piglins.
Player CountIntegerThe amount of players in this world
PlayersList<Player>Get a list of all players in this World
Respawn Anchor WorksBooleanGets if this world allows players to charge and use respawn anchors.
Sea LevelIntegerGets the sea level for this world.
SeedLongGets the Seed for this world.
Send View DistanceIntegerGets the sending view distance for this world.
Simulation DistanceIntegerReturns the simulation distance used for this world.
Spawn LocationLocationGets the default spawn Location of this world
Thunder DurationIntegerGet the thundering duration.
ThunderingBooleanReturns whether there is thunder.
Tickable Tile Entity CountIntegerThe amount of tickable block entities in this world
Tile Entity CountIntegerThe amount of block entities in this world
TimeLongGets the relative in-game time of this world, or 0 if this world does not have a world clock.
UidUUIDGets the Unique ID of this world
View DistanceIntegerReturns the view distance used for this world.
Void Damage AmountFloatGets the damage applied to the entities when they are in the void in this world.
Void Damage EnabledBooleanChecks if void damage is enabled on this world.
Void Damage Min Build Height OffsetNumberGets the offset applied to getMinHeight() to determine the height at which void damage starts to apply.
Weather DurationIntegerGet the remaining time in ticks of the current conditions.

Goes on with: Next

Nearest Player​

world.nearest_player

The closest player within a radius, missing when there is none

InTypeWhat it is
LocationLocationWhere to search from
RadiusNumberHow far to search
Survival Only (optional)BooleanWhether only players in survival or adventure count
OutTypeWhat it is
PlayerPlayerThe closest player; missing when none is in range, and on Folia when the range reaches into another region

Particle Delay​

particle.delay

Data for particles that appear after a delay in ticks, such as shriek

InTypeWhat it is
TicksIntegerHow long the particle waits before it shows
OutTypeWhat it is
DelayIntegerThe delay, as data for particles such as shriek

Particle Power​

particle.power

Data for particles that take a strength, such as dragon breath and sculk charge

InTypeWhat it is
PowerNumberThe strength the particle shows, e.g. of dragon breath
OutTypeWhat it is
PowerFloatThe strength the particle shows, e.g. of dragon breath

Read Dust​

dust.read

Reads the properties of a Dust

InTypeWhat it is
DustDustOptions which can be applied to dust particles - a particle color and size.
OutTypeWhat it is
ColorColorThe color of the particles to be displayed.
SizeFloatRelative size of the particle.

Read Dust Transition​

dust_transition.read

Reads the properties of a Dust Transition

InTypeWhat it is
Dust TransitionDust TransitionOptions which can be applied to a color transitioning dust particles.
OutTypeWhat it is
ColorColorThe color of the particles to be displayed.
SizeFloatRelative size of the particle.
To ColorColorThe final of the particles to be displayed.

Read Spell​

spell.read

Reads the properties of a Spell

InTypeWhat it is
SpellSpellOptions which can be applied to effect particles.
OutTypeWhat it is
ColorColorThe color of the particles to be displayed.
PowerFloatThe power of the particles to be displayed.

Read Trail​

trail.read

Reads the properties of a Trail

InTypeWhat it is
TrailTrailOptions which can be applied to trail particles - a location, color and duration.
OutTypeWhat it is
ColorColorThe color of the particles to be displayed.
DurationIntegerThe duration of the trail to be displayed.
TargetLocationThe target of the particles to be displayed.

Read World​

world.read

Reads the properties of a World

InTypeWhat it is
WorldWorldRepresents a world, which may contain entities, chunks and blocks
OutTypeWhat it is
Allow MonstersBooleanGets whether monsters can spawn in this world.
Auto SaveBooleanGets whether or not the world will automatically save
Bed WorksBooleanGets if beds work in this world.
Chunk CountIntegerThe amount of chunks in this world
Clear WeatherBooleanReturns whether the world has clear weather.
Clear Weather DurationIntegerGet the clear weather duration.
Coordinate ScaleNumberGets the coordinate scaling of this world.
Day TimeBooleanCheck if it is currently daytime in this world
DifficultyDifficultyGets the Difficulty of the world.
EntitiesList<Entity>Get a list of all entities in this World
Entity CountIntegerThe amount of entities in this world
EnvironmentEnvironmentGets the World.Environment type of this world
Fixed TimeBooleanChecks if this world has a fixed time
Full TimeLongGets the full in-game time on this world, or 0 if this world does not have a world clock.
Game TimeLongGets the full in-game time on this world since the world generation
HardcoreBooleanGets whether the world is hardcore or not.
InfiniburnCollection<Material>Gets the collection of materials that burn infinitely in this world.
Listening Plugin ChannelsSet<Text>Gets a set containing all the Plugin Channels that this client is listening on.
Living EntitiesList<Living Entity>Get a list of all living entities in this World
Logical HeightIntegerGets the maximum height to which chorus fruits and nether portals can bring players within this dimension.
Max HeightIntegerGets the maximum height of this world.
Min HeightIntegerGets the minimum height of this world.
Moon PhaseMoonPhasethe current moon phase at the current time in the world
NameTextGets the legacy Bukkit name of this world.
Piglin SafeBooleanGets if this world allow to piglins to survive without shaking and transforming to zombified piglins.
Player CountIntegerThe amount of players in this world
PlayersList<Player>Get a list of all players in this World
Respawn Anchor WorksBooleanGets if this world allows players to charge and use respawn anchors.
Sea LevelIntegerGets the sea level for this world.
SeedLongGets the Seed for this world.
Send View DistanceIntegerGets the sending view distance for this world.
Simulation DistanceIntegerReturns the simulation distance used for this world.
Spawn LocationLocationGets the default spawn Location of this world
Thunder DurationIntegerGet the thundering duration.
ThunderingBooleanReturns whether there is thunder.
Tickable Tile Entity CountIntegerThe amount of tickable block entities in this world
Tile Entity CountIntegerThe amount of block entities in this world
TimeLongGets the relative in-game time of this world, or 0 if this world does not have a world clock.
UidUUIDGets the Unique ID of this world
View DistanceIntegerReturns the view distance used for this world.
Void Damage AmountFloatGets the damage applied to the entities when they are in the void in this world.
Void Damage EnabledBooleanChecks if void damage is enabled on this world.
Void Damage Min Build Height OffsetNumberGets the offset applied to getMinHeight() to determine the height at which void damage starts to apply.
Weather DurationIntegerGet the remaining time in ticks of the current conditions.

Show Marker​

world.show_marker

Shows a glowing marker that grows over its time and then disappears, e.g. where an attack will land; every player sees it, without the resource pack

InTypeWhat it is
LocationLocationWhere it shows, on the ground
ColorColorIts colour
SizeNumberRadius of an area or cross, height of a pillar, in blocks
SecondsNumberHow long it grows and shows
For (optional)PlayerThe only player who sees it; everyone when not given

Goes on with: Next

Show Text​

world.show_text

Shows floating text for a while, facing whoever looks at it and seen through walls

InTypeWhat it is
LocationLocationWhere it floats
TextTextWhat it says, MiniMessage like <red>Run!
SecondsNumberHow long it shows
Size (optional)NumberIts scale, 1 for normal; 1 when not given
For (optional)PlayerThe only player who sees it; everyone when not given

Goes on with: Next

Spawn Lit TNT​

world.spawn_tnt

Spawns burning TNT that hurts what stands near but breaks no blocks

InTypeWhat it is
LocationLocationWhere it lies
Seconds (optional)NumberHow long the fuse burns; 2 when not given
Power (optional)NumberHow strong the explosion is, 4 for normal TNT; 4 when not given

Goes on with: Next

Spawn Particle​

world.spawn_particle

Spawns particles around a location; particles such as dust need data, connected from a node like Dust

InTypeWhat it is
WorldWorldThe world to spawn them in
ParticleParticleThe kind of particle
LocationLocationWhere they appear
CountIntegerHow many
Offset XNumberSpread east and west
Offset YNumberSpread up and down
Offset ZNumberSpread north and south
Data (optional)ObjectWhat particles such as dust need, from a node like Dust; leave empty for others

Goes on with: Next

Spawn Potion Cloud​

world.spawn_potion_cloud

Spawns a lingering cloud that applies a potion to everything inside

InTypeWhat it is
LocationLocationWhere the cloud appears
PotionPotionThe effect it gives
SecondsIntegerHow long it lasts
RadiusNumberIts size when it appears
Radius Per Tick (optional)NumberHow much it grows per tick; negative to shrink
Color (optional)ColorIts colour

Goes on with: Next

Strike Lightning​

world.strike_lightning

Strikes lightning at a location; an effect only strike looks the same but deals no damage and sets nothing on fire

InTypeWhat it is
WorldWorldThe world to strike in
LocationLocationWhere it strikes
Effect Only (optional)BooleanOnly the look and sound, no damage and no fire; false when not given

Goes on with: Next