coll1234567 / Bukkit / 150a2861a73

Commits

coll1234567 authored and md_5 committed 150a2861a73 19 Mar 2023

#827: Add BlockData#getPlacementMaterial

Modified

-192
+     * support depending on its states. A common example would be a wall's ability to support
-193
+     * torches only on the center of the upper block face, whereas a grass block would
-194
+     * support all levels of block support on all block faces.
-195
+     *
-196
+     * @param face the face to check
-197
+     * @param support the possible support level
-198
+     *
-199
+     * @return true if the face is sturdy and can support a block, false otherwise
-200
+     */
-201
+    boolean isFaceSturdy(@NotNull BlockFace face, @NotNull BlockSupport support);
-+
-+
+    /**
-+
+     * Gets the material that a player would use to place this block.
-+
+     * <p>
-+
+     * For most blocks this is the same as {@link #getMaterial()} but some blocks
-+
+     * have different materials used to place them.
-+
+     *
-+
+     * For example:
-+
+     * <pre>
-+
+     * {@link Material#REDSTONE_WIRE} -> {@link Material#REDSTONE}
-+
+     * {@link Material#CARROTS} -> {@link Material#CARROT}
-+
+     * </pre>
-+
+     * @return placement material
-+
+     */
-+
+    @NotNull
-+
+    Material getPlacementMaterial();
-218
+}