thomasmny · thomasmny · Jun 24, 2025 · Jun 16, 2025 · Jun 17, 2025 · Jun 17, 2025
diff --git a/buildsystem-api/javadoc/overview.html b/buildsystem-api/javadoc/overview.html
@@ -1,11 +1,11 @@
 <body>
 <p>
-    BuildSystem is a utility plugin targeted towards build-teams.
-    It allows worlds to be easily managed and also provides handy tools to assist with building.
+  BuildSystem is a utility plugin targeted towards build-teams.
+  It allows worlds to be easily managed and also provides handy tools to assist with building.
 </p>
 <h1>Useful Links</h1>
 <ul>
-    <li><a target="_top" href="https://buildsystem.eintosti.de">Project Website</a></li>
-    <li><a target="_top" href="https://github.com/thomasmny/BuildSystem">Source Code</a></li>
+  <li><a target="_top" href="https://buildsystem.eintosti.de">Project Website</a></li>
+  <li><a target="_top" href="https://github.com/thomasmny/BuildSystem">Source Code</a></li>
 </ul>
 </body>
diff --git a/buildsystem-api/src/main/java/de/eintosti/buildsystem/api/BuildSystem.java b/buildsystem-api/src/main/java/de/eintosti/buildsystem/api/BuildSystem.java
@@ -24,6 +24,8 @@
 
 /**
  * The BuildSystem API.
+ *
+ * @since 3.0.0
  */
 public interface BuildSystem {
 

diff --git a/buildsystem-api/src/main/java/de/eintosti/buildsystem/api/BuildSystemProvider.java b/buildsystem-api/src/main/java/de/eintosti/buildsystem/api/BuildSystemProvider.java
@@ -22,6 +22,8 @@
 
 /**
  * Provides static access to the {@link BuildSystem} API.
+ *
+ * @since 3.0.0
  */
 public class BuildSystemProvider {
 

diff --git a/buildsystem-api/src/main/java/de/eintosti/buildsystem/api/event/world/BuildWorldEvent.java b/buildsystem-api/src/main/java/de/eintosti/buildsystem/api/event/world/BuildWorldEvent.java
@@ -25,6 +25,8 @@
 
 /**
  * Represents a {@link BuildWorld} related event.
+ *
+ * @since 3.0.0
  */
 public class BuildWorldEvent extends Event {
 

diff --git a/...system-api/src/main/java/de/eintosti/buildsystem/api/event/world/BuildWorldLoadEvent.java b/...system-api/src/main/java/de/eintosti/buildsystem/api/event/world/BuildWorldLoadEvent.java
@@ -23,6 +23,8 @@
 
 /**
  * Called when a {@link BuildWorld} is loaded.
+ *
+ * @since 3.0.0
  */
 public class BuildWorldLoadEvent extends BuildWorldEvent implements Cancellable {
 

diff --git a/...em-api/src/main/java/de/eintosti/buildsystem/api/event/world/BuildWorldPostLoadEvent.java b/...em-api/src/main/java/de/eintosti/buildsystem/api/event/world/BuildWorldPostLoadEvent.java
@@ -22,6 +22,8 @@
 
 /**
  * Called after a {@link BuildWorld} has loaded.
+ *
+ * @since 3.0.0
  */
 public class BuildWorldPostLoadEvent extends BuildWorldEvent {
 

diff --git a/...-api/src/main/java/de/eintosti/buildsystem/api/event/world/BuildWorldPostUnloadEvent.java b/...-api/src/main/java/de/eintosti/buildsystem/api/event/world/BuildWorldPostUnloadEvent.java
@@ -22,6 +22,8 @@
 
 /**
  * Called after a {@link BuildWorld} has unloaded.
+ *
+ * @since 3.0.0
  */
 public class BuildWorldPostUnloadEvent extends BuildWorldEvent {
 

diff --git a/...stem-api/src/main/java/de/eintosti/buildsystem/api/event/world/BuildWorldUnloadEvent.java b/...stem-api/src/main/java/de/eintosti/buildsystem/api/event/world/BuildWorldUnloadEvent.java
@@ -23,6 +23,8 @@
 
 /**
  * Called when a {@link BuildWorld} is unloaded.
+ *
+ * @since 3.0.0
  */
 public class BuildWorldUnloadEvent extends BuildWorldEvent implements Cancellable {
 

diff --git a/.../src/main/java/de/eintosti/buildsystem/api/navigator/settings/NavigatorInventoryType.java b/.../src/main/java/de/eintosti/buildsystem/api/navigator/settings/NavigatorInventoryType.java
diff --git a/...ystem-api/src/main/java/de/eintosti/buildsystem/api/navigator/settings/NavigatorType.java b/...ystem-api/src/main/java/de/eintosti/buildsystem/api/navigator/settings/NavigatorType.java
@@ -17,6 +17,11 @@
  */
 package de.eintosti.buildsystem.api.navigator.settings;
 
+/**
+ * Represents the type of the navigator.
+ *
+ * @since 3.0.0
+ */
 public enum NavigatorType {
     OLD,
     NEW;

diff --git a/...system-api/src/main/java/de/eintosti/buildsystem/api/navigator/settings/WorldDisplay.java b/...system-api/src/main/java/de/eintosti/buildsystem/api/navigator/settings/WorldDisplay.java
@@ -19,6 +19,11 @@
 
 import de.eintosti.buildsystem.api.world.BuildWorld;
 
+/**
+ * Interface for managing the display settings of worlds in the navigator.
+ *
+ * @since 3.0.0
+ */
 public interface WorldDisplay {
 
     /**

diff --git a/...dsystem-api/src/main/java/de/eintosti/buildsystem/api/navigator/settings/WorldFilter.java b/...dsystem-api/src/main/java/de/eintosti/buildsystem/api/navigator/settings/WorldFilter.java
@@ -21,6 +21,11 @@
 import java.util.function.Predicate;
 import org.jetbrains.annotations.ApiStatus.Internal;
 
+/**
+ * Interface for a world filter that restricts which {@link BuildWorld}s are shown to a user in the navigator.
+ *
+ * @since 3.0.0
+ */
 public interface WorldFilter {
 
     enum Mode {

diff --git a/buildsystem-api/src/main/java/de/eintosti/buildsystem/api/navigator/settings/WorldSort.java b/buildsystem-api/src/main/java/de/eintosti/buildsystem/api/navigator/settings/WorldSort.java
@@ -19,6 +19,11 @@
 
 import org.jetbrains.annotations.ApiStatus.Internal;
 
+/**
+ * Represents the sorting options for worlds in the navigator.
+ *
+ * @since 3.0.0
+ */
 public enum WorldSort {
 
     /**

diff --git a/buildsystem-api/src/main/java/de/eintosti/buildsystem/api/player/BuildPlayer.java b/buildsystem-api/src/main/java/de/eintosti/buildsystem/api/player/BuildPlayer.java
@@ -17,14 +17,13 @@
  */
 package de.eintosti.buildsystem.api.player;
 
-import de.eintosti.buildsystem.api.navigator.settings.NavigatorInventoryType;
 import de.eintosti.buildsystem.api.player.settings.Settings;
 import de.eintosti.buildsystem.api.world.BuildWorld;
+import de.eintosti.buildsystem.api.world.display.NavigatorCategory;
+import java.util.UUID;
 import javax.annotation.Nullable;
 import org.bukkit.Location;
 import org.bukkit.entity.Player;
-
-import java.util.UUID;
 import org.jetbrains.annotations.ApiStatus.Internal;
 
 public interface BuildPlayer {
@@ -110,19 +109,19 @@ public interface BuildPlayer {
     void setPreviousLocation(Location location);
 
     /**
-     * Gets the {@link NavigatorInventoryType} the player last looked at.
+     * Gets the {@link NavigatorCategory} the player last looked at.
      *
      * @return The last looked navigator inventory type
      */
     @Internal
     @Nullable
-    NavigatorInventoryType getLastLookedAt();
+    NavigatorCategory getLastLookedAt();
 
     /**
-     * Sets the {@link NavigatorInventoryType} the player last looked at.
+     * Sets the {@link NavigatorCategory} the player last looked at.
      *
      * @param type The last looked navigator inventory type
      */
     @Internal
-    void setLastLookedAt(NavigatorInventoryType type);
+    void setLastLookedAt(NavigatorCategory type);
 }
diff --git a/buildsystem-api/src/main/java/de/eintosti/buildsystem/api/player/CachedValues.java b/buildsystem-api/src/main/java/de/eintosti/buildsystem/api/player/CachedValues.java
@@ -22,6 +22,11 @@
 import org.bukkit.inventory.ItemStack;
 import org.jetbrains.annotations.ApiStatus.Internal;
 
+/**
+ * Interface for managing cached values of a player.
+ *
+ * @since 3.0.0
+ */
 @Internal
 public interface CachedValues {
 

diff --git a/buildsystem-api/src/main/java/de/eintosti/buildsystem/api/player/LogoutLocation.java b/buildsystem-api/src/main/java/de/eintosti/buildsystem/api/player/LogoutLocation.java
@@ -20,6 +20,11 @@
 import org.bukkit.Location;
 import org.jetbrains.annotations.ApiStatus.Internal;
 
+/**
+ * Represents a player's logout location, which includes the world name and the location coordinates.
+ *
+ * @since 3.0.0
+ */
 @Internal
 public interface LogoutLocation {
 

diff --git a/buildsystem-api/src/main/java/de/eintosti/buildsystem/api/player/PlayerService.java b/buildsystem-api/src/main/java/de/eintosti/buildsystem/api/player/PlayerService.java
@@ -18,16 +18,17 @@
 package de.eintosti.buildsystem.api.player;
 
 import de.eintosti.buildsystem.api.storage.PlayerStorage;
-import de.eintosti.buildsystem.api.storage.WorldStorage;
 import de.eintosti.buildsystem.api.world.BuildWorld;
 import de.eintosti.buildsystem.api.world.data.Visibility;
-import org.bukkit.entity.Player;
-import org.jetbrains.annotations.Unmodifiable;
-
-import java.util.Collection;
 import java.util.Set;
 import java.util.UUID;
+import org.bukkit.entity.Player;
 
+/**
+ * Service for managing {@link BuildPlayer}.
+ *
+ * @since 3.0.0
+ */
 public interface PlayerService {
 
     PlayerStorage getPlayerStorage();
@@ -49,8 +50,7 @@ public interface PlayerService {
     boolean isInBuildMode(Player player);
 
     /**
-     * Gets whether the given player is allowed to create a new {@link BuildWorld}.<br>
-     * This depends on the following factors:
+     * Gets whether the given player is allowed to create a new {@link BuildWorld}.<br> This depends on the following factors:
      * <ul>
      *  <li>Is the maximum number of worlds set by the config less than the amount of existing worlds?</li>
      *  <li>Is the maximum number of worlds created by the player less than the amount of worlds said player is allowed to create?</li>
@@ -65,8 +65,7 @@ public interface PlayerService {
     /**
      * Returns the maximum amount of {@link BuildWorld}s a player can create.
      * <p>
-     * If the player has the permission {@code buildsystem.admin}, unlimited worlds can be created.
-     * Otherwise, there are two different permissions to set said amount:
+     * If the player has the permission {@code buildsystem.admin}, unlimited worlds can be created. Otherwise, there are two different permissions to set said amount:
      * <p>
      * To set the maximum of...
      * <ul>

diff --git a/buildsystem-api/src/main/java/de/eintosti/buildsystem/api/player/settings/DesignColor.java b/buildsystem-api/src/main/java/de/eintosti/buildsystem/api/player/settings/DesignColor.java
@@ -19,6 +19,8 @@
 
 /**
  * A {@link DesignColor} is the color which glass panes are tinted to in different menus.
+ *
+ * @since 3.0.0
  */
 public enum DesignColor {
     RED,

diff --git a/buildsystem-api/src/main/java/de/eintosti/buildsystem/api/player/settings/Settings.java b/buildsystem-api/src/main/java/de/eintosti/buildsystem/api/player/settings/Settings.java
@@ -19,11 +19,17 @@
 
 import de.eintosti.buildsystem.api.navigator.settings.NavigatorType;
 import de.eintosti.buildsystem.api.navigator.settings.WorldDisplay;
+import de.eintosti.buildsystem.api.player.BuildPlayer;
 import org.bukkit.GameMode;
 import org.bukkit.potion.PotionEffectType;
 import org.bukkit.scheduler.BukkitTask;
 import org.jetbrains.annotations.ApiStatus.Internal;
 
+/**
+ * Different settings a {@link BuildPlayer} can modify for themselves.
+ *
+ * @since 3.0.0
+ */
 public interface Settings {
 
     /**
-Original file line number
+Diff line change
@@ Expand Up / @@ -24,6 +24,8 @@ @@
     /**
      * The BuildSystem API.
+     *
+     * @since 3.0.0
      */
     public interface BuildSystem {
@@ Expand Down @@