Multi Theft Auto: Wiki - User contributions [en]

HeroInventory

2013-04-07T21:33:46Z

Lcaseidefensis: added reference to HeroBook

==Description==
HeroInventory is a new way to expand a roleplay server's features. This resource allows a server to not only archive items; but organize them appropriately! Adding items, and groups are very simple.

community page link[http://community.mtasa.com/index.php?p=resources&s=details&id=6310]

==Notes==
You're able to add items by editing g_items.lua.
An example use of the resource:HeroBook[https://wiki.multitheftauto.com/wiki/HeroBook#Integrate_Into_HeroInventory](from Malicious Hero)

==Callbacks==
===onPlayerUseItem===
<syntaxhighlight lang="lua">
bool onPlayerUseItem( int itemID, int itemAmount )
</syntaxhighlight>

* source = player using the item

The callback is found in e_item_use.lua in the folder "events". Examples are shown.

===onPlayerPickupItem===
<syntaxhighlight lang="lua">
bool onPlayerPickupItem( element playerElement, int itemID, string itemDroppedBy )
</syntaxhighlight>

The callback is found in e_item_pickup.lua in the folder "events". Examples are shown.
==Player Functions==
===addPlayerItem===
<syntaxhighlight lang="lua">
bool addPlayerItem ( element playerElement, int itemID, int amount )
</syntaxhighlight>
<syntaxhighlight lang="lua">
@title
addPlayerItem
@author
Malicious Hero.
@parameters
playerElement - The element you wish to add an item to.
itemID - The item ID; This can be found in g_items.lua.
amount - The amount of the item you want.
@description
This will add an item to a client.
</syntaxhighlight>
===refreshClientGroups===
<syntaxhighlight lang="lua">
bool refreshClientGroups( )
</syntaxhighlight>
<syntaxhighlight lang="lua">
@title
refreshClientGroups
@author
Malicious Hero.
@parameters

@description
This is not really a function used when exporting; but it's important this command remains
in this resource because without this, groups would not be sync properly.
</syntaxhighlight>

===removeItemFromPlayer===
<syntaxhighlight lang="lua">
bool removeItemFromPlayer( element playerElement, int itemID, [ int amount ] )
</syntaxhighlight>
<syntaxhighlight lang="lua">
@title
removeItemFromPlayer
@author
Malicious Hero.
@parameters
playerElement - The player.
itemID - The item ID
amount - The amount you wish to remove. You can leave this blank to remove everything.
@description
Use this function to remove an item from a player.
</syntaxhighlight>

===transferPlayerItem===
<syntaxhighlight lang="lua">
bool transferPlayerItem( element playerElement, element targetElement, int itemID, int amount )
</syntaxhighlight>
<syntaxhighlight lang="lua">
@title
transferPlayerItem
@author
Malicious Hero.
@parameters
playerElement - The player.
targetElement - The target.
itemID - The item ID
amount - The amount you wish to remove. You can leave this blank to remove everything.
@description
Use this function to move one item to another player.
</syntaxhighlight>

===doesPlayerHaveItem===
<syntaxhighlight lang="lua">
bool doesPlayerHaveItem( element playerElement, int itemID)
</syntaxhighlight>
<syntaxhighlight lang="lua">
@title
doesPlayerHaveItem
@author
Malicious Hero.
@parameters
playerElement - The player.
itemID - The item ID
@description
Use this function to move one item to another player.
@returns
if returning true, it will return the amount as well.
</syntaxhighlight>

===getPlayerItemAmount===
<syntaxhighlight lang="lua">
bool getPlayerItemAmount( element playerElement, int itemID )
</syntaxhighlight>
<syntaxhighlight lang="lua">
@title
getPlayerItemAmount
@author
Malicious Hero.
@parameters
playerElement - The player.
itemID - The item ID
@description
Use this function to get a player's item amount
@returns
The amount item. If false, they don't have the item
</syntaxhighlight>
==Group Functions==
===addInventoryGroup===
<syntaxhighlight lang="lua">
bool addInventoryGroup( string group_name, path imagesrc )
</syntaxhighlight>
<syntaxhighlight lang="lua">
@title
addInventoryGroup
@author
Malicious Hero.
@parameters
group_name - Indicates the group name that you wish to add.
imagesrc - The picture you want to associate with the group.
@description
This will add a inventory group, which will allow the server to create new items.
Please keep in mind that in s_inventory_config.lua, you are able to set the maximum amount
of groups you allow.
</syntaxhighlight>

===removeInventoryGroup===
<syntaxhighlight lang="lua">
bool removeInventoryGroup( string group_name )
</syntaxhighlight>
<syntaxhighlight lang="lua">
@title
removeInventoryGroup
@author
Malicious Hero.
@parameters
group_name - Indicates the group name that you wish to add.
@description
This will remove an inventory group.
</syntaxhighlight>

BindKey

2013-03-23T14:13:41Z

Lcaseidefensis: /* Syntax */

{{Server client function}}
__NOTOC__
Binds a player's key to a handler function or command, which will be called when the key is pressed.

==Syntax==
<section name="Server - Syntax 1" class="server" show="true">
<syntaxhighlight lang="lua">bindKey ( player thePlayer, string key, string keyState, function handlerFunction, [ var arguments, ... ] )</syntaxhighlight>

===Required Arguments===
*'''thePlayer:''' The player you wish to bind the key of.
*'''key:''' The key or control you wish to bind to the command. See [[key names]] for a list of possible keys and [[control names]] for a list of possible controls.
*'''keyState:''' A string that has one of the following values:
**'''"up":''' If the bound key should trigger the function when the key is released
**'''"down":''' If the bound key should trigger the function when the key is pressed
**'''"both":''' If the bound key should trigger the function when the key is pressed or released
*'''handlerFunction:''' The function that will be triggered when the player's key is pressed. This function should have the form:
:<syntaxhighlight lang="lua">function functionName ( player keyPresser, string key, string keyState, [ var arguments, ... ] )</syntaxhighlight>
:The values passed to this function are:
:*'''keyPresser:''' The player who pressed the key
:*'''key:''' The key that was pressed
:*'''keyState:''' The state of the key that was pressed, ''down'' if it was pressed, ''up'' if it was released.
:*'''arguments''' The optional arguments you specified when calling [[bindKey]] (see below).
</section>

{{New feature|3|1.0|
<section name="Server - Syntax 2" class="server" show="true">
This alternative syntax allows you to bind a key with a command. This will also allow users to customize the control in their Settings menu. Use in conjunction with [[addCommandHandler]] to add handler functions to the keybind.

<syntaxhighlight lang="lua">bindKey ( player thePlayer, string key, string keyState, string commandName, [ string arguments ] )</syntaxhighlight>

===Required Arguments===
*'''thePlayer:''' The player you wish to bind the key of.
*'''key:''' The key or control you wish to bind to the command. See [[key names]] for a list of possible keys.
*'''keyState:''' A string that has one of the following values:
**'''"up":''' If the bound key should trigger the function when the key is released
**'''"down":''' If the bound key should trigger the function when the key is pressed
**'''"both":''' If the bound key should trigger the function when the key is pressed or released
*'''commandName:''' The name of the command that the key should be binded to.
===Optional Arguments===
*'''arguments''' Space delimited arguments that are entered as if one was typing the command.
</section>
}}

<section name="Client - Syntax 1" class="client" show="true">
<syntaxhighlight lang="lua">bindKey ( string key, string keyState, function handlerFunction, [ var arguments, ... ] ) </syntaxhighlight>

===Required Arguments===
*'''key:''' The key or control you wish to bind to the command. See [[key names]] for a list of possible keys and [[control names]] for a list of possible controls.
*'''keyState:''' A string that has one of the following values:
**'''"up":''' If the bound key should trigger the function when the key is released
**'''"down":''' If the bound key should trigger the function when the key is pressed
**'''"both":''' If the bound key should trigger the function when the key is pressed or released

*'''handlerFunction:''' The function that will be triggered when the player's key is pressed. This function should have the form:
:<syntaxhighlight lang="lua">function functionName ( string key, string keyState, [ var arguments, ... ] )</syntaxhighlight>
:The values passed to this function are:
:*'''key:''' The key that was pressed
:*'''keyState:''' The state of the key that was pressed, ''down'' if it was pressed, ''up'' if it was released.
:*'''arguments''' The optional arguments you specified when calling [[bindKey]] (see below).
</section>

{{New feature|3|1.0|
<section name="Client - Syntax 2" class="client" show="true">
This alternative syntax allows you to bind a key with a command. This will also allow users to customize the control in their Settings menu. Use in conjunction with [[addCommandHandler]] to add handler functions to the keybind.

<syntaxhighlight lang="lua">bindKey ( string key, string keyState, string commandName, [ string arguments ] )</syntaxhighlight>

===Required Arguments===
*'''key:''' The key or control you wish to bind to the command. See [[key names]] for a list of possible keys.
*'''keyState:''' A string that has one of the following values:
**'''"up":''' If the bound key should trigger the function when the key is released
**'''"down":''' If the bound key should trigger the function when the key is pressed
**'''"both":''' If the bound key should trigger the function when the key is pressed or released
*'''commandName:''' The name of the command that the key should be binded to.
*'''arguments''' Space delimited arguments that are entered as if one was typing the command.
</section>
}}

===Optional Arguments===
{{OptionalArg}}
*'''arguments:''' Any arguments you may want to pass to the function when the key is pressed by the user. Any number of arguments of can be specified, each being passed to the designated function. You may not pass functions.

==Example==
Example 1
<section name="Server" class="server" show="true">
This example will bind a player's 'F1' key and 'fire' control to 1 input function.
<syntaxhighlight lang="lua">
function funcInput ( player, key, keyState )
local state = "let go of"
if ( keyState == "down" ) then
state = "pressed"
end
outputChatBox ( getPlayerName ( player) .. " " .. state .. " the " .. key .. " key!" )
end

function bindTheKeys ( player, commandName )
bindKey ( player, "F1", "down", funcInput ) -- bind the player's F1 down key
bindKey ( player, "F1", "up", funcInput ) -- bind the player's F1 up key
bindKey ( player, "fire", "both", funcInput ) -- bind the player's fire down and up control
end
addCommandHandler ( "bindme", bindTheKeys )
</syntaxhighlight>
</section>

Example 2
<section name="Client" class="client" show="true">
This example will bind a player's 'F1' key and 'fire' control to 1 input function, clientside.
<syntaxhighlight lang="lua">
function funcInput ( key, keyState )
local state = "let go of"
if ( keyState == "down" ) then
state = "pressed"
end
outputChatBox ( "You " .. state .. " the " .. key .. " key!" )
end

function bindTheKeys ()
bindKey ( "F1", "down", funcInput ) -- bind the player's F1 down key
bindKey ( "F1", "up", funcInput ) -- bind the player's F1 up key
bindKey ( "fire", "both", funcInput ) -- bind the player's fire down and up control
end
addCommandHandler ( "bindme", bindTheKeys )
</syntaxhighlight>
</section>

<section name="Server" class="server" show="true">
This example says how cool <s>Robpol86</s> Ransom is if players wants to move.
<syntaxhighlight lang="lua">
function fanFunction()
bindKey (source,"forwards","down",
function(player,key,state)
outputChatBox (getPlayerName (player) .. "#FFFF00 thinks Ransom is cool.",getRootElement(),255,255,0,true)
end
)
end
addEventHandler ("onPlayerLogin",getRootElement(),fanFunction)
</syntaxhighlight>
</section>

==See Also==
{{Input functions}}

Talk:OnElementClicked

2013-02-24T22:52:45Z

Lcaseidefensis: Created page with "I suggest returning element part for vehicles and peds."

I suggest returning element part for vehicles and peds.

HeroInventory

2013-01-23T23:04:25Z

Lcaseidefensis: link to the resource's community page

==Description==
HeroInventory is a new way to expand a roleplay server's features. This resource allows a server to not only archive items; but organize them appropriately! Adding items, and groups are very simple.

community page link[http://community.mtasa.com/index.php?p=resources&s=details&id=6310]

==Notes==
You're able to add items by editing g_items.lua.

==Callbacks==
===onPlayerUseItem===
<syntaxhighlight lang="lua">
bool onPlayerUseItem( int itemID, int itemAmount )
</syntaxhighlight>

* source = player using the item

The callback is found in s_item_use.lua in the folder "server". Examples are shown.
==Player Functions==
===addPlayerItem===
<syntaxhighlight lang="lua">
bool addPlayerItem ( element playerElement, int itemID, int amount )
</syntaxhighlight>
<syntaxhighlight lang="lua">
@title
addPlayerItem
@author
Malicious Hero.
@parameters
playerElement - The element you wish to add an item to.
itemID - The item ID; This can be found in g_items.lua.
amount - The amount of the item you want.
@description
This will add an item to a client.
</syntaxhighlight>
===refreshClientGroups===
<syntaxhighlight lang="lua">
bool refreshClientGroups( )
</syntaxhighlight>
<syntaxhighlight lang="lua">
@title
refreshClientGroups
@author
Malicious Hero.
@parameters

@description
This is not really a function used when exporting; but it's important this command remains
in this resource because without this, groups would not be sync properly.
</syntaxhighlight>

===removeItemFromPlayer===
<syntaxhighlight lang="lua">
bool removeItemFromPlayer( element playerElement, int itemID, [ int amount ] )
</syntaxhighlight>
<syntaxhighlight lang="lua">
@title
removeItemFromPlayer
@author
Malicious Hero.
@parameters
playerElement - The player.
itemID - The item ID
amount - The amount you wish to remove. You can leave this blank to remove everything.
@description
Use this function to remove an item from a player.
</syntaxhighlight>

===transferPlayerItem===
<syntaxhighlight lang="lua">
bool transferPlayerItem( element playerElement, element targetElement, int itemID, int amount )
</syntaxhighlight>
<syntaxhighlight lang="lua">
@title
transferPlayerItem
@author
Malicious Hero.
@parameters
playerElement - The player.
targetElement - The target.
itemID - The item ID
amount - The amount you wish to remove. You can leave this blank to remove everything.
@description
Use this function to move one item to another player.
</syntaxhighlight>

===doesPlayerHaveItem===
<syntaxhighlight lang="lua">
bool doesPlayerHaveItem( element playerElement, int itemID)
</syntaxhighlight>
<syntaxhighlight lang="lua">
@title
doesPlayerHaveItem
@author
Malicious Hero.
@parameters
playerElement - The player.
itemID - The item ID
@description
Use this function to move one item to another player.
@returns
if returning true, it will return the amount as well.
</syntaxhighlight>

===getPlayerItemAmount===
<syntaxhighlight lang="lua">
bool getPlayerItemAmount( element playerElement, int itemID )
</syntaxhighlight>
<syntaxhighlight lang="lua">
@title
getPlayerItemAmount
@author
Malicious Hero.
@parameters
playerElement - The player.
itemID - The item ID
@description
Use this function to get a player's item amount
@returns
The amount item. If false, they don't have the item
</syntaxhighlight>
==Group Functions==
===addInventoryGroup===
<syntaxhighlight lang="lua">
bool addInventoryGroup( string group_name, path imagesrc )
</syntaxhighlight>
<syntaxhighlight lang="lua">
@title
addInventoryGroup
@author
Malicious Hero.
@parameters
group_name - Indicates the group name that you wish to add.
imagesrc - The picture you want to associate with the group.
@description
This will add a inventory group, which will allow the server to create new items.
Please keep in mind that in s_inventory_config.lua, you are able to set the maximum amount
of groups you allow.
</syntaxhighlight>

===removeInventoryGroup===
<syntaxhighlight lang="lua">
bool removeInventoryGroup( string group_name )
</syntaxhighlight>
<syntaxhighlight lang="lua">
@title
removeInventoryGroup
@author
Malicious Hero.
@parameters
group_name - Indicates the group name that you wish to add.
@description
This will remove an inventory group.
</syntaxhighlight>

Requested Functions and Events

2012-05-21T16:48:42Z

Lcaseidefensis: /* Client-Side */

==Server-side==

Element type: GUI, for getElemensByType("GUI")
----------
Event like onServerTick wich is run very often. Like the clientside onClientRender. This could be useful for constat checking wich must be done under 50ms (lower than timers can handle).

----
onVehicleCreated or an equivalent... shouldn't be too hard? -Robhol (14:15 Jul 6, 08)
:If we did it, it'd be onElementCreated - what do you want this for? [[User:EAi|eAi]] 08:58, 7 July 2008 (CDT)
::onElementCreated is a good idea - it could be used for lots of things. Also, how about onVehicleDrown or whatever? that is, when a vehicle hits deep water. Checking for collisions and stuff is very awkward, and client-side only, and has to be checked constantly.. -Robhol (17:31 Jul 9 08)
:::I second that. It would be useful if you use like me element data like the fuel amount or other stuff. And an event like this would help me to setup those element data, when a car spawns. Otherwise I would either have to edit every car spawn script I use or do a post-setup when someone is entering the car.. [[User:MaddDogg14]] (04:34 Apr 4, 10 (CEST))
::::i definetly agree, onElementCreated would be VERY useful for utility/librares scripts, but i think this should be limited by ACL, because "evil" scripts could abuse this othervise -Karlis (9:10 Apr 5, 10)

----

I ask for a function that detects if a ped is on floor, eg. '''isPedOnFloor(ped thePed)''', thanks. --<span style="font-family:Courier New, Courier, monospace">[[User:Shadd|Shadd]]</span><sub>([[User_talk:Shadd|In caso di emergenza rompere le scatole]])</sub> 11:29, 15 June 2008 (CDT)
: [[isPedOnGround]]? [[User:Awwu|Awwu]] 12:58, 15 June 2008 (CDT)
::I need to know if the player has its back touching the ground, not if it's simply "on ground". --<span style="font-family:Courier New, Courier, monospace">[[User:Shadd|Shadd]]</span><sub>([[User_talk:Shadd|In caso di emergenza rompere le scatole]])</sub> 14:16, 16 June 2008 (CDT)
:::Check what task the player has, they should have TASK_COMPLEX_FALL_AND_GET_UP or TASK_COMPLEX_FALL_AND_STAY_DOWN... [[User:EAi|eAi]] 19:12, 16 June 2008 (CDT)
::::Thanks. What task does player have after being hitten by a melee attack that cause it to fall down? Would "TASK_SIMPLE_BE_KICKED_ON_GROUND" and "TASK_SIMPLE_GET_UP" work? --<span style="font-family:Courier New, Courier, monospace">[[User:Shadd|Shadd]]</span><sub>([[User_talk:Shadd|In caso di emergenza rompere le scatole]])</sub> 09:35, 17 June 2008 (CDT)
:::::Try it, I'm not entirely sure. You should be able to produce some code to show the player's current tasks very easily... [[User:EAi|eAi]] 19:20, 17 June 2008 (CDT)
::::::My goal is to edit the standard damage of the attacks, in this case i have to know when player is on ground to cause higher damage. However it doesn't seem to work, when i hit the player it simply gets up without animation with no damage. --<span style="font-family:Courier New, Courier, monospace">[[User:Shadd|Shadd]]</span><sub>([[User_talk:Shadd|In caso di emergenza rompere le scatole]])</sub> 19:10, 19 June 2008 (CDT)

----

It may looks strange and useless (waste of time?) but I think that it could be a awesome feature. Having a web browser.
Like: http://www.youtube.com/watch?v=wT1UR6qEgdg
http://princeofcode.com/awesomium.php
:definetly useles and waste of time, suporting xfire enought. -karlis
::Really Karlis, who asked you bro. It could be very useful, actually. For example, creating dynamic billboards. Instead of changing the TXD, they could set up a browser object over the billboard. That way they can also set up a timer to change the image, etc. [[User:JacobS|JacobS]] 20:08, 1 August 2010 (UTC)

----

There could be something like createBrowser( float x, float y, float z, [float rx, float ry, float rz, float width, float high, string url, bool locked] )
locked parameter: false = navigation bar present, true = no navigation bar
toggleBrowserFullsceenMode(browser theBrowser, bool tog, [bool smooth])
smooth parameter: If set to true the browser will smoothly move from his ingame position to the fullscreen position
toggleBrowserBackground(browser theBrowser, bool tog)
Set the browser background transparent.

----

Security: Disable file downloads, disable popups (disable flash, javascript and any other protocols than http and https [no mailto and stuff...]?)

----

Should be a Client and server function. --[[User:Masterofquebec|Masterofquebec]] 00:10, 15 October 2009 (UTC)

----

Support of tooltips from CEGUI would be cool. I saw a property for that, but it didn't work for me. [[User:MaddDogg14]] (04:36 Apr 4, 10 (CEST))

----

I request a function that gets all clothes from a ped, just like getPedClothes but for all bodyparts. With this function it would be more ease to save clothes to database.
:That's so easy to do yourself that it's barely worth adding. Just loop all the indexes 0-17 and save them to a table. [[User:Awwu|Awwu]] 19:26, 17 April 2010 (UTC)

----

[[setProjectileTarget]] for setting a projectile to target a specific entity. I am trying to create a Battlefield Bad Company type of gamemode and in that game, you can plant a 'tracer'. Any rocket fired (if the tracer is on screen) will seek the tracer. [[User:LeetWoovie|LeetWoovie]] 05:01, 19 April 2010 (UTC)

----

(marcol07, June the 25th, 2010) I would like to have some function to create light source as element or sth like createFire, for example createLight(x,y,z,xrot,yrot,zrot,f,r,g,b) where "f" is an angle of lightning. or it is possible with some model or function? It would be good to create for example fog lamps or classic street lamps

----

moveElement available for markers, objects, pedestrians and players or maybe more if you can do. [[User:Socialz|Socialz]] 13:10, 1 January 2012 (CET)

==Client-Side==
----

Adding possibility to toggle radio hud label by '''showHudComponent''' -karlis

----

Pickup events clientside please, onClientPickupHit onClientPickupUse.

----

Would it be possible to add a color arg to guiGridListSetItemText()? Im trying to get each item colored differently in one list. Thanks, ABEL

----

I need a function which could get current target of hydra or a HS rocket launcher, like when someone press space and targets a element, to get what element is it for calculating distance from it. '''getPlayerOccupiedVehicleTarget''' or '''getPlayerHSTarget'''.
Thanks in advance -Nidza a.k.a. CodeMaster 2:26 PM 19th June 2008.

----

It'd be useful to have something to disable elements of the default hud (weapon display, health display, armor, radar, etcetera) so that you can create your own HUDs. Something like '''setHudElement(element name, toggle)'''.

[[User:Lord Xalphox|Lord Xalphox]] 19:32, 22 March 2009 (CET)
:[[showPlayerHudComponent]]? [[User:Awwu|Awwu]] 19:43, 22 March 2009 (CET)

----

I'd like to have a function that sets the chatbox input line text. Then I could script my own chat history function (that inserts the last sent text into the input line again by pressing arrow up) (which samp has since 0.2 btw) since nobody builds it into the client. [[User:NeonBlack|NeonBlack]] 12:03, 4 July 2009 (CEST) PS.: samp also supports cut, copy and paste :P
----

A function setElementMatrix, doing the exact opposite of getElementMatrix would be much appreciated. --[[User:Kayl|Kayl]] 15:21, 13 November 2009 (UTC)

----

Functions like setTrainPosition(train,track,pos) and track,pos getTrainPosition(train) would be great in order to allow more script side control of trains.
The track argument would be an index of the track number (currently there are around 4 tracks handled, including 1 incompletely defined).
The position would be a float between 0 and 1 (or however you guys handle it) telling where on the track the train currently is.
It would be great if those functions could be available client and server side. --[[User:Kayl|Kayl]] 12:58, 23 November 2009 (UTC)

----

need this function client and server side '''movePlayerHudComponent(string component, float x, float y)''' --[[User:SuatEyrice|SuatEyrice]] 00:18, 26 February 2010 (UTC)

----

'''(marcol07, June the 27th, 2010)''' I would be so happy to have fuction to set Analog control of player sth like '''getAnalogControlState(string controlName)''' but inverted to '''setAnalogControlState(string controlName, float state)'''

----
OnPedDamage (serverside) event. There is OnClientPedDamage, but it's clientside. [[User:damage22|damage22]]

----
'''setRadioVolume(element thePlayer, int volume)''', to create GUI volume control, turn off the radio without changing the station, etc. [[User:JacobS|JacobS]] 14:47, 29 July 2010 (UTC)
----
'''setVehicleHydraulics(element theVehicle, bool state)''', to force hydraulics to be up (true) or down (false)
----
'''createFire(x, y, z, theSize, dimension)''', just like [[createFire]], only with the option to enter a dimension for the fire to appear in
----
'''setGunshotsEnabled(bool enabled)''', '''getGunshotsEnabled()''' and '''createGunshot(x,y,z,radius)''' - to enable/disable the game's gunshot ambience, and to create gunshots at specific locations with radii that it is audible in [[User:JacobS.|JacobS.]] 19:28, 11 September 2010 (MDT)

----
onClick should pass the name of the clicked SUBobject too (eg: vehicle parts, bone names etc.)--[[User:Lcaseidefensis|Lcaseidefensis]] 16:48, 21 May 2012 (UTC)

----
something to open/close doors like in singleplayer (teleports are a bit unrealistic)

Requested Functions and Events

2012-05-11T21:45:10Z

Lcaseidefensis: /* Client-Side */ requesting sa data file replacer functions

==Server-side==

Element type: GUI, for getElemensByType("GUI")
----------
Event like onServerTick wich is run very often. Like the clientside onClientRender. This could be useful for constat checking wich must be done under 50ms (lower than timers can handle).

----
onVehicleCreated or an equivalent... shouldn't be too hard? -Robhol (14:15 Jul 6, 08)
:If we did it, it'd be onElementCreated - what do you want this for? [[User:EAi|eAi]] 08:58, 7 July 2008 (CDT)
::onElementCreated is a good idea - it could be used for lots of things. Also, how about onVehicleDrown or whatever? that is, when a vehicle hits deep water. Checking for collisions and stuff is very awkward, and client-side only, and has to be checked constantly.. -Robhol (17:31 Jul 9 08)
:::I second that. It would be useful if you use like me element data like the fuel amount or other stuff. And an event like this would help me to setup those element data, when a car spawns. Otherwise I would either have to edit every car spawn script I use or do a post-setup when someone is entering the car.. [[User:MaddDogg14]] (04:34 Apr 4, 10 (CEST))
::::i definetly agree, onElementCreated would be VERY useful for utility/librares scripts, but i think this should be limited by ACL, because "evil" scripts could abuse this othervise -Karlis (9:10 Apr 5, 10)

----

I ask for a function that detects if a ped is on floor, eg. '''isPedOnFloor(ped thePed)''', thanks. --<span style="font-family:Courier New, Courier, monospace">[[User:Shadd|Shadd]]</span><sub>([[User_talk:Shadd|In caso di emergenza rompere le scatole]])</sub> 11:29, 15 June 2008 (CDT)
: [[isPedOnGround]]? [[User:Awwu|Awwu]] 12:58, 15 June 2008 (CDT)
::I need to know if the player has its back touching the ground, not if it's simply "on ground". --<span style="font-family:Courier New, Courier, monospace">[[User:Shadd|Shadd]]</span><sub>([[User_talk:Shadd|In caso di emergenza rompere le scatole]])</sub> 14:16, 16 June 2008 (CDT)
:::Check what task the player has, they should have TASK_COMPLEX_FALL_AND_GET_UP or TASK_COMPLEX_FALL_AND_STAY_DOWN... [[User:EAi|eAi]] 19:12, 16 June 2008 (CDT)
::::Thanks. What task does player have after being hitten by a melee attack that cause it to fall down? Would "TASK_SIMPLE_BE_KICKED_ON_GROUND" and "TASK_SIMPLE_GET_UP" work? --<span style="font-family:Courier New, Courier, monospace">[[User:Shadd|Shadd]]</span><sub>([[User_talk:Shadd|In caso di emergenza rompere le scatole]])</sub> 09:35, 17 June 2008 (CDT)
:::::Try it, I'm not entirely sure. You should be able to produce some code to show the player's current tasks very easily... [[User:EAi|eAi]] 19:20, 17 June 2008 (CDT)
::::::My goal is to edit the standard damage of the attacks, in this case i have to know when player is on ground to cause higher damage. However it doesn't seem to work, when i hit the player it simply gets up without animation with no damage. --<span style="font-family:Courier New, Courier, monospace">[[User:Shadd|Shadd]]</span><sub>([[User_talk:Shadd|In caso di emergenza rompere le scatole]])</sub> 19:10, 19 June 2008 (CDT)

----

It may looks strange and useless (waste of time?) but I think that it could be a awesome feature. Having a web browser.
Like: http://www.youtube.com/watch?v=wT1UR6qEgdg
http://princeofcode.com/awesomium.php
:definetly useles and waste of time, suporting xfire enought. -karlis
::Really Karlis, who asked you bro. It could be very useful, actually. For example, creating dynamic billboards. Instead of changing the TXD, they could set up a browser object over the billboard. That way they can also set up a timer to change the image, etc. [[User:JacobS|JacobS]] 20:08, 1 August 2010 (UTC)

----

There could be something like createBrowser( float x, float y, float z, [float rx, float ry, float rz, float width, float high, string url, bool locked] )
locked parameter: false = navigation bar present, true = no navigation bar
toggleBrowserFullsceenMode(browser theBrowser, bool tog, [bool smooth])
smooth parameter: If set to true the browser will smoothly move from his ingame position to the fullscreen position
toggleBrowserBackground(browser theBrowser, bool tog)
Set the browser background transparent.

----

Security: Disable file downloads, disable popups (disable flash, javascript and any other protocols than http and https [no mailto and stuff...]?)

----

Should be a Client and server function. --[[User:Masterofquebec|Masterofquebec]] 00:10, 15 October 2009 (UTC)

----

Support of tooltips from CEGUI would be cool. I saw a property for that, but it didn't work for me. [[User:MaddDogg14]] (04:36 Apr 4, 10 (CEST))

----

I request a function that gets all clothes from a ped, just like getPedClothes but for all bodyparts. With this function it would be more ease to save clothes to database.
:That's so easy to do yourself that it's barely worth adding. Just loop all the indexes 0-17 and save them to a table. [[User:Awwu|Awwu]] 19:26, 17 April 2010 (UTC)

----

[[setProjectileTarget]] for setting a projectile to target a specific entity. I am trying to create a Battlefield Bad Company type of gamemode and in that game, you can plant a 'tracer'. Any rocket fired (if the tracer is on screen) will seek the tracer. [[User:LeetWoovie|LeetWoovie]] 05:01, 19 April 2010 (UTC)

----

(marcol07, June the 25th, 2010) I would like to have some function to create light source as element or sth like createFire, for example createLight(x,y,z,xrot,yrot,zrot,f,r,g,b) where "f" is an angle of lightning. or it is possible with some model or function? It would be good to create for example fog lamps or classic street lamps

----

moveElement available for markers, objects, pedestrians and players or maybe more if you can do. [[User:Socialz|Socialz]] 13:10, 1 January 2012 (CET)

==Client-Side==
----

Adding possibility to toggle radio hud label by '''showHudComponent''' -karlis

----

Pickup events clientside please, onClientPickupHit onClientPickupUse.

----

Would it be possible to add a color arg to guiGridListSetItemText()? Im trying to get each item colored differently in one list. Thanks, ABEL

----

I need a function which could get current target of hydra or a HS rocket launcher, like when someone press space and targets a element, to get what element is it for calculating distance from it. '''getPlayerOccupiedVehicleTarget''' or '''getPlayerHSTarget'''.
Thanks in advance -Nidza a.k.a. CodeMaster 2:26 PM 19th June 2008.

----

It'd be useful to have something to disable elements of the default hud (weapon display, health display, armor, radar, etcetera) so that you can create your own HUDs. Something like '''setHudElement(element name, toggle)'''.

[[User:Lord Xalphox|Lord Xalphox]] 19:32, 22 March 2009 (CET)
:[[showPlayerHudComponent]]? [[User:Awwu|Awwu]] 19:43, 22 March 2009 (CET)

----

I'd like to have a function that sets the chatbox input line text. Then I could script my own chat history function (that inserts the last sent text into the input line again by pressing arrow up) (which samp has since 0.2 btw) since nobody builds it into the client. [[User:NeonBlack|NeonBlack]] 12:03, 4 July 2009 (CEST) PS.: samp also supports cut, copy and paste :P
----

A function setElementMatrix, doing the exact opposite of getElementMatrix would be much appreciated. --[[User:Kayl|Kayl]] 15:21, 13 November 2009 (UTC)

----

Functions like setTrainPosition(train,track,pos) and track,pos getTrainPosition(train) would be great in order to allow more script side control of trains.
The track argument would be an index of the track number (currently there are around 4 tracks handled, including 1 incompletely defined).
The position would be a float between 0 and 1 (or however you guys handle it) telling where on the track the train currently is.
It would be great if those functions could be available client and server side. --[[User:Kayl|Kayl]] 12:58, 23 November 2009 (UTC)

----

need this function client and server side '''movePlayerHudComponent(string component, float x, float y)''' --[[User:SuatEyrice|SuatEyrice]] 00:18, 26 February 2010 (UTC)

----

'''(marcol07, June the 27th, 2010)''' I would be so happy to have fuction to set Analog control of player sth like '''getAnalogControlState(string controlName)''' but inverted to '''setAnalogControlState(string controlName, float state)'''

----
OnPedDamage (serverside) event. There is OnClientPedDamage, but it's clientside. [[User:damage22|damage22]]

----
'''setRadioVolume(element thePlayer, int volume)''', to create GUI volume control, turn off the radio without changing the station, etc. [[User:JacobS|JacobS]] 14:47, 29 July 2010 (UTC)
----
'''setVehicleHydraulics(element theVehicle, bool state)''', to force hydraulics to be up (true) or down (false)
----
'''createFire(x, y, z, theSize, dimension)''', just like [[createFire]], only with the option to enter a dimension for the fire to appear in
----
'''setGunshotsEnabled(bool enabled)''', '''getGunshotsEnabled()''' and '''createGunshot(x,y,z,radius)''' - to enable/disable the game's gunshot ambience, and to create gunshots at specific locations with radii that it is audible in [[User:JacobS.|JacobS.]] 19:28, 11 September 2010 (MDT)

----
it would be great to replace not just the handling and model files but col data files also (not the collision models), or should I just make new .col files? :S--[[User:Lcaseidefensis|Lcaseidefensis]] 21:45, 11 May 2012 (UTC)