isOwner: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 9: Line 9:
isOwner()
isOwner()
isOwner(player)
isOwner(player)
isOwner(player, id)
isOwner(player, tokenRef)
isOwner(player, id, mapname)
isOwner(player, tokenRef, mapname)
</syntaxhighlight>
</syntaxhighlight>
'''Parameters'''
'''Parameters'''
{{param|player|The name of the player to check for ownership, defaults to the [[getPlayerName|Current Player]]. }}
{{param|player|The name of the player to check for ownership, defaults to the [[getPlayerName|Current Player]]. }}
{{param|id|The token {{code|id}} of the token which is checked for ownership, defaults to the [[Current Token]]. {{TrustedParameter}} }}
{{param|tokenRef|Either the token [[getSelected|{{code|id}}]] or [[getTokenName|Token Name]] of the token which is checked for ownership, defaults to the [[Current Token]]. {{TrustedParameter}} }}
{{param|mapname|The name of the map to find the token.  Defaults to the current map.}}
{{param|mapname|The name of the map to find the token.  Defaults to the current map.}}
 
{{Note|Token IDs are unique, but Token Names can be duplicated. Using Token Name when more than one token has the same name can produce unexpected results.}}


|examples=
|examples=

Revision as of 15:49, 17 May 2024

isOwner() Function

Introduced in version 1.3b48
Returns true(1) if the given Player is an owner of a specific Token.

Usage

isOwner()
isOwner(player)
isOwner(player, tokenRef)
isOwner(player, tokenRef, mapname)

Parameters

  • player - The name of the player to check for ownership, defaults to the Current Player.
  • tokenRef - Either the token id or Token Name of the token which is checked for ownership, defaults to the Current Token.

     Note: This parameter can only be used in a Trusted Macro

  • mapname - The name of the map to find the token. Defaults to the current map.
Token IDs are unique, but Token Names can be duplicated. Using Token Name when more than one token has the same name can produce unexpected results.

Examples

Returns You can edit me. if the Current Player is an owner of the Current Token.
[r, if(isOwner()): "You can edit me."]

Returns Azhrei can edit me. if the given Player is an owner of the given Token.

[h: id = getSelected() ]
[r, if(isOwner("Azhrei", id)): "Azhrei can edit me."]

See Also

Version Changes

  • 1.3b51 - Added id parameter option.
  • 1.5.4 - Added mapname parameter option.