nova.core.world

Class World

java.lang.Object

nova.core.world.World

All Implemented Interfaces:

Identifiable

public abstract class World
extends java.lang.Object
implements Identifiable

An in-game world

Constructor Summary

Constructors

Constructor and Description
World()

Method Summary

Modifier and Type	Method and Description
abstract Entity	addClientEntity(EntityFactory factory) Creates an entity only on the client side.
abstract <T extends Entity> T	addClientEntity(T entity) Creates an entity only on the client side.
abstract Entity	addEntity(EntityFactory factory) Creates an entity
abstract Entity	addEntity(org.apache.commons.math3.geometry.euclidean.threed.Vector3D position, Item item) Creates an entity that holds an item
abstract java.util.Optional<Block>	getBlock(org.apache.commons.math3.geometry.euclidean.threed.Vector3D position) Gets the block which occupies the given position.
abstract java.util.Set<Entity>	getEntities(Cuboid bound) Gets a set of entities within a certain bound
abstract java.util.Optional<Entity>	getEntity(java.lang.String uniqueID) Gets an entity based on its UUID
abstract void	markChange(org.apache.commons.math3.geometry.euclidean.threed.Vector3D position) Marks a specific block to indicate it changed.
abstract void	markStaticRender(org.apache.commons.math3.geometry.euclidean.threed.Vector3D position) Marks a position to render static.
abstract void	playSoundAtPosition(org.apache.commons.math3.geometry.euclidean.threed.Vector3D position, Sound soundFactory) Plays a sound at a certain position.
boolean	removeBlock(org.apache.commons.math3.geometry.euclidean.threed.Vector3D position) Removes the block in the specified position.
abstract void	removeEntity(Entity entity) Destroys an entity, removing it from the world.
abstract boolean	setBlock(org.apache.commons.math3.geometry.euclidean.threed.Vector3D position, BlockFactory blockFactory) Sets the block occupying a given position.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface nova.core.util.Identifiable

getID, sameType

Constructor Detail

World

public World()

Method Detail

markStaticRender

public abstract void markStaticRender(org.apache.commons.math3.geometry.euclidean.threed.Vector3D position)

Marks a position to render static.

Parameters:

position - The position to perform the static re-rendering.

markChange

public abstract void markChange(org.apache.commons.math3.geometry.euclidean.threed.Vector3D position)

Marks a specific block to indicate it changed.

Parameters:

position - The position being changed.

getBlock

public abstract java.util.Optional<Block> getBlock(org.apache.commons.math3.geometry.euclidean.threed.Vector3D position)

Gets the block which occupies the given position.

Parameters:

position - The position to query.

Returns:

The block at the position. If the block is air, it will return the air block. If no block is present (the void), it will return an empty optional.

setBlock

public abstract boolean setBlock(org.apache.commons.math3.geometry.euclidean.threed.Vector3D position,
                                 BlockFactory blockFactory)

Sets the block occupying a given position.

Parameters:

position - The position of the block to set.

blockFactory - The block factory.

Returns:

true if the replace was successful.

removeBlock

public boolean removeBlock(org.apache.commons.math3.geometry.euclidean.threed.Vector3D position)

Removes the block in the specified position.

Parameters:

position - the position of the block to remove.

Returns:

true if the block was removed.

addEntity

public abstract Entity addEntity(EntityFactory factory)

Creates an entity

Parameters:

factory - The entity factory

Returns:

The added entity

addEntity

public abstract Entity addEntity(org.apache.commons.math3.geometry.euclidean.threed.Vector3D position,
                                 Item item)

Creates an entity that holds an item

Parameters:

position - The position to add the item to

item - The item

Returns:

The added entity

addClientEntity

public abstract Entity addClientEntity(EntityFactory factory)

Creates an entity only on the client side. For example, particle effects.

TODO: Replace this with an actual particle system.

Parameters:

factory - The entity factory

Returns:

The added entity

addClientEntity

public abstract <T extends Entity> T addClientEntity(T entity)

Creates an entity only on the client side. For example, particle effects.

TODO: Replace this with an actual particle system.

Type Parameters:

T - The entity type

Parameters:

entity - The entity to add

Returns:

The added entity

removeEntity

public abstract void removeEntity(Entity entity)

Destroys an entity, removing it from the world.

Parameters:

entity - The entity to remove

getEntity

public abstract java.util.Optional<Entity> getEntity(java.lang.String uniqueID)

Gets an entity based on its UUID

Parameters:

uniqueID - The entity's unique ID

Returns:

The entity or empty if the entity does not exist.

getEntities

public abstract java.util.Set<Entity> getEntities(Cuboid bound)

Gets a set of entities within a certain bound

Parameters:

bound - The boundary

Returns:

A set of entities.

playSoundAtPosition

public abstract void playSoundAtPosition(org.apache.commons.math3.geometry.euclidean.threed.Vector3D position,
                                         Sound soundFactory)

Plays a sound at a certain position.

Parameters:

position - The position in the world of the sound.

soundFactory - The sound factory that will create the sound to be played.