initial commit

.gitignore

@@ -0,0 +1,38 @@
+target/
+!.mvn/wrapper/maven-wrapper.jar
+!**/src/main/**/target/
+!**/src/test/**/target/
+
+### IntelliJ IDEA ###
+.idea/modules.xml
+.idea/jarRepositories.xml
+.idea/compiler.xml
+.idea/libraries/
+*.iws
+*.iml
+*.ipr
+
+### Eclipse ###
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+
+### NetBeans ###
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+build/
+!**/src/main/**/build/
+!**/src/test/**/build/
+
+### VS Code ###
+.vscode/
+
+### Mac OS ###
+.DS_Store

.idea/.gitignore

@@ -0,0 +1,3 @@
+# Default ignored files
+/shelf/
+/workspace.xml

.idea/encodings.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Encoding">
+    <file url="file://$PROJECT_DIR$/src/main/java" charset="UTF-8" />
+    <file url="file://$PROJECT_DIR$/src/main/resources" charset="UTF-8" />
+  </component>
+</project>

.idea/misc.xml

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ExternalStorageConfigurationManager" enabled="true" />
+  <component name="MavenProjectsManager">
+    <option name="originalFiles">
+      <list>
+        <option value="$PROJECT_DIR$/pom.xml" />
+      </list>
+    </option>
+  </component>
+  <component name="ProjectRootManager" version="2" languageLevel="JDK_21" default="true" project-jdk-name="temurin-21" project-jdk-type="JavaSDK">
+    <output url="file://$PROJECT_DIR$/out" />
+  </component>
+</project>

.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>

pom.xml

@@ -0,0 +1,41 @@
+<?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>eu.m724</groupId>
+    <artifactId>mutils</artifactId>
+    <version>1.0-SNAPSHOT</version>
+
+    <properties>
+        <maven.compiler.source>21</maven.compiler.source>
+        <maven.compiler.target>21</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    </properties>
+
+    <build>
+        <resources>
+            <resource>
+                <directory>src/main/resources</directory>
+                <filtering>true</filtering>
+            </resource>
+        </resources>
+    </build>
+
+    <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.21.1-R0.1-SNAPSHOT</version>
+            <scope>provided</scope>
+        </dependency>
+    </dependencies>
+</project>

src/main/java/eu/m724/utils/UtilsPlugin.java

@@ -0,0 +1,6 @@
+package eu.m724.utils;
+
+import org.bukkit.plugin.java.JavaPlugin;
+
+public class UtilsPlugin extends JavaPlugin {
+}

src/main/java/eu/m724/utils/notification/Notification.java

@@ -0,0 +1,29 @@
+package eu.m724.utils.notification;
+
+import net.md_5.bungee.api.chat.BaseComponent;
+
+/**
+ *
+ * @param namespace the namespace of the notification,
+ * @param lingering
+ * @param duration
+ * @param content
+ */
+public record Notification(
+        String namespace,
+        boolean lingering,
+        int duration,
+        BaseComponent[] content
+) {
+
+    public enum Priority {
+        /** Notification will be visible in an unobtrusive way */
+        BACKGROUND,
+        /** Notification will pop up as a subtitle for a short time */
+        NORMAL,
+        /** Notification will pop up as a subtitle for a short time and remain in the action bar for some more */
+        HIGH,
+        /** Notification will pop up as a subtitle in a flashy way for some time, along with a ALERT title */
+        ALERT
+    }
+}

src/main/java/eu/m724/utils/notification/NotificationManager.java

@@ -0,0 +1,14 @@
+package eu.m724.utils.notification;
+
+import org.bukkit.entity.Player;
+
+import java.util.HashSet;
+import java.util.Set;
+
+public class NotificationManager {
+    private final Set<NotifiedPlayer> players = new HashSet<>();
+
+    public void showNotification(Player player, Notification notification) {
+
+    }
+}

src/main/java/eu/m724/utils/notification/NotifiedPlayer.java

@@ -0,0 +1,23 @@
+package eu.m724.utils.notification;
+
+import org.bukkit.entity.Player;
+
+import java.time.Instant;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.Set;
+
+public class NotifiedPlayer {
+    private final Player player;
+
+    // displayed notifications and when
+    private final Map<Notification, Instant> notifications = new HashMap<>();
+
+    public NotifiedPlayer(Player player) {
+        this.player = player;
+    }
+
+    public Player getPlayer() {
+        return player;
+    }
+}

src/main/resources/plugin.yml

@@ -0,0 +1,5 @@
+name: mUtils724
+version: ${project.version}
+
+main: eu.m724.utils.UtilsPlugin
+api-version: 1.21.1