almasb by fxgl

JavaFX Game Development Framework

Maven Central Build Status codecov


  • No installation or setup required
  • “Out of the box”: Java 8-11, Win/Mac/Linux/Android 5.0+(Sample)/iOS(alpha)/Web(Sample)
  • Simple and clean API, higher level than other engines
  • Superset of JavaFX: no need to learn new UI API
  • Real-world game development techniques: Entity-Component, Event System, Scripting, and many more
  • Games are easily packaged into a single executable .jar

Good for:

  • Any 2D genre (side-scroller / platformer / arcade / RPG)
  • Complex UI controls
  • Hobby / academic / commercial projects
  • Teaching / learning / improving game development skills
  • Fast prototyping of game ideas

Minimal Example

public class BasicGameApp extends GameApplication {

    protected void initSettings(GameSettings settings) {
        settings.setTitle("Basic Game App");

    public static void main(String[] args) {

Getting Started

  • Version for Java 8-10: 0.5.4
  • Version for Java 11: 11.3

Note: from now on only 11.0+ will be developed. FXGL 11 supports Java 11+ and has a more scalable architecture, but currently supports only a subset of features from 0.5.4.

Want a quick dive into code? See basic examples. Otherwise, you have the following options:


  • Maven project if you use Java
  • Maven project if you use Kotlin

Already have pom.xml? Then add: (use 0.5.4 for Java 8-10)



  • Gradle project if you use Java 8-10
  • Gradle project if you use Java 11+
  • Gradle project if you use Kotlin

Already have build.gradle? Then add: (use 0.5.4 for Java 8-10)

repositories {

dependencies {
    compile 'com.github.almasb:fxgl:11.3'

Uber jar

Download the latest uber jar from Releases


  • University of Brighton, UK
  • University of Nottingham, UK
  • kidOYO, USA
  • Walton High School, USA
  • Zealand Institute of Business and Technology, Denmark
  • Federal Institute of Education, Science and Technology of Rio Grande do Sul, Brazil

If your institution wants to use / is using FXGL, drop me an email to discuss how FXGL can aid your course.

Contribution & Support

If you want to build FXGL from sources or want to contribute, please see the Contribution Guide (including non-code). FXGL is fully modular, so new contributors do not need to understand the entire codebase, only the module to which the contribution is made.

You can support the FXGL development / show interest by simply starring the repo.


  • Ask questions on StackOverflow with tags javafx and fxgl
  • Tweet with #fxgl
  • Chat with the friendly FXGL community
  • Email
compile "com.github.almasb:fxgl:11.3"

Related Libraries


Lightweight JavaFX Framework for Kotlin

Last updated 3 mins ago


Java / JavaFX / Kotlin Game Library (Engine)

Last updated 3 mins ago