General

• Introduction
• Frequently Asked Questions
• Roadmap
• Release notes

Basics

• Getting Started
  • Get LITIENGINE
  • Installation and Setup
  • 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
• Working with the Sample projects

Get LITIENGINE

Get the Java library

So you want to build a 2D Java game with the LITIENGINE, that's great! Now, the first thing you want to do is to actually download the library. There are multiple ways to achieve this. 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 (Groovy)

compile 'de.gurkenlabs:litiengine:0.5.1'

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.

More specifically, you can use LITIENGINE's library which is distributed over the Maven Central Repository without download and import library as "oldschool" way by add some code at build.gradle.

apply plugin: 'java'
apply plugin: 'maven'

repositories {
  mavenCentral()
}

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

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

Apache Maven

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

Download the LITIENGINE SDK

The LITIENGINE comes with an editor that supports you with creating game environments and managing your resources. It is a stand alone product which produces a .litidata game project files that can then be loaded to your game.

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

Download LITIENGINE SDK

Managing Native Libraries

Managing (and deploying) the native libraries is only necessary for Controller Support and Accessing the Steamworks library.

The LITIENGINE has some native dependencies that allow supporting Controller Input and access to Steamworks. In case you want to use these features, you can either use a build tool plugin (e.g. the Gradle Natives Plugin) or get the native libraries from the downloadable LITIENGINE package. Either way, you need to add the location of the natives to the .classpath of your project if you want to use the functionality when your Game is being run from within your IDE. The following build.gradle file extracts all native libraries of the LITIENGINE to the 'libs' folder upon calling gradle includeNatives

plugins {
  id 'com.stehno.natives' version '0.3.1'
}

natives {
  configurations = ['runtime']
  outputDir = 'libs'
}

apply plugin: 'java'
apply plugin: 'maven'

repositories {
  mavenCentral()
}

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

---

Last updated 2 weeks ago

On this page