From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
From: Jake Potrebic <jake.m.potrebic@gmail.com>
Date: Fri, 9 Dec 2022 01:34:03 -0800
Subject: [PATCH] fix Instruments

Add missing instrument enums
fix some wrong javadocs

diff --git a/src/main/java/org/bukkit/Instrument.java b/src/main/java/org/bukkit/Instrument.java
index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000 100644
--- a/src/main/java/org/bukkit/Instrument.java
+++ b/src/main/java/org/bukkit/Instrument.java
@@ -0,0 +0,0 @@ import org.jetbrains.annotations.Nullable;
 public enum Instrument {
 
     /**
-     * Piano is the standard instrument for a note block.
+     * Piano (Harp) is the standard instrument for a note block.
      */
     PIANO(0x0),
     /**
@@ -0,0 +0,0 @@ public enum Instrument {
      */
     SNARE_DRUM(0x2),
     /**
-     * Sticks are normally played when a note block is on top of a glass
+     * Sticks (Hat) are normally played when a note block is on top of a glass
      * block.
      */
     STICKS(0x3),
@@ -0,0 +0,0 @@ public enum Instrument {
     /**
      * Pling is normally played when a note block is on top of a glowstone block.
      */
-    PLING(0xF);
+    // Paper start
+    PLING(0xF),
+    /**
+     * Zombie is normally played when a zombie head is on top of a note block.
+     */
+    @org.jetbrains.annotations.ApiStatus.Experimental
+    ZOMBIE(0x10),
+    /**
+     * Skeleton is normally played when a skeleton skull is on top of a note block.
+     */
+    @org.jetbrains.annotations.ApiStatus.Experimental
+    SKELETON(0x11),
+    /**
+     * Creeper is normally played when a creeper head is on top of a note block.
+     */
+    @org.jetbrains.annotations.ApiStatus.Experimental
+    CREEPER(0x12),
+    /**
+     * Dragon is normally played when an Ender Dragon head is on top of a note block.
+     */
+    @org.jetbrains.annotations.ApiStatus.Experimental
+    DRAGON(0x13),
+    /**
+     * Wither skeleton is normally played when a wither skeleton skull head is on top of a note block.
+     */
+    @org.jetbrains.annotations.ApiStatus.Experimental
+    WITHER_SKELETON(0x14),
+    /**
+     * Piglin is normally played when a piglin head is on top of a note block.
+     */
+    @org.jetbrains.annotations.ApiStatus.Experimental
+    PIGLIN(0x15),
+    /**
+     * Custom head is normally played when a player head is on top of a note block.
+     */
+    @org.jetbrains.annotations.ApiStatus.Experimental
+    CUSTOM_HEAD(0x16);
+    // Paper end
 
     private final byte type;
     private static final Map<Byte, Instrument> BY_DATA = Maps.newHashMap();
diff --git a/src/main/java/org/bukkit/entity/Player.java b/src/main/java/org/bukkit/entity/Player.java
index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000 100644
--- a/src/main/java/org/bukkit/entity/Player.java
+++ b/src/main/java/org/bukkit/entity/Player.java
@@ -0,0 +0,0 @@ public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginM
     public void playNote(@NotNull Location loc, byte instrument, byte note);
 
     /**
-     * Play a note for a player at a location. This requires a note block
-     * at the particular location (as far as the client is concerned). This
-     * will not work without a note block. This will not work with cake.
+     * Play a note for a player at a location.
      *
      * @param loc The location of a note block
      * @param instrument The instrument