This function was added in SA-MP 0.3e and will not work in earlier versions!


Replace the texture of an object with text.

objectidThe ID of the object to replace the texture of with text.
textThe text to show on the object. (MAX 2048 characters)
materialindexThe object's material index to replace with text.
materialsizeThe size of the material.
fontfaceThe font to use.
fontsizeThe size of the text (MAX 255).
boldBold text. Set to 1 for bold, 0 for not.
fontcolorThe color of the text, in ARGB format.
backcolorThe background color, in ARGB format.
textalignmentThe alignment of the text (default: left).


1: The function was executed successfully.

0: The function failed to execute.


if (strcmp("/text", cmdtext, true) == 0)
new objectId = CreateObject(19353, 0, 0, 10, 0.0, 0.0, 90.0); //create the object
SetObjectMaterialText(objectId, "SA-MP {FFFFFF}0.3{008500}e {FF8200}RC7", 0, OBJECT_MATERIAL_SIZE_256x128,
"Arial", 28, 0, 0xFFFF8200, 0xFF000000, OBJECT_MATERIAL_TEXT_ALIGN_CENTER);
// write "SA-MP 0.3e RC7" on the object, with orange font color and black background
return 1;



Color embedding can be used for multiple colors in the text.


You MUST use ARGB color format, not RGBA like used in client messages etc.

Related Functions

  • SetPlayerObjectMaterialText: Replace the texture of a player object with text.
  • SetObjectMaterial: Replace the texture of an object with the texture from another model in the game.
  • Ultimate Creator by Nexius
  • SetObjectMaterialText Editor by RIDE2DAY
  • Fusez's Map Editor by RedFusion