Begin switching to JSpecify annotations (#11448)

* Begin switching to JSpecify annotations

* more

* fixes

patches/api/0177-Add-ThrownEggHatchEvent.patch

@@ -8,10 +8,10 @@ Adds a new event similar to PlayerEggThrowEvent, but without the Player requirem
 
 diff --git a/src/main/java/com/destroystokyo/paper/event/entity/ThrownEggHatchEvent.java b/src/main/java/com/destroystokyo/paper/event/entity/ThrownEggHatchEvent.java
 new file mode 100644
-index 0000000000000000000000000000000000000000..092bab9be36acc0f04c7ea5b3510879169a0a125
+index 0000000000000000000000000000000000000000..26526049a4c7f7ebe6bea27a9c5a638df3ef8854
 --- /dev/null
 +++ b/src/main/java/com/destroystokyo/paper/event/entity/ThrownEggHatchEvent.java
-@@ -0,0 +1,120 @@
+@@ -0,0 +1,117 @@
 +package com.destroystokyo.paper.event.entity;
 +
 +import com.google.common.base.Preconditions;
@@ -20,13 +20,14 @@ index 0000000000000000000000000000000000000000..092bab9be36acc0f04c7ea5b35108791
 +import org.bukkit.event.Event;
 +import org.bukkit.event.HandlerList;
 +import org.jetbrains.annotations.ApiStatus;
-+import org.jetbrains.annotations.NotNull;
++import org.jspecify.annotations.NullMarked;
 +
 +/**
 + * Called when a thrown egg might hatch.
 + * <p>
 + * This event fires for all thrown eggs that may hatch, players, dispensers, etc.
 + */
++@NullMarked
 +public class ThrownEggHatchEvent extends Event {
 +
 +    private static final HandlerList HANDLER_LIST = new HandlerList();
@@ -37,7 +38,7 @@ index 0000000000000000000000000000000000000000..092bab9be36acc0f04c7ea5b35108791
 +    private EntityType hatchType;
 +
 +    @ApiStatus.Internal
-+    public ThrownEggHatchEvent(@NotNull final Egg egg, final boolean hatching, final byte numHatches, @NotNull final EntityType hatchingType) {
++    public ThrownEggHatchEvent(final Egg egg, final boolean hatching, final byte numHatches, final EntityType hatchingType) {
 +        this.egg = egg;
 +        this.hatching = hatching;
 +        this.numHatches = numHatches;
@@ -49,7 +50,6 @@ index 0000000000000000000000000000000000000000..092bab9be36acc0f04c7ea5b35108791
 +     *
 +     * @return the egg involved in this event
 +     */
-+    @NotNull
 +    public Egg getEgg() {
 +        return this.egg;
 +    }
@@ -68,9 +68,9 @@ index 0000000000000000000000000000000000000000..092bab9be36acc0f04c7ea5b35108791
 +     * Sets whether the egg will hatch or not.
 +     *
 +     * @param hatching {@code true} if you want the egg to hatch, {@code false} if you want it
-+     *     not to
++     *                 not to
 +     */
-+    public void setHatching(boolean hatching) {
++    public void setHatching(final boolean hatching) {
 +        this.hatching = hatching;
 +    }
 +
@@ -79,7 +79,6 @@ index 0000000000000000000000000000000000000000..092bab9be36acc0f04c7ea5b35108791
 +     *
 +     * @return The type of the mob being hatched by the egg
 +     */
-+    @NotNull
 +    public EntityType getHatchingType() {
 +        return this.hatchType;
 +    }
@@ -89,13 +88,13 @@ index 0000000000000000000000000000000000000000..092bab9be36acc0f04c7ea5b35108791
 +     *
 +     * @param hatchType The type of the mob being hatched by the egg
 +     */
-+    public void setHatchingType(@NotNull EntityType hatchType) {
++    public void setHatchingType(final EntityType hatchType) {
 +        Preconditions.checkArgument(hatchType.isSpawnable(), "Can't spawn that entity type from an egg!");
 +        this.hatchType = hatchType;
 +    }
 +
 +    /**
-+     * Get the number of mob hatches from the egg. By default the number will
++     * Get the number of mob hatches from the egg. By default, the number will
 +     * be the number the server would've done
 +     * <ul>
 +     *  <li>7/8 chance of being 0
@@ -117,17 +116,15 @@ index 0000000000000000000000000000000000000000..092bab9be36acc0f04c7ea5b35108791
 +     *
 +     * @param numHatches The number of mobs coming out of the egg
 +     */
-+    public void setNumHatches(byte numHatches) {
++    public void setNumHatches(final byte numHatches) {
 +        this.numHatches = numHatches;
 +    }
 +
-+    @NotNull
 +    @Override
 +    public HandlerList getHandlers() {
 +        return HANDLER_LIST;
 +    }
 +
-+    @NotNull
 +    public static HandlerList getHandlerList() {
 +        return HANDLER_LIST;
 +    }