build(project): Convert the workspace to a Gradle project

This helps import the project into an IDE and to start the game.

Author: TobseF

.gitignore

@@ -3,6 +3,7 @@
 
 # Build target
 out
+build
 target
 tag
 

.idea/runConfigurations/XSwing.xml

@@ -39,10 +39,49 @@ Pay attention: One stack can only take up to eight balls.
  <kbd>F2</kbd>: Toggle Fullscreen  
  <kbd>S</kbd>: Change game size (experimental)
 
+To use the app, you need at least a Java 1.8 JRE.
+You can get it for any platform [here](https://adoptium.net/temurin/releases/).
+
+## 🎮 Start
+The game needs an installed Java runtime environment (JRE) with at least 8.
+You can get it for any platform [here](https://adoptium.net/temurin/releases/?version=8).
+For example on Windows choose:
+ * Operating System: `Windows`
+ * Architecture: `x64`
+ * Package Type: `JRE`
+ * Version: `8 - LTS`
+And download the `.msi` installer.
+
+If the `.jar` wile type is linked with the `java`, you can simply start the game by opening the `XSwingPlus.jar`.
+Otherwise, start the game with console:
+```shell
+java -jar XSwingPlus.jar
+```
+
 ## 🚀 Setup
-All dependencies are included. Add the `lib` folder to _Libraries_.  
-In addition to the `.jar` archives, you also have to set the native library location:  
-_Configure project library_ > _Native Library Locations_ > `$PROJECT_DIR$`
+To start developing, import the workspace als [Gradle](https://gradle.org) project in your IDE.
+All dependencies are included in the `lib` folder. They should be automatically referenced by Gradle.  
+To start the game simply run the Gradle task:
+```shell
+gradle run
+```
+This will compile the game and start the game with splash Screen (class `xswing.start.XSwingWithOptions`).
+If you use [IntelliJ IDEA](https://www.jetbrains.com/idea/) you can also use the predefined run configurations:
+ * ▶ `XSwing` 
+ * ▶ `XSwingNoSplash` 
+
+## 📦 Package
+You can build the game for distribution wich wil generate a runnable jar which includes all dependencies,
+resources and natives. 
+```shell
+gradle shadowJar
+```
+This will packe the game to the output folder: `build\libs\`.
+
+> 💡 Keep in mind, that the game not only needs the resources in the `res` folder, but also the
+> native [LWJGL](https://www.lwjgl.org) bindings for your platform 
+> (`.ddl` for Windows, `.so` Linux and `.jnilib` for Mac).
+> The `shadowJar` will copy all natives for all platforms to the build dir for you!
 
 ## 📜 Licence
 This remake is a free fan project. _Software 2000_ is not involved in any way.

.idea/runConfigurations/XSwingNoSplash.xml

@@ -0,0 +1,67 @@
+import com.github.jengelman.gradle.plugins.shadow.tasks.ShadowJar
+
+plugins {
+  // Apply the application plugin to add support for building an application in Java.
+  application
+
+  id("com.github.johnrengelman.shadow") version "7.1.2"
+}
+
+repositories {
+  flatDir {
+    dirs("lib")
+  }
+}
+
+dependencies {
+  implementation(":gson:2.2.4")
+  implementation(":ixbm:")
+  implementation(":jinput:")
+  implementation(":jnlp:")
+  implementation(":jogg:0.0.7")
+  implementation(":jorbis:0.0.15")
+  implementation(":lwjgl:")
+  implementation(":lwjgl:debug")
+  implementation(":lwjgl:util")
+  implementation(":nifty:1.1")
+  implementation(":nifty-default-controls:1.1")
+  implementation(":slick:")
+  implementation(":tinylinepp:")
+  implementation(":xpp3:1.1.4c:")
+
+  testImplementation(":junit:4.13.1")
+  testImplementation(":junit-benchmarks:0.7.0")
+  testImplementation(":hamcrest-core:1.3")
+}
+
+application {
+  // The main class for the application.
+  mainClass.set("xswing.start.XSwingWithOptions")
+}
+
+// Output to build/libs/XSwingPlus.jar
+tasks.withType<ShadowJar> {
+  archiveClassifier.set("")
+
+  copy {
+    into("$buildDir/libs/")
+    with(copySpec {
+      from(".") {
+        include("res/**")
+      }
+    })
+  }
+  copy {
+    into("$buildDir/libs/")
+    with(copySpec {
+      from(".") {
+        include("*.dll")
+        include("*.so")
+        include("*.jnilib")
+        include("README.md")
+        include("config.json")
+      }
+    })
+  }
+}
+

README.md

@@ -0,0 +1,7 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.2-bin.zip
+networkTimeout=10000
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists