SetVehicleNumberPlate

From SA-MP Wiki

Jump to: navigation, search

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


Description:

Set a vehicle numberplate.


Parameters:
(vehicleid, numberplate[])
vehicleidThe ID of the vehicle to set the number plate of.
numberplateThe text that should be displayed on the number plate.


Return Values:

  • 1: The function executed successfully.
  • 0: The function failed to execute. The vehicle does not exist


Tip

Image:Light_bulb_icon.png

You can use color embedding on the number plate text.


Image:32px-Ambox_warning_orange.png

Notes

  • This function has no internal error checking. Do not assign custom number plates to vehicles without plates (boats, planes, etc) as this will result in some unneeded processing time on the client.
  • The vehicle must be re-spawned or re-streamed for the changes to take effect.
  • There's a limit of 32 characters on each number plate (including embedded colors).
  • The text length that can be seen on the number plate is around 9 to 10 characters, more characters will cause the text to split.
  • Some vehicle models has a backward number plate, e.g. Boxville (498) (as an alternative to this vehicle you can use vehicle model ID 609, which is a duplicated Boxville (aka Boxburg), but with a regular number plate).
  • This function only works in versions 0.2.1, 0.2.2, 0.2x and 0.3c (and beyond).


Example Usage:

new vehicleid = CreateVehicle(542, 2074.73, 1089.89, 10.51, 0.0, -1, -1, -1);
SetVehicleNumberPlate(vehicleid, "ABCD 123");

Related Functions

The following functions may be useful, as they are related to this function in one way or another.

Personal tools