Need help with box2dlights?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

222 Stars 75 Forks Apache License 2.0 152 Commits 21 Opened issues


Fork of box2dlights by Kalle Hamalainen

Services available


Need anything else?

Contributors list



Kalle Hameleinen's Box2DLights is a 2D lighting framework that uses box2d for raycasting and OpenGL ES 2.0 for rendering. This library is intended to be used with libgdx.

Try Kalle's game Boxtrix to see the library in action.


  • Arbitrary number of lights
  • Gaussian blurred light maps
  • Point light
  • Cone Light
  • Directional Light
  • Chain Light [New in 1.3]
  • Shadows
  • Dynamic/static/xray light
  • Culling
  • Colored ambient light
  • Gamma corrected colors
  • Handler class to do all the work
  • Query method for testing is point inside of light/shadow

This library offer easy way to add soft dynamic 2d lights to your physic based game. Rendering use libgdx but it would be easy to port this to other frameworks or pure openGl too.


Box2DLights is also available in Maven Central. Add the following dependency to your libgdx core project:


If you use Gradle, add the following dependency to your build.gradle file, in the dependencies block of the core project:

 compile "com.badlogicgames.box2dlights:box2dlights:1.4"

Maintenance Note

Box2dlights was moved from Google Code to Github to make contributing easier. The libgdx team will happily merge pull requests but will not fix bugs or ensure compatibility with the latest libgdx version.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.