Merge pull request #876 from QwQ-dev/slimefunitem_optional_methods

Add SlimefunItem#getOptionalById(String) and SlimefunItem#getOptionalByItem(ItemStack).

src/main/java/io/github/thebusybiscuit/slimefun4/api/items/SlimefunItem.java

@@ -1233,6 +1233,17 @@ public final int hashCode() {
         return Slimefun.getRegistry().getSlimefunItemIds().get(id);
     }
 
+    /**
+     * Retrieve a {@link Optional} {@link SlimefunItem} by its id.
+     *
+     * @param id
+     *            The id of the {@link SlimefunItem}
+     * @return The {@link Optional} {@link SlimefunItem} associated with that id. Empty if non-existent
+     */
+    public static @Nonnull Optional<SlimefunItem> getOptionalById(@Nonnull String id) {
+        return Optional.ofNullable(getById(id));
+    }
+
     /**
      * Retrieve a {@link SlimefunItem} from an {@link ItemStack}.
      *
@@ -1258,6 +1269,17 @@ public final int hashCode() {
         return null;
     }
 
+    /**
+     * Retrieve a {@link Optional} {@link SlimefunItem} from an {@link ItemStack}.
+     *
+     * @param item
+     *            The {@link ItemStack} to check
+     * @return The {@link Optional} {@link SlimefunItem} associated with this {@link ItemStack} if present, otherwise empty
+     */
+    public static @Nonnull Optional<SlimefunItem> getOptionalByItem(@Nullable ItemStack item) {
+        return Optional.ofNullable(getByItem(item));
+    }
+
     /**
      * Should load the {@link SlimefunBlockData} by default.
      * If return false, only the item with {@link BlockTicker} will be loaded with {@link ChunkLoadEvent}.