Community Resources: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (Prettified)
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==Community calls documentation==
This page lists PHP calls that MTA Community allows you to use in your scripts, via [[callRemote]].
only use:
 
==community.mtasa.com/mta/resources.php==
 
Retrieves the latest version number for a resource available on MTA Community.
 
'''Arguments''':
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
callRemote()
string "version", string resourceName
</syntaxhighlight>
'''Returns:'''
*a string with the resource name
*a string of the resource version in format of "x.x.x", or integer 0 if an error has occurred
*a number which is the community id for the resource, or nil if an error has occurred
 
===Example===
<syntaxhighlight lang="lua">
addEventHandler( "onResourceStart", getResourceRootElement(),
  function()
      callRemote( "http://community.mtasa.com/mta/resources.php", handleVersionCheck, "version", getResourceName(getThisResource()) )
  end
)
 
function handleVersionCheck( resName, commVer, commId )
    local thisVer = getResourceInfo(getThisResource(), "version")
    if commId and thisVer ~= commVer then
        outputChatBox( getResourceName(getThisResource()) .. " is outdated. Your version: " .. thisVer .. " | Current: " .. commVer )
        outputChatBox( "Please download the update @ http://community.multitheftauto.com/index.php?p=resources&s=details&id=" .. commId )
    end
end
</syntaxhighlight>
</syntaxhighlight>


<!--
==community.mtasa.com/mta/verify.php==
==community.mtasa.com/mta/verify.php==


Line 15: Line 42:
'''Returns:''' an integer, 1 if user is valid, 0 otherwise
'''Returns:''' an integer, 1 if user is valid, 0 otherwise


==Example==
===Example===
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
addEventHandler ( "onPlayerJoin", getRootElement(), function()
addEventHandler ( "onPlayerJoin", getRootElement(), function()
Line 29: Line 56:
end
end
</syntaxhighlight>
</syntaxhighlight>
 
-->
==community.mtasa.com/mta/groups.php==
==community.mtasa.com/mta/groups.php==


'''Calls:'''
Retrieves group information from MTA Community.


Info:
'''Arguments''':
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
string "info", int groupID
string "info", int groupID
</syntaxhighlight>  
</syntaxhighlight>  
'''Returns 5 values:'''<br />
'''Returns 5 values:'''
1. Group name<br />
* Group name
2. Owner username<br />
* Owner username
3. Number of members<br />
* Number of members
4. Public. Integer: 1 if the group is public, 0 otherwise<br />
* Public. Integer: 1 if the group is public, 0 otherwise
5. Registration time<br />
* Registration time




Line 52: Line 79:
'''Returns:''' a table of usernames in the group
'''Returns:''' a table of usernames in the group


==Examples==
===Examples===
<section name="Group Example" class="server" show="true">
<section name="Group Example" class="server" show="false">
This outputs the servers group name, if the group is public or private, and the registration time.
This outputs the servers group name, if the group is public or private, and the registration time.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
Line 67: Line 94:
</syntaxhighlight>
</syntaxhighlight>
</section>
</section>
<section name="Members Example" class="server" show="true">
<section name="Members Example" class="server" show="false">
This outputs the members in the servers group, which is found on the MTA Community Site.
This outputs the members in the servers group, which is found on the MTA Community Site.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
addCommandHandler("members",function(player)
addCommandHandler("members",function(player)
   callRemote("http://community.mtasa.com/mta/groups.php",function(members,player)--Call after the command goes through
   callRemote("http://community.mtasa.com/mta/groups.php",members,"members",1)--Call after the command goes through
end)
 
function members(player,members)
   if(members)then
   if(members)then
       outputChatBox("Members in this servers group: "..members..".",player,255,255,255) --Outputs the members to the player who typed in the command
       outputChatBox("Members in this servers group: "..members..".",player,255,255,255) --Outputs the members to the player who typed in the command
   end
   end
end,"members",1)
end
end)
</syntaxhighlight>
</syntaxhighlight>
</section>
</section>
==community.mtasa.com/mta/resources.php==
'''Calls:'''
Latest resource version:
<syntaxhighlight lang="lua">
string "version", string resourceName
</syntaxhighlight>
'''Returns:''' a string, resource version in format of "x.x.x". Integer 0 if an error has occured




[[Category:Scripting Concepts]]
[[Category:Scripting Concepts]]

Latest revision as of 09:25, 23 June 2016

This page lists PHP calls that MTA Community allows you to use in your scripts, via callRemote.

community.mtasa.com/mta/resources.php

Retrieves the latest version number for a resource available on MTA Community.

Arguments:

string "version", string resourceName

Returns:

  • a string with the resource name
  • a string of the resource version in format of "x.x.x", or integer 0 if an error has occurred
  • a number which is the community id for the resource, or nil if an error has occurred

Example

addEventHandler( "onResourceStart", getResourceRootElement(), 
   function()
      callRemote( "http://community.mtasa.com/mta/resources.php", handleVersionCheck, "version", getResourceName(getThisResource()) )
   end
)

function handleVersionCheck( resName, commVer, commId )
    local thisVer = getResourceInfo(getThisResource(), "version")
    if commId and thisVer ~= commVer then
        outputChatBox( getResourceName(getThisResource()) .. " is outdated. Your version: " .. thisVer .. " | Current: " .. commVer )
        outputChatBox( "Please download the update @ http://community.multitheftauto.com/index.php?p=resources&s=details&id=" .. commId )
    end
end

community.mtasa.com/mta/groups.php

Retrieves group information from MTA Community.

Arguments:

string "info", int groupID

Returns 5 values:

  • Group name
  • Owner username
  • Number of members
  • Public. Integer: 1 if the group is public, 0 otherwise
  • Registration time


Members list:

string "members", int groupID

Returns: a table of usernames in the group

Examples

Click to expand [+]
Group Example
Click to expand [+]
Members Example