public interface World extends PluginMessageRecipient, Metadatable
Modifier and Type | Interface and Description |
---|---|
static interface |
World.ChunkLoadCallback
Used by
getChunkAtAsync(Location,ChunkLoadCallback) methods
to request a Chunk to be loaded, with this callback receiving
the chunk when it is finished. |
static class |
World.Environment
Represents various map environment types that a world may be
|
static class |
World.Spigot |
Modifier and Type | Method and Description |
---|---|
boolean |
canGenerateStructures()
Gets whether or not structures are being generated.
|
boolean |
createExplosion(double x,
double y,
double z,
float power)
Creates explosion at given coordinates with given power
|
boolean |
createExplosion(double x,
double y,
double z,
float power,
boolean setFire)
Creates explosion at given coordinates with given power and optionally
setting blocks on fire.
|
boolean |
createExplosion(double x,
double y,
double z,
float power,
boolean setFire,
boolean breakBlocks)
Creates explosion at given coordinates with given power and optionally
setting blocks on fire or breaking blocks.
|
default boolean |
createExplosion(Entity source,
float power)
Creates explosion at given entities location with given power and optionally
setting blocks on fire, with the specified entity as the source.
|
default boolean |
createExplosion(Entity source,
float power,
boolean setFire)
Creates explosion at given entities location with given power and optionally
setting blocks on fire, with the specified entity as the source.
|
default boolean |
createExplosion(Entity source,
float power,
boolean setFire,
boolean breakBlocks)
Creates explosion at given entities location with given power and optionally
setting blocks on fire, with the specified entity as the source.
|
default boolean |
createExplosion(Entity source,
Location loc,
float power)
Creates explosion at given location with given power, with the specified entity as the source.
|
default boolean |
createExplosion(Entity source,
Location loc,
float power,
boolean setFire)
Creates explosion at given location with given power and optionally
setting blocks on fire, with the specified entity as the source.
|
boolean |
createExplosion(Entity source,
Location loc,
float power,
boolean setFire,
boolean breakBlocks)
Creates explosion at given location with given power and optionally
setting blocks on fire, with the specified entity as the source.
|
boolean |
createExplosion(Location loc,
float power)
Creates explosion at given coordinates with given power
|
boolean |
createExplosion(Location loc,
float power,
boolean setFire)
Creates explosion at given coordinates with given power and optionally
setting blocks on fire.
|
default boolean |
createExplosion(Location loc,
float power,
boolean setFire,
boolean breakBlocks)
Creates explosion at given location with given power and optionally
setting blocks on fire or breaking blocks.
|
Item |
dropItem(Location location,
ItemStack item)
Drops an item at the specified
Location |
Item |
dropItemNaturally(Location location,
ItemStack item)
Drops an item at the specified
Location with a random offset |
boolean |
generateTree(Location location,
TreeType type)
Creates a tree at the given
Location |
boolean |
generateTree(Location loc,
TreeType type,
BlockChangeDelegate delegate)
Deprecated.
rarely used API that was largely for implementation purposes
|
boolean |
getAllowAnimals()
Gets whether animals can spawn in this world.
|
boolean |
getAllowMonsters()
Gets whether monsters can spawn in this world.
|
int |
getAmbientSpawnLimit()
Gets the limit for number of ambient mobs that can spawn in a chunk in
this world
|
int |
getAnimalSpawnLimit()
Gets the limit for number of animals that can spawn in a chunk in this
world
|
Biome |
getBiome(int x,
int z)
Gets the biome for the given block coordinates.
|
Block |
getBlockAt(int x,
int y,
int z)
Gets the
Block at the given coordinates |
Block |
getBlockAt(Location location)
|
default Block |
getBlockAtKey(long key)
Gets the
Block at the given block key |
int |
getBlockTypeIdAt(int x,
int y,
int z)
Deprecated.
Magic value
|
int |
getBlockTypeIdAt(Location location)
Deprecated.
Magic value
|
Chunk |
getChunkAt(Block block)
|
Chunk |
getChunkAt(int x,
int z)
Gets the
Chunk at the given coordinates |
Chunk |
getChunkAt(Location location)
|
default Chunk |
getChunkAt(long chunkKey)
Gets the chunk at the specified chunk key, which is the X and Z packed into a long.
|
void |
getChunkAtAsync(Block block,
World.ChunkLoadCallback cb)
|
void |
getChunkAtAsync(int x,
int z,
World.ChunkLoadCallback cb)
Requests a
Chunk to be loaded at the given coordinates
This method makes no guarantee on how fast the chunk will load,
and will return the chunk to the callback at a later time. |
void |
getChunkAtAsync(Location location,
World.ChunkLoadCallback cb)
|
int |
getChunkCount() |
Difficulty |
getDifficulty()
Gets the Difficulty of the world.
|
ChunkSnapshot |
getEmptyChunkSnapshot(int x,
int z,
boolean includeBiome,
boolean includeBiomeTempRain)
Get empty chunk snapshot (equivalent to all air blocks), optionally
including valid biome data.
|
List<Entity> |
getEntities()
Get a list of all entities in this World
|
<T extends Entity> |
getEntitiesByClass(Class<T>... classes)
Deprecated.
|
<T extends Entity> |
getEntitiesByClass(Class<T> cls)
Get a collection of all entities in this World matching the given
class/interface
|
Collection<Entity> |
getEntitiesByClasses(Class<?>... classes)
Get a collection of all entities in this World matching any of the
given classes/interfaces
|
Entity |
getEntity(UUID uuid)
Gets an entity in this world by its UUID
|
int |
getEntityCount() |
World.Environment |
getEnvironment()
Gets the
World.Environment type of this world |
long |
getFullTime()
Gets the full in-game time on this world
|
String[] |
getGameRules()
Get existing rules
|
String |
getGameRuleValue(String rule)
Gets the current state of the specified rule
|
ChunkGenerator |
getGenerator()
Gets the chunk generator for this world
|
Block |
getHighestBlockAt(int x,
int z)
Gets the lowest block at the given coordinates such that the block and
all blocks above it are transparent for lighting purposes.
|
Block |
getHighestBlockAt(Location location)
Gets the lowest block at the given
Location such that the block
and all blocks above it are transparent for lighting purposes. |
int |
getHighestBlockYAt(int x,
int z)
Gets the y coordinate of the lowest block at this position such that the
block and all blocks above it are transparent for lighting purposes.
|
int |
getHighestBlockYAt(Location location)
Gets the y coordinate of the lowest block at the given
Location
such that the block and all blocks above it are transparent for lighting
purposes. |
double |
getHumidity(int x,
int z)
Gets the humidity for the given block coordinates.
|
boolean |
getKeepSpawnInMemory()
Gets whether the world's spawn area should be kept loaded into memory
or not.
|
List<LivingEntity> |
getLivingEntities()
Get a list of all living entities in this World
|
Chunk[] |
getLoadedChunks()
Gets an array of all loaded
Chunk s |
default Location |
getLocationAtKey(long key)
Gets the
Location at the given block key |
int |
getMaxHeight()
Gets the maximum height of this world.
|
int |
getMonsterSpawnLimit()
Gets limit for number of monsters that can spawn in a chunk in this
world
|
String |
getName()
Gets the unique name of this world
|
Collection<Entity> |
getNearbyEntities(Location location,
double x,
double y,
double z)
Returns a list of entities within a bounding box centered around a Location.
|
default <T extends Entity> |
getNearbyEntitiesByType(Class<? extends Entity> clazz,
Location loc,
double xRadius,
double yRadius,
double zRadius,
Predicate<T> predicate)
Gets all nearby entities of the specified type, within the specified radius (bounding box)
|
default <T extends Entity> |
getNearbyEntitiesByType(Class<? extends T> clazz,
Location loc,
double radius)
Gets all nearby entities of the specified type, within the specified radius (bounding box)
|
default <T extends Entity> |
getNearbyEntitiesByType(Class<? extends T> clazz,
Location loc,
double xzRadius,
double yRadius)
Gets all nearby entities of the specified type, within the specified radius, with x and x radius matching (bounding box)
|
default <T extends Entity> |
getNearbyEntitiesByType(Class<? extends T> clazz,
Location loc,
double xRadius,
double yRadius,
double zRadius)
Gets all nearby entities of the specified type, within the specified radius (bounding box)
|
default <T extends Entity> |
getNearbyEntitiesByType(Class<? extends T> clazz,
Location loc,
double xzRadius,
double yRadius,
Predicate<T> predicate)
Gets all nearby entities of the specified type, within the specified radius, with x and x radius matching (bounding box)
|
default <T extends Entity> |
getNearbyEntitiesByType(Class<? extends T> clazz,
Location loc,
double radius,
Predicate<T> predicate)
Gets all nearby entities of the specified type, within the specified radius (bounding box)
|
default Collection<LivingEntity> |
getNearbyLivingEntities(Location loc,
double radius)
Gets nearby players within the specified radius (bounding box)
|
default Collection<LivingEntity> |
getNearbyLivingEntities(Location loc,
double xzRadius,
double yRadius)
Gets nearby players within the specified radius (bounding box)
|
default Collection<LivingEntity> |
getNearbyLivingEntities(Location loc,
double xRadius,
double yRadius,
double zRadius)
Gets nearby players within the specified radius (bounding box)
|
default Collection<LivingEntity> |
getNearbyLivingEntities(Location loc,
double xRadius,
double yRadius,
double zRadius,
Predicate<LivingEntity> predicate)
Gets nearby players within the specified radius (bounding box)
|
default Collection<LivingEntity> |
getNearbyLivingEntities(Location loc,
double xzRadius,
double yRadius,
Predicate<LivingEntity> predicate)
Gets nearby players within the specified radius (bounding box)
|
default Collection<LivingEntity> |
getNearbyLivingEntities(Location loc,
double radius,
Predicate<LivingEntity> predicate)
Gets nearby players within the specified radius (bounding box)
|
default Collection<Player> |
getNearbyPlayers(Location loc,
double radius)
Gets nearby players within the specified radius (bounding box)
|
default Collection<Player> |
getNearbyPlayers(Location loc,
double xzRadius,
double yRadius)
Gets nearby players within the specified radius (bounding box)
|
default Collection<Player> |
getNearbyPlayers(Location loc,
double xRadius,
double yRadius,
double zRadius)
Gets nearby players within the specified radius (bounding box)
|
default Collection<Player> |
getNearbyPlayers(Location loc,
double xRadius,
double yRadius,
double zRadius,
Predicate<Player> predicate)
Gets nearby players within the specified radius (bounding box)
|
default Collection<Player> |
getNearbyPlayers(Location loc,
double xzRadius,
double yRadius,
Predicate<Player> predicate)
Gets nearby players within the specified radius (bounding box)
|
default Collection<Player> |
getNearbyPlayers(Location loc,
double radius,
Predicate<Player> predicate)
Gets nearby players within the specified radius (bounding box)
|
int |
getPlayerCount() |
List<Player> |
getPlayers()
Get a list of all players in this World
|
List<BlockPopulator> |
getPopulators()
Gets a list of all applied
BlockPopulator s for this World |
boolean |
getPVP()
Gets the current PVP setting for this world.
|
int |
getSeaLevel()
Gets the sea level for this world.
|
long |
getSeed()
Gets the Seed for this world.
|
Location |
getSpawnLocation()
Gets the default spawn
Location of this world |
double |
getTemperature(int x,
int z)
Gets the temperature for the given block coordinates.
|
int |
getThunderDuration()
Get the thundering duration.
|
int |
getTickableTileEntityCount() |
long |
getTicksPerAnimalSpawns()
Gets the world's ticks per animal spawns value
|
long |
getTicksPerMonsterSpawns()
Gets the world's ticks per monster spawns value
|
int |
getTileEntityCount() |
long |
getTime()
Gets the relative in-game time of this world.
|
UUID |
getUID()
Gets the Unique ID of this world
|
int |
getWaterAnimalSpawnLimit()
Gets the limit for number of water animals that can spawn in a chunk in
this world
|
int |
getWeatherDuration()
Get the remaining time in ticks of the current conditions.
|
WorldBorder |
getWorldBorder()
Gets the world border for this world.
|
File |
getWorldFolder()
Gets the folder of this world on disk.
|
WorldType |
getWorldType()
Gets the type of this world.
|
boolean |
hasStorm()
Returns whether the world has an ongoing storm.
|
boolean |
isAutoSave()
Gets whether or not the world will automatically save
|
boolean |
isChunkGenerated(int x,
int z)
Checks if a
Chunk has been generated at the given coordinates. |
default boolean |
isChunkGenerated(long chunkKey)
Checks if a
Chunk has been generated at the specified chunk key,
which is the X and Z packed into a long. |
boolean |
isChunkInUse(int x,
int z)
Checks if the
Chunk at the specified coordinates is loaded and
in use by one or more players |
boolean |
isChunkLoaded(Chunk chunk)
Checks if the specified
Chunk is loaded |
boolean |
isChunkLoaded(int x,
int z)
Checks if the
Chunk at the specified coordinates is loaded |
boolean |
isGameRule(String rule)
Checks if string is a valid game rule
|
boolean |
isThundering()
Returns whether there is thunder.
|
void |
loadChunk(Chunk chunk)
Loads the specified
Chunk |
void |
loadChunk(int x,
int z)
Loads the
Chunk at the specified coordinates |
boolean |
loadChunk(int x,
int z,
boolean generate)
Loads the
Chunk at the specified coordinates |
void |
playEffect(Location location,
Effect effect,
int data)
Plays an effect to all players within a default radius around a given
location.
|
void |
playEffect(Location location,
Effect effect,
int data,
int radius)
Plays an effect to all players within a given radius around a location.
|
<T> void |
playEffect(Location location,
Effect effect,
T data)
Plays an effect to all players within a default radius around a given
location.
|
<T> void |
playEffect(Location location,
Effect effect,
T data,
int radius)
Plays an effect to all players within a given radius around a location.
|
void |
playSound(Location location,
Sound sound,
float volume,
float pitch)
Play a Sound at the provided Location in the World
|
void |
playSound(Location location,
Sound sound,
SoundCategory category,
float volume,
float pitch)
Play a Sound at the provided Location in the World.
|
void |
playSound(Location location,
String sound,
float volume,
float pitch)
Play a Sound at the provided Location in the World.
|
void |
playSound(Location location,
String sound,
SoundCategory category,
float volume,
float pitch)
Play a Sound at the provided Location in the World.
|
boolean |
refreshChunk(int x,
int z)
Deprecated.
This method is not guaranteed to work suitably across all client implementations.
|
boolean |
regenerateChunk(int x,
int z)
Regenerates the
Chunk at the specified coordinates |
void |
save()
Saves world to disk
|
void |
setAmbientSpawnLimit(int limit)
Sets the limit for number of ambient mobs that can spawn in a chunk in
this world
|
void |
setAnimalSpawnLimit(int limit)
Sets the limit for number of animals that can spawn in a chunk in this
world
|
void |
setAutoSave(boolean value)
Sets whether or not the world will automatically save
|
void |
setBiome(int x,
int z,
Biome bio)
Sets the biome for the given block coordinates
|
void |
setDifficulty(Difficulty difficulty)
Sets the Difficulty of the world.
|
void |
setFullTime(long time)
Sets the in-game time on the server
|
boolean |
setGameRuleValue(String rule,
String value)
Set the specified gamerule to specified value.
|
void |
setKeepSpawnInMemory(boolean keepLoaded)
Sets whether the world's spawn area should be kept loaded into memory
or not.
|
void |
setMonsterSpawnLimit(int limit)
Sets the limit for number of monsters that can spawn in a chunk in this
world
|
void |
setPVP(boolean pvp)
Sets the PVP setting for this world.
|
void |
setSpawnFlags(boolean allowMonsters,
boolean allowAnimals)
Sets the spawn flags for this.
|
boolean |
setSpawnLocation(int x,
int y,
int z)
Sets the spawn location of the world
|
boolean |
setSpawnLocation(Location location)
Sets the spawn location of the world.
|
void |
setStorm(boolean hasStorm)
Set whether there is a storm.
|
void |
setThunderDuration(int duration)
Set the thundering duration.
|
void |
setThundering(boolean thundering)
Set whether it is thundering.
|
void |
setTicksPerAnimalSpawns(int ticksPerAnimalSpawns)
Sets the world's ticks per animal spawns value
|
void |
setTicksPerMonsterSpawns(int ticksPerMonsterSpawns)
Sets the world's ticks per monster spawns value
|
void |
setTime(long time)
Sets the relative in-game time on the server.
|
void |
setWaterAnimalSpawnLimit(int limit)
Sets the limit for number of water animals that can spawn in a chunk in
this world
|
void |
setWeatherDuration(int duration)
Set the remaining time in ticks of the current conditions.
|
<T extends Entity> |
spawn(Location location,
Class<T> clazz)
Spawn an entity of a specific class at the given
Location |
<T extends Entity> |
spawn(Location location,
Class<T> clazz,
Consumer<T> function)
Spawn an entity of a specific class at the given
Location , with
the supplied function run before the entity is added to the world. |
Arrow |
spawnArrow(Location location,
Vector direction,
float speed,
float spread)
|
<T extends Arrow> |
spawnArrow(Location location,
Vector direction,
float speed,
float spread,
Class<T> clazz)
Creates an arrow entity of the given class at the given
Location |
Entity |
spawnEntity(Location loc,
EntityType type)
Creates a entity at the given
Location |
FallingBlock |
spawnFallingBlock(Location location,
int blockId,
byte blockData)
Deprecated.
Magic value
|
FallingBlock |
spawnFallingBlock(Location location,
Material material,
byte data)
Deprecated.
Magic value
|
FallingBlock |
spawnFallingBlock(Location location,
MaterialData data)
|
void |
spawnParticle(Particle particle,
double x,
double y,
double z,
int count)
Spawns the particle (the number of times specified by count)
at the target location.
|
void |
spawnParticle(Particle particle,
double x,
double y,
double z,
int count,
double offsetX,
double offsetY,
double offsetZ)
Spawns the particle (the number of times specified by count)
at the target location.
|
void |
spawnParticle(Particle particle,
double x,
double y,
double z,
int count,
double offsetX,
double offsetY,
double offsetZ,
double extra)
Spawns the particle (the number of times specified by count)
at the target location.
|
default <T> void |
spawnParticle(Particle particle,
double x,
double y,
double z,
int count,
double offsetX,
double offsetY,
double offsetZ,
double extra,
T data)
Spawns the particle (the number of times specified by count)
at the target location.
|
<T> void |
spawnParticle(Particle particle,
double x,
double y,
double z,
int count,
double offsetX,
double offsetY,
double offsetZ,
T data)
Spawns the particle (the number of times specified by count)
at the target location.
|
<T> void |
spawnParticle(Particle particle,
double x,
double y,
double z,
int count,
T data)
Spawns the particle (the number of times specified by count)
at the target location.
|
default <T> void |
spawnParticle(Particle particle,
List<Player> receivers,
Player source,
double x,
double y,
double z,
int count,
double offsetX,
double offsetY,
double offsetZ,
double extra,
T data)
Spawns the particle (the number of times specified by count)
at the target location.
|
<T> void |
spawnParticle(Particle particle,
List<Player> receivers,
Player source,
double x,
double y,
double z,
int count,
double offsetX,
double offsetY,
double offsetZ,
double extra,
T data,
boolean force)
Spawns the particle (the number of times specified by count)
at the target location.
|
void |
spawnParticle(Particle particle,
Location location,
int count)
Spawns the particle (the number of times specified by count)
at the target location.
|
void |
spawnParticle(Particle particle,
Location location,
int count,
double offsetX,
double offsetY,
double offsetZ)
Spawns the particle (the number of times specified by count)
at the target location.
|
void |
spawnParticle(Particle particle,
Location location,
int count,
double offsetX,
double offsetY,
double offsetZ,
double extra)
Spawns the particle (the number of times specified by count)
at the target location.
|
<T> void |
spawnParticle(Particle particle,
Location location,
int count,
double offsetX,
double offsetY,
double offsetZ,
double extra,
T data)
Spawns the particle (the number of times specified by count)
at the target location.
|
<T> void |
spawnParticle(Particle particle,
Location location,
int count,
double offsetX,
double offsetY,
double offsetZ,
T data)
Spawns the particle (the number of times specified by count)
at the target location.
|
<T> void |
spawnParticle(Particle particle,
Location location,
int count,
T data)
Spawns the particle (the number of times specified by count)
at the target location.
|
World.Spigot |
spigot() |
LightningStrike |
strikeLightning(Location loc)
Strikes lightning at the given
Location |
LightningStrike |
strikeLightningEffect(Location loc)
Strikes lightning at the given
Location without doing damage |
boolean |
unloadChunk(Chunk chunk)
Safely unloads and saves the
Chunk at the specified coordinates |
boolean |
unloadChunk(int x,
int z)
Safely unloads and saves the
Chunk at the specified coordinates |
boolean |
unloadChunk(int x,
int z,
boolean save)
Safely unloads and optionally saves the
Chunk at the specified
coordinates |
boolean |
unloadChunk(int x,
int z,
boolean save,
boolean safe)
Deprecated.
it is never safe to remove a chunk in use
|
boolean |
unloadChunkRequest(int x,
int z)
Safely queues the
Chunk at the specified coordinates for
unloading |
boolean |
unloadChunkRequest(int x,
int z,
boolean safe)
Queues the
Chunk at the specified coordinates for unloading |
getListeningPluginChannels, sendPluginMessage
getMetadata, hasMetadata, removeMetadata, setMetadata
int getEntityCount()
int getTileEntityCount()
int getTickableTileEntityCount()
int getChunkCount()
int getPlayerCount()
Block getBlockAt(int x, int y, int z)
Block
at the given coordinatesx
- X-coordinate of the blocky
- Y-coordinate of the blockz
- Z-coordinate of the blockReturns the current type ID of
the block
Block getBlockAt(Location location)
location
- Location of the blockReturns the current type ID
of the block
default Block getBlockAtKey(long key)
Block
at the given block keykey
- The block key. See Block.getBlockKey()
Location.toBlockKey()
,
Block.getBlockKey()
default Location getLocationAtKey(long key)
Location
at the given block keykey
- The block key. See Location.toBlockKey()
Location.toBlockKey()
,
Block.getBlockKey()
@Deprecated int getBlockTypeIdAt(int x, int y, int z)
x
- X-coordinate of the blocky
- Y-coordinate of the blockz
- Z-coordinate of the blockReturns a live Block object at the
given location
@Deprecated int getBlockTypeIdAt(Location location)
Location
location
- Location of the blockReturns a live Block object at
the given location
int getHighestBlockYAt(int x, int z)
x
- X-coordinate of the blocksz
- Z-coordinate of the blocksint getHighestBlockYAt(Location location)
Location
such that the block and all blocks above it are transparent for lighting
purposes.location
- Location of the blocksBlock getHighestBlockAt(int x, int z)
x
- X-coordinate of the blockz
- Z-coordinate of the blockBlock getHighestBlockAt(Location location)
Location
such that the block
and all blocks above it are transparent for lighting purposes.location
- Coordinates to get the highest blockChunk getChunkAt(int x, int z)
Chunk
at the given coordinatesx
- X-coordinate of the chunkz
- Z-coordinate of the chunkChunk getChunkAt(Location location)
location
- Location of the chunkChunk getChunkAt(Block block)
block
- Block to get the containing chunk fromdefault Chunk getChunkAt(long chunkKey)
Chunk.getChunkKey()
for easy access to the key, or you may calculate it as:
long chunkKey = (long) chunkX & 0xffffffffL | ((long) chunkZ & 0xffffffffL) >> 32;chunkKey
- The Chunk Key to look up the chunk bydefault boolean isChunkGenerated(long chunkKey)
Chunk
has been generated at the specified chunk key,
which is the X and Z packed into a long.chunkKey
- The Chunk Key to look up the chunk byboolean isChunkGenerated(int x, int z)
Chunk
has been generated at the given coordinates.x
- X-coordinate of the chunkz
- Z-coordinate of the chunkvoid getChunkAtAsync(int x, int z, World.ChunkLoadCallback cb)
Chunk
to be loaded at the given coordinates
This method makes no guarantee on how fast the chunk will load,
and will return the chunk to the callback at a later time.
You should use this method if you need a chunk but do not need it
immediately, and you wish to let the server control the speed
of chunk loads, keeping performance in mind.
The World.ChunkLoadCallback
will always be executed synchronously
on the main Server Thread.x
- Chunk X-coordinate of the chunk - (world coordinate / 16)z
- Chunk Z-coordinate of the chunk - (world coordinate / 16)cb
- Callback to receive the chunk when it is loaded.
will be executed synchronouslyvoid getChunkAtAsync(Location location, World.ChunkLoadCallback cb)
Chunk
to be loaded at the given Location
This method makes no guarantee on how fast the chunk will load,
and will return the chunk to the callback at a later time.
You should use this method if you need a chunk but do not need it
immediately, and you wish to let the server control the speed
of chunk loads, keeping performance in mind.
The World.ChunkLoadCallback
will always be executed synchronously
on the main Server Thread.location
- Location of the chunkcb
- Callback to receive the chunk when it is loaded.
will be executed synchronouslyvoid getChunkAtAsync(Block block, World.ChunkLoadCallback cb)
Chunk
to be loaded that contains the given Block
This method makes no guarantee on how fast the chunk will load,
and will return the chunk to the callback at a later time.
You should use this method if you need a chunk but do not need it
immediately, and you wish to let the server control the speed
of chunk loads, keeping performance in mind.
The World.ChunkLoadCallback
will always be executed synchronously
on the main Server Thread.block
- Block to get the containing chunk fromcb
- Callback to receive the chunk when it is loaded.
will be executed synchronouslyboolean isChunkLoaded(Chunk chunk)
Chunk
is loadedchunk
- The chunk to checkChunk[] getLoadedChunks()
Chunk
svoid loadChunk(Chunk chunk)
Chunk
chunk
- The chunk to loadboolean isChunkLoaded(int x, int z)
Chunk
at the specified coordinates is loadedx
- X-coordinate of the chunkz
- Z-coordinate of the chunkboolean isChunkInUse(int x, int z)
Chunk
at the specified coordinates is loaded and
in use by one or more playersx
- X-coordinate of the chunkz
- Z-coordinate of the chunkvoid loadChunk(int x, int z)
Chunk
at the specified coordinates
If the chunk does not exist, it will be generated.
This method is analogous to loadChunk(int, int, boolean)
where
generate is true.
x
- X-coordinate of the chunkz
- Z-coordinate of the chunkboolean loadChunk(int x, int z, boolean generate)
Chunk
at the specified coordinatesx
- X-coordinate of the chunkz
- Z-coordinate of the chunkgenerate
- Whether or not to generate a chunk if it doesn't
already existboolean unloadChunk(Chunk chunk)
Chunk
at the specified coordinates
This method is analogous to unloadChunk(int, int, boolean,
boolean)
where safe and saveis true
chunk
- the chunk to unloadboolean unloadChunk(int x, int z)
Chunk
at the specified coordinates
This method is analogous to unloadChunk(int, int, boolean,
boolean)
where safe and saveis true
x
- X-coordinate of the chunkz
- Z-coordinate of the chunkboolean unloadChunk(int x, int z, boolean save)
Chunk
at the specified
coordinates
This method is analogous to unloadChunk(int, int, boolean,
boolean)
where save is true
x
- X-coordinate of the chunkz
- Z-coordinate of the chunksave
- Whether or not to save the chunk@Deprecated boolean unloadChunk(int x, int z, boolean save, boolean safe)
Chunk
at the specified
coordinatesx
- X-coordinate of the chunkz
- Z-coordinate of the chunksave
- Controls whether the chunk is savedsafe
- Controls whether to unload the chunk when players are
nearbyboolean unloadChunkRequest(int x, int z)
Chunk
at the specified coordinates for
unloading
This method is analogous to unloadChunkRequest(int, int,
boolean)
where safe is true
x
- X-coordinate of the chunkz
- Z-coordinate of the chunkboolean unloadChunkRequest(int x, int z, boolean safe)
Chunk
at the specified coordinates for unloadingx
- X-coordinate of the chunkz
- Z-coordinate of the chunksafe
- Controls whether to queue the chunk when players are nearbyboolean regenerateChunk(int x, int z)
Chunk
at the specified coordinatesx
- X-coordinate of the chunkz
- Z-coordinate of the chunk@Deprecated boolean refreshChunk(int x, int z)
Chunk
to all clientsx
- X-coordinate of the chunkz
- Z-coordinate of the chunkItem dropItem(Location location, ItemStack item)
Location
location
- Location to drop the itemitem
- ItemStack to dropItem dropItemNaturally(Location location, ItemStack item)
Location
with a random offsetlocation
- Location to drop the itemitem
- ItemStack to dropArrow spawnArrow(Location location, Vector direction, float speed, float spread)
location
- Location to spawn the arrowdirection
- Direction to shoot the arrow inspeed
- Speed of the arrow. A recommend speed is 0.6spread
- Spread of the arrow. A recommend spread is 12<T extends Arrow> T spawnArrow(Location location, Vector direction, float speed, float spread, Class<T> clazz)
Location
T
- type of arrow to spawnlocation
- Location to spawn the arrowdirection
- Direction to shoot the arrow inspeed
- Speed of the arrow. A recommend speed is 0.6spread
- Spread of the arrow. A recommend spread is 12clazz
- the Entity class for the arrow
SpectralArrow
,Arrow
,TippedArrow
boolean generateTree(Location location, TreeType type)
Location
location
- Location to spawn the treetype
- Type of the tree to create@Deprecated boolean generateTree(Location loc, TreeType type, BlockChangeDelegate delegate)
Location
loc
- Location to spawn the treetype
- Type of the tree to createdelegate
- A class to call for each block changed as a result of
this methodEntity spawnEntity(Location loc, EntityType type)
Location
loc
- The location to spawn the entitytype
- The entity to spawnLightningStrike strikeLightning(Location loc)
Location
loc
- The location to strike lightningLightningStrike strikeLightningEffect(Location loc)
Location
without doing damageloc
- The location to strike lightningList<Entity> getEntities()
List<LivingEntity> getLivingEntities()
@Deprecated <T extends Entity> Collection<T> getEntitiesByClass(Class<T>... classes)
T
- an entity subclassclasses
- The classes representing the types of entity to match<T extends Entity> Collection<T> getEntitiesByClass(Class<T> cls)
T
- an entity subclasscls
- The class representing the type of entity to matchCollection<Entity> getEntitiesByClasses(Class<?>... classes)
classes
- The classes representing the types of entity to matchdefault Collection<LivingEntity> getNearbyLivingEntities(Location loc, double radius)
loc
- Center locationradius
- Radiusdefault Collection<LivingEntity> getNearbyLivingEntities(Location loc, double xzRadius, double yRadius)
loc
- Center locationxzRadius
- X/Z RadiusyRadius
- Y Radiusdefault Collection<LivingEntity> getNearbyLivingEntities(Location loc, double xRadius, double yRadius, double zRadius)
loc
- Center locationxRadius
- X RadiusyRadius
- Y RadiuszRadius
- Z radiusdefault Collection<LivingEntity> getNearbyLivingEntities(Location loc, double radius, Predicate<LivingEntity> predicate)
loc
- Center locationradius
- X Radiuspredicate
- a predicate used to filter resultsdefault Collection<LivingEntity> getNearbyLivingEntities(Location loc, double xzRadius, double yRadius, Predicate<LivingEntity> predicate)
loc
- Center locationxzRadius
- X/Z RadiusyRadius
- Y Radiuspredicate
- a predicate used to filter resultsdefault Collection<LivingEntity> getNearbyLivingEntities(Location loc, double xRadius, double yRadius, double zRadius, Predicate<LivingEntity> predicate)
loc
- Center locationxRadius
- X RadiusyRadius
- Y RadiuszRadius
- Z radiuspredicate
- a predicate used to filter resultsdefault Collection<Player> getNearbyPlayers(Location loc, double radius)
loc
- Center locationradius
- X/Y/Z Radiusdefault Collection<Player> getNearbyPlayers(Location loc, double xzRadius, double yRadius)
loc
- Center locationxzRadius
- X/Z RadiusyRadius
- Y Radiusdefault Collection<Player> getNearbyPlayers(Location loc, double xRadius, double yRadius, double zRadius)
loc
- Center locationxRadius
- X RadiusyRadius
- Y RadiuszRadius
- Z Radiusdefault Collection<Player> getNearbyPlayers(Location loc, double radius, Predicate<Player> predicate)
loc
- Center locationradius
- X/Y/Z Radiuspredicate
- a predicate used to filter resultsdefault Collection<Player> getNearbyPlayers(Location loc, double xzRadius, double yRadius, Predicate<Player> predicate)
loc
- Center locationxzRadius
- X/Z RadiusyRadius
- Y Radiuspredicate
- a predicate used to filter resultsdefault Collection<Player> getNearbyPlayers(Location loc, double xRadius, double yRadius, double zRadius, Predicate<Player> predicate)
loc
- Center locationxRadius
- X RadiusyRadius
- Y RadiuszRadius
- Z Radiuspredicate
- a predicate used to filter resultsdefault <T extends Entity> Collection<T> getNearbyEntitiesByType(Class<? extends T> clazz, Location loc, double radius)
T
- the entity typeclazz
- Type to filter byloc
- Center locationradius
- X/Y/Z radius to search withindefault <T extends Entity> Collection<T> getNearbyEntitiesByType(Class<? extends T> clazz, Location loc, double xzRadius, double yRadius)
T
- the entity typeclazz
- Type to filter byloc
- Center locationxzRadius
- X/Z radius to search withinyRadius
- Y radius to search withindefault <T extends Entity> Collection<T> getNearbyEntitiesByType(Class<? extends T> clazz, Location loc, double xRadius, double yRadius, double zRadius)
T
- the entity typeclazz
- Type to filter byloc
- Center locationxRadius
- X RadiusyRadius
- Y RadiuszRadius
- Z Radiusdefault <T extends Entity> Collection<T> getNearbyEntitiesByType(Class<? extends T> clazz, Location loc, double radius, Predicate<T> predicate)
T
- the entity typeclazz
- Type to filter byloc
- Center locationradius
- X/Y/Z radius to search withinpredicate
- a predicate used to filter resultsdefault <T extends Entity> Collection<T> getNearbyEntitiesByType(Class<? extends T> clazz, Location loc, double xzRadius, double yRadius, Predicate<T> predicate)
T
- the entity typeclazz
- Type to filter byloc
- Center locationxzRadius
- X/Z radius to search withinyRadius
- Y radius to search withinpredicate
- a predicate used to filter resultsdefault <T extends Entity> Collection<T> getNearbyEntitiesByType(Class<? extends Entity> clazz, Location loc, double xRadius, double yRadius, double zRadius, Predicate<T> predicate)
T
- the entity typeclazz
- Type to filter byloc
- Center locationxRadius
- X RadiusyRadius
- Y RadiuszRadius
- Z Radiuspredicate
- a predicate used to filter resultsList<Player> getPlayers()
Collection<Entity> getNearbyEntities(Location location, double x, double y, double z)
location
- The center of the bounding boxx
- 1/2 the size of the box along x axisy
- 1/2 the size of the box along y axisz
- 1/2 the size of the box along z axisEntity getEntity(UUID uuid)
uuid
- the UUID of the entityString getName()
UUID getUID()
Location getSpawnLocation()
Location
of this worldboolean setSpawnLocation(Location location)
location
- The Location
to set the spawn for this world at.boolean setSpawnLocation(int x, int y, int z)
x
- X coordinatey
- Y coordinatez
- Z coordinatelong getTime()
The relative time is analogous to hours * 1000
Returns an absolute time of this world
void setTime(long time)
The relative time is analogous to hours * 1000
Note that setting the relative time below the current relative time
will actually move the clock forward a day. If you require to rewind
time, please see setFullTime(long)
time
- The new relative time to set the in-game time to (in
hours*1000)Sets the absolute time of this world
long getFullTime()
Returns a relative time of this world
void setFullTime(long time)
Note that this sets the full time of the world, which may cause adverse effects such as breaking redstone clocks and any scheduled events
time
- The new absolute time to set this world toSets the relative time of this world
boolean hasStorm()
void setStorm(boolean hasStorm)
hasStorm
- Whether there is rain and snowint getWeatherDuration()
void setWeatherDuration(int duration)
duration
- Time in ticksboolean isThundering()
void setThundering(boolean thundering)
thundering
- Whether it is thunderingint getThunderDuration()
void setThunderDuration(int duration)
duration
- Duration in ticksboolean createExplosion(double x, double y, double z, float power)
x
- X coordinatey
- Y coordinatez
- Z coordinatepower
- The power of explosion, where 4F is TNTboolean createExplosion(double x, double y, double z, float power, boolean setFire)
x
- X coordinatey
- Y coordinatez
- Z coordinatepower
- The power of explosion, where 4F is TNTsetFire
- Whether or not to set blocks on fireboolean createExplosion(double x, double y, double z, float power, boolean setFire, boolean breakBlocks)
x
- X coordinatey
- Y coordinatez
- Z coordinatepower
- The power of explosion, where 4F is TNTsetFire
- Whether or not to set blocks on firebreakBlocks
- Whether or not to have blocks be destroyedboolean createExplosion(Location loc, float power)
loc
- Location to blow uppower
- The power of explosion, where 4F is TNTboolean createExplosion(Location loc, float power, boolean setFire)
loc
- Location to blow uppower
- The power of explosion, where 4F is TNTsetFire
- Whether or not to set blocks on fireboolean createExplosion(Entity source, Location loc, float power, boolean setFire, boolean breakBlocks)
source
- The source entity of the explosionloc
- Location to blow uppower
- The power of explosion, where 4F is TNTsetFire
- Whether or not to set blocks on firebreakBlocks
- Whether or not to have blocks be destroyeddefault boolean createExplosion(Entity source, Location loc, float power, boolean setFire)
source
- The source entity of the explosionloc
- Location to blow uppower
- The power of explosion, where 4F is TNTsetFire
- Whether or not to set blocks on firedefault boolean createExplosion(Entity source, Location loc, float power)
source
- The source entity of the explosionloc
- Location to blow uppower
- The power of explosion, where 4F is TNTdefault boolean createExplosion(Entity source, float power, boolean setFire, boolean breakBlocks)
source
- The source entity of the explosionpower
- The power of explosion, where 4F is TNTsetFire
- Whether or not to set blocks on firebreakBlocks
- Whether or not to have blocks be destroyeddefault boolean createExplosion(Entity source, float power, boolean setFire)
source
- The source entity of the explosionpower
- The power of explosion, where 4F is TNTsetFire
- Whether or not to set blocks on firedefault boolean createExplosion(Entity source, float power)
source
- The source entity of the explosionpower
- The power of explosion, where 4F is TNTdefault boolean createExplosion(Location loc, float power, boolean setFire, boolean breakBlocks)
loc
- Location to blow uppower
- The power of explosion, where 4F is TNTsetFire
- Whether or not to set blocks on firebreakBlocks
- Whether or not to have blocks be destroyedWorld.Environment getEnvironment()
World.Environment
type of this worldlong getSeed()
boolean getPVP()
void setPVP(boolean pvp)
pvp
- True/False whether PVP should be Enabled.ChunkGenerator getGenerator()
void save()
List<BlockPopulator> getPopulators()
BlockPopulator
s for this World<T extends Entity> T spawn(Location location, Class<T> clazz) throws IllegalArgumentException
Location
T
- the class of the Entity
to spawnlocation
- the Location
to spawn the entity atclazz
- the class of the Entity
to spawnEntity
IllegalArgumentException
- if either parameter is null or the
Entity
requested cannot be spawned<T extends Entity> T spawn(Location location, Class<T> clazz, Consumer<T> function) throws IllegalArgumentException
Location
, with
the supplied function run before the entity is added to the world.
T
- the class of the Entity
to spawnlocation
- the Location
to spawn the entity atclazz
- the class of the Entity
to spawnfunction
- the function to be run before the entity is spawned.Entity
IllegalArgumentException
- if either parameter is null or the
Entity
requested cannot be spawnedFallingBlock spawnFallingBlock(Location location, MaterialData data) throws IllegalArgumentException
FallingBlock
entity at the given Location
of
the specified Material
. The material dictates what is falling.
When the FallingBlock hits the ground, it will place that block.
The Material must be a block type, check with material.isBlock()
. The Material may not be air.
location
- The Location
to spawn the FallingBlockdata
- The block dataFallingBlock
instanceIllegalArgumentException
- if Location
or MaterialData
are null or Material
of the MaterialData
is not a block@Deprecated FallingBlock spawnFallingBlock(Location location, Material material, byte data) throws IllegalArgumentException
FallingBlock
entity at the given Location
of
the specified Material
. The material dictates what is falling.
When the FallingBlock hits the ground, it will place that block.
The Material must be a block type, check with material.isBlock()
. The Material may not be air.
location
- The Location
to spawn the FallingBlockmaterial
- The block Material
typedata
- The block dataFallingBlock
instanceIllegalArgumentException
- if Location
or Material
are null or Material
is not a block@Deprecated FallingBlock spawnFallingBlock(Location location, int blockId, byte blockData) throws IllegalArgumentException
location
- The Location
to spawn the FallingBlockblockId
- The id of the intended materialblockData
- The block dataIllegalArgumentException
- if location is null, or blockId is
invalidspawnFallingBlock(org.bukkit.Location, org.bukkit.Material, byte)
void playEffect(Location location, Effect effect, int data)
void playEffect(Location location, Effect effect, int data, int radius)
<T> void playEffect(Location location, Effect effect, T data)
<T> void playEffect(Location location, Effect effect, T data, int radius)
ChunkSnapshot getEmptyChunkSnapshot(int x, int z, boolean includeBiome, boolean includeBiomeTempRain)
x
- - chunk x coordinatez
- - chunk z coordinateincludeBiome
- - if true, snapshot includes per-coordinate biome
typeincludeBiomeTempRain
- - if true, snapshot includes per-coordinate
raw biome temperature and rainfallvoid setSpawnFlags(boolean allowMonsters, boolean allowAnimals)
allowMonsters
- - if true, monsters are allowed to spawn in this
world.allowAnimals
- - if true, animals are allowed to spawn in this
world.boolean getAllowAnimals()
boolean getAllowMonsters()
Biome getBiome(int x, int z)
x
- X coordinate of the blockz
- Z coordinate of the blockvoid setBiome(int x, int z, Biome bio)
x
- X coordinate of the blockz
- Z coordinate of the blockbio
- new Biome type for this blockdouble getTemperature(int x, int z)
It is safe to run this method when the block does not exist, it will not create the block.
x
- X coordinate of the blockz
- Z coordinate of the blockdouble getHumidity(int x, int z)
It is safe to run this method when the block does not exist, it will not create the block.
x
- X coordinate of the blockz
- Z coordinate of the blockint getMaxHeight()
If the max height is 100, there are only blocks from y=0 to y=99.
int getSeaLevel()
This is often half of getMaxHeight()
boolean getKeepSpawnInMemory()
void setKeepSpawnInMemory(boolean keepLoaded)
keepLoaded
- if true then the world's spawn area will be kept
loaded into memory.boolean isAutoSave()
void setAutoSave(boolean value)
value
- true if the world should automatically save, otherwise
falsevoid setDifficulty(Difficulty difficulty)
difficulty
- the new difficulty you want to set the world toDifficulty getDifficulty()
File getWorldFolder()
WorldType getWorldType()
boolean canGenerateStructures()
long getTicksPerAnimalSpawns()
This value determines how many ticks there are between attempts to spawn animals.
Example Usage:
Note:
If set to 0, animal spawning will be disabled for this world. We
recommend using setSpawnFlags(boolean, boolean)
to control
this instead.
Minecraft default: 400.
void setTicksPerAnimalSpawns(int ticksPerAnimalSpawns)
This value determines how many ticks there are between attempts to spawn animals.
Example Usage:
Note:
If set to 0, animal spawning will be disabled for this world. We
recommend using setSpawnFlags(boolean, boolean)
to control
this instead.
Minecraft default: 400.
ticksPerAnimalSpawns
- the ticks per animal spawns value you want
to set the world tolong getTicksPerMonsterSpawns()
This value determines how many ticks there are between attempts to spawn monsters.
Example Usage:
Note:
If set to 0, monsters spawning will be disabled for this world. We
recommend using setSpawnFlags(boolean, boolean)
to control
this instead.
Minecraft default: 1.
void setTicksPerMonsterSpawns(int ticksPerMonsterSpawns)
This value determines how many ticks there are between attempts to spawn monsters.
Example Usage:
Note:
If set to 0, monsters spawning will be disabled for this world. We
recommend using setSpawnFlags(boolean, boolean)
to control
this instead.
Minecraft default: 1.
ticksPerMonsterSpawns
- the ticks per monster spawns value you
want to set the world toint getMonsterSpawnLimit()
void setMonsterSpawnLimit(int limit)
Note: If set to a negative number the world will use the server-wide spawn limit instead.
limit
- the new mob limitint getAnimalSpawnLimit()
void setAnimalSpawnLimit(int limit)
Note: If set to a negative number the world will use the server-wide spawn limit instead.
limit
- the new mob limitint getWaterAnimalSpawnLimit()
void setWaterAnimalSpawnLimit(int limit)
Note: If set to a negative number the world will use the server-wide spawn limit instead.
limit
- the new mob limitint getAmbientSpawnLimit()
void setAmbientSpawnLimit(int limit)
Note: If set to a negative number the world will use the server-wide spawn limit instead.
limit
- the new mob limitvoid playSound(Location location, Sound sound, float volume, float pitch)
This function will fail silently if Location or Sound are null.
location
- The location to play the soundsound
- The sound to playvolume
- The volume of the soundpitch
- The pitch of the soundvoid playSound(Location location, String sound, float volume, float pitch)
This function will fail silently if Location or Sound are null. No sound will be heard by the players if their clients do not have the respective sound for the value passed.
location
- the location to play the soundsound
- the internal sound name to playvolume
- the volume of the soundpitch
- the pitch of the soundvoid playSound(Location location, Sound sound, SoundCategory category, float volume, float pitch)
This function will fail silently if Location or Sound are null.
location
- The location to play the soundsound
- The sound to playcategory
- the category of the soundvolume
- The volume of the soundpitch
- The pitch of the soundvoid playSound(Location location, String sound, SoundCategory category, float volume, float pitch)
This function will fail silently if Location or Sound are null. No sound will be heard by the players if their clients do not have the respective sound for the value passed.
location
- the location to play the soundsound
- the internal sound name to playcategory
- the category of the soundvolume
- the volume of the soundpitch
- the pitch of the soundString[] getGameRules()
String getGameRuleValue(String rule)
Will return null if rule passed is null
rule
- Rule to look up value ofboolean setGameRuleValue(String rule, String value)
The rule may attempt to validate the value passed, will return true if value was set.
If rule is null, the function will return false.
rule
- Rule to setvalue
- Value to set rule toboolean isGameRule(String rule)
rule
- Rule to checkWorldBorder getWorldBorder()
void spawnParticle(Particle particle, Location location, int count)
particle
- the particle to spawnlocation
- the location to spawn atcount
- the number of particlesvoid spawnParticle(Particle particle, double x, double y, double z, int count)
particle
- the particle to spawnx
- the position on the x axis to spawn aty
- the position on the y axis to spawn atz
- the position on the z axis to spawn atcount
- the number of particles<T> void spawnParticle(Particle particle, Location location, int count, T data)
T
- Typeparticle
- the particle to spawnlocation
- the location to spawn atcount
- the number of particlesdata
- the data to use for the particle or null,
the type of this depends on Particle.getDataType()
<T> void spawnParticle(Particle particle, double x, double y, double z, int count, T data)
T
- Typeparticle
- the particle to spawnx
- the position on the x axis to spawn aty
- the position on the y axis to spawn atz
- the position on the z axis to spawn atcount
- the number of particlesdata
- the data to use for the particle or null,
the type of this depends on Particle.getDataType()
void spawnParticle(Particle particle, Location location, int count, double offsetX, double offsetY, double offsetZ)
particle
- the particle to spawnlocation
- the location to spawn atcount
- the number of particlesoffsetX
- the maximum random offset on the X axisoffsetY
- the maximum random offset on the Y axisoffsetZ
- the maximum random offset on the Z axisvoid spawnParticle(Particle particle, double x, double y, double z, int count, double offsetX, double offsetY, double offsetZ)
particle
- the particle to spawnx
- the position on the x axis to spawn aty
- the position on the y axis to spawn atz
- the position on the z axis to spawn atcount
- the number of particlesoffsetX
- the maximum random offset on the X axisoffsetY
- the maximum random offset on the Y axisoffsetZ
- the maximum random offset on the Z axis<T> void spawnParticle(Particle particle, Location location, int count, double offsetX, double offsetY, double offsetZ, T data)
T
- Typeparticle
- the particle to spawnlocation
- the location to spawn atcount
- the number of particlesoffsetX
- the maximum random offset on the X axisoffsetY
- the maximum random offset on the Y axisoffsetZ
- the maximum random offset on the Z axisdata
- the data to use for the particle or null,
the type of this depends on Particle.getDataType()
<T> void spawnParticle(Particle particle, double x, double y, double z, int count, double offsetX, double offsetY, double offsetZ, T data)
T
- Typeparticle
- the particle to spawnx
- the position on the x axis to spawn aty
- the position on the y axis to spawn atz
- the position on the z axis to spawn atcount
- the number of particlesoffsetX
- the maximum random offset on the X axisoffsetY
- the maximum random offset on the Y axisoffsetZ
- the maximum random offset on the Z axisdata
- the data to use for the particle or null,
the type of this depends on Particle.getDataType()
void spawnParticle(Particle particle, Location location, int count, double offsetX, double offsetY, double offsetZ, double extra)
particle
- the particle to spawnlocation
- the location to spawn atcount
- the number of particlesoffsetX
- the maximum random offset on the X axisoffsetY
- the maximum random offset on the Y axisoffsetZ
- the maximum random offset on the Z axisextra
- the extra data for this particle, depends on the
particle used (normally speed)void spawnParticle(Particle particle, double x, double y, double z, int count, double offsetX, double offsetY, double offsetZ, double extra)
particle
- the particle to spawnx
- the position on the x axis to spawn aty
- the position on the y axis to spawn atz
- the position on the z axis to spawn atcount
- the number of particlesoffsetX
- the maximum random offset on the X axisoffsetY
- the maximum random offset on the Y axisoffsetZ
- the maximum random offset on the Z axisextra
- the extra data for this particle, depends on the
particle used (normally speed)<T> void spawnParticle(Particle particle, Location location, int count, double offsetX, double offsetY, double offsetZ, double extra, T data)
T
- Typeparticle
- the particle to spawnlocation
- the location to spawn atcount
- the number of particlesoffsetX
- the maximum random offset on the X axisoffsetY
- the maximum random offset on the Y axisoffsetZ
- the maximum random offset on the Z axisextra
- the extra data for this particle, depends on the
particle used (normally speed)data
- the data to use for the particle or null,
the type of this depends on Particle.getDataType()
default <T> void spawnParticle(Particle particle, double x, double y, double z, int count, double offsetX, double offsetY, double offsetZ, double extra, T data)
T
- Typeparticle
- the particle to spawnx
- the position on the x axis to spawn aty
- the position on the y axis to spawn atz
- the position on the z axis to spawn atcount
- the number of particlesoffsetX
- the maximum random offset on the X axisoffsetY
- the maximum random offset on the Y axisoffsetZ
- the maximum random offset on the Z axisextra
- the extra data for this particle, depends on the
particle used (normally speed)data
- the data to use for the particle or null,
the type of this depends on Particle.getDataType()
default <T> void spawnParticle(Particle particle, List<Player> receivers, Player source, double x, double y, double z, int count, double offsetX, double offsetY, double offsetZ, double extra, T data)
T
- Typeparticle
- the particle to spawnreceivers
- List of players to receive the particles, or null for all in worldsource
- Source of the particles to be used in visibility checks, or null if no player sourcex
- the position on the x axis to spawn aty
- the position on the y axis to spawn atz
- the position on the z axis to spawn atcount
- the number of particlesoffsetX
- the maximum random offset on the X axisoffsetY
- the maximum random offset on the Y axisoffsetZ
- the maximum random offset on the Z axisextra
- the extra data for this particle, depends on the
particle used (normally speed)data
- the data to use for the particle or null,
the type of this depends on Particle.getDataType()
<T> void spawnParticle(Particle particle, List<Player> receivers, Player source, double x, double y, double z, int count, double offsetX, double offsetY, double offsetZ, double extra, T data, boolean force)
T
- Typeparticle
- the particle to spawnreceivers
- List of players to receive the particles, or null for all in worldsource
- Source of the particles to be used in visibility checks, or null if no player sourcex
- the position on the x axis to spawn aty
- the position on the y axis to spawn atz
- the position on the z axis to spawn atcount
- the number of particlesoffsetX
- the maximum random offset on the X axisoffsetY
- the maximum random offset on the Y axisoffsetZ
- the maximum random offset on the Z axisextra
- the extra data for this particle, depends on the
particle used (normally speed)data
- the data to use for the particle or null,
the type of this depends on Particle.getDataType()
force
- allows the particle to be seen further away from the player
and shows to players using any vanilla client particle settingsWorld.Spigot spigot()
Copyright © 2021. All rights reserved.