Entity Info guildExists

$guildExists[]

Checks if a server (guild) with the given ID exists and if the bot has access to it. Returns "true" or "false".

Syntax
$guildExists[guildId]

$guildExists[] — Check Server Existence

$guildExists[] determines if a Discord server identified by its ID exists and if the bot is currently present on it.

Syntax

$guildExists[guildId]

Parameters

Parameter Required Description
guildId Yes The ID of the server to check.

Return Value

  • Type: string
  • "true" if the bot is present on the server, "false" otherwise.

Note: The return value is a string ("true" / "false"), not a boolean. For conditions, compare with ==true or ==false.

Usage

Simple Check

$sendMessage[Presence on server 123456789: $guildExists[123456789]]

Condition Before Action

$if[$guildExists[$message[1]]==true]
$sendMessage[✅ The bot is present on this server.]
$else
$sendMessage[❌ The bot is not on this server, or the ID is invalid.]
$stop
$endif

Multi-Server Check

$var[guild1;123456789012345678]
$var[guild2;987654321098765432]
$if[$guildExists[$var[guild1]]==true]
$sendMessage[Server 1: ✅ Present]
$else
$sendMessage[Server 1: ❌ Absent]
$endif
$if[$guildExists[$var[guild2]]==true]
$sendMessage[Server 2: ✅ Present]
$else
$sendMessage[Server 2: ❌ Absent]
$endif

Availability Log

$if[$guildExists[$var[targetGuild]]==true]
$log[Action executed: server $var[targetGuild] found]
$else
$log[Action blocked: server $var[targetGuild] not found]
$endif

Notes

  • The function only checks if the bot is present on the server, not if the server exists on Discord.
  • A server may exist without the bot being on it — in this case, $guildExists[] returns "false".
  • The ID must be a valid numeric string (Snowflake, 18-19 digits).
  • To get the current server’s ID, use $guildID[] or $serverID[].