A 100% Java 2D collision detection and physics engine. Designed to be fast, stable, extensible, and easy to use. dyn4j is free for use in commercial and non-commercial applications.
The project is comprised of the main project managed here and three others:
- dyn4j-tests A test suite of over 1,000 JUnit tests
- dyn4j-samples A collection of samples to help get started
- dyn4j-sandbox A non-trivial desktop application that allows users to build scenes, run, save, and load them - all built with dyn4j as the simulation engine.
- Java 1.6+
dyn4j comes with a lot of features and extensibility, but getting started is easy.
Add dyn4j to your classpath by downloading a release from Releases or Maven Central
Or by adding a Maven dependency:
<dependency>
<groupId>org.dyn4j</groupId>
<artifactId>dyn4j</artifactId>
<version>3.2.4</version>
</dependency>World world = new World();This create a new simulation environment with default settings. The default settings use the meter-kilogram-seconds system and include the default pipeline classes.
Body body = new Body();
body.addFixture(Geometry.createCircle(1.0));
body.translate(1.0, 0.0);
body.setMass(MassType.Normal);
world.addBody(body);A body is the primary unit of simulation and completely rigid. A body is comprised of many fixtures or shapes. While the shapes of dyn4j are all convex (and must be), a collection of these shapes can be used to create a body that is not. A body can be initially placed in a scene by translating or rotating it. Once the shape(s) of a body is defined, it must be given a mass. The mass is typically MassType.NORMAL or MassType.INFINITE. When set to NORMAL, the mass will be calculated based on the shapes. An INFINITE mass body might represent a floor, ground, or something unmovable.
PinJoint joint = new PinJoint(body, new Vector2(0, 0), 4, 0.7, 1000);
world.addJoint(joint);A joint is a constraint on the motion of one or more bodies. There are many joint types that serve different purposes. Generally, joints are used to link bodies together in a specified way. Bodies can have multiple joints attached to them making for some interesting combinations.
for (int i = 0; i < 100; i++) {
world.step(1);
}In a GUI based application you would call the World.update(elapsedTime) method. Either way, each time the world is advanced forward in time (which may or may not occur when using the World.update(elapsedTime) methods) the bodies added to it will be moved based on the world gravity (if any) and will interact with other bodies placed in the world.
From here you should take a look at the dyn4j-samples sub project to get a jump start with a simple Java2D framework. You can also check out the documentation here.