Multi Theft Auto: Wiki - User contributions [en]

User:BloodStason

2010-06-19T22:48:19Z

BloodStason: Created page with ''''Name:''' Stason '''Nick:''' BloodStason '''GameTime:''' 3 Years '''Age:''' 15 '''ICQ:''' 452029147'

'''Name:''' Stason

'''Nick:''' BloodStason

'''GameTime:''' 3 Years

'''Age:''' 15

'''ICQ:''' 452029147

RU/Meta.xml

2010-06-19T22:36:13Z

BloodStason:

{{translate}}
Этот файл имеет очень важное содержание, которое позволяет загрузить ресурс/режим/карту. Вам нужно указать имена файлов, которые ваш скрипт/режим e (resource) будет использовать в файле '''meta.xml'''. Если вы хотите отображать изображение на экране клиента, клиент должен сначала загрузить его. Чтобы сервер знал, что вы хотите использовать изображение, нужно прописать имя файла в meta.xml. Если вам нужно использовать какие-то настройки для скрипта в качестве переменных, вы можете прописать их в тэге <settings>.

Примечание: Вы можете опробывать простой генератор meta.xml, созданный 50p: http://forum.mtasa.com/viewtopic.php?f=91&t=22247

== Возможные тэги ==
Тэги в .xml такие же, как в . html. Файл meta.xml имеет множество тэгов, необходимых и опциональных. У них есть свои атрибуты.
Язык XML не умеет формировать тэги, он служит как простой способ хранения данных. Интерпретацией тэгов занимаются скрипты, то есть '''вы можете определять новые тэги в XML'''. Однако, MTA определяет несколько тэгов самостоятельно, они приведены ниже:

*'''<info />''' Информация о данном ресурсе, possible parameters include (any arbitrary parameters can be used and read using [[getResourceInfo]]):
** '''author:''' Автор
** '''version:''' Версия
** '''name:''' Название
** '''description:''' Описание
** '''type:''' Тип ресурса, может быть "gamemode", "script", "map" or "misc".
*'''<script />''' Исходный код для этого ресурса, возможные параметры:
** '''src:''' Имя файла исходного кода
** '''type:''' Тип исходного кода: "Client" или "Server"
*'''<map />''' Карта для режима игры, возможность параметрами являются:
**'''src:''' .map имя файла (Может лежать в других папках. Например: "maps/filename.map")
**'''dimension:''' Объём, в котором карта будет загружена (по желанию)
*'''<file />''' Файл на стороне клиента. Как правило, эти образы. txd, .col, .dff или .xml файлы. Они будут скачаны с клиента, когда ресурс запустится (Или при присоединении)
**'''src:''' Файл на стороне клиента (Может лежать в других папках. Например: "image/image.png")
*'''<include />''' Включать ресурс, когда он ресурс будет использоваться
**'''resource:''' Имя ресурса, которое вы хотите использовать для этого ресурса
**'''minversion:''' Минимальная версия ресурса (не обязательно)
**'''maxversion:''' Максимальная версия ресурса(не обязательно)
*'''<config />''' Файл конфигураций (.XML) возможные параметры:
**'''src:''' Имя конфигурационного файла
**'''type:''' Тип файла конфигурации: "Clien" или "Server"
*'''<export />''' Это функция экспорта из этого ресурса, так что другие ресурсы могут использовать их - [[call]]
**'''function:''' Имя функции
**'''type''' Экспортирует клиентские или серверные функции (Возможные значения: "Server" и "Client")
**'''http:''' Может ли быть функция вызвана через HTTP (true/false)
*'''<html />'''
**'''src:''' Имя HTTP файла (Может быть путь. Например: files/file.png)
**'''default:''' HTML-файл, который отображается по умолчанию при посещении /resourceName/ на сервере. Только один HTML-файл может быть по умолчанию, остальные игнорируются. (true/false)
**'''raw:''' HTML-файл не обрабатывается интерпретатором LUA, может рассматриваться как двоичные данные. Должен использоваться для двоичных файлов (В основном изображения) (true/false)
*'''<settings> <setting name="" value=""/> </settings>:''' Большинство режимах игры использовать [[settings system]] (Настройки системы), чтобы администраторы сервера могли настроить его так, как они хотят. Например, вы можете установить время, а затем использовать [[get]] (Получить) и [[set]] (Установить), чтобы получить значение или изменить его, соответственно.

== Пример ==
Вот пример мета файла Используется некоторые упомянутые теги:
<syntaxhighlight lang="lua" lang="xml"><meta>
<info author="Slothman" type="gamemode" name="Stealth" />
<config src="help.xml" type="client"/>

<script src="stealthmain_server.lua" />
<script src="noiseblip.lua" />
<script src="mission_timer.lua" />
<script src="gadgets_server.lua" />
<script src="gadgets_client.lua" type="client"/>
<script src="stealthmain_client.lua" type="client"/>
<script src="noisebar.lua" type="client"/>
<script src="spycam.lua" type="client"/>

<file src="riot_shield.txd" />
<file src="riot_shield.dff" />
<file src="riot_shield.col" />
<file src="armor.png" />
<file src="camera.png" />
<file src="cloak.png" />
<file src="goggles.png" />
<file src="mine.png" />
<file src="radar.png" />
<file src="shield.png" />

<include resource="scoreboard" />
<include resource="killmessages" />
<include resource="maplimits" />

<settings>
<setting name="roundlimit" value="[6]" /> 
<setting name="teamdamage" value="[1]" /> 
<setting name="teambalance" value="[1]" /> 
<setting name="spazammo" value="[25]" /> 
<setting name="m4ammo" value="[100]" />
<setting name="shotgunammo" value="[25]" />
<setting name="sniperammo" value="[20]" />
<setting name="ak47ammo" value="[120]" />
<setting name="rifleammo" value="[40]" />
<setting name="deserteagleammo" value="[45]" />
<setting name="pistolammo" value="[132]" />
<setting name="uziammo" value="[150]" />
<setting name="tec9ammo" value="[150]" />
<setting name="silencedammo" value="[65]" />
<setting name="grenadeammo" value="[4]" />
<setting name="satchelammo" value="[4]" />
<setting name="teargasammo" value="[4]" />
<setting name="molatovammo" value="[4]" />
</settings>
</meta></syntaxhighlight>
[[Category:Scripting Concepts]]
[[Category:Incomplete]]
[[en:Meta.xml]]

RU/Meta.xml

2010-06-19T22:32:20Z

BloodStason:

{{translate}}
Этот файл имеет очень важное содержание, которое позволяет загрузить ресурс/режим/карту. Вам нужно указать имена файлов, которые ваш скрипт/режим e (resource) будет использовать в файле '''meta.xml'''. Если вы хотите отображать изображение на экране клиента, клиент должен сначала загрузить его. Чтобы сервер знал, что вы хотите использовать изображение, нужно прописать имя файла в meta.xml. Если вам нужно использовать какие-то настройки для скрипта в качестве переменных, вы можете прописать их в тэге <settings>.

Примечание: Вы можете опробывать простой генератор meta.xml, созданный 50p: http://forum.mtasa.com/viewtopic.php?f=91&t=22247

== Возможные тэги ==
Тэги в .xml такие же, как в . html. Файл meta.xml имеет множество тэгов, необходимых и опциональных. У них есть свои атрибуты.
Язык XML не умеет формировать тэги, он служит как простой способ хранения данных. Интерпретацией тэгов занимаются скрипты, то есть '''вы можете определять новые тэги в XML'''. Однако, MTA определяет несколько тэгов самостоятельно, они приведены ниже:

*'''<info />''' Информация о данном ресурсе, possible parameters include (any arbitrary parameters can be used and read using [[getResourceInfo]]):
** '''author:''' Автор
** '''version:''' Версия
** '''name:''' Название
** '''description:''' Описание
** '''type:''' Тип ресурса, может быть "gamemode", "script", "map" or "misc".
*'''<script />''' Исходный код для этого ресурса, возможные параметры:
** '''src:''' Имя файла исходного кода
** '''type:''' Тип исходного кода: "Client" или "Server"
*'''<map />''' Карта для режима игры, возможность параметрами являются:
**'''src:''' .map имя файла (Может лежать в других папках. Например: "maps/filename.map")
**'''dimension:''' Объём, в котором карта будет загружена (по желанию)
*'''<file />''' Файл на стороне клиента. Как правило, эти образы. txd, .col, .dff или .xml файлы. Они будут скачаны с клиента, когда ресурс запустится (Или при присоединении)
**'''src:''' Файл на стороне клиента (Может лежать в других папках. Например: "image/image.png")
*'''<include />''' Включать ресурс, когда он ресурс будет использоваться
**'''resource:''' Имя ресурса, которое вы хотите использовать для этого ресурса
**'''minversion:''' Минимальная версия ресурса (не обязательно)
**'''maxversion:''' Максимальная версия ресурса(не обязательно)
*'''<config />''' Файл конфигураций (.XML) возможные параметры:
**'''src:''' Имя конфигурационного файла
**'''type:''' Тип файла конфигурации: "Clien" или "Server"
*'''<export />''' Это функция экспорта из этого ресурса, так что другие ресурсы могут использовать их - [[call]]
**'''function:''' Имя функции
**'''type''' Экспортирует клиентские или серверные функции (Возможные значения: "Server" и "Client")
**'''http:''' Может ли быть функция вызвана через HTTP (true/false)
*'''<html />'''
**'''src:''' Имя HTTP файла (Может быть путь. Например: files/file.png)
**'''default:''' HTML-файл, который отображается по умолчанию при посещении /resourceName/ на сервере. Только один HTML-файл может быть по умолчанию, остальные игнорируются. (true/false)
**'''raw:''' HTML-файл не обрабатывается интерпретатором LUA, может рассматриваться как двоичные данные. Должен использоваться для двоичных файлов (В основном изображения) (true/false)
*'''<settings> <setting name="" value=""/> </settings>:''' Большинство режимах игры использовать [[settings system]] (Настройки системы), чтобы администраторы сервера могли настроить его так, как они хотят. Например, вы можете установить время, а затем использовать [[get]] (Получить) и [[set]] (Установить), чтобы получить значение или изменить его, соответственно.

== Пример ==
Вот пример мета файла Используется некоторые упомянутые теги:
<syntaxhighlight lang="lua" lang="xml"><meta>
<info author="Slothman" type="gamemode" name="Stealth" />
<config src="help.xml" type="client"/>

<script src="stealthmain_server.lua" />
<script src="noiseblip.lua" />
<script src="mission_timer.lua" />
<script src="gadgets_server.lua" />
<script src="gadgets_client.lua" type="client"/>
<script src="stealthmain_client.lua" type="client"/>
<script src="noisebar.lua" type="client"/>
<script src="spycam.lua" type="client"/>

<file src="riot_shield.txd" />
<file src="riot_shield.dff" />
<file src="riot_shield.col" />
<file src="armor.png" />
<file src="camera.png" />
<file src="cloak.png" />
<file src="goggles.png" />
<file src="mine.png" />
<file src="radar.png" />
<file src="shield.png" />

<include resource="scoreboard" />
<include resource="killmessages" />
<include resource="maplimits" />

<settings>
<setting name="roundlimit" value="[6]" /> 
<setting name="teamdamage" value="[1]" /> 
<setting name="teambalance" value="[1]" /> 
<setting name="spazammo" value="[25]" /> 
<setting name="m4ammo" value="[100]" />
<setting name="shotgunammo" value="[25]" />
<setting name="sniperammo" value="[20]" />
<setting name="ak47ammo" value="[120]" />
<setting name="rifleammo" value="[40]" />
<setting name="deserteagleammo" value="[45]" />
<setting name="pistolammo" value="[132]" />
<setting name="uziammo" value="[150]" />
<setting name="tec9ammo" value="[150]" />
<setting name="silencedammo" value="[65]" />
<setting name="grenadeammo" value="[4]" />
<setting name="satchelammo" value="[4]" />
<setting name="teargasammo" value="[4]" />
<setting name="molatovammo" value="[4]" />
</settings>
</meta></syntaxhighlight>
[[Category:Scripting Concepts]]
[[Category:Incomplete]]
[[en:Meta.xml]]

Введение в скриптинг GUI

2010-06-05T13:50:37Z

BloodStason:

Одна из важных особенностей MTA:SA - возможность создания собственного GUI (графический пользовательский интерфейс). Графический интерфейс состоит из окон, кнопок, текстовых полей... Проще говоря, из всех стандартных компонент графических интерфейсов. Они могут использоваться пока пользователь в игре, и использоваться для ввода/вывода вместо команд.

[[Image:AdminGUI.png|thumb|Admin Console GUI]]

==Руководство по созданию интерфейса авторизации==
В этом руководстве мы сделаем простое окно авторизаци с двумя полями ввода и кнопкой. Окно появляется, когда игрок подключается к игре, и после того, как нажата кнопка, игрок респаунится. Это руководство - продолжение предыдущего ([[RU/Scripting Introduction|Введение в скриптинг]]). Теперь мы познакомимся с написанием клиентских скриптов.

===Отрисовка окна===
GUI работает на стороне клиента. Хорошим решением будет поместить все клиентские скрипты в отдельный каталог. Перейдите в каталог /Ваш сервер MTA/mods/deathmatch/resources/myserver/ и создайте подкаталог "client". В нём создайте текстовый файл и назовите его "gui.lua". В этом файле мы напишем функцию, отображающую окно:
<syntaxhighlight lang="lua">
function CreateLoginWindow()
local X = 0.375
local Y = 0.375
local Width = 0.25
local Height = 0.25
wdwLogin = guiCreateWindow(X, Y, Width, Height, "Please Log In", true)
end
</syntaxhighlight>
Вы можете кликнуть по имени функции, чтобы прочитать её описание. Заметьте, что координаты окна задаются в ''процентах'' от размеров экрана. Это значит, что левая граница экрана по ширине принимается за 0, а правая за 1, соответственно, "X" равное 0.5 обозначает середину экрана. Аналогично и для позиции по высоте, ширины и высоты окна (если "width" равно 0.5, окно будет в половину ширины экрана). Теперь мы добавим текстовые метки (с надписями "username:" и "password:"), поля ввода и кнопку. Замените функцию её полной версией:
<syntaxhighlight lang="lua">
function CreateLoginWindow()
local X = 0.375
local Y = 0.375
local Width = 0.25
local Height = 0.25
wdwLogin = guiCreateWindow(X, Y, Width, Height, "Please Log In", true)

X = 0.0825
Y = 0.2
Width = 0.25
Height = 0.25
guiCreateLabel(X, Y, Width, Height, "Username", true, wdwLogin)
Y = 0.5
guiCreateLabel(X, Y, Width, Height, "Password", true, wdwLogin)

X = 0.415
Y = 0.2
Width = 0.5
Height = 0.15
edtUser = guiCreateEdit(X, Y, Width, Height, "", true, wdwLogin)
Y = 0.5
edtPass = guiCreateEdit(X, Y, Width, Height, "", true, wdwLogin)
guiEditSetMaxLength(edtUser, 50)
guiEditSetMaxLength(edtPass, 50)

X = 0.415
Y = 0.7
Width = 0.25
Height = 0.2
btnLogin = guiCreateButton(X, Y, Width, Height, "Log In", true, wdwLogin)

guiSetVisible(wdwLogin, false)
end
</syntaxhighlight>
Обратите внимание на то, что каждый компонент интерфейса является дочерним по отношению к окну, это достигается указанием родительского элемента (wdwLogin, в данном случае) при создании элемента:
<syntaxhighlight lang="lua">
guiCreateLabel(X, Y, Width, Height, "Password", true, wdwLogin)
</syntaxhighlight>
Это очень удобно, т.к. в дальнейшем, при отображении окна, можно обращаться только к родительскому элементу. К примеру:
<syntaxhighlight lang="lua">
guiSetVisible(wdwLogin, false) --прячет всё окно целиком так, что мы можем показать его игроку в любой момент.
</syntaxhighlight>

Для редактироования GUI вы также можете воспользоваться [[RU/Resource:GUI_Editor | редактором GUI]].

===Использование написаной нами функции===
Функция CreateLoginWindow написана, но она не будет работать, пока мы её не вызовем. Рекомендуется создавать все окна при запуске ресурса на клиенте, прятать их, и показывать игроку позднее, когда они понадобятся. Для этого напишем обработчик события "[[onClientResourceStart]]", в котором будем создавать окно:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreateLoginWindow()
end
)
</syntaxhighlight>
Мы хотим показывать окно когда клиент подключается к игре, используя то же событие "[[onClientResourceStart]]". Теперь обработчик выглядит так:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreateLoginWindow()

outputChatBox("Welcome to My MTA DM Server, please log in. ")

if (wdwLogin ~= nil) then
guiSetVisible(wdwLogin, true)
end

showCursor(true)
guiSetInputEnabled(true)
end
)
</syntaxhighlight>
Заметьте, что мы выполняем проверку перед показом окна, так, в случае, если окно не создано, не возникнет ошибки. Функция [[showCursor]] включает управление мышью, а [[guiSetInputEnabled]] позволяет быть уверенным, что использование при вводе некоторых клавиш, таких как "A", "S", "D", "W", "T", не приведёт к движению персонажа, или вводу текста в чате. На следующем шаге мы заставим кнопку работать так, как задумывалось.

===Обработчик нажатия кнопки===
Когда пользователь кликает по любому элементу интерфейса, генерируется событие "[[onClientGUIClick]]" для этого элемента. К примеру, если вы кликните по кнопке, можно добавить обработчик для этого события:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", theButtonElement, theHandlerFunction, false)
</syntaxhighlight>
В нашем скрипте требуется только обработчик привязанный к кнопке. При клике по ней, клиент должен сообщить серверу, что нужно респаунить игрока. Найдите обработчик события "onClientResourceStart" из предыдущей части и добавьте следующую строку сразу ПОСЛЕ вызова CreateLoginWindow() :
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", btnLogin, clientSubmitLogin, false)
</syntaxhighlight>
Обработчик должен быть добавлен здесь, чтобы быть уверенным, что переменная btnLogin содержит существующую кнопку. Нельзя привязать событие к несуществующему элементу. Вы, должно быть, заметили, что нам потребуется функция "clientSubmitLogin", вызываемая в предыдущей строке.
<syntaxhighlight lang="lua">
function clientSubmitLogin(button, state)
if (button == "left" and state == "up") then

triggerServerEvent("SubmitLogin", getRootElement(), guiGetText(edtUser), guiGetText(edtPass))
guiSetInputEnabled(false)
guiSetVisible(wdwLogin, false)
showCursor(false)
end
end
</syntaxhighlight>
Переменная "button" передается обработчиком события и содержит строку с именем этой кнопки (к примеру "left" или "right"). Здесь мы познакомились с новой концепцией пользовательских событий. Пользовательские события могут генерироваться как на одной стороне, так и на разных (с сервера на клиент и наоборот). Мы используем функцию [[triggerServerEvent]], чтобы сгенерировать событие "SubmitLogin" на сервере.

Теперь у нас есть весь необходимый клиентский код. На сервере, как вы помните, мы спавним игрока как только он подключается к серверу:
<syntaxhighlight lang="lua">
function joinHandler()
local x,y,z
x = 1959.55
y = -1714.46
z = 10
spawnPlayer(source, x, y, z)
fadeCamera(source, true)
outputChatBox("Welcome to My Server", source)
end
addEventHandler("onPlayerJoin", getRootElement(), joinHandler)
</syntaxhighlight>
Так как теперь мы должны спавнить игрока после нажатия на кнопку, нам нужно заменить событие "onPlayerJoin" пользовательским событием, генерируемым клиентом. Замените приведенный выше код следующим образом:
<syntaxhighlight lang="lua">
function joinHandler(username, password)
local x,y,z
x = 1959.55
y = -1714.46
z = 10
if (client) then
spawnPlayer(client, x, y, z)
fadeCamera(client, true)
outputChatBox("Welcome to My Server", client)
end
end

addEvent("SubmitLogin", true)
addEventHandler("SubmitLogin", getRootElement(), joinHandler)
</syntaxhighlight>
Обратите внимание на второй параметр функции [[addEvent]] (имеющий значение "true"), он указывает, что событие может быть сгенерировано другой стороной. так же заметьте, что "client" - внутренняя переменная, используемая MTA для идентификации игрока, сгенерировавшего событие.

И, наконец, не забудьте добавить файл gui.lua в meta.xml основного ресурса и пометть его как клиентский:
<syntaxhighlight lang="xml">
<script src="client/gui.lua" type="client" />
</syntaxhighlight>

Теперь у нас есть минимальное окно авторизации, спавнящее игрока при нажатии кнопки "login". Вы также можете использовать логин и пароль, передаваемые функцией [[triggerServerEvent]] для идентификации пользователя.

[[en:Introduction_to_Scripting_GUI]]
[[it:Introduzione_allo_scripting_della_GUI]]