diff --git a/paper-api/src/main/java/org/bukkit/BanList.java b/paper-api/src/main/java/org/bukkit/BanList.java index 5829aca9e5..60aea29d51 100644 --- a/paper-api/src/main/java/org/bukkit/BanList.java +++ b/paper-api/src/main/java/org/bukkit/BanList.java @@ -48,7 +48,7 @@ public interface BanList { */ @Deprecated(since = "1.20.1") @Nullable - public BanEntry getBanEntry(@NotNull String target); + public > E getBanEntry(@NotNull String target); // Paper /** * Gets a {@link BanEntry} by target. @@ -77,7 +77,7 @@ public interface BanList { */ @Deprecated(since = "1.20.1") @Nullable - public BanEntry addBan(@NotNull String target, @Nullable String reason, @Nullable Date expires, @Nullable String source); + public > E addBan(@NotNull String target, @Nullable String reason, @Nullable Date expires, @Nullable String source); // Paper /** * Adds a ban to this list. If a previous ban exists, this will @@ -140,7 +140,7 @@ public interface BanList { * @return an immutable set containing every entry tracked by this list */ @NotNull - public Set> getEntries(); + public > Set getEntries(); // Paper /** * Gets if a {@link BanEntry} exists for the target, indicating an active diff --git a/paper-api/src/main/java/org/bukkit/OfflinePlayer.java b/paper-api/src/main/java/org/bukkit/OfflinePlayer.java index 9facde856f..a8003b4796 100644 --- a/paper-api/src/main/java/org/bukkit/OfflinePlayer.java +++ b/paper-api/src/main/java/org/bukkit/OfflinePlayer.java @@ -147,7 +147,7 @@ public interface OfflinePlayer extends ServerOperator, AnimalTamer, Configuratio * (updated) previous ban */ @Nullable - public BanEntry ban(@Nullable String reason, @Nullable Date expires, @Nullable String source); + public > E ban(@Nullable String reason, @Nullable Date expires, @Nullable String source); // Paper - fix ban list API /** * Adds this user to the {@link ProfileBanList}. If a previous ban exists, this will @@ -161,7 +161,7 @@ public interface OfflinePlayer extends ServerOperator, AnimalTamer, Configuratio * (updated) previous ban */ @Nullable - public BanEntry ban(@Nullable String reason, @Nullable Instant expires, @Nullable String source); + public > E ban(@Nullable String reason, @Nullable Instant expires, @Nullable String source); // Paper - fix ban list API /** * Adds this user to the {@link ProfileBanList}. If a previous ban exists, this will @@ -175,7 +175,7 @@ public interface OfflinePlayer extends ServerOperator, AnimalTamer, Configuratio * (updated) previous ban */ @Nullable - public BanEntry ban(@Nullable String reason, @Nullable Duration duration, @Nullable String source); + public > E ban(@Nullable String reason, @Nullable Duration duration, @Nullable String source); // Paper - fix ban list API /** * Checks if this player is whitelisted or not diff --git a/paper-api/src/main/java/org/bukkit/ban/ProfileBanList.java b/paper-api/src/main/java/org/bukkit/ban/ProfileBanList.java index e805e629ce..5248cf08ef 100644 --- a/paper-api/src/main/java/org/bukkit/ban/ProfileBanList.java +++ b/paper-api/src/main/java/org/bukkit/ban/ProfileBanList.java @@ -10,7 +10,7 @@ import org.jetbrains.annotations.Nullable; /** * A {@link BanList} targeting player profile bans. */ -public interface ProfileBanList extends BanList { +public interface ProfileBanList extends BanList { // Paper /** * {@inheritDoc} @@ -23,8 +23,48 @@ public interface ProfileBanList extends BanList { * @return the entry for the newly created ban, or the entry for the * (updated) previous ban * @throws IllegalArgumentException if ProfilePlayer has an invalid UUID + * @deprecated use {@link #addBan(com.destroystokyo.paper.profile.PlayerProfile, String, Date, String)} */ @Nullable - public BanEntry addBan(@NotNull PlayerProfile target, @Nullable String reason, @Nullable Date expires, @Nullable String source); + // Paper start + @Deprecated + public > E addBan(@NotNull PlayerProfile target, @Nullable String reason, @Nullable Date expires, @Nullable String source); + /** + * @throws IllegalArgumentException if ProfilePlayer has an invalid UUID + */ + @Nullable BanEntry addBan(com.destroystokyo.paper.profile.@NotNull PlayerProfile target, @Nullable String reason, @Nullable Date expires, @Nullable String source); + + // the 5 methods below are added to maintain compat for the bukkit.PlayerProfile parameter type + /** + * @deprecated use {@link #getBanEntry(Object)} + */ + @Deprecated + @Nullable > E getBanEntry(@NotNull PlayerProfile target); + + /** + * @deprecated use {@link #isBanned(Object)} + */ + @Deprecated + boolean isBanned(@NotNull PlayerProfile target); + + /** + * @deprecated use {@link #pardon(Object)} + */ + @Deprecated + void pardon(@NotNull PlayerProfile target); + + /** + * @deprecated use {@link #addBan(Object, String, java.time.Instant, String)} + */ + @Deprecated + @Nullable > E addBan(@NotNull PlayerProfile target, @Nullable String reason, @Nullable java.time.Instant expires, @Nullable String source); + + /** + * @deprecated use {@link #addBan(Object, String, java.time.Duration, String)} + */ + @Deprecated + @Nullable > E addBan(@NotNull PlayerProfile target, @Nullable String reason, @Nullable java.time.Duration duration, @Nullable String source); + + // Paper end } diff --git a/paper-api/src/main/java/org/bukkit/entity/Player.java b/paper-api/src/main/java/org/bukkit/entity/Player.java index c2d49ff3ae..ad8e53bc52 100644 --- a/paper-api/src/main/java/org/bukkit/entity/Player.java +++ b/paper-api/src/main/java/org/bukkit/entity/Player.java @@ -359,7 +359,7 @@ public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginM * (updated) previous ban */ @Nullable - public BanEntry ban(@Nullable String reason, @Nullable Date expires, @Nullable String source, boolean kickPlayer); + public > E ban(@Nullable String reason, @Nullable Date expires, @Nullable String source, boolean kickPlayer); // Paper - fix ban list API /** * Adds this user to the {@link ProfileBanList}. If a previous ban exists, this will @@ -375,7 +375,7 @@ public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginM * (updated) previous ban */ @Nullable - public BanEntry ban(@Nullable String reason, @Nullable Instant expires, @Nullable String source, boolean kickPlayer); + public > E ban(@Nullable String reason, @Nullable Instant expires, @Nullable String source, boolean kickPlayer); // Paper - fix ban list API /** * Adds this user to the {@link ProfileBanList}. If a previous ban exists, this will @@ -391,7 +391,7 @@ public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginM * (updated) previous ban */ @Nullable - public BanEntry ban(@Nullable String reason, @Nullable Duration duration, @Nullable String source, boolean kickPlayer); + public > E ban(@Nullable String reason, @Nullable Duration duration, @Nullable String source, boolean kickPlayer); // Paper - fix ban list API /** * Adds this user's current IP address to the {@link IpBanList}. If a previous ban exists, this will