/litiengine

LITIENGINE 🕹 The pure 2D java game engine.

Primary LanguageJavaMIT LicenseMIT

LITIENGINE Logo

LITIENGINE is a free and open source Java 2D Game Engine. It provides all the infrastructure to create tile based 2D games with plain java, be it a platformer or a top-down adventure.

Build Status Coverage Maven Central MIT License Discord chat

Main Features

  • Basic Game Infrastructure (GameLoop, Configuration, Resource Management, Logging, ...)
  • 2D Render Engine (GUI Components, Spritesheet Animations, Ambient Lighting, Particle System, ...)
  • 2D Sound Engine (support for .wav, .mp3 and .ogg)
  • 2D Physics Engine
  • Support for Tile Maps in .tmx format (e.g. made with Tiled Editor)
  • Player Input via Gamepad/Keyboard/Mouse
  • Entity Framework
  • Message Based Networking Framework

🚧 Important Note

Currently the LITIENGINE is being actively developed and therefore some parts of the framework are not final yet. Be aware that the engine API might change over the course of the next releases up until beta (v0.5.0-beta). Nonetheless, the LITIENGINE can of course already be used to make fully functioning 2D java games.

Installation

The library is distributed over the Maven Central Repository and you can grab the necessary .jar-file(s) from there by using your favorite build automation tool or manually download the library.

Gradle

repositories {
  mavenCentral()
}

dependencies {
  compile 'de.gurkenlabs:litiengine:0.4.20'
}

Maven

<dependency>
  <groupId>de.gurkenlabs</groupId>
  <artifactId>litiengine</artifactId>
  <version>0.4.20</version>
</dependency>

More Installation Instructions

Getting Started

  1. Setup the Game Project
  2. Learning the Basics
  3. Configuring the Game
  4. Loading a .tmx Map

Documentation

The LITIENGINE documentation pages containing in-depth guides for LITIengine are currently in deployment. We're looking forward to your contributions!

⚠️ We are aware that there is currently a lack of documentation, but we're planning to document the most important parts of the library and use-cases with the first beta release to ensure that features don't get deprecated before they're even used.

If you are searching for a particular method or class within the API or just want to further explore the engine's possiblities, the Javadocs are a good place to start.

Javadocs

Questions?

Visit the official LITIENGINE forum for troubleshooting or to learn about the LITIengine community. If you encounter bugs or want to request fancy new features, you can also open an issue in our Issue Tracker.

Libraries Used

utiLITI

Contributing

Cite the LITIENGINE

If you want to cite parts of the LITIengie in your academic work, you can use the following Digital Object Identifier:

DOI

Contacts

Authors

Gurkenlabs

Gurkenlabs is an indie game development project by two brothers from Bavaria:

Support the devs