Multi Theft Auto: Wiki - User contributions [en]

User:Xman40100

2019-12-27T22:23:15Z

Xman40100:

Hello! My name is Andrés, I'm 19 years old, born and raised in Colombia. On the full time job, I'm a frontend and backend dev. About to enter college for a computer engineering degree!

I have always wanted to create a multiplayer server for GTA San Andreas, my favorite game of all time. It was that interested that sparked my interest in programming. I began with little gamemodes for sa-mp, and I used to play with my friends on my server.

Few years later, I decided that what I wanted to do in sa-mp could not be done. I played MTA on occassion, as my internet was pretty slow back then to download all the resources and textures from various servers, but I always was blown away on how MTA could do a lot of things. So... here I am, now developing what I always wanted on MTA. Can't wait to actually share it with the world! :)

User:Xman40100

2019-12-27T22:21:49Z

Xman40100: me_irl

Hello! My name is Andrés, I'm 19 years old, born and raised in Colombia. On the full time job, I'm a frontend and backend dev. About to enter college for a computer engineering degree!

I have always wanted to create a multiplayer server for GTA San Andreas, my favorite game of all time. It was that interested that sparked my interest in programming. I began with little gamemodes for sa-mp, and I used to play with my friend on my server.

Few years later, I decided that what I wanted to do in sa-mp could not be done. I played MTA on occassion, as my internet was pretty slow back then to download all the resources and textures from various servers, but I always was blown away on how MTA could do a lot of things. So... here I am, now developing what I always wanted on MTA. Can't wait to actually share it with the world! :)

SetVehicleColor

2019-12-27T22:07:18Z

Xman40100: Added clarification for https://github.com/multitheftauto/mtasa-blue/issues/1193#issuecomment-569347801

__NOTOC__
{{Server client function}}
This function will set the color of a vehicle using either a RGB format, or the [[Vehicle Colors|standard San Andreas color IDs.]] Vehicles can have up to 4 colors, most of the vehicles have 2 colors only.

If '''p1, p2, p3 and p4''' are used, MTA will take it as the '''palette color format''', more or less arguments than that will use the '''RGB format'''.

{{New feature|3.0110|1.1|
==Syntax==
<syntaxhighlight lang="lua">
bool setVehicleColor ( vehicle theVehicle, int r1/p1, int g1/p2, int b1/p3, [int r2]/int p4, [int g2, int b2, int r3, int g3, int b3, int r4, int g4, int b4] )
</syntaxhighlight>

{{OOP||[[vehicle]]:setColor}}
===Required Arguments===
*'''theVehicle:''' The [[vehicle]] that you wish to set the color of.
* RGB format:
** '''r1, g1, b1:''' Three integers indicating the red, green and blue components of the first (main) color for the vehicle
* Palette format:
** '''p1, p2, p3, p4:''' Four integers indicating the [[Vehicle Colors|vehicle color IDs]] from the palette.
===Optional Arguments (RGB format only)===
*'''r2, g2, b2:''' Three integers indicating the red, green and blue components of the second color for the vehicle
*'''r3, g3, b3:''' Three integers indicating the red, green and blue components of the third color for the vehicle
*'''r4, g4, b4:''' Three integers indicating the red, green and blue components of the fourth color for the vehicle
}}
===Returns===
Returns ''true'' if vehicle's color was set, ''false'' if an invalid vehicle or invalid colors were specified.

==Examples==
<section name="Example 1 - RGB format" class="server" show="true">
This example implements a serverside ''random_color'' console command.
<syntaxhighlight lang="lua">
addCommandHandler( 'random_color',
function( uPlayer )
if isPedInVehicle( uPlayer ) then
local uVehicle = getPedOccupiedVehicle( uPlayer )
if uVehicle then
local r, g, b = math.random( 255 ), math.random( 255 ), math.random( 255 )
setVehicleColor( uVehicle, r, g, b )
end
end
end
)
</syntaxhighlight>
</section>

<section name="Example 2 - palette format" class="server" show="true">
This example implements a serverside command for the player to spawn a red and white Banshee, using the palette colors.
<syntaxhighlight lang="lua">
addCommandHandler("banshee", function(player)
local x, y, z = getElementPosition(player)
local rx, ry, rz = getElementRotation(player)
local vehicle = createVehicle(429, x, y, z, 0.0, 0.0, rz, "PALETTE")
setVehicleColor(vehicle, 3, 1, 0, 0)-- A red and white Banshee!
addVehicleUpgrade(vehicle, 1010)
warpPedIntoVehicle(player, vehicle, 0)
outputChatBox("You have spawned a red and white Banshee! I also added NOS for you!", source, 50, 168, 82)
end)
</syntaxhighlight>
</section>

== Issues ==
{{Issues|
{{Issue|9033|Clientside setVehicleColor doesn't work directly after creation}}
}}

==See Also==
{{Vehicle_functions}}