$hasPerms

The function $hasPerms is an inline permission check. Unlike guards ($onlyPerms, $onlyBotPerms), it does not interrupt the command but returns "true" or "false", allowing fine-grained conditional management.

Syntax

$hasPerms[userID;permission1;permission2;...]

Parameters

Parameter	Type	Description
userID	Snowflake	The ID of the user whose permissions to check.
permission1;permission2;...	String[]	List of permissions to verify. All permissions must be present.

Return Value

• Type: String "true" or "false"
• "true": the user has all listed permissions
• "false": at least one permission is missing

Behavior

• Checks the global permissions of the user on the server.
• The check is of type AND: all listed permissions are required.
• The Administrator permission implicitly satisfies all others.
• Does not interrupt the command (unlike $onlyPerms).

Examples

Simple Conditional Check

$if[$hasPerms[$authorID;BanMembers]==true]
  $ban[$mentioned[1];$noMentionMessage]
  $sendMessage[Member banned.]
$else
  $sendMessage[❌ You do not have permission to ban.]
$endif

Multi-Permission Check

$if[$hasPerms[$authorID;ManageMessages;ManageChannels]==true]
  $clear[$message[1]]
  $sendMessage[$message[1] messages deleted.]
$else
  $sendMessage[❌ Insufficient permissions.]
$endif

Check Bot Permissions

$if[$hasPerms[$botID;KickMembers]==false]
  $sendMessage[⚠️ I do not have permission to kick. Please check my permissions.]
  $stop
$endif
$kick[$mentioned[1]]

Conditional Log

$if[$hasPerms[$authorID;Administrator]==true]
  $log[Admin action: $userName used the command.]
$endif

Notes

• $hasPerms is an inline function: it does not block the command. Use it with $if to create conditional behaviors.
• For the bot, use $botID as the userID.
• Permission names are in PascalCase (BanMembers, KickMembers, ManageMessages, etc.).
• For a check with automatic interruption, use $onlyPerms (user) or $onlyBotPerms (bot).
• $checkUserPerms is an alias of $hasPerms.