gurkenlabs / Litiengine

LITIENGINE is a free and open source Java 2D Game Engine. It provides a comprehensive Java library and a dedicated map editor to create tile-based 2D games.

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

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 {
  implementation 'de.gurkenlabs:litiengine:0.5.1'
}

Maven

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

More Installation Instructions

Getting Started

1. Setup the Game Project
2. Running the Game
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.

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

• JInput for Gamepad support
• MP3 SPI for .mp3 support
• Ogg Vorbis SPI for .ogg support
• Steamworks4j for supporting the steamworks SDK

utiLITI

• Darklaf for theming support

Contributing

• Agree to our Code of Conduct
• View our Contribution guidelines

Citations

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

Contacts

• Website litiengine.com
• Twitter @gurkenlabs
• Facebook gurkenlabsofficial
• YouTube Gurkenlabs
• Bug Reports Issue Tracker
• E-Mail [email protected]
• Forum forum.litiengine.com

Authors

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

• Steffen Wilke (steffen-wilke)
• Matthias Wilke (nightm4re94)

Support the devs

• Open Collective