https://github.com/gurkenlabs/litiengine
LITIENGINE 🕹 The pure 2D java game engine.
https://github.com/gurkenlabs/litiengine
2d 2d-game-engine 2d-java-games 2d-rendering-engine collision-handling easy-to-use game-engine java java-2d-engine java-game-engine litiengine physics-engine sound-engine tile tilemap tmx
Last synced: about 2 months ago
JSON representation
LITIENGINE 🕹 The pure 2D java game engine.
- Host: GitHub
- URL: https://github.com/gurkenlabs/litiengine
- Owner: gurkenlabs
- License: mit
- Created: 2017-04-11T14:33:26.000Z (about 8 years ago)
- Default Branch: main
- Last Pushed: 2025-04-07T12:03:12.000Z (3 months ago)
- Last Synced: 2025-04-13T19:14:38.871Z (3 months ago)
- Topics: 2d, 2d-game-engine, 2d-java-games, 2d-rendering-engine, collision-handling, easy-to-use, game-engine, java, java-2d-engine, java-game-engine, litiengine, physics-engine, sound-engine, tile, tilemap, tmx
- Language: Java
- Homepage: https://litiengine.com/
- Size: 11.1 MB
- Stars: 767
- Watchers: 32
- Forks: 96
- Open Issues: 29
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Citation: CITATION.cff
Awesome Lists containing this project
README
**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.
[](https://github.com/gurkenlabs/litiengine/actions/workflows/build.yml)
[](https://sonarcloud.io/summary/new_code?id=de.gurkenlabs:litiengine)
[](https://maven-badges.herokuapp.com/maven-central/de.gurkenlabs/litiengine)
[](https://github.com/gurkenlabs/litiengine/blob/main/LICENSE)
[](https://discord.gg/rRB9cKD)
[](https://opencollective.com/litiengine)
## :video_game: 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](http://www.mapeditor.org/))
* Player Input via Gamepad/Keyboard/Mouse
* Entity Framework
## :gear: Installation
### :elephant: Gradle
The LITIENGINE Java library is hosted on the [Maven Central Repository](https://search.maven.org/artifact/de.gurkenlabs/litiengine), i.e. fetching it with Gradle is as simple as configuring your source repository and defining the dependency as shown below.
#### Groovy syntax:
```groovy
repositories {
mavenCentral()
}
dependencies {
implementation 'de.gurkenlabs:litiengine:0.8.0'
}
```
#### Kotlin Syntax:
```kotlin
repositories {
mavenCentral()
}
dependencies {
implementation("de.gurkenlabs:litiengine:0.8.0")
}
```
### Other ways of installing and using LITIENGINE
For alternative ways of downloading and applying LITIENGINE to your project, visit our [Getting Started Guide](https://litiengine.com/docs/getting-started/).
## :books: Documentation
The [LITIENGINE documentation](https://litiengine.com/docs/) contains in-depth explanations, guides, and tutorials for general concepts of the engine.
### Javadocs
If you are searching for a particular method or class within the API or just want to further explore the engine's capabilities and structure, the Javadocs are a good place to start:
[](https://litiengine.com/api/)
### Questions
You've found yourself trying to work out a feature of the engine that is not yet documented?
Join our community in the [LITIENGINE forum](https://github.com/gurkenlabs/litiengine/discussions) hosted on Github or on [Discord](https://discord.gg/rRB9cKD) for troubleshooting.
### Bugs and Issues
You've encountered an obvious issue or bug with LITIENGINE or want to request enhancements and features? File an issue in our [Issue Tracker](https://github.com/gurkenlabs/litiengine/issues).
## :package: Libraries Used
* [JInput](https://github.com/jinput/jinput) for Gamepad support
* [MP3 SPI](https://mvnrepository.com/artifact/com.googlecode.soundlibs/mp3spi/1.9.5.4) for .mp3 support
* [Ogg Vorbis SPI](https://mvnrepository.com/artifact/com.googlecode.soundlibs/vorbisspi/1.0.3.3) for .ogg support
### utiLITI
* [Darklaf](https://github.com/weisJ/darklaf) for theming support
### Other Recommended Libraries
* [Steamworks4j](https://github.com/code-disaster/steamworks4j) for supporting the steamworks SDK
## :handshake: Contributing
If you've decided to help out with LITIENGINE's development - you're awesome!
And here's what you need to to:
* Agree to our [Code of Conduct](https://github.com/gurkenlabs/litiengine/blob/main/CODE_OF_CONDUCT.md)
* View our [Contribution guidelines](https://github.com/gurkenlabs/litiengine/blob/main/CONTRIBUTING.md)
## Star History (Compared with other 2D java game libraries / frameworks / engines)
[](https://star-history.com/#gurkenlabs/litiengine&AlmasB/FXGL&magefree/mage&b3dgs/lionengine&fastjengine/FastJ&cping/LGame&LWJGL/lwjgl3&playn/playn&mini2Dx/mini2Dx&Timeline)
## Contact
LITIENGINE is created by two Bavarian brothers known as [gurkenlabs](https://gurkenlabs.de/):
|  |  |
| :-----------: | :------------: |
| Steffen Wilke | Matthias Wilke |
| [steffen-wilke](https://github.com/steffen-wilke) | [nightm4re94](https://github.com/nightm4re94) |
### :speech_balloon: Links and Social Media
[](https://litiengine.com)
[](https://forum.litiengine.com)
[](mailto:[email protected]?subject=[LITIENGINE])
[](https://twitter.com/gurkenlabs)
[](https://www.instagram.com/gurkenlabs)
[](https://www.youtube.com/channel/UCN7-9zYTxip_Hl1LvCQ8RBA)
## Sponsors and supporters
[  ](https://opencollective.com/litiengine#support)
