HasPlayerSpell

From Wiki G1R-MP G1 Remake Multiplayer
Revision as of 11:36, 27 August 2026 by QCherry (talk | contribs) (Document 0.1a Lua API, identities, moderation and synchronized spells)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

hasPlayerSpell

Checks whether a player has an authoritative spell grant.

Syntax

bool hasPlayerSpell(int playerId, int|string spell)

Parameters

Name Type Required Description
playerId int yes The connected player identifier.
spell string yes A spell id, stable spell key, or value from the global SPELL table.

Returns

Returns true when the spell is granted; otherwise returns false.

Examples

Grant a spell only when it is missing:

if not hasPlayerSpell(playerId, SPELL.fire_bolt) then
    givePlayerSpell(playerId, SPELL.fire_bolt)
end

Notes

  • Available only in server-side resource scripts.
  • This is an alias of isPlayerSpellGranted.
  • A granted catalog entry is not necessarily castable. See Synchronized spell catalog for the basic synchronized set in G1R:MP 0.1a.