Package com.csse3200.game.entities.factories

Class CollectableFactory

java.lang.Object

com.csse3200.game.entities.factories.CollectableFactory

public class CollectableFactory
extends Object

Factory for creating collectable entities (e.g., keys, coins, potions).

Constructor Summary

Constructors

Constructor	Description
CollectableFactory()

Method Summary

Modifier and Type	Method	Description
static Entity	createCollectable(String itemId)	Creates a new collectable entity instance based on its configuration ID.
static Entity	createDashUpgrade()	Builds a collectable upgrade that enable the dash ability
static Entity	createGlideUpgrade()	Build a new collectable glider upgrade that enables the glide ability
static Entity	createGrappleUpgrade()	Builds a new collectable grappler upgrade that enables the grapple ability
static Entity	createKey(String target)	Builds a collectable key for target.

Methods inherited from class java.lang.Object

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

Constructor Details

CollectableFactory

public CollectableFactory()

Method Details

createCollectable

public static Entity createCollectable(String itemId)

Creates a new collectable entity instance based on its configuration ID.

The returned entity includes:

• A static PhysicsComponent and ColliderComponent configured as a sensor obstacle.
• A CollectableComponentV2 to handle collisions and inventory logic.
• Visual representation from either an animated AnimationRenderComponent if a sprite atlas is provided, or a TextureRenderComponent for static images.
• A ConeLightComponent for a visual backlight effect.

Parameters:

itemId - the identifier of the collectable, as defined in items.json

Returns:

a collectable Entity

Throws:

IllegalArgumentException - if itemId is not registered

createKey

public static Entity createKey(String target)

Builds a collectable key for target.

Returns:

a new key entity

See Also:

• KeyComponent

createDashUpgrade

public static Entity createDashUpgrade()

Builds a collectable upgrade that enable the dash ability

Returns:

a new upgrade entity

See Also:

• UpgradesComponent

createGlideUpgrade

public static Entity createGlideUpgrade()

Build a new collectable glider upgrade that enables the glide ability

Returns:

a new upgrade entity

See Also:

• UpgradesComponent

createGrappleUpgrade

public static Entity createGrappleUpgrade()

Builds a new collectable grappler upgrade that enables the grapple ability

Returns:

a new upgrade entity

See Also:

• UpgradesComponent