General

• Introduction
• Frequently Asked Questions
• Roadmap
• Release notes

Basics

• Getting Started
  • Install JDK
  • Set Up IDE
  • Build Systems
  • Project Structure
  • Get LITIENGINE
  • Manage native libraries
  • Run the Game
• Game API
  • Game.graphics()
  • Game.audio()
  • Game.physics()
  • Game.loop()
  • Game.world()
  • Game.window()
  • Game.screens()
• Input API
  • Input.keyboard()
  • Input.mouse()
  • Input.gamepads()
• Configuration
• Tile Maps
  • Map Objects
  • Custom Properties
• Resource Management
  • Texture Atlas
  • Sprite Info Files
• Entity Framework
  • Default Entity Types
  • Subscribe to Entity Events
  • Annotations for static information
• Control Entities
  • Entity Controllers
  • Animation Controller
  • Movement Controller
  • Behavior Controller
  • Messaging System
  • Ability Framework
• User Interface
  • GuiComponents: An Overview
  • Creating Menus
• utiLITI
  • Create Projects
  • Import maps
• Deployment
• Savegames
• Libraries and Tools

Tutorials

• Creating a Simple Platformer
• Creating an Arkanoid Clone
• Modifying example projects

Get LITIENGINE

Now, let us discuss how to actually download the LITIENGINE library. There are multiple ways to achieve this:

Download the LITIENGINE Java library manually

From the Maven central repository

The Maven Central Repository is the default repository for Apache Maven, SBT and other build systems and can be easily used from Apache Ant/Ivy, Gradle and many other tools. You can download the LITIENGINE library directly from the Maven Central Repository if you do not want to use a dedicated build system or need only specific files.

From the LITIENGINE SDK

The LITIENGINE SDK consists of the LITIENGINE Java library and utiLITI, our project management and map creation tool. It is a stand-alone editor which produces project files that can then be loaded to your game. You can download the LITIENGINE SDK from litiengine.com.

Note: The utiLITI editor is not an IDE for Java development.

Add the downloaded library to your project

Eclipse

• Open the context menu on your project
• Select Properties > Java Build Path > Libraries. From here, you can add JAR files to the build path, whether they are inside your workspace or not. You can also add a class folder, a directory containing Java class files that are not in a JAR.

Example: The LITIENGINE library is in the lib folder inside your project. Simply go to Project -> Properties -> Java Build Path -> Libraries -> Add JAR and add lib/litiengine-0.5.1.jar to your project's build path.

IntelliJ IDEA

• Go to File -> Project Structure (Ctrl+Alt+Shift+S)
• Go to Project Settings -> Libraries
• Hit New Project Library / + (Alt+Insert) and locate litiengine-0.5.1.jar

Download the LITIENGINE Java library via Build Automation Utilities

Gradle

Add the LITIENGINE dependency to your Gradle project by adding the following code to your project's build.gradle file:

apply plugin: 'java'
apply plugin: 'application'

repositories {
  mavenCentral()
}

dependencies {
  // For Gradle versions below 3.0
  compile 'de.gurkenlabs:litiengine:0.5.1'

  // For Gradle versions above 3.0
  implementation 'de.gurkenlabs:litiengine:0.5.1'
}

Note: if you failed build, try to modify apply plugin: 'java' to apply plugin: 'java-library'

The compile step has been deprecated since Gradle 3.0 - use implementation instead for newer versions!

If you want to use recent features of the LITIENGINE master branch that haven't been part of a stable release yet, you can also configure Gradle to include a local clone of the engine repository. Assuming you have cloned the engine to a folder in the same location as your project, you would have the following project structure:

project/settings.gradle
litiengine/setting.gradle.kts

Then in project/settings.gradle, add the following line:

includeBuild "../litiengine"

In project/build.gradle, define the dependency as usual:

dependencies {
 implementation 'de.gurkenlabs:litiengine'
}

Gradle will automatically replace any dependency with the version provided by includeBuild if it finds a matching module.

A basic example for a Gradle based LITIENGINE project can be found HERE. Have a look at the project's build.gradle and settings.gradle.

Apache Maven

Add the following code to your project's pom.xml:

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

Apache Ant

To manage dependencies in Ant, you can use Apache Ivy. Add the following code to ivy.xml:

<dependencies>
  <dependency org="de.gurkenlabs" name="litiengine" rev="0.5.1" />
</dependencies>

---

Last updated 2 weeks ago

On this page