Paper/patches/api/0371-Custom-Chat-Completion-Suggestions-API.patch

From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
From: Owen1212055 <23108066+Owen1212055@users.noreply.github.com>
Date: Sat, 30 Jul 2022 11:23:11 -0400
Subject: [PATCH] Custom Chat Completion Suggestions API


diff --git a/src/main/java/org/bukkit/entity/Player.java b/src/main/java/org/bukkit/entity/Player.java
index b063aba9439f1f32f0716c636d28b2821eeb4fcf..847d9723acf141351b4f88a7a70143fa9d684efc 100644
--- a/src/main/java/org/bukkit/entity/Player.java
+++ b/src/main/java/org/bukkit/entity/Player.java
@@ -2933,6 +2933,29 @@ public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginM
      * @throws IllegalArgumentException If the level is negative or greater than {@code 4} (i.e. not within {@code [0, 4]}).
      */
     void sendOpLevel(byte level);
+
+    /**
+     * Adds custom chat completion suggestions that the client will
+     * suggest when typing in chat.
+     *
+     * @param completions custom completions
+     * @deprecated use {@link #addCustomChatCompletions(Collection)}
+     */
+    @Deprecated(since = "1.20.1")
+    void addAdditionalChatCompletions(@NotNull java.util.Collection<String> completions);
+
+    /**
+     * Removes custom chat completion suggestions that the client
+     * suggests when typing in chat.
+     *
+     * Note: this only applies to previously added custom completions,
+     * online player names are always suggested and cannot be removed.
+     *
+     * @param completions custom completions
+     * @deprecated use {@link #addCustomChatCompletions(Collection)}
+     */
+    @Deprecated(since = "1.20.1")
+    void removeAdditionalChatCompletions(@NotNull java.util.Collection<String> completions);
     // Paper end
 
     // Spigot start