diff --git a/paper-api/src/main/java/org/bukkit/Bukkit.java b/paper-api/src/main/java/org/bukkit/Bukkit.java index a371da9d1..db47fe656 100644 --- a/paper-api/src/main/java/org/bukkit/Bukkit.java +++ b/paper-api/src/main/java/org/bukkit/Bukkit.java @@ -1117,20 +1117,24 @@ public final class Bukkit { /** * Adds a recipe to the crafting manager. + * Recipes added with this method won't be sent to the client automatically. + *
+ * Players still have to discover recipes via {@link Player#discoverRecipe(NamespacedKey)} + * before seeing them in their recipe book. * * @param recipe the recipe to add - * @return true if the recipe was added, false if it wasn't for some - * reason + * @return true if the recipe was added, false if it wasn't for some reason + * @see #addRecipe(Recipe, boolean) */ @Contract("null -> false") public static boolean addRecipe(@Nullable Recipe recipe) { return server.addRecipe(recipe); } - // Paper start - method to send recipes immediately /** * Adds a recipe to the crafting manager. * + * @apiNote resendRecipes is ignored at the moment for stability reasons, recipes will always be updated * @param recipe the recipe to add * @param resendRecipes true to update the client with the full set of recipes * @return true if the recipe was added, false if it wasn't for some reason @@ -1139,7 +1143,6 @@ public final class Bukkit { public static boolean addRecipe(@Nullable Recipe recipe, boolean resendRecipes) { return server.addRecipe(recipe, resendRecipes); } - // Paper end - method to send recipes immediately /** * Get a list of all recipes for a given item. The stack size is ignored diff --git a/paper-api/src/main/java/org/bukkit/Server.java b/paper-api/src/main/java/org/bukkit/Server.java index d7ebfcfc6..2eb72a31c 100644 --- a/paper-api/src/main/java/org/bukkit/Server.java +++ b/paper-api/src/main/java/org/bukkit/Server.java @@ -988,26 +988,24 @@ public interface Server extends PluginMessageRecipient, net.kyori.adventure.audi public boolean dispatchCommand(@NotNull CommandSender sender, @NotNull String commandLine) throws CommandException; /** - * Adds a recipe to the crafting manager. Recipes added with - * this method won't be sent to the client automatically. Use - * {@link #updateRecipes()} or {@link #updateResources()} to - * update clients to new recipes added. + * Adds a recipe to the crafting manager. + * Recipes added with this method won't be sent to the client automatically. *
- * Player's still have to discover recipes via {@link Player#discoverRecipe(NamespacedKey)} + * Players still have to discover recipes via {@link Player#discoverRecipe(NamespacedKey)} * before seeing them in their recipe book. * * @param recipe the recipe to add - * @return true if the recipe was added, false if it wasn't for some - * reason + * @return true if the recipe was added, false if it wasn't for some reason * @see #addRecipe(Recipe, boolean) */ @Contract("null -> false") - public boolean addRecipe(@Nullable Recipe recipe); + boolean addRecipe(@Nullable Recipe recipe); // Paper start - method to send recipes immediately /** * Adds a recipe to the crafting manager. * + * @apiNote resendRecipes is ignored for now for stability reasons, recipes will always be updated * @param recipe the recipe to add * @param resendRecipes true to update the client with the full set of recipes * @return true if the recipe was added, false if it wasn't for some reason