• How to build and run the game
  • Software requirements
  • Source code repositories
  • Build steps
  • Source code of the dependencies
• JNDT: Java Native Deployment Toolkit
  • Introduction
  • Source code
  • Setup
  • Manual of the Ant tasks
    • create-app-dir
    • create-linux-app-bundles
    • create-os-x-app-bundle
    • create-windows-app-bundles

How to build and run the game

Software requirements

You need these programs to use the game for development purposes:

• Java Development Kit 21 or higher: here, here or in the official repository of your GNU Linux distribution
• Git
• Gradle: here (already supported and bundled with major IDEs like Eclipse and Netbeans)
• ANT: here (already supported and bundled with major IDEs like Eclipse and Netbeans)

Source code repositories

These are the URIs of the Git repositories for all versions:

• read only access
  • https://git.code.sf.net/p/tuer/git/alpha/ (abandoned alpha version that uses my own engine)
  • https://git.code.sf.net/p/tuer/git/tuer/ (abandoned pre-beta version that uses JMonkeyEngine 2.0)
  • https://git.code.sf.net/p/tuer/git/pre_beta/ (current pre-beta version that uses JogAmp's Ardor3D Continuation)
• read/write access (reserved to the contributors of the project)
  • https://gouessej@git.code.sf.net/p/tuer/git/alpha/ (abandoned alpha version that uses my own engine)
  • https://gouessej@git.code.sf.net/p/tuer/git/tuer/ (abandoned pre-beta version that uses JMonkeyEngine 2.0)
  • https://gouessej@git.code.sf.net/p/tuer/git/pre_beta/ (current pre-beta version that uses JogAmp's Ardor3D Continuation)

Build steps

Enter this when you're in the ANT home to download the JARs required by some optional tasks: ./bin/ant networking -f fetch.xml -Ddest=system

Please follow one of these methods:

• In command line, follow these steps:
  • enter this to get the source code: git clone URI_of_the_Git_repository
  • enter this to build the project with Ant: ant build
  • enter this to run the game with Ant: ant run-game
  • enter this to build the project with Gradle: gradle build
  • enter this to run the game with Gradle: gradle run
  • enter this to run the editor with Gradle: gradle runEditor
• In Eclipse (version 4.15.0 or higher), with Subclipse (version 1.6.0 or higher), follow these steps:
  • Right click in the package area
  • Select "Import projects..."
  • Expand the "Git" directory
  • Select "Projects from Git (with smart import)"
  • Click on "Next"
  • Select "Clone URI"
  • Click on "Next"
  • Enter the URI of the Git repository in the "URI" text field
  • Click on "Next"
  • Select the branch named "master"
  • Click on "Next"
  • Choose a destination folder
  • Click on "Next"
  • Click on "Finish"
  • Follow these steps to build the project with Ant within Eclipse:
    • Go to the menu "Window" → "Show view" → "Ant"
    • Drag and drop the file build.xml into the ANT view
    • Double-click on the "build" target in this view to build the project
    • Double-click on the "run-game" target in this view to run the game
• In Netbeans (version 11.0 or higher), follow these steps:
  • Go to the "Team" menu → "Subversion" → "Checkout..."
  • Enter the URL of the Git repository as "Repository URL"
  • Click on "Next"
  • Click on "Finish"
  • Wait for a while
  • A popup entitled "Checkout Completed" appears, click on "Create Project..."
  • Select "Java Project with Existing Sources"
  • Click on "Next"
  • Enter a project name and click on "Next"
  • In the "Source Package Folders" section, click on "Add Folder..." and select the only directory
  • Click on "Next"
  • Click on "Finish"
  • In the "project" tab, select the "Libraries" node → "Add JAR/Folder" and select all JARs in all subdirectories of the "lib" directory
  • Go to the "project" tab → "Source packages" → "default package" → build.xml → build → "Run Target" to build the project
  • Go to the "project" tab → "Source packages" → "default package" → build.xml → run-game → "Run Target" to run the game
• In other IDEs, make your own way with them, I have no time to waste with proprietary IDEs and IDEs with a confidential audience

Source code of the dependencies

You can get the source code of the dependencies here :

• OpenJDK
• JOGL
• JOAL
• GlueGen
• JOGG
• JORBIS
• JogAmp's Ardor3D Continuation
• Paul Lamb's 3D sound system
• Fettle
• OSM2World
• Ant
• Ant-Contrib
• jDeb
• Redline RPM
• Apache Commons Compress
• Apache Commons IO
• slf4j
• XZ for Java
• Bountycastle Java

TUER requires less than 32 MB (the latest version may require more than 64 MB) but some programs used to precompute its data require 1 GB and even 2 GB. Do not try to build the game from the source code if your computer does not have enough RAM. Use the VM argument "-Xmx" if a particular map needs much memory.

JNDT: Java Native Deployment Toolkit

Introduction

JNDT is used to build the self-contained native application bundles of the project. It turns a fat JAR into some bundles easy to deploy and to install. It builds both some convenient native installers with a full desktop integration and some archives as fallbacks.

It's a cross-platform packager, i.e it's able both to run under several operating systems and to generate native bundles for an operating system different from the one it's being executed.

N.B: JNDT supports Java 9 and higher. As it uses a viral license (GPL version 2) and as it injects a part of its own source code into the bundles, its use is allowed only for the programs using a compatible license.

Source code

The source code of JNDT is in a single Ant library file here.

Setup

The dependencies of JNDT are here, you must copy them into a directory and set the value of the Ant property "jndtlibdir" to this path ("lib/ant" in the example below):

<property name="jndt-version" value="0.0.0"/>
<property name="jndt-release" value="0"/>
<property name="jndt-jar-filename" value="jndt-${jndt-version}-${jndt-release}.jar"/>
<property name="jndtlibdir" value="lib/ant"/>
<taskdef resource="jndt/antlib.xml" classpath="${jndtlibdir}/${jndt-jar-filename}"/>

Nullsoft Scriptable Install System (NSIS), available in numerous GNU Linux distributions, under Microsoft Windows and under Mac OS X, must be installed separately to generate an installer for Microsoft Windows.

Manual of the Ant tasks

JNDT is composed of the 4 Ant tasks below:

create-app-dir

Creates the directory of the application, i.e the directory containing the necessary files to run the application, its JAR, its resources (optional), the JRE (optional), the native launcher or the launch script and the files for the native integration in the desktop (the icon, ...).

create-linux-app-bundles

Creates a RPM package, a DEB package and an archive for GNU Linux.

create-os-x-app-bundle

Creates a compressed APP file for Mac OS X.

create-windows-app-bundles

Creates a compressed application archive and an installer for Microsoft Windows.