Require plugins to specify an API version and match with the server

plugin-schema.json

@@ -12,7 +12,8 @@
   "required": [
     "name",
     "description",
-        "mainClass"
+    "mainClass",
+    "api"
   ],
   "properties": {
     "name": {
@@ -31,6 +32,10 @@
         "number"
       ]
     },
+    "api": {
+      "description": "The API revision the plugin is using.",
+      "type": "number"
+    },
     "description": {
       "description": "Human readable plugin summary.",
       "type": "string"

src/main/java/emu/grasscutter/plugin/PluginConfig.java

@@ -4,6 +4,7 @@ package emu.grasscutter.plugin;
 public final class PluginConfig {
     public String name, description, version;
     public String mainClass;
+    public Integer api;
     public String[] authors;
     public String[] loadAfter;
 
@@ -14,6 +15,7 @@ public final class PluginConfig {
      */
     @SuppressWarnings("BooleanMethodIsAlwaysInverted")
     public boolean validate() {
-        return name != null && description != null && mainClass != null;
+        return name != null && description != null &&
+            mainClass != null && api != null;
     }
 }

src/main/java/emu/grasscutter/plugin/PluginManager.java

@@ -1,28 +1,28 @@
 package emu.grasscutter.plugin;
 
+import emu.grasscutter.Grasscutter;
+import emu.grasscutter.server.event.*;
+import emu.grasscutter.utils.*;
+import lombok.*;
+
+import javax.annotation.Nullable;
+import java.io.*;
+import java.lang.reflect.Method;
+import java.net.*;
+import java.util.*;
+import java.util.jar.*;
+
 import static emu.grasscutter.utils.lang.Language.translate;
 
-import emu.grasscutter.Grasscutter;
-import emu.grasscutter.server.event.Event;
-import emu.grasscutter.server.event.EventHandler;
-import emu.grasscutter.utils.FileUtils;
-import emu.grasscutter.utils.JsonUtils;
-import java.io.File;
-import java.io.FileNotFoundException;
-import java.io.InputStreamReader;
-import java.lang.reflect.Method;
-import java.net.MalformedURLException;
-import java.net.URL;
-import java.net.URLClassLoader;
-import java.util.*;
-import java.util.jar.JarEntry;
-import java.util.jar.JarFile;
-import javax.annotation.Nullable;
-import lombok.AllArgsConstructor;
-import lombok.Getter;
-
 /** Manages the server's plugins and the event system. */
 public final class PluginManager {
+    /*
+     * This should only be changed when a breaking change is made to the plugin API.
+     * A 'breaking change' is something which changes the existing logic of the API.
+     */
+    @SuppressWarnings("FieldCanBeLocal")
+    private static int API_VERSION = 2;
+
     /* All loaded plugins. */
     private final Map<String, Plugin> plugins = new LinkedHashMap<>();
     /* All currently registered listeners per plugin. */
@@ -78,6 +78,16 @@ public final class PluginManager {
 
                     // Create a plugin config instance from the config file.
                     PluginConfig pluginConfig = JsonUtils.loadToClass(fileReader, PluginConfig.class);
+                    // Check the plugin's API version.
+                    if (pluginConfig.api == null) {
+                        Grasscutter.getLogger().warn(translate("plugin.invalid_api.not_present", plugin.getName()));
+                        return;
+                    } else if (pluginConfig.api != API_VERSION) {
+                        Grasscutter.getLogger().warn(translate("plugin.invalid_api.lower",
+                            plugin.getName(), pluginConfig.api, API_VERSION));
+                        return;
+                    }
+
                     // Check if the plugin config is valid.
                     if (!pluginConfig.validate()) {
                         Grasscutter.getLogger().warn(translate("plugin.invalid_config", plugin.getName()));

src/main/resources/languages/en-US.json

@@ -460,6 +460,10 @@
     "enabling_plugin": "Enabling plugin: %s",
     "enabling_failed": "Failed to enable plugin: %s",
     "disabling_plugin": "Disabling plugin: %s",
-    "disabling_failed": "Failed to disable plugin: %s"
+    "disabling_failed": "Failed to disable plugin: %s",
+    "invalid_api": {
+      "not_present": "Plugin %s does not specify an API version.",
+      "lower": "Plugin %s is using API version %s, while the server is using API version %s."
+    }
   }
 }

src/main/resources/languages/es-ES.json

@@ -460,6 +460,10 @@
     "enabling_plugin": "Activando plugin: %s",
     "enabling_failed": "Error al activar el plugin: %s",
     "disabling_plugin": "Desactivando el plugin: %s",
-    "disabling_failed": "Error al desactivar el plugin: %s"
+    "disabling_failed": "Error al desactivar el plugin: %s",
+    "invalid_api": {
+      "not_present": "🇺🇸Plugin %s does not specify an API version.",
+      "lower": "🇺🇸Plugin %s is using API version %s, while the server is using API version %s."
+    }
   }
 }

src/main/resources/languages/fr-FR.json

@@ -460,6 +460,10 @@
     "enabling_plugin": "Activation du plugin %s",
     "enabling_failed": "Impossible d'activer le plugin %s",
     "disabling_plugin": "Désactivation du plugin %s",
-    "disabling_failed": "Impossible de désactiver le plugin %s"
+    "disabling_failed": "Impossible de désactiver le plugin %s",
+    "invalid_api": {
+      "not_present": "🇺🇸Plugin %s does not specify an API version.",
+      "lower": "🇺🇸Plugin %s is using API version %s, while the server is using API version %s."
+    }
   }
 }

src/main/resources/languages/it-IT.json

@@ -460,6 +460,10 @@
     "enabling_plugin": "Abilitazione plug-in: %s",
     "enabling_failed": "Impossibile abilitare il plug-in: %s",
     "disabling_plugin": "Disabilitazione plug-in: %s",
-    "disabling_failed": "Impossibile disabilitare il plug-in: %s"
+    "disabling_failed": "Impossibile disabilitare il plug-in: %s",
+    "invalid_api": {
+      "not_present": "🇺🇸Plugin %s does not specify an API version.",
+      "lower": "🇺🇸Plugin %s is using API version %s, while the server is using API version %s."
+    }
   }
 }

src/main/resources/languages/ja-JP.json

@@ -460,6 +460,10 @@
     "enabling_plugin": "プラグインを有効にしています: %s",
     "enabling_failed": "プラグインの有効化に失敗しました: %s",
     "disabling_plugin": "プラグインを無効にしています: %s",
-    "disabling_failed": "プラグインの無効化に失敗しました: %s"
+    "disabling_failed": "プラグインの無効化に失敗しました: %s",
+    "invalid_api": {
+      "not_present": "🇺🇸Plugin %s does not specify an API version.",
+      "lower": "🇺🇸Plugin %s is using API version %s, while the server is using API version %s."
+    }
   }
 }

src/main/resources/languages/ko-KR.json

@@ -460,6 +460,10 @@
     "enabling_plugin": "플러그인을 활성화했습니다: %s",
     "enabling_failed": "플러그인을 활성화하는데 실패했습니다: %s",
     "disabling_plugin": "플러그인을 비활성화했습니다: %s",
-    "disabling_failed": "플러그인을 비활성화하는데 실패했습니다: %s"
+    "disabling_failed": "플러그인을 비활성화하는데 실패했습니다: %s",
+    "invalid_api": {
+      "not_present": "🇺🇸Plugin %s does not specify an API version.",
+      "lower": "🇺🇸Plugin %s is using API version %s, while the server is using API version %s."
+    }
   }
 }

src/main/resources/languages/pl-PL.json

@@ -460,6 +460,10 @@
     "enabling_plugin": "Włączanie pluginu: %s",
     "enabling_failed": "Nie udało się załączyć pluginu: %s",
     "disabling_plugin": "Wyłączanie pluginu: %s",
-    "disabling_failed": "Nie udało się wyłączyć pluginu: %s"
+    "disabling_failed": "Nie udało się wyłączyć pluginu: %s",
+    "invalid_api": {
+      "not_present": "🇺🇸Plugin %s does not specify an API version.",
+      "lower": "🇺🇸Plugin %s is using API version %s, while the server is using API version %s."
+    }
   }
 }

src/main/resources/languages/ro-RO.json

@@ -460,6 +460,10 @@
     "enabling_plugin": "🇺🇸Enabling plugin: %s",
     "enabling_failed": "🇺🇸Failed to enable plugin: %s",
     "disabling_plugin": "🇺🇸Disabling plugin: %s",
-    "disabling_failed": "🇺🇸Failed to disable plugin: %s"
+    "disabling_failed": "🇺🇸Failed to disable plugin: %s",
+    "invalid_api": {
+      "not_present": "🇺🇸Plugin %s does not specify an API version.",
+      "lower": "🇺🇸Plugin %s is using API version %s, while the server is using API version %s."
+    }
   }
 }

src/main/resources/languages/ru-RU.json

@@ -460,6 +460,10 @@
     "enabling_plugin": "Включаем Плагин: %s",
     "enabling_failed": "Ошибка включения Плагина: %s",
     "disabling_plugin": "Отключаем Плагин: %s",
-    "disabling_failed": "Ошибка отключения Плагина: %s"
+    "disabling_failed": "Ошибка отключения Плагина: %s",
+    "invalid_api": {
+      "not_present": "🇺🇸Plugin %s does not specify an API version.",
+      "lower": "🇺🇸Plugin %s is using API version %s, while the server is using API version %s."
+    }
   }
 }

src/main/resources/languages/zh-CN.json

@@ -460,6 +460,10 @@
     "enabling_plugin": "启用插件：%s",
     "enabling_failed": "无法启用插件：%s",
     "disabling_plugin": "正在禁用插件：%s",
-    "disabling_failed": "无法禁用插件：%s"
+    "disabling_failed": "无法禁用插件：%s",
+    "invalid_api": {
+      "not_present": "🇺🇸Plugin %s does not specify an API version.",
+      "lower": "🇺🇸Plugin %s is using API version %s, while the server is using API version %s."
+    }
   }
 }

src/main/resources/languages/zh-TW.json

@@ -460,6 +460,10 @@
     "enabling_plugin": "🇺🇸Enabling plugin: %s",
     "enabling_failed": "🇺🇸Failed to enable plugin: %s",
     "disabling_plugin": "🇺🇸Disabling plugin: %s",
-    "disabling_failed": "🇺🇸Failed to disable plugin: %s"
+    "disabling_failed": "🇺🇸Failed to disable plugin: %s",
+    "invalid_api": {
+      "not_present": "🇺🇸Plugin %s does not specify an API version.",
+      "lower": "🇺🇸Plugin %s is using API version %s, while the server is using API version %s."
+    }
   }
 }