Physics World (FXGL 11)

FXGL, like many other 2D game frameworks, uses jbox2d to deal with physics. We will only cover how to use jbox2d within FXGL, since the library has its own documentation.

Adding Physics to Entities

In order to add an entity to the physics world, all we need to do is configure PhysicsComponent and attach it to the entity:

PhysicsComponent physics = new PhysicsComponent();

physics.setBodyType(BodyType.DYNAMIC);

// these are direct jbox2d objects, so we don't actually introduce new API
FixtureDef fd = new FixtureDef();
fd.setDensity(0.7f);
fd.setRestitution(0.3f);
physics.setFixtureDef(fd);

Entity entity = ...
entity.addComponent(physics);

getGameWorld().addEntity(entity);

Once the entity is added to the game world, the PhysicsComponent will be automatically picked up by the physics world. It is important to note that an entity with PhysicsComponent is now managed by the physics world. Hence we cannot directly modify the entity's transforms, e.g. position, rotation. Instead we have to modify the PhysicsComponent. Say you want to move a physics supported entity. You can do that as follows:

PhysicsComponent physics = entity.getComponent(PhysicsComponent.class);
physics.setLinearVelocity(10, 0);

This will set entity's velocity to 10 pixels per second. You can use meters with the following call:

physics.setBodyLinearVelocity(10, 0);

Here 10 means meters. To get a better feel for the API have a look at this Mario sample. It shows the basic code you are likely to need in your physics based games.

Repositioning an Entity with Physics

When an entity has a physics component, it is a part of the physics world. Hence, we cannot use setPosition to changes the entity's position. Instead, we can use:

entity.getComponent(PhysicsComponent.class).overwritePosition(...);

Using FXGL Physics

FXGL comes with its own collision detection and reporting mechanism. The API is easy to work with and provides means of identifying when the collision started, when the collision ended and whether the collision is still happening. See this sample for info on usage.

Making HitBoxes Visible

1. Enable settings.setDeveloperMenuEnabled(true).
2. When running in ApplicationMode.DEVELOPER or ApplicationMode.DEBUG, press key 1 to open developer menu where you can turn on hit boxes.