Schreiben Sie Spigot in VS Code

Ich möchte ein Plug-In für Micra erstellen. Aber ich möchte Eclipse nicht für diejenigen verwenden, die VS-Code [offizielles Spigot MC-Wiki] verwenden möchten (https://www.spigotmc.org/wiki/creating-a-blank-spigot-plugin-in-vs-code/). ) Ist eine grobe japanische Übersetzung. Bitte beachten Sie, dass es einige Übersetzungen und Änderungen gibt, um die Teile zu bearbeiten, die in meiner Umgebung nicht funktionierten [^ 1].

Voraussetzungen

VSCode hat Java Extension Pack installiert.
OpenJDK muss enthalten sein. (Für das Java-Erweiterungspaket ist OpenJDK erforderlich.)
Sie benötigen auch Apache Maven.
Grundkenntnisse in Java haben.
Verfügen Sie über einen eindeutigen Namen wie die Gruppen-ID des Plug-Ins, die Internetdomäne, die für das Paket verwendet werden kann, oder einen Teil der E-Mail-Adresse.

Vorbereitung des Arbeitsbereichs

Erstellen Sie mit VS Coede einen Arbeitsbereich und konfigurieren Sie ihn. Sie können die Einstellungen über das Fenstermenü oder durch Bearbeiten von default.code-workspace ändern.

files.autoGuestEncoding： Aktivieren Sie das Kontrollkästchen. [^ 2]

files.encoding： Geben Sie utf8 an.

java.home： Geben Sie den absoluten Pfad von OpenJDK an.

java.jdt.ls.vmargs： Legen Sie zusätzliche Java VM-Argumente fest, um den Java Language Server zu starten. Auf "-Dfile.encoding = UTF-8" setzen. [^ 2]

javac-linter.javac： Legt die ausführbare Datei javac fest. Geben Sie im Argument von javac "-Dfile.encoding = UTF-8" an. [^ 2]

Am Ende sollte "default.code-workspace" wie folgt aussehen.

{ "folders": [ { "path": "." } ], "settings": { "files.autoGuessEncoding": true, "files.encoding": "utf8", "java.home": "C:\openjdk-1.8.0", "java.jdt.ls.vmargs": "-Dfile.encoding=UTF-8", "javac-linter.javac": "javac -Dfile.encoding=UTF-8" } }


## Erstellen eines leeren Plug-Ins
 Klicken Sie mit der rechten Maustaste auf das Arbeitsbereichsverzeichnis und klicken Sie auf "Aus Maven-Archetyp generieren".
 Klicken Sie im Menü oben im VS-Code-Fenster auf "maven-archetype-quickstart". [^ 3]
 Wenn der Bildschirm zur Versionsauswahl angezeigt wird, wählen Sie den neuesten (2.0).
 Der Explorer wird geöffnet. Wählen Sie daher einen Arbeitsbereich aus.

 Das Terminal fragt Sie nach einigen Projekteinstellungen.

**groupId**:
 Geben Sie den Paketnamen ein
**artifactId**:
 Geben Sie den Namen des Plug-Ins ohne Versionsnummer ein
**version**：
 Geben Sie die Versionsnummer des Steckers ein. Wenn Sie die Eingabetaste drücken, ohne etwas einzugeben, wird "1.0-SNAPSHOT" angezeigt.
**package**：
 Es wird empfohlen, nur die Eingabetaste zu drücken, um die Standardeinstellung zu verwenden. Der Standardwert ist groupId.

 Danach werden Sie von Maven aufgefordert, die Einstellungen des Maven-Projekts zu bestätigen.
 Wenn es korrekt ist, drücken Sie zur Bestätigung Y oder Enter.
 Wenn der Satz "BUILD SUCCESS" im Terminal angezeigt wird, öffnen Sie pom.xml aus dem Plugin-Verzeichnis und bearbeiten Sie ihn wie folgt.

 ** Hinweis: Folgendes ist der Fall, wenn die groupId auf "dev.cibmc.spigot.blankplugin" gesetzt ist **
>```
<?xml version="1.0" encoding="UTF-8"?>
<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>dev.cibmc.spigot.blankplugin</groupId>
  <artifactId>BlankPlugin</artifactId>
  <version>1.0-SNAPSHOT</version>
  <packaging>jar</packaging>
  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
  </properties>
  <repositories>
      <repository>
          <id>spigot-repo</id>
          <url>https://hub.spigotmc.org/nexus/content/repositories/snapshots/</url>
      </repository>
  </repositories>
  <dependencies>
      <dependency>
            <groupId>org.spigotmc</groupId>
            <artifactId>spigot-api</artifactId>
            <version>1.12.2-R0.1-SNAPSHOT</version>
            <scope>provided</scope>
      </dependency>
  </dependencies>
  <build>
    <sourceDirectory>${project.basedir}/src/main/java</sourceDirectory>
    <resources>
      <resource>
        <directory>${project.basedir}/src/main/resources</directory>
        <includes>
          <include>plugin.yml</include>
        </includes>
      </resource>
    </resources>
  </build>
</project>

Natürlich können Sie die Version der Spigot-API ändern.

Erstellen Sie ein Ressourcenverzeichnis in [projectBaseDir] / src / main und erstellen Sie darin die Datei plugin.yml. Unten finden Sie ein Beispiel für plugin.yml.

main: dev.cibmc.spigot.blankplugin.App name: BlankPlugin version: 0.1


---
 Dies ist ein Teil, der nicht im Originalartikel enthalten ist
 In meiner Umgebung [^ 1] musste der Inhalt von versin jedoch in doppelte Anführungszeichen gesetzt werden, und die Elemente api und api-version wurden benötigt.
 API gibt die Version von Minecraft an (z. B. 1.16.2) und API-Version gibt die Version der Spigot-API an (z. B. 1.16).

 Daher funktioniert es normal, indem Folgendes ausgeführt wird. (Für Version 1.16.2)

>```
main: dev.cibmc.spigot.blankplugin.App
name: BlankPlugin
version: "0.1"
api: 1.16.2
api-version: 1.16

Zu diesem Zeitpunkt sollte der Arbeitsbereich-Verzeichnisbaum folgendermaßen aussehen: BlankPlugin 　┣ src 　┃　┣ main 　┃　┃　┣ java 　┃　┃　┃　┗ dev 　┃　┃　┃　　　┗ cibmc 　┃　┃　┃　　　　　┗ spigot 　┃　┃　┃　　　　　　　┗ blankplugin 　┃　┃　┃　　　　　　　　　┗ App.java 　┃　┃　┗ resources 　┃　┃　　　┗ plugin.yml 　┃　┗ test 　┣ target 　┗ pom.xml

Klicken Sie im MAVEN-Bereich mit der rechten Maustaste auf "Brank Plugin" und wählen Sie "Installieren" aus dem Menü. Vergewissern Sie sich, dass im Terminal "BUILD SUCCESS" angezeigt wird.

** Hinweis: Die als Beispiel bereitgestellte groupId "dev.cibmc.spigot.blankplugin" sollte beim Erstellen eines Plugins in Ihre eigene groupId geändert werden. ** **.

** Hinweis 2: Wenn Sie APP nicht im Namen der Hauptklasse verwenden möchten, benennen Sie die Datei um, benennen Sie die Klasse um und ändern Sie die Definition von main in plugin.yml. ** **.

Erstellen Sie ein leeres Plugin

Öffnen Sie die Datei App.java in dem Verzeichnis, das im vorherigen Kapitel erstellt wurde. (Oder wenn Sie die Datei umbenannt haben, diese Datei) Unten finden Sie einen Beispielcode.

package dev.cibmc.spigot.blankplugin; import org.bukkit.plugin.java.JavaPlugin; public class App extends JavaPlugin { @Override public void onEnable() { getLogger().info("Hello, SpigotMC!"); } @Override public void onDisable() { getLogger().info("See you again, SpigotMC!"); } }


 Wenn "Klassenpfad unvollständig ist. Es werden nur Syntaxfehler gemeldet." Wird unten rechts im VS-Code angezeigt. Klicken Sie im MAVEN-Bedienfeld mit der rechten Maustaste auf "BrankPlugin" und wählen Sie "Benutzerdefinierte Ziele ..." aus dem Menü.
 Geben Sie danach "eclipse: eclipse" in das Eingabefeld oben im VS-Code-Fenster ein und drücken Sie die Eingabetaste.

 Klicken Sie abschließend im MAVEN-Bedienfeld mit der rechten Maustaste auf "Brank Plugin" und wählen Sie erneut "Installieren".
 Wenn der Build erfolgreich ist, wird das Spigot-Plug-In im Zielverzeichnis generiert.

## Führen Sie das leere Plugin aus
 Kopieren Sie das erstellte Plug-In in das Plug-In-Verzeichnis und starten Sie den Server.
 Anschließend wird das unten gezeigte Serverprotokoll angezeigt.
>```
[HH:MM:SS] [Server thread/INFO]: [BlankPlugin] Enabling BlankPlugin v1.0-SNAPSHOT
[HH:MM:SS] [Server thread/INFO]: [BlankPlugin] Hello, SpigotMC!

Wenn Sie den Befehl stop auf der Konsole ausführen, wird das folgende Protokoll angezeigt.

[HH:MM:SS] [Server thread/INFO]: [BlankPlugin] Disabling BlankPlugin v1.0-SNAPSHOT [HH:MM:SS] [Server thread/INFO]: [BlankPlugin] See you again, SpigotMC!


# Verweise
 Offizielles Spigot MC-Wiki (https://www.spigotmc.org/wiki/creating-a-blank-spigot-plugin-in-vs-code/)
 [^ 1]: windows10, Micra ver1.16.x
 [^ 2]: In meinem Fall hat es gut funktioniert, auch wenn ich es nicht angezogen habe.
 [^ 3]: Möglicherweise befindet sich JDK-8 usw. dahinter, aber Sie müssen sich darüber keine Sorgen machen.