From 626d08431eb4e2722631b95a1fd69dd73b5b8ee7 Mon Sep 17 00:00:00 2001
From: Remigio <31587616+Remigio07@users.noreply.github.com>
Date: Sat, 10 May 2025 15:33:38 +0200
Subject: [PATCH] Add missing IllegalArgumentExceptions to Javadocs (#4015)

---
 .../main/java/net/luckperms/api/node/types/DisplayNameNode.java  | 1 +
 .../main/java/net/luckperms/api/node/types/InheritanceNode.java  | 1 +
 api/src/main/java/net/luckperms/api/node/types/MetaNode.java     | 1 +
 .../main/java/net/luckperms/api/node/types/PermissionNode.java   | 1 +
 .../java/net/luckperms/api/node/types/RegexPermissionNode.java   | 1 +
 5 files changed, 5 insertions(+)

diff --git a/api/src/main/java/net/luckperms/api/node/types/DisplayNameNode.java b/api/src/main/java/net/luckperms/api/node/types/DisplayNameNode.java
index 2c6321b85..3db052fad 100644
--- a/api/src/main/java/net/luckperms/api/node/types/DisplayNameNode.java
+++ b/api/src/main/java/net/luckperms/api/node/types/DisplayNameNode.java
@@ -63,6 +63,7 @@ public interface DisplayNameNode extends ScopedNode<DisplayNameNode, DisplayName
      *
      * @param displayName the display name to set
      * @return the builder
+     * @throws IllegalArgumentException if {@code displayName} is empty
      */
     static @NonNull Builder builder(@NonNull String displayName) {
         return builder().displayName(displayName);
diff --git a/api/src/main/java/net/luckperms/api/node/types/InheritanceNode.java b/api/src/main/java/net/luckperms/api/node/types/InheritanceNode.java
index 520911b97..e1c060ee2 100644
--- a/api/src/main/java/net/luckperms/api/node/types/InheritanceNode.java
+++ b/api/src/main/java/net/luckperms/api/node/types/InheritanceNode.java
@@ -67,6 +67,7 @@ public interface InheritanceNode extends ScopedNode<InheritanceNode, Inheritance
      *
      * @param group the group to set
      * @return the builder
+     * @throws IllegalArgumentException if {@code group} is not a valid group name
      */
     static @NonNull Builder builder(@NonNull String group) {
         return builder().group(group);
diff --git a/api/src/main/java/net/luckperms/api/node/types/MetaNode.java b/api/src/main/java/net/luckperms/api/node/types/MetaNode.java
index 4939b68e9..da8f2b29b 100644
--- a/api/src/main/java/net/luckperms/api/node/types/MetaNode.java
+++ b/api/src/main/java/net/luckperms/api/node/types/MetaNode.java
@@ -71,6 +71,7 @@ public interface MetaNode extends ScopedNode<MetaNode, MetaNode.Builder> {
      * @param key the meta key to set
      * @param value the meta value to set
      * @return the builder
+     * @throws IllegalArgumentException if {@code key} is empty
      */
     static @NonNull Builder builder(@NonNull String key, @NonNull String value) {
         return builder().key(key).value(value);
diff --git a/api/src/main/java/net/luckperms/api/node/types/PermissionNode.java b/api/src/main/java/net/luckperms/api/node/types/PermissionNode.java
index eb5b4934c..f992c10ef 100644
--- a/api/src/main/java/net/luckperms/api/node/types/PermissionNode.java
+++ b/api/src/main/java/net/luckperms/api/node/types/PermissionNode.java
@@ -88,6 +88,7 @@ public interface PermissionNode extends ScopedNode<PermissionNode, PermissionNod
      *
      * @param permission the permission to set
      * @return the builder
+     * @throws IllegalArgumentException if {@code permission} is empty
      */
     static @NonNull Builder builder(@NonNull String permission) {
         return builder().permission(permission);
diff --git a/api/src/main/java/net/luckperms/api/node/types/RegexPermissionNode.java b/api/src/main/java/net/luckperms/api/node/types/RegexPermissionNode.java
index e9603cac8..9e7f364ff 100644
--- a/api/src/main/java/net/luckperms/api/node/types/RegexPermissionNode.java
+++ b/api/src/main/java/net/luckperms/api/node/types/RegexPermissionNode.java
@@ -75,6 +75,7 @@ public interface RegexPermissionNode extends ScopedNode<RegexPermissionNode, Reg
      *
      * @param pattern the pattern to set
      * @return the builder
+     * @throws IllegalArgumentException if {@code pattern} is empty
      */
     static @NonNull Builder builder(@NonNull String pattern) {
         return builder().pattern(pattern);