Remove org.jetbrains annotations and update dependencies

Removed all `org.jetbrains` annotations from the codebase and updated the build script to exclude `org.jetbrains` annotations from `paper-api`. This streamlines our annotation usage to rely solely on `org.jspecify` annotations and ensures consistency across the project.

Author: david

paper/build.gradle.kts

@@ -25,7 +25,9 @@ repositories {
 
 dependencies {
     compileOnly("org.projectlombok:lombok:1.18.34")
-    compileOnly("io.papermc.paper:paper-api:1.21.3-R0.1-SNAPSHOT")
+    compileOnly("io.papermc.paper:paper-api:1.21.3-R0.1-SNAPSHOT") {
+        exclude("org.jetbrains", "annotations")
+    }
 
     api(project(":version-checker")) {
         exclude("com.google.code.gson", "gson")

paper/src/main/java/core/paper/gui/GUI.java

@@ -19,7 +19,6 @@
 import org.bukkit.event.inventory.InventoryOpenEvent;
 import org.bukkit.inventory.Inventory;
 import org.bukkit.plugin.Plugin;
-import org.jetbrains.annotations.ApiStatus;
 import org.jspecify.annotations.NullMarked;
 
 import java.util.stream.IntStream;
@@ -73,7 +72,6 @@ protected void formatDefault() {
      * <p>
      * Note: Do not call this method directly, it is automatically called by the system.
      */
-    @ApiStatus.OverrideOnly
     protected void onClose() {
     }
 
@@ -83,7 +81,6 @@ protected void onClose() {
      * <p>
      * Note: Do not call this method directly, it is automatically called by the system.
      */
-    @ApiStatus.OverrideOnly
     protected void onOpen() {
     }
 

paper/src/main/java/core/paper/item/ItemBuilder.java

@@ -12,10 +12,8 @@
 import org.bukkit.inventory.meta.ItemMeta;
 import org.bukkit.inventory.meta.SkullMeta;
 import org.bukkit.inventory.meta.components.FoodComponent;
-import org.jetbrains.annotations.ApiStatus;
-import org.jetbrains.annotations.Nullable;
-import org.jetbrains.annotations.Range;
 import org.jspecify.annotations.NullMarked;
+import org.jspecify.annotations.Nullable;
 
 import java.util.*;
 import java.util.function.Consumer;
@@ -95,7 +93,6 @@ public ItemBuilder displayName(Component name) {
      * @return the modified item builder
      * @see ItemMeta#setFood(FoodComponent)
      */
-    @ApiStatus.Experimental
     @SuppressWarnings("UnstableApiUsage")
     public ItemBuilder food(@Nullable FoodComponent food) {
         return modify(meta -> meta.setFood(food));
@@ -119,7 +116,7 @@ public ItemBuilder rarity(@Nullable ItemRarity rarity) {
      * @return the modified ItemBuilder object
      * @see ItemMeta#setMaxStackSize(Integer)
      */
-    public ItemBuilder maxStackSize(@Range(from = 1, to = 99) @Nullable Integer max) {
+    public ItemBuilder maxStackSize(@Nullable Integer max) {
         return modify(meta -> meta.setMaxStackSize(max));
     }
 
@@ -130,7 +127,7 @@ public ItemBuilder maxStackSize(@Range(from = 1, to = 99) @Nullable Integer max)
      * @return the modified item builder
      * @see ItemStack#setAmount(int)
      */
-    public ItemBuilder amount(@Range(from = 0, to = 99) int amount) {
+    public ItemBuilder amount(int amount) {
         setAmount(Math.clamp(amount, 0, getMaxStackSize()));
         return this;
     }

paper/src/main/java/core/paper/scoreboard/BelowNameScoreboard.java

@@ -8,8 +8,8 @@
 import org.bukkit.scoreboard.DisplaySlot;
 import org.bukkit.scoreboard.Objective;
 import org.bukkit.scoreboard.Scoreboard;
-import org.jetbrains.annotations.Nullable;
 import org.jspecify.annotations.NullMarked;
+import org.jspecify.annotations.Nullable;
 
 @NullMarked
 public class BelowNameScoreboard {

paper/src/main/java/core/paper/scoreboard/Sidebar.java

@@ -8,9 +8,8 @@
 import org.bukkit.Bukkit;
 import org.bukkit.entity.Player;
 import org.bukkit.scoreboard.*;
-import org.jetbrains.annotations.Nullable;
-import org.jetbrains.annotations.Range;
 import org.jspecify.annotations.NullMarked;
+import org.jspecify.annotations.Nullable;
 
 import java.util.Arrays;
 
@@ -78,7 +77,7 @@ public Sidebar numberFormat(@Nullable NumberFormat format) {
      * @param format the number format to be set for the specified line
      * @return the Sidebar object
      */
-    public Sidebar numberFormat(@Range(from = 1, to = 15) int line, @Nullable NumberFormat format) {
+    public Sidebar numberFormat(int line, @Nullable NumberFormat format) {
         getScore(line).numberFormat(format);
         return this;
     }
@@ -90,7 +89,7 @@ public Sidebar numberFormat(@Range(from = 1, to = 15) int line, @Nullable Number
      * @param content the component to be displayed on the line
      * @return the Sidebar object
      */
-    public Sidebar line(@Range(from = 1, to = 15) int line, @Nullable Component content) {
+    public Sidebar line(int line, @Nullable Component content) {
         getTeam(line).prefix(content);
         return showLine(line);
     }
@@ -101,7 +100,7 @@ public Sidebar line(@Range(from = 1, to = 15) int line, @Nullable Component cont
      * @param line the line to display (1-15)
      * @return the Sidebar object
      */
-    public Sidebar showLine(@Range(from = 1, to = 15) int line) {
+    public Sidebar showLine(int line) {
         var score = getScore(line);
         if (!score.isScoreSet()) score.setScore(line);
         return this;
@@ -113,7 +112,7 @@ public Sidebar showLine(@Range(from = 1, to = 15) int line) {
      * @param line the line to hide (1-15)
      * @return the Sidebar object
      */
-    public Sidebar hideLine(@Range(from = 1, to = 15) int line) {
+    public Sidebar hideLine(int line) {
         var value = Line.valueOf(line);
         var objective = this.objective.getScore(value.color());
         if (objective.isScoreSet()) scoreboard.resetScores(value.color());
@@ -122,12 +121,12 @@ public Sidebar hideLine(@Range(from = 1, to = 15) int line) {
         return this;
     }
 
-    private Score getScore(@Range(from = 1, to = 15) int line) {
+    private Score getScore(int line) {
         var value = Line.valueOf(line);
         return this.objective.getScore(value.color());
     }
 
-    private Team getTeam(@Range(from = 1, to = 15) int line) {
+    private Team getTeam(int line) {
         var value = Line.valueOf(line);
         var team = scoreboard.getTeam(value.name());
         if (team != null) return team;
@@ -159,7 +158,7 @@ private enum Line {
         private final String color;
         private final int score;
 
-        private static Line valueOf(@Range(from = 1, to = 15) int line) {
+        private static Line valueOf(int line) {
             return Arrays.stream(values())
                     .filter(value -> value.score() == line)
                     .findAny()