RU/Server Scripting Functions: Difference between revisions

Latest revision as of 11:18, 8 June 2022

Авторы: Вы создали страницу, но ее нет в этом списке? Запутались? Читайте: Добавление страниц в категории и шаблоны

На этой странице располагается список всех серверных функций скриптинга, которые когда-либо были внедрены и теперь являются встроенными. Чтобы запросить новую функцию или событие, напишите об этом в наш GitHub хранилище.

Обратите внимание, что функции скриптинга также можно расширить благодаря подгрузке динамических модулей с ними. Они предоставляют новый функционал, как утилитарные функции. Эти функции скриптинга не являются встроенными и требуют подгрузки модуля для того, чтобы с ними можно было работать.

Отправляйтесь на страницу с модулями, если хотите получить список доступных невстроенных серверных функций и модулей.

Если вам захочется узнать о других функциях, посетите страницу с полезными функциями.

Клиентские функции скриптинга можно найти здесь.

Функции аккаунта

addAccount - регистрирует аккаунт
copyAccountData - копирует данные аккаунта в другой
getAccount - получает аккаунт указанного пользователя
getAccountByID - получает аккаунт с указанным ID
getAccountData - получает указанные данные аккаунта
getAccountID - получает ID указанного аккаунта
getAccountIP - получает IP указанного аккаунта
getAccountName - получает имя аккаунта
getAccountPlayer - получает активного пользователя аккаунта
getAccountSerial - получает серийный номер аккаунта
getAccounts - получает все зарегистрированные аккаунты
getAccountsByData - получает аккаунты с указанными сохранёнными данными
getAccountsByIP - получает аккаунт с указанным IP
getAccountsBySerial - получает все аккаунты с указанным серийным номером
getAllAccountData - получает все данные аккаунта
getPlayerAccount - получает аккаунт указанного игрока
isGuestAccount - проверяет, является ли аккаунт гостевым
logIn - авторизует игрока под указанный аккаунт
logOut - выходит из аккаунта указанного игрока
removeAccount - удаляет аккаунт
setAccountData - сохраняет данные в аккаунте
setAccountName - устанавливает имя аккаунту
setAccountPassword - устанавливает пароль аккаунта

Функции администратора

addBan — блокирует доступ по серийному номеру, IP адресу и / или нику
banPlayer — блокирует указанного игрока по серийному номеру, IP адресу и / или нику
getBanAdmin — возвращает ник администратора, ответственного за указанную блокировку
getBanIP — возвращает заблокированный IP адрес для указанной блокировки
getBanNick — возвращает ник заблокированного игрока для указанной блокировки
getBanReason — возвращает причину выдачи для указанной блокировки
getBans — возвращает таблицу выданных блокировок
getBanSerial — возвращает заблокированный серийный номер для указанной блокировки
getBanTime — возвращает время в секундах, прошедшее от 1.01.1970 до момента выдачи указанной блокировки
getBanUsername — возвращает ник заблокированного игрока для указанной блокировки (устарела)
getUnbanTime — возвращает время в секундах, прошедшее от 1.01.1970 до момента снятия указанной блокировки
isBan — проверка значение на соответствие типу ban
kickPlayer — исключает указанного игрока из игры
setBanAdmin — изменяет никнейм ответственного за блокировку администратора
setBanNick — изменяет никнейм игрока для указанной блокировки
setBanReason — изменяет причину указанной блокировки
setUnbanTime — изменяет время разблокировки для указанного игрока
removeBan — удаляет указанную блокировку
reloadBans — обновление данных о выданных блокировках из файла banlist.xml

Функции ввода

Функции взрыва

createExplosion

Функции воды

createWater - создаёт область воды
getWaterColor - возвращает цвет воды мира GTA
getWaterVertexPosition - возвращает мировую позицию вершины (т.е. угла) водной области
getWaveHeight - возвращает текущую высоту волны
resetWaterColor - сбрасывает цвет воды мира GTA по умолчанию
resetWaterLevel - сбрасывает уровень воды в мире GTA до уровня по умолчанию
setWaterColor - меняет цвет воды в мире GTA
setWaterLevel - устанавливает высоту части или всей воды в игровом мире
setWaterVertexPosition - устанавливает мировое положение угловой точки воды
setWaveHeight - устанавливает высоту волны на указанное значение

Функции вывода

Функции звука

playSoundFrontEnd - воспроизводит внешний звук для указанного игрока

Функции игрока

Функции камеры

fadeCamera — заливает экран цветом или отменяет этот эффект
getCameraInterior — возвращает номер интерьера, в котором установлена камера
getCameraMatrix — возвращает позицию камеры
getCameraTarget — возвращает элемент, за которым закреплена камера
setCameraInterior — устанавливает номер интерьера для созданной камеры
setCameraMatrix — устанавливает позицию камеры
setCameraTarget — закрепляет камеру за определенным элементом

Функции карты

Функции коллизии

addColPolygonPoint — добавляет новую вершину к существующей форме коллизии
createColPolygon — создает форму коллизии
createColCircle — создает форму коллизии в виде окружности
createColCuboid — создает форму коллизии в виде прямоугольного параллелепипеда
createColRectangle — создает форму коллизии в виде прямоугольника
createColSphere — созданет форму коллизии в виде сферы
createColTube — созданет форму коллизии в виде цилиндра

ДОБАВЛЕНО/ОБНОВЛЕНО В ВЕРСИИ 1.5.9 r20807:

getColPolygonHeight — возвращает начальные и конечные координаты по Z формы коллизии

getColPolygonPoints — возвращает координаты (X, Y) вершин формы коллизии
getColPolygonPointPosition — возвращает координаты (X, Y) вершины формы коллизии по указанному индексу
getColShapeType — возвращает тип формы коллизии
getColShapeRadius — возвращает радиус формы коллизии
getColShapeSize — возвращает размер формы коллизии
getElementColShape — возвращает форму коллизии, созданной с помощью пикапа или маркера
getElementsWithinColShape — возвращает элементы, находящихся в зоне формы коллизии
isElementWithinColShape — проверяет нахождение элемента в зоне формы коллизии
isInsideColShape — проверяет нахождение указанной точки в зоне формы коллизии
removeColPolygonPoint — удаляет вершины формы коллизии по указанному индексу

ДОБАВЛЕНО/ОБНОВЛЕНО В ВЕРСИИ 1.5.9 r20807:

setColPolygonHeight — изменяет начальные и конечные координаты по Z формы коллизии

setColPolygonPointPosition — изменяет координаты точки формы коллизии по указанному индексу
setColShapeRadius — изменяет радиус формы коллизии
setColShapeSize — изменяет размер формы коллизии

Функции команды

Функции курсора

Функции маркера

Функции матрицы

Функции меток на радаре

createBlip — создает блип (иконку) на радаре игрока
createBlipAttachedTo — создает блип (иконку) на радаре игрока с привязкой к определенному элементу
getBlipColor — возвращает цвет созданного блипа
getBlipIcon — возвращает номер иконки созданного блипа
getBlipSize — возвращает размер созданного блипа
setBlipColor — устанавливает цвет созданного блипа
setBlipIcon — устанавливает иконку созданного блипа
setBlipSize — устанавливает размер созданного блипа
getBlipOrdering — возвращает позицию созданного блипа по координате Z
setBlipOrdering — устанавливает позицию созданного блипа по координате Z
getBlipVisibleDistance — возвращает дальность видимости для созданного блипа
setBlipVisibleDistance — устанавливает дальность видимости для созданного блипа

Функции мира

Функции модуля

Функции настройки реестра

get
set

Функции объекта

Функции объявления

getGameType — возвращает название игрового режима, установленного на сервере
getMapName — возвращает название карты
getRuleValue — возвращает правило, установленное на сервере, по ключу
removeRuleValue — удаляет правило, установленное на сервере, по ключу
setGameType — устанавливает название игрового режима
setMapName — устанавливает название карты
setRuleValue — добавляет правило по ключу

Функции оружия

giveWeapon - дает указанное оружие игроку или пешеходу
takeAllWeapons - удаляет всё оружие с указанного игрока или пешехода
takeWeapon - удаляет указанное оружие или боеприпасы с игрока или пешехода

ДО ВЕРСИИ 1.3.1 :

takeWeaponAmmo - удаляет определённое кол-во боеприпасов у игрока для указанного оружия
giveWeaponAmmo - даёт определённое кол-во боеприпасов игроку для указанного оружия

getOriginalWeaponProperty - получает исходное свойство указанного типа оружия
getPickupWeapon - получает ID оружия из указанного пикапа
getSlotFromWeapon - получает слот к которому принадлежит оружие
getWeaponIDFromName - получает ID оружия из его названия
getWeaponNameFromID - получает название оружия или причину смерти из его ID
getWeaponProperty - получает свойство указанного оружия
setWeaponAmmo - устанавливает определенное кол-во боеприпасов для указанного оружия
setWeaponProperty - устанавливает свойство указанного типа оружия

Функции пешеходов (NPC)

Функции пикапа

Функции ресурса

addResourceConfig - добавляет новый пустой файл конфигурации к существующему ресурсу
addResourceMap - добавляет новый пустой файл карты к существующему ресурсу
callRemote - вызывает функции, которые были экспортированы с HTTP-доступом другими серверами MTA
copyResource - копирует указанный ресурс с новым именем
createResource - создаёт новый пустой ресурс
deleteResource - удаляет ресурс из памяти MTA и перемещает его в каталог /resources-cache/trash/
getResourceACLRequests - возвращает раздел запроса ACL из файла meta.xml данного ресурса
getResourceInfo - возвращает значение любого атрибута в теге информации о ресурсе
getResourceLastStartTime - возвращает последнее время и дату запуска ресурса
getResourceLoadFailureReason - возвращает причину, по которой не удалось запустить ресурс
getResourceLoadTime - возвращает дату и время последней загрузки ресурса на сервер
getResourceMapRootElement - возвращает корневой элемент определённой карты в указанном ресурсе
getResourceOrganizationalPath - возвращает путь к файлу организации ресурса
getResources - возвращает таблицу всех ресурсов, существующих на сервере
isResourceArchived - проверяет, заархивирован ли ресурс в данный момент (запускается из ZIP-файла)
isResourceProtected - проверяет, защищён ли ресурс в настоящее время, как определено в mtaserver.conf
refreshResources - находит новые ресурсы и проверяет наличие изменений в текущих
renameResource - переименовывает ресурс
removeResourceFile - удаляет файл из ресурса
restartResource - перезапускает работающий ресурс
setResourceInfo - устанавливает значение любого атрибута в теге информации о ресурсе
startResource - запускает ресурс либо постоянно, либо как зависимость от текущего ресурса
stopResource - останавливает работающий ресурс
updateResourceACLRequest - изменяет доступ для одного запроса ACL к данному ресурсу

abortRemoteRequest - прерывает запрос fetchRemote или callRemote
call - вызывает функции из другого ресурса
fetchRemote - отправляет и получает данные с HTTP-серверов
getRemoteRequestInfo - возвращает информацию о запросе fetchRemote или callRemote
getRemoteRequests - возвращает все текущие запросы fetchRemote и callRemote
getResourceConfig - возвращает корневой узел файла конфигурации
getResourceDynamicElementRoot - возвращает корень динамического элемента указанного ресурса
getResourceExportedFunctions - возвращает таблицу, содержащую имена функций, экспортируемых ресурсом
getResourceFromName - возвращает ресурс из его имени
getResourceName - возвращает имя указанного ресурса
getResourceRootElement - возвращает корневой элемент ресурса
getResourceState - возвращает состояние указанного ресурса
getThisResource - возвращает ресурс, из которого был сделан вызов функции

Функции сервера

Функции снаряда

detonateSatchels

Функции события

getCancelReason - получает причину отмены события
triggerClientEvent - позволяет вызвать срабатывание события, предварительно созданного на клиенте
triggerLatentClientEvent - аналог triggerClientEvent, но скорость передачи может быть ограничена

addEvent - позволяет зарегистрировать своё собственное событие
addEventHandler - прикрепляет к событию обработчик
cancelEvent - останавливает автоматическую внутреннюю обработку события
cancelLatentEvent - останавливает автоматическую внутреннюю обработку скрытого события
getEventHandlers - получает прикреплённые функции из события и присоединённый элемент из текущего lua-скрипта
getLatentEventHandles - получает текущие скрытые события в очереди
getLatentEventStatus - получает состояние одного скрытого события в очереди
removeEventHandler - открепляет от события обработчик
triggerEvent - вызывает срабатывание указанного события для указанного элемента в дереве элементов
wasEventCancelled - проверяет, было ли отменено последнее завершённое событие

Функции текста

Функции тела и одежды

getBodyPartName — возвращает название части тела по указанному ID
getClothesByTypeIndex — возвращает название текстуры и модели одежды по указанным типу и индексу
getClothesTypeName — возвращает название типа одежды по указанному индексу
getTypeIndexFromClothes — возвращает тип и индекс одежды по указанным названию текстуры и названию модели

Функции территории радара

Функции транспорта

Функции утилит

getUserdataType

Функции файлов

Функции элемента

attachElements
createElement
destroyElement
detachElements
getAttachedElements
getElementAlpha
getElementAttachedOffsets
getElementAttachedTo
getElementCollisionsEnabled
getElementByID
getElementChild
getElementChildren
getElementChildrenCount
getElementColShape - получает связанную с элементом форму коллизии
getElementData
getElementDimension
getElementHealth
getElementID
getElementInterior
getElementModel
getElementMatrix
setElementMatrix
getElementParent
getElementPosition
getElementRotation
getElementType
getElementVelocity
getElementsByType
getElementsWithinColShape - получает список всех элементов связанных с формой коллизии указанного типа
getLowLODElement
isElementLowLOD
setLowLODElement
getPedContactElement
getResourceDynamicElementRoot
getResourceRootElement
getRootElement
hasElementData
isElement
isElementAttached
isElementCallPropagationEnabled
isElementDoubleSided
isElementFrozen
isElementInWater
isElementWithinColShape - определяет, находится ли элемент в пределах формы коллизии
isElementWithinMarker
setElementAlpha
setElementAngularVelocity
getElementAngularVelocity
setElementAttachedOffsets
setElementCallPropagationEnabled
setElementCollisionsEnabled
setElementData
setElementDimension
setElementDoubleSided
setElementFrozen
setElementHealth
setElementID
setElementInterior
setElementModel
setElementParent
setElementPosition
setElementRotation
setElementVelocity

Функции ACL

aclCreate - создаёт запись ACL
aclCreateGroup - создаёт группу ACL
aclDestroy - уничтожает запись ACL
aclDestroyGroup - уничтожает группу ACL
aclGet - возвращает запись ACL с указанным именем
aclGetGroup - возвращает группу ACL с указанным именем
aclGetName - возвращает имя указанной записи ACL
aclGetRight - проверяет, установлен ли доступ для указанного права в ACL
aclGroupAddACL - добавляет указанный ACL в указанную группу ACL
aclGroupAddObject - добавляет указанный объект в указанную группу ACL
aclGroupGetName - возвращает имя указанной ACL группы
aclGroupList - возвращает все группы ACL
aclGroupListACL - возвращает все ACL из указанной группы ACL
aclGroupListObjects - возвращает все объекты их указанной группы ACL
aclGroupRemoveACL - удаляет указанный ACL из группы ACL
aclGroupRemoveObject - удаляет указанный объект из указанной группы ACL
aclList - возвращает список всех ACL из XML-файла ACL
aclListRights - возвращает таблицу всех прав, которыми обладает указанный ACL
aclReload - перезагружает ACL и группы ACL из XML-файла ACL
aclRemoveRight - удаляет указанное право из указанного ACL
aclSave - немедленно сохраняет XML-файл ACL
aclSetRight - изменяет указанное право для указанного ACL
hasObjectPermissionTo - проверяет, имеет ли указанный объект доступ для выполнения указанного действия
isObjectInACLGroup - проверяет, входит ли указанный объект в указанную группу

Функции HTTP

Эти функции могут использоваться только из lua-блоков в HTML-страницах, размещённых на сервере

Функции SQL

executeSQLQuery

dbPrepareString

Функции UTF-8

Функции XML

xmlCopyFile - копирует всё содержимое определённого узла в XML-документе в новый файл документа
xmlCreateChild - создаёт новый дочерний узел в узле XML
xmlCreateFile - создаёт новый XML-документ, который впоследствии можно сохранить в файл с помощью xmlSaveFile

ДО ВЕРСИИ 1.0.0 :

xmlCreateSubNode - создаёт подузел для указанного XML узла
xmlFindSubNode - возвращает именованный подузел определённого XML узла

xmlDestroyNode - удаляет узел XML из дерева узлов XML
xmlFindChild - возвращает именованный дочерний узел узла XML
xmlLoadFile - загружает XML-файл и возвращает узел, указав конкретный путь к файлу
xmlLoadString - создаёт XML узел из строкового ввода
xmlNodeGetAttribute - возвращает атрибут узла в файле конфигурации
xmlNodeGetAttributes - возвращает все аттрибуты выбранного XML узла
xmlNodeGetChildren - возвращает все дочерние элементы определенного XML узла или определенного дочернего узла
xmlNodeGetName - возвращает имя тега указанного XML узла
xmlNodeGetParent - возвращает родительский узел XML узла
xmlNodeGetValue - читает значения тегов в файлах XML
xmlNodeSetAttribute - редактирует атрибуты узла в файле конфигурации
xmlNodeSetName - задает имя тега указанного XML узла
xmlNodeSetValue - присваивает значения тегам в файлах XML
xmlSaveFile - сохраняет загруженный файл XML
xmlUnloadFile - выгружает XML файл из памяти

@@ Line 1: / Line 1: @@
-{{translate}}
 <pageclass class="server"></pageclass>
-Здесь приведены все [[event|функции скриптов]], выполняемые на '''серверной стороне''', которые уже встроены в мод. Для консультации по работе функций или событий посети [[Requested Functions and Events|эту страницу]].
+{{RU/Adding_Pages_to_Categories_and_Templates}}
+На этой странице располагается список всех '''серверных''' функций скриптинга, которые когда-либо были внедрены и теперь являются встроенными. Чтобы запросить новую функцию или событие, напишите об этом в [https://github.com/multitheftauto/mtasa-blue/issues наш GitHub хранилище.]
-Прошу заметить, что скриптовые функции могут быть расширены при загрузке  в динамических модулях, которые обеспечивают новые функции, такие как доступ к базе данных MySQL. Эти функции не встроены в мод и требуют модуль чтобы загрузить для готовности.
+Обратите внимание, что функции скриптинга также можно расширить благодаря подгрузке динамических модулей с ними. Они предоставляют новый функционал, как утилитарные функции. Эти функции скриптинга не являются встроенными и требуют подгрузки модуля для того, чтобы с ними можно было работать.
-Зайдите на [[Module functions|эту страницу]] для ознакомления с функциями, которые не встроены в мод, однако доступны для пользования.
+Отправляйтесь на страницу с [[RU/Modules|модулями]], если хотите получить список доступных невстроенных серверных функций и модулей.
-'''Функции для работы на клиентской стороне вы можете найти здесь: [[RU/Client Scripting Functions|Клиентские Функции Скриптинга]].'''
+Если вам захочется узнать о других функциях, посетите [[RU/Useful_Functions|страницу с полезными функциями]].
+'''Клиентские функции скриптинга можно найти [[RU/Client Scripting Functions|здесь]]'''.
+__TOC__
 ==Функции аккаунта==
-{{Account_functions}}
+{{RU/Server account functions}}
+==Функции администратора==
+{{RU/Server admin functions}}
+==Функции ввода==
+{{RU/Input_functions}}
-==Функции ACL==
+==Функции взрыва==
-{{ACL_functions}}
+{{RU/Explosion_functions}}
-==Функции администрирования==
+==Функции воды==
-{{RU/Admin_functions}}
+{{RU/Server water functions}}
+{{RU/Shared water functions}}
-==Аудио функции==
+==Функции вывода==
-{{Audio_functions}}
+{{RU/Output_functions}}
-==Функции объявления==
+==Функции звука==
-{{Announce_functions}}
+{{RU/Audio_functions}}
-==Blip функции==
+==Функции игрока==
-{{Blip_functions}}
+{{RU/Player functions}}
 ==Функции камеры==
-{{Camera functions}}
+{{RU/Camera functions}}
-==Функции формы столкновения==
+==Функции карты==
-{{Collision shape functions}}
+{{RU/Map_functions}}
-==Функции клиента==
+==Функции коллизии==
-{{Client functions}}
+{{RU/Collision shape functions}}
-==Функции тела и одежды==
+==Функции команды==
-{{Clothes and body functions}}
+{{RU/Team functions}}
 ==Функции курсора==
-{{Cursor_functions}}
+{{RU/Cursor_functions}}
-==Функции элементов==
+==Функции маркера==
-{{Element functions}}
+{{RU/Marker functions}}
-==Функции событий==
+==Функции матрицы==
-{{RU/Event functions}}
+{{RU/Shared_matrix_functions}}
+==Функции меток на радаре==
+{{RU/Blip_functions}}
+==Функции мира==
+{{RU/World functions}}
-==Функции взрывов==
+==Функции модуля==
-{{Explosion_functions}}
+{{RU/Module functions}}
-==Функции файлов==
+==Функции настройки реестра==
-{{File_functions}}
+{{RU/Settings registry functions}}
-==Функции HTTP==
+==Функции объекта==
-{{HTTP_functions}}
+{{RU/Object functions}}
-==Функции ввода==
+==Функции объявления==
-{{Input_functions}}
+{{RU/Announce_functions}}
-==Функции карты==
+==Функции оружия==
-{{Map_functions}}
+{{RU/Server weapon functions}}
+{{RU/Shared weapon functions}}
-==Функции маркеров==
+==Функции пешеходов (NPC)==
-{{Marker functions}}
+{{RU/Ped_functions}}
-==Функции объектов==
+==Функции пикапа==
-{{Object functions}}
+{{RU/Pickup functions}}
-==Функции педов==
+==Функции ресурса==
-{{Ped_functions}}
+{{RU/Server resource functions}}
+{{RU/Shared resource functions}}
-==Функции пикапов==
+==Функции сервера==
-{{Pickup functions}}
+{{RU/Server functions}}
-==Функции игрока==
+==Функции снаряда==
-{{Player functions}}
+{{RU/Projectile_functions}}
-==Функции области радара==
+==Функции события==
-{{Radar area functions}}
+{{RU/Server event_functions}}
+{{RU/Shared_event_functions}}
-==Функции ресурсов==
+==Функции текста==
-{{Resource functions}}
+{{RU/Text functions}}
-==Серийные функции==
+==Функции тела и одежды==
-{{Serial functions}}
+{{RU/Clothes and body functions}}
-==Серверные функции==
+==Функции территории радара==
-{{Server functions}}
+{{RU/Radar area functions}}
-==Функции настройки реестра==
+==Функции транспорта==
-{{RU/Settings registry functions}}
+{{RU/Vehicle functions}}
-==Функции SQL==
+==Функции утилит==
-{{SQL_functions}}
+{{RU/Utility functions}}
-==Функции команды==
+==Функции файлов==
-{{Team functions}}
+{{RU/File_functions}}
-==Функции текста==
+==Функции элемента==
-{{Text functions}}
+{{RU/Server element functions}}
+{{RU/Shared element functions}}
-==Полезные функции==
+==Функции ACL==
-{{Utility functions}}
+{{RU/Server ACL functions}}
-==Функции транспорта==
+==Функции HTTP==
-{{Vehicle functions}}
+{{RU/HTTP_functions}}
-==Функции оружия==
+==Функции SQL==
-{{RU/Weapon functions}}
+{{RU/SQL_functions}}
-==Функции мира==
+==Функции UTF-8==
-{{RU/World functions}}
+{{RU/UTF8 functions}}
 ==Функции XML==
-{{XML functions}}
+{{RU/Server XML functions}}
+{{RU/Shared XML functions}}
-==Устаревшие функции==
-Access: [http://development.mtasa.com/wiki/Category:Depreciated <nowiki>[[Category:Depreciated]]</nowiki> ]<br>
-''Note: dont change this, done purposely to keep this page from being included in the listing.''
 [[en:Server Scripting Functions]]
+[[ru:Server Scripting Functions]]
+[[hu:Server Scripting Functions]]
+[[de:Server-Seitige Scripting Funktionen]]
+[[es:Funciones_del_Server]]
+[[pl:Server Scripting Functions]]
+[[pt-br:Funções de Scripting do Servidor]]
+[[tr:Server Scripting Functions]]
+[[ar:Server Scripting Functions]]
+[[zh-cn:Server Scripting Functions]]