isOwner: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
mNo edit summary
No edit summary
 
(8 intermediate revisions by 4 users not shown)
Line 3: Line 3:
|version=1.3b48
|version=1.3b48
|description=
|description=
Returns {{true}} if the [[Player]] is an owner of a specific [[Token]].
Returns {{true}} if the given Player is an owner of a specific [[Token]].


|usage=
|usage=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
isOwner()
isOwner()
</source>
isOwner(player)
<source lang="mtmacro" line>
isOwner(player, tokenRef)
isOwner(id)
isOwner(player, tokenRef, mapname)
</source>
</syntaxhighlight>
'''Parameter'''
'''Parameters'''
{{param|id|The token {{code|id}} of the token which is checked for ownership, defaults to the [[Current Token]]. {{TrustedParameter}} }}
{{param|player|The name of the player to check for ownership, defaults to the [[getPlayerName|Current Player]]. }}
{{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.}}
{{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=
Returns {{code|You can edit me.}} if the [[Current Token]] is owned by the [[Player]].
Returns {{code|You can edit me.}} if the [[getPlayerName|Current Player]] is an owner of the [[Current Token]].
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[r, if(isOwner()): "You can edit me."]
[r, if(isOwner()): "You can edit me."]
</source>
</syntaxhighlight>
 
Returns {{code|Azhrei can edit me.}} if the given Player is an owner of the given [[Token]].
<syntaxhighlight lang="mtmacro" line>
[h: id = getSelected() ]
[r, if(isOwner("Azhrei", id)): "Azhrei can edit me."]
</syntaxhighlight>


|also=
|also=
Line 27: Line 36:
|changes=
|changes=
{{change|1.3b51|Added {{code|id}} parameter option.}}
{{change|1.3b51|Added {{code|id}} parameter option.}}
{{change|1.5.4|Added {{code|mapname}} parameter option.}}


}}
}}
[[Category:Token Function]]
[[Category:Token Function]]

Latest 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.