View source for Set3DTextPosition

<!-- This page is generated automatically from the function definition: set3DTextPosition. -->
= set3DTextPosition =
Moves a replicated world-space text label owned by the current resource.

== Syntax ==
<syntaxhighlight lang="lua">
bool set3DTextPosition(string textId, number x, number y, number z)
</syntaxhighlight>

== Parameters ==
{| class="wikitable"
! Name !! Type !! Required !! Description
|-
| <code>textId</code> || <code>string</code> || yes || The opaque identifier returned by create3DText.
|-
| <code>x</code> || <code>number</code> || yes || New world X coordinate in metres.
|-
| <code>y</code> || <code>number</code> || yes || New world Y coordinate in metres.
|-
| <code>z</code> || <code>number</code> || yes || New world Z coordinate in metres.
|}

== Returns ==
Returns <code>true</code> when the label is owned by the current resource and the update is accepted; otherwise returns <code>false</code>.

== Examples ==
Place a label above a player's current position:
<syntaxhighlight lang="lua" line>
local position = getPlayerPosition(playerId)
if position then
    set3DTextPosition(labelId, position.x, position.y, position.z + 2.0)
end
</syntaxhighlight>

== Notes ==
* Available only in server-side resource scripts.
* Coordinates use metres and are replicated reliably after validation.

[[Category:Server Functions]]
[[Category:World Functions]]
[[Category:Spatial Functions]]