Add documentation for volume getter

Author: duncte123

src/main/kotlin/dev/arbjerg/lavalink/client/LavalinkPlayer.kt

@@ -12,6 +12,10 @@ class LavalinkPlayer(private val node: LavalinkNode, protocolPlayer: Player) : I
      * To get the current position of the track, use [position].
      */
     val track = protocolPlayer.track
+
+    /**
+     * Number between 0 and 1000, where 100 is 100% volume.
+     */
     val volume = protocolPlayer.volume
     val paused = protocolPlayer.paused
 

src/main/kotlin/dev/arbjerg/lavalink/client/PlayerUpdateBuilder.kt

@@ -63,7 +63,11 @@ class PlayerUpdateBuilder internal constructor(private val node: LavalinkNode, p
     }
 
     override fun setVolume(volume: Int): PlayerUpdateBuilder {
-        this.volume = min(1000, max(0, volume)).toOmissible()
+        if (volume < 0 || volume > 1000) {
+            throw IllegalArgumentException("Volume must not be less than 0 or greater than 1000");
+        }
+
+        this.volume = volume.toOmissible()
         return this
     }