Multi Theft Auto: Wiki - User contributions [en]

RU/Client side scripts

2010-08-15T16:42:39Z

Arhang3L:

{{translate}}
Клиентские скрипты - это те скрипты, которые исполняются непосредственно клиентской стороной мода. А значит, есть доступ к большому объему информации о игровом мире, но почти нет информации о других игроках в игре.

Это полезно для действий, которые нужно выполнить на клиентской стороне, например визуальные эффекты, создание и манипуляции с GUI.

==Как это работает?==
Скрипты клиентской стороны следуют практически той же схемы, что и серверной стороны. Мы постараемся обеспечить необходимую функциональность для клиентской стороны скриптов. Взаимодействие между серверными и клиентскими скриптами осуществляется с использованием тех же системных событий, которые мы уже имеем. Серверные и клиентские скрипты должны находиться в двух разных файлах, которые включены в ресурсах (в метафайл) с помощью тэга <script> (типа атрибут).

К примеру:
<syntaxhighlight lang="xml">

<meta>
<script src="guitest.lua" type="client" />
<info author="IJs" />
</meta>
</syntaxhighlight>

If you wanted to trigger a client side event from the server, you would first have to register the client side event using [[addEvent]]. Then, you can attach a handler to the event as you would in a server side script. Then in the server side script, you'll be able to call [[triggerClientEvent]] ( player, "eventName", fromElement, args ... ) which will trigger the event client side. The same can be done in reverse using [[triggerServerEvent]].

For example:

'''Client-side:'''
<syntaxhighlight lang="lua">
function showObjectBrowser(id)
-- code here
end

addEvent("doShowObjectBrowser", true)
addEventHandler("doShowObjectBrowser", getRootElement(), showObjectBrowser)
</syntaxhighlight>

'''Server-side:'''
<syntaxhighlight lang="lua">
triggerClientEvent ( somePlayer, "doShowObjectBrowser", getRootElement(), 1034 )
</syntaxhighlight>

[[en:Client side scripts]]
[[it:Script client-side]]

AddAccount

2010-07-22T15:43:38Z

Arhang3L: /* Example */

{{Server function}}
__NOTOC__
This function adds an account to the list of registered accounts of the current server.

==Syntax==

{{New feature|3|1.0 r848|
<syntaxhighlight lang="lua">
account addAccount ( string name, string pass )
</syntaxhighlight>
}}
{{Deprecated_feature|3|1.0|
<syntaxhighlight lang="lua">
bool addAccount ( string name, string pass )
</syntaxhighlight>
}}

===Required Arguments===

*'''name:''' The name of the account you wish to make, this normally is the player's name.
*'''pass:''' The password to set for this account for future logins.

===Returns===

{{New feature|3|1.0 r848|
Returns the ''account'' element if the account was created, ''false'' if the account already exists or an error occured.
}}
{{Deprecated_feature|3|1.0|
Returns ''true'' if the account was created, ''false'' if the account already exists or an error occured.
}}

==Пример==
<section name="Server" class="server" show="true">
'''Example 1:''' Позволяет игрокам регистрироваться на вашем сервере с помощью /register <пароль>.
<syntaxhighlight lang="lua">
function registerPlayer ( source, commandName, password )
-- Check if the password field is blank or not (only blank if they didnt enter one)
if ( password ~= "" and password ~= nil ) then
--Attempt to add the account, and save its value in a var
local accountAdded = addAccount( getPlayerName(source), password )
if ( accountAdded ) then
-- Tell the user all is done
outputChatBox ( "Thank you " .. getPlayerName(source) .. ", you're now registed, you can login with /login", source )
else
-- There was an error making the account, tell the user
outputChatBox ( "Error creating account, contact the server admin", source )
end
else
-- Если в синтаксисе ввода есть ошибка, сообщите об этом пользователю.
outputChatBox ( "Error creating account, correct syntax: /register <password>", source )
end
end
addCommandHandler ( "register", registerPlayer ) -- add the command handler
</syntaxhighlight>

'''This code differs by allowing the user to change their username that they wish to use.'''

'''Example 2:''' This enables players to register on your server by using /register <username> <password> in the chat window.
<syntaxhighlight lang="lua">
function registerPlayer ( source, commandName, username, password )
if(password ~= "" and password ~= nil and username ~= "" and username ~= nil) then
local accountAdded = addAccount(username,password)
if(accountAdded) then
outputChatBox("Thank you " .. getPlayerName(source) .. ", you're now registed, you can login with /login",source)
else
outputChatBox("Error creating account, contact the server admin.",source)
end
else
outputChatBox("Error creating account, correct syntax: /register <nick> <pass>",source)
end
end
addCommandHandler ( "register", registerPlayer ) -- add the command handler
</syntaxhighlight>

'''Example 3:''' This code differs again so the user can only register once /register <username> <password>.
<syntaxhighlight lang="lua">
local bRegisteredOnce = false

function registerPlayer ( source, commandName, username, password )
if(password ~= "" and password ~= nil and username ~= "" and username ~= nil and bRegisteredOnce == false) then
local accountAdded = addAccount(username,password)
if(accountAdded) then
outputChatBox("Thank you " .. getPlayerName(source) .. ", you're now registed, you can login with /login",source)
bRegisteredOnce = true
else
outputChatBox("Error creating account, contact the server admin.",source)
end
else
if bRegisteredOnce == true then
outputChatBox("You already registered on this server!",source)
else
outputChatBox("Error creating account, correct syntax: /register <nick> <pass>",source)
end
end
end
addCommandHandler ( "register", registerPlayer ) -- add the command handler
</syntaxhighlight>
</section>

==See Also==

{{Account_functions}}

AddAccount

2010-07-22T15:39:38Z

Arhang3L: /* Синтаксис */

{{Server function}}
__NOTOC__
This function adds an account to the list of registered accounts of the current server.

==Синтаксис==

{{New feature|3|1.0 r848|
<syntaxhighlight lang="lua">
account addAccount ( string name, string pass )
</syntaxhighlight>
}}
{{Deprecated_feature|3|1.0|
<syntaxhighlight lang="lua">
bool addAccount ( string name, string pass )
</syntaxhighlight>
}}

===Необходимые аргументы===

*'''name:''' Имя аккаунта, который вы хотите создать.
*'''pass:''' Установленный пароль для аккаунта.

===Возвраты===

{{New feature|3|1.0 r848|
Возвращает ''account'' если аккаунт был создан, ''false'' если аккаунт уже существует или произошла ошибка.
}}
{{Deprecated_feature|3|1.0|
Возвращает ''true'' если аккаунт был создан, ''false'' если аккаунт уже существует или произошла ошибка.
}}

==Example==
<section name="Server" class="server" show="true">
'''Example 1:''' This enables players to register on your server by using /register <password> in the chat window.
<syntaxhighlight lang="lua">
function registerPlayer ( source, commandName, password )
-- Check if the password field is blank or not (only blank if they didnt enter one)
if ( password ~= "" and password ~= nil ) then
--Attempt to add the account, and save its value in a var
local accountAdded = addAccount( getPlayerName(source), password )
if ( accountAdded ) then
-- Tell the user all is done
outputChatBox ( "Thank you " .. getPlayerName(source) .. ", you're now registed, you can login with /login", source )
else
-- There was an error making the account, tell the user
outputChatBox ( "Error creating account, contact the server admin", source )
end
else
-- There was an error in the syntax, tell the user the correct syntax.
outputChatBox ( "Error creating account, correct syntax: /register <password>", source )
end
end
addCommandHandler ( "register", registerPlayer ) -- add the command handler
</syntaxhighlight>

'''This code differs by allowing the user to change their username that they wish to use.'''

'''Example 2:''' This enables players to register on your server by using /register <username> <password> in the chat window.
<syntaxhighlight lang="lua">
function registerPlayer ( source, commandName, username, password )
if(password ~= "" and password ~= nil and username ~= "" and username ~= nil) then
local accountAdded = addAccount(username,password)
if(accountAdded) then
outputChatBox("Thank you " .. getPlayerName(source) .. ", you're now registed, you can login with /login",source)
else
outputChatBox("Error creating account, contact the server admin.",source)
end
else
outputChatBox("Error creating account, correct syntax: /register <nick> <pass>",source)
end
end
addCommandHandler ( "register", registerPlayer ) -- add the command handler
</syntaxhighlight>

'''Example 3:''' This code differs again so the user can only register once /register <username> <password>.
<syntaxhighlight lang="lua">
local bRegisteredOnce = false

function registerPlayer ( source, commandName, username, password )
if(password ~= "" and password ~= nil and username ~= "" and username ~= nil and bRegisteredOnce == false) then
local accountAdded = addAccount(username,password)
if(accountAdded) then
outputChatBox("Thank you " .. getPlayerName(source) .. ", you're now registed, you can login with /login",source)
bRegisteredOnce = true
else
outputChatBox("Error creating account, contact the server admin.",source)
end
else
if bRegisteredOnce == true then
outputChatBox("You already registered on this server!",source)
else
outputChatBox("Error creating account, correct syntax: /register <nick> <pass>",source)
end
end
end
addCommandHandler ( "register", registerPlayer ) -- add the command handler
</syntaxhighlight>
</section>

==See Also==

{{Account_functions}}

AddAccount

2010-07-22T15:36:05Z

Arhang3L: /* Syntax */

{{Server function}}
__NOTOC__
This function adds an account to the list of registered accounts of the current server.

==Синтаксис==

{{New feature|3|1.0 r848|
<syntaxhighlight lang="lua">
account addAccount ( string name, string pass )
</syntaxhighlight>
}}
{{Deprecated_feature|3|1.0|
<syntaxhighlight lang="lua">
bool addAccount ( string name, string pass )
</syntaxhighlight>
}}

===Необходимые аргументы===

*'''name:''' Имя аккаунта, который вы хотите создать.
*'''pass:''' Установленный пароль для аккаунта.

===Возвраты===

{{New feature|3|1.0 r848|
Returns the ''account'' element if the account was created, ''false'' if the account already exists or an error occured.
}}
{{Deprecated_feature|3|1.0|
Returns ''true'' if the account was created, ''false'' if the account already exists or an error occured.
}}

==Example==
<section name="Server" class="server" show="true">
'''Example 1:''' This enables players to register on your server by using /register <password> in the chat window.
<syntaxhighlight lang="lua">
function registerPlayer ( source, commandName, password )
-- Check if the password field is blank or not (only blank if they didnt enter one)
if ( password ~= "" and password ~= nil ) then
--Attempt to add the account, and save its value in a var
local accountAdded = addAccount( getPlayerName(source), password )
if ( accountAdded ) then
-- Tell the user all is done
outputChatBox ( "Thank you " .. getPlayerName(source) .. ", you're now registed, you can login with /login", source )
else
-- There was an error making the account, tell the user
outputChatBox ( "Error creating account, contact the server admin", source )
end
else
-- There was an error in the syntax, tell the user the correct syntax.
outputChatBox ( "Error creating account, correct syntax: /register <password>", source )
end
end
addCommandHandler ( "register", registerPlayer ) -- add the command handler
</syntaxhighlight>

'''This code differs by allowing the user to change their username that they wish to use.'''

'''Example 2:''' This enables players to register on your server by using /register <username> <password> in the chat window.
<syntaxhighlight lang="lua">
function registerPlayer ( source, commandName, username, password )
if(password ~= "" and password ~= nil and username ~= "" and username ~= nil) then
local accountAdded = addAccount(username,password)
if(accountAdded) then
outputChatBox("Thank you " .. getPlayerName(source) .. ", you're now registed, you can login with /login",source)
else
outputChatBox("Error creating account, contact the server admin.",source)
end
else
outputChatBox("Error creating account, correct syntax: /register <nick> <pass>",source)
end
end
addCommandHandler ( "register", registerPlayer ) -- add the command handler
</syntaxhighlight>

'''Example 3:''' This code differs again so the user can only register once /register <username> <password>.
<syntaxhighlight lang="lua">
local bRegisteredOnce = false

function registerPlayer ( source, commandName, username, password )
if(password ~= "" and password ~= nil and username ~= "" and username ~= nil and bRegisteredOnce == false) then
local accountAdded = addAccount(username,password)
if(accountAdded) then
outputChatBox("Thank you " .. getPlayerName(source) .. ", you're now registed, you can login with /login",source)
bRegisteredOnce = true
else
outputChatBox("Error creating account, contact the server admin.",source)
end
else
if bRegisteredOnce == true then
outputChatBox("You already registered on this server!",source)
else
outputChatBox("Error creating account, correct syntax: /register <nick> <pass>",source)
end
end
end
addCommandHandler ( "register", registerPlayer ) -- add the command handler
</syntaxhighlight>
</section>

==See Also==

{{Account_functions}}