Added @since annotations across API interfaces

Documented the version in which interfaces, methods, and classes were introduced.

Author: NonSwag

src/main/java/net/thenextlvl/service/api/Controller.java

@@ -4,6 +4,12 @@
 import org.jetbrains.annotations.Contract;
 import org.jspecify.annotations.NullMarked;
 
+/**
+ * The `Controller` interface provides methods to retrieve basic information
+ * about the controller, such as the associated plugin and name.
+ *
+ * @since 2.2.1
+ */
 @NullMarked
 public interface Controller {
     /**

src/main/java/net/thenextlvl/service/api/capability/Capability.java

@@ -13,6 +13,8 @@
  * <p>
  * Implementations of this interface can be used in conjunction with capability
  * providers or related systems to organize and query available functionalities.
+ *
+ * @since 2.2.0
  */
 public interface Capability extends Keyed {
 }

src/main/java/net/thenextlvl/service/api/capability/CapabilityException.java

@@ -7,6 +7,8 @@
  * An exception that indicates a problem related to a specific {@link Capability}.
  * This exception is typically thrown when there is an issue or unsupported operation
  * associated with a particular capability in the system.
+ *
+ * @since 2.2.0
  */
 @NullMarked
 public class CapabilityException extends RuntimeException {

src/main/java/net/thenextlvl/service/api/capability/CapabilityProvider.java

@@ -13,6 +13,7 @@
  * capabilities and provides mechanisms to check whether the provider supports individual or multiple capabilities.
  *
  * @param <T> the type of {@link Capability} supported by this provider
+ * @since 2.2.0
  */
 @NullMarked
 public interface CapabilityProvider<T extends Capability> {

src/main/java/net/thenextlvl/service/api/character/Character.java

@@ -18,6 +18,7 @@
  * functionalities such as spawning, despawning, teleportation, and state management.
  *
  * @param <T> the type of the entity associated with this character
+ * @since 2.2.0
  */
 @NullMarked
 public interface Character<T extends Entity> extends Persistable, Viewable {

src/main/java/net/thenextlvl/service/api/character/CharacterCapability.java

@@ -18,6 +18,8 @@
  * <p>
  * Each capability is associated with a unique {@link Key} that acts as an
  * identifier for the capability.
+ *
+ * @since 2.2.0
  */
 @NullMarked
 public enum CharacterCapability implements Capability {

src/main/java/net/thenextlvl/service/api/character/CharacterController.java

@@ -21,6 +21,8 @@
  * and interacting with non-player characters (NPCs).
  * It includes functionality for creating, spawning, retrieving, and checking
  * entities as NPCs, along with capability management.
+ *
+ * @since 2.2.0
  */
 @NullMarked
 public interface CharacterController extends CapabilityProvider<CharacterCapability>, Controller {

src/main/java/net/thenextlvl/service/api/character/event/CharacterDamageEvent.java

@@ -14,6 +14,8 @@
  * the damage, and controlling whether the event should be cancelled.
  * <p>
  * This event will only be fired for providers that support the {@link CharacterCapability#HEALTH} capability.
+ *
+ * @since 2.2.0
  */
 @NullMarked
 public class CharacterDamageEvent extends CharacterEvent implements Cancellable {

src/main/java/net/thenextlvl/service/api/character/event/CharacterEvent.java

@@ -16,6 +16,8 @@
  * <p>
  * Subclasses can make use of these common properties while implementing specific
  * character-related event functionalities.
+ *
+ * @since 2.2.0
  */
 @NullMarked
 public abstract class CharacterEvent extends Event {

src/main/java/net/thenextlvl/service/api/character/event/EntityDamageCharacterEvent.java

@@ -15,6 +15,8 @@
  * It can be used to inspect and modify the damage attributed to an entity's attack and to check the critical status.
  * <p>
  * This event will only be fired for providers that support the {@link CharacterCapability#HEALTH} capability.
+ *
+ * @since 2.2.0
  */
 @NullMarked
 public class EntityDamageCharacterEvent extends CharacterDamageEvent {