Bearbeiten von „Modding des Underground Simulator“

In diesem Guide geht es um die Erweiterungen des Underground Simulator mit sogenannten Extensions. Java-Vorkenntnisse sind zum teil von Nöten, und ein OpenJDK, am besten 21, wir benutzen für den US 25. Wir fangen am Anfang an.


In diesem Guide geht es um die Erweiterungen des Underground Simulator mit sogenannten Extensions. Wir fangen am Anfang an.

==Schritt 1: Projekt aufsetzen ==
===Schritt 1.1: Maven===
Für alle Leute, die die Mod mit Apache Maven nutzen, haben ein leichtes Leben. Sie geben einfach in ihrem leeren Projektordner Folgendes ein:

<pre>
mvn dependency:get \
  -Dartifact=de.qstudios:underground-mod-archetype:1.0-SNAPSHOT \
  -DrepoUrl=https://mvn.deepslatesmp.de/repository/maven-snapshots
</pre>

und dann:

<pre>
mvn archetype:generate \
  -DarchetypeCatalog=local \
  -DarchetypeGroupId=de.qstudios \
  -DarchetypeArtifactId=underground-mod-archetype \
  -DarchetypeVersion=1.0-SNAPSHOT
</pre>
Das war's. Ihr könnt zum nächsten Kapitel fortfahren.
===Schritt 1.2: Gradle o.ä.===
Das ist nicht ganz so einfach, aber nicht wirklich schwer. 
ihr braucht so ein Setup:
<pre>
(Modname)/                       ← Root-Ordner des neuen Mods
├─ pom.xml                     ← Maven POM für das Mod-Projekt
├─ mod.json                    ← Konfigurationsdatei der Mod
└─ src/
   └─ main/
       ├─ java/
       │   └─ (dein Package)   ← Package aus groupId/artifactId
       │       └─ App.java        ← Beispiel-Klassen-Datei
       └─ resources/
           └─ config/             ← Optional: zusätzliche Ressourcen/Configs</pre>
Die pom.xml sieht so aus:
<pre>
<project xmlns="http://maven.apache.org/POM/4.0.0" 
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
                             http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>(eure GroupID)</groupId>
    <artifactId>(Euer Modname)</artifactId>
    <version>1.0</version>
    <packaging>jar</packaging>

  <repositories>
    <repository>
      <url>https://mvn.deepslatesmp.de/repository/maven-public</url>
      <name>Underground Simulator Repo</name>
      <id>us-repo</id>
    </repository>
  </repositories>
  <dependencies>
    <dependency>
      <artifactId>underground</artifactId>
      <groupId>de.qstudios.underground</groupId>
      <version>v0.5.0-alpha.dev-SNAPSHOT</version>
    </dependency>
  </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.10.1</version>
                <configuration>
                    <source>17</source>
                    <target>17</target>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>
</pre>