1.2.6

Javadoc update
Added WebListener with Javalin provider
Moved to Canvas from Folia
Remove auto-save

Author: UnFamousSoul

.idea/inspectionProfiles/Project_Default.xml

@@ -1,6 +1,6 @@
 plugins {
     id 'java'
-    id 'io.papermc.paperweight.userdev' version "2.0.0-beta.19"
+    id "io.canvasmc.weaver.userdev" version "2.3.12"
 }
 
 group = 'com.unfamoussoul'
@@ -11,10 +11,17 @@ repositories {
     maven {
         url = 'https://repo.papermc.io/repository/maven-public/'
     }
+
+    maven { url = "https://maven.canvasmc.io/releases" }
+    maven {
+        url = "https://maven.canvasmc.io/snapshots"
+        mavenContent { snapshotsOnly() }
+    }
 }
 
 dependencies {
-    paperweight.foliaDevBundle("${folia_version}")
+    paperweight.canvasDevBundle("${canvas_version}")
+    implementation("io.javalin:javalin:${javalin_version}")
 }
 
 java {

.idea/jarRepositories.xml

@@ -1,2 +1,3 @@
-folia_version=1.21.11-R0.1-SNAPSHOT
-version=1.2.5
+canvas_version=1.21.11-R0.1-SNAPSHOT
+javalin_version=7.0.1
+version=1.2.6

build.gradle

@@ -1 +1,10 @@
+pluginManagement {
+    repositories {
+        gradlePluginPortal()
+        maven {
+            url = uri("https://maven.canvasmc.io/releases")
+        }
+    }
+}
+
 rootProject.name = 'SAPI'

gradle.properties

@@ -23,5 +23,25 @@ public boolean execute(@NotNull CommandSender commandSender, @NotNull String s,
         return false;
     }
 
+    /**
+     * Зарегистрировать команду в системе Brigadier. Вызывается при добавлении команды в модуль.
+     * Пример:
+     * <pre><code>
+     *     public TestCommand() {
+     *         super("test");
+     *         register(test());
+     *     }
+     *
+     *     private LiteralArgumentBuilder<CommandSourceStack> test() {
+     *         return Commands.literal("test")
+     *                 .executes(context -> {
+     *                     CommandSender sender = context.getSource().getSender();
+     *                     sender.sendRichMessage(sender.getName());
+     *                     return 1;
+     *                 });
+     *     }
+     * </code></pre>
+     * @param builderSupplier - поставщик билдеров для Brigadier
+     */
     protected native void register(@NotNull LiteralArgumentBuilder<CommandSourceStack> builderSupplier);
 }

settings.gradle

@@ -6,7 +6,13 @@
 import java.lang.annotation.Target;
 
 /**
- * Аннотация для полей, которые должны автоматически сохраняться в .ser файл
+ * Аннотация для полей, которые должны автоматически сохраняться в .ser файл.
+ * Пример:
+ * <pre><code>
+ *     \@Persistent(value = "player_phrases")
+ *     private final Map<UUID, List<String>> playerPhrases = new HashMap<>();
+ * </code></pre>
+ * теперь любое изменение в playerPhrases будет сохраняться в файл plugins/SAPI/data/<имя_Модуля>/player_phrases.ser
  */
 @SuppressWarnings("unused")
 @Retention(RetentionPolicy.RUNTIME)
@@ -17,11 +23,4 @@
      * Имя файла для сохранения
      */
     String value();
-    
-    /**
-     * Интервал авто-сохранения в тиках.
-     * Стандартно 10 секунд
-     * 0 секунд - отключено
-     */
-    long autoSave() default 200L;
 }

src/main/java/com/unfamoussoul/sapi/api/command/DynamicCommand.java

@@ -0,0 +1,37 @@
+package com.unfamoussoul.sapi.api.web;
+
+import io.javalin.Javalin;
+import io.javalin.config.JavalinConfig;
+import org.eclipse.jetty.util.thread.QueuedThreadPool;
+
+import java.util.function.Consumer;
+
+
+/**
+ * Класс для создания веб-сервера на основе Javalin. Позволяет создавать и управлять веб-приложением,
+ * а также предоставляет доступ к пулу потоков и самому приложению для настройки и обработки запросов.
+ */
+@SuppressWarnings("unused")
+public abstract class WebListener {
+
+    /**
+     * Создать Javalin приложение с конфигурацией
+     * @param config конфигурация для Javalin приложения
+     */
+    protected native Javalin create(Consumer<JavalinConfig> config);
+
+    /**
+     * Запустить Javalin приложение на указанном порту
+     * @param port порт для прослушивания
+     */
+    public native void start(int port);
+
+    /**
+     * Остановить Javalin приложение
+     */
+    public native void stop();
+
+    protected native QueuedThreadPool getThreadPool();
+
+    protected native Javalin getApp();
+}

src/main/java/com/unfamoussoul/sapi/api/serialize/Persistent.java

@@ -4,6 +4,7 @@
 import com.unfamoussoul.sapi.api.access.SAPIAccess;
 import com.unfamoussoul.sapi.api.command.DynamicCommand;
 import com.unfamoussoul.sapi.api.config.ConfigHandler;
+import com.unfamoussoul.sapi.api.web.WebListener;
 import com.unfamoussoul.sapi.locale.Locale;
 import org.bukkit.event.Listener;
 import org.jetbrains.annotations.NotNull;
@@ -59,6 +60,18 @@ protected SAPIModule(SAPI plugin) {
      */
     protected native void removeListener(Listener @NotNull ... listeners);
 
+    /**
+     * Добавляет веб-листенер с сервера
+     * @param listener Веб-листенер для добавления
+     * @param port Порт, на котором будет работать веб-листенер
+     */
+    protected native void addWebListener(WebListener listener, int port);
+
+    /**
+     * Удаляет веб-листенер с сервера
+     */
+    protected native void removeWebListener(WebListener @NotNull ... listeners);
+
     /**
      * Загрузка локализации. После этого вы можете использовать getLocale() для получения локализированого текста
      */