note Help Needed

This wiki is the result of an ongoing community effort — thank you all for helping!

If you want to provide changes to this page then please click here.

Create3DTextLabel

Description

Creates a 3D Text Label at a specific location in the world

Name	Description
const text[]	The initial text string.
colour	The text Color, as an integer or hex in RGBA color format
Float:x	X-Coordinate
Float:y	Y-Coordinate
Float:z	Z-Coordinate
Float:drawDistance	The distance from where you are able to see the 3D Text Label
virtualWorld	The virtual world in which you are able to see the 3D Text
bool:testLOS	Test the line-of-sight so this text can't be seen through objects (true/false)
OPEN_MP_TAGS:...	Indefinite number of arguments of any tag.

Returns

The ID of the newly created 3D Text Label, or INVALID_3DTEXT_ID if the 3D Text Label limit (MAX_3DTEXT_GLOBAL) was reached.

Examples

public OnGameModeInit()
{
    Create3DTextLabel("I'm at the coordinates:\n30.0, 40.0, 50.0", 0x008080FF, 30.0, 40.0, 50.0, 40.0, 0, false);
    return 1;
}

public OnPlayerCommandText(playerid, cmdtext[])
{
    if (!strcmp(cmdtext, "/mark", true))
    {
        new name[MAX_PLAYER_NAME];
        new Float:x, Float:y, Float:z;
        new worldid;

        GetPlayerName(playerid, name, sizeof(name));
        GetPlayerPos(playerid, x, y, z);
        worldid = GetPlayerVirtualWorld(playerid);

        Create3DTextLabel("%s marked this place", 0xFF0000FF, x, y, z, 15.0, worldid, false, name);
        return 1;
    }
    return 0;
}

Notes

tip

drawDistance seems to be a lot smaller when spectating.

tip

Use colour embedding for multiple colours in the text.

warning

If text[] is empty, the server/clients next to the text might crash! (Fixed in open.mp)
If the virtualworld is set as -1 the text will not appear.

Related Functions

Delete3DTextLabel: Delete a 3D text label.
IsValid3DTextLabel: Checks if a 3D text label is valid.
Is3DTextLabelStreamedIn: Checks if a 3D text label is streamed in for a player.
Attach3DTextLabelToPlayer: Attach a 3D text label to a player.
Attach3DTextLabelToVehicle: Attach a 3D text label to a vehicle.
Update3DTextLabelText: Change the text of a 3D text label.
Get3DTextLabelText: Gets the 3D text label text.
Get3DTextLabelColour: Gets the 3D text label colour.
Get3DTextLabelPos: Gets the 3D text label position.
Get3DTextLabelDrawDistance: Gets the 3D text label draw distance.
Set3DTextLabelDrawDistance: Sets the 3D text label draw distance.
Get3DTextLabelVirtualWorld: Gets the 3D text label virtual world id.
Set3DTextLabelVirtualWorld: Sets the 3D text label virtual world id.
Get3DTextLabelLOS: Gets the 3D text label line-of-sight.
Set3DTextLabelLOS: Sets the 3D text label line-of-sight.
CreatePlayer3DTextLabel: Create A 3D text label for one player.
DeletePlayer3DTextLabel: Delete a player's 3D text label.
UpdatePlayer3DTextLabelText: Change the text of a player's 3D text label.