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:

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

und dann:

mvn archetype:generate \
  -DarchetypeCatalog=local \
  -DarchetypeGroupId=de.qstudios \
  -DarchetypeArtifactId=underground-mod-archetype \
  -DarchetypeVersion=1.0-SNAPSHOT

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:

(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

Die pom.xml sieht so aus:

<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>