Paper/patches/api/0372-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 d2f3114d2fe708553b638010394022d09bde39cf..a175ec2744f6ae3e4823c3eaea52e7991b659851 100644
--- a/src/main/java/org/bukkit/entity/Player.java
+++ b/src/main/java/org/bukkit/entity/Player.java
@@ -2809,6 +2809,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