Multi Theft Auto: Wiki - User contributions [en]

DxDrawMaterialLine3D

2021-12-07T21:48:45Z

Baloo Pro: /* Example */

__NOTOC__
{{Client function}}
This function draws a textured 3D line between two points in the 3D world - rendered for one frame. This should be used in conjunction with [[onClientPreRender]] in order to display continuously.

The 3D line with a large width value effectively becomes a rectangle, so it it possible to construct basic shapes such as boxes with several large width lines and the appropriate values for 'faceToward'.

3D lines are drawn at a particular place in the [[Game_Processing_Order|game processing order]], so use [[onClientPreRender]] for drawing if you are attaching them to world elements.

==Syntax==
<syntaxhighlight lang="lua">
bool dxDrawMaterialLine3D ( float startX, float startY, float startZ, float endX, float endY, float endZ, [ bool flipUV = false, ] element material, float width,
[ int color = white, [ bool postGUI = false, ] float faceTowardX, float faceTowardY, float faceTowardZ ] )
</syntaxhighlight>

===Required Arguments===
* '''startX/Y/Z:''' The start position of the 3D line, representing a coordinate in the GTA world.
* '''endX/Y/Z:''' The end position of the 3D line, representing a coordinate in the GTA world.
* '''material:''' A [[material]] to draw the line with.
* '''width:''' The width/thickness of the line in GTA world units. (This is 1/75th of the width used in dxDrawLine3D)

==Optional Arguments==
{{OptionalArg}}
{{Added feature/item|1.5.9|1.5.8|20862|
* '''flipUV''': A bool representing whether a UV orientation should be flipped.
}}
* '''color:''' An [[int|integer]] of the hex color, produced using [[tocolor]] or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue).
* '''postGUI''': A bool representing whether the line should be drawn on top of or behind any ingame GUI.
* '''faceTowardX/Y/Z:''' The position the front of the line should face towards. If this is not set, the camera position is used, so the front of the line faces toward the camera.

===Returns===
Returns a ''true'' if the operation was successful, ''false'' otherwise.

==Example==
Draws [[:File:DxDrawMaterialLine3D-example.png|an image]] in coordiantes -2422.68555, -608.78986, 132.56250:
<syntaxhighlight lang="lua">
local redcircle = dxCreateTexture("red.png")

x,y,z = -2422.68555, -608.78986, 132.56250

size = 1

addEventHandler("onClientRender", root, function()
dxDrawMaterialLine3D(x+size, y+size, z-0.95, x-size, y-size, z-0.95, redcircle, size*2,tocolor(255, 255, 255, 255), false, x, y, z)
end)
</syntaxhighlight>

==Requirements==
{{Requirements|n/a|1.3.0-9.03931|}}

==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.5.5-9.11998|Added ''postGUI'' argument}}
{{ChangelogItem|1.5.8-9.20862|Added ''flipUV'' argument}}

==See Also==
{{Drawing_functions}}

DgsCreateNineSlice

2020-09-03T12:33:18Z

Baloo Pro: /* Example */

__NOTOC__
{{Client function}}

This function creates a nine-slice scaler.

==Syntax==
<syntaxhighlight lang="lua">
element dgsCreateNineSlice( element texture, float gridXLeft, float gridXRight, float gridYTop, float gridYBottom [, bool relative = false ] )
</syntaxhighlight>

[[Image:DGS_Nine_Slice.png|300px|thumb|Nine Slice Scaling]]
===Required Arguments===
*'''texture:''' A texture element that you want to scale.
*'''gridXLeft:''' A float of the position of left grid, depends of by '''relative'''
*'''gridXRight:''' A float of the position of right grid, depends of by '''relative'''
*'''gridYTop:''' A float of the position of top grid, depends of by '''relative'''
*'''gridYBottom:''' A float of the position of bottom grid, depends of by '''relative'''

===Optional Arguments===
*'''relative:''' A bool of whether the position of grid is ranging from 0 to 1 or just absolute pixels

===Returns===
Returns a dgs-dxnineslice (DGS Plugin Type)[ dgs-dxcustomrenderer(Element Type) ] if succeed, ''false'' otherwise

==Example==
<syntaxhighlight lang="lua">
DGS = exports.dgs --get exported functions from dgs

yourTexture = dxCreateTexture("yourTexture")
nSlice = DGS:dgsCreateNineSlice( yourTexture, 0.2, 0.35, 0.2, 0.65, true )
Image = DGS:dgsCreateImage( 100, 200, 500, 450, nSlice, false )
</syntaxhighlight>

==See Also==
{{DGSFUNCTIONS}}

RU/Slothbot

2020-04-23T14:18:25Z

Baloo Pro: /* setBotWait */

<pageclass class="resource" subcaption="Resource"></pageclass>

{{translate|ru}}

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

=Особенности=
'''Командная игра:'''
Бот способен отличать врага от союзника.

'''Навигация по карте:'''
Если бот будет заспаунен на карте без специальных путей, он сможет двигаться самостоятельно и искать врагов, но не так ловко.

'''Агрессивность:'''
Эти боты атакуют игроков и ботов состоящих в других командах.

'''Кооператив:'''
При обнаружении союзника, боты могут автоматически объединяться в команду с ним.

'''Подвижность и ловкость:'''
Если на пути бота появятся препятствия он попытается обойти их или перепрыгнуть.

'''Типы игры ботов:'''
*"hunting" - ("Охота") бот следует по указанному пути и выискивает врага.
*"waiting" - ("Выжидание") бот стоит на месте пока в поле его зрения не появится враг.
*"guarding" - ("Охрана") бот не двигается с места и атакует врага если тот находится в поле его зрения.
*"following" - ("Следование") бот следует за союзником (игроком/ботом) и атакует врагов в поле зрения.
*"chasing" - ("Преследование") бот преследует врага и атакует его.

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

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

=События Сервера=

==onBotFindEnemy==
Это условие вызывается когда бот находит врага. Оно может быть отменено, чтобы бот никого не атаковал.

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element enemy
</syntaxhighlight>
*'''enemy''': Игрок или бот являющийся врагом.
<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который нашел врага

==onBotWasted==
Это срабатывает, когда бот убит.

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element attacker, float weapon, float bodypart
</syntaxhighlight>
*'''attacker''': Элемент, который убил бота
*'''weapon''': Идентификатор оружия, используемого для убийства бота
*'''bodypart''': Идентификатор части тела, в который попали, чтобы убить бота
<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который умер

==onBotSpawned==
Это срабатывает, когда появляется бот.

<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который спавнился.

==onBotFollow==
Это срабатывает, когда бот начинает следовать за товарищем по команде

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element leader
</syntaxhighlight>
*'''leader''': Игрок или Ped бот начал следовать за ним
<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который начинает следовать за товарищем по команде

=Server Functions=
All of these funtions will have to be used through the [[call]] function, otherwise they won't work

==spawnBot==
Эта функция создаёт бота в игре, возвращает элемент bot или false, если возникла проблема.

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
element spawnBot ( float x, float y, float z, int rotation = 0, [ int skinID = 0, int interior = 0, int dimension = 0, team theTeam = nil, int weapon = 0, string theMode = "hunting", element theModesubject = nil ] )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''x:''' x координата спавна бота
*'''y:''' y координата спавна бота
*'''z:''' z координата спавна бота
*'''rotation:''' Ротация бота на спавне

<big>'''Optional Arguments'''</big>
*'''skinID:''' Скин бота при спавне
*'''interior:''' Интерьер, в котором появится бот
*'''dimension:''' Идентификатор [[dimension]] - измерения, в котором должен находиться бот
*'''theTeam:''' Команда к которой присоединится бот
*'''weapon:''' Оружие, которое будет носить пед
*'''theMode:''' Действие, которое бот будет выполнять при появлении на свет (см. раздел "режимы игры" выше)
*'''theModeSubject:''' Если theMode "преследует " или" следует", этот аргумент необходим, чтобы сообщить боту, какого противника преследовать или за каким товарищем по команде следовать

==setBotHunt==
заставляет бота путешествовать по путям до тех пор, пока он не найдет врага или товарища по команде

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotHunt ( element theBot )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' Бот, на которого вы хотите охотиться

==setBotWait==
заставляет бота стоять неподвижно до тех пор, пока в поле зрения не появится враг

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotWait ( element theBot )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' Бот, которого вы хотите подождать

==setBotChase==
makes the bot attack an anemy bot or player

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotChase ( element theBot, element theTarget )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot that you want to do the chasing
*'''theTarget:''' The bot or player you want to be chased

==setBotFollow==
makes the bot follow a teammate bot or player

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotFollow( element theBot, element theTarget )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot that you want to do the following
*'''theTarget:''' The bot or player you want to be followed

==setBotGuard==
makes the bot move to the specific coords and stay there while attacking any enemies

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotGuard( element theBot, float x, float y, float z, [ bool priority = false ] )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to do the guarding
*'''x:''' The X coords you want the bot to guard
*'''y:''' The Y coords you want the bot to guard
*'''z:''' The Z coords you want the bot to guard

<big>'''Optional Arguments'''</big>
*'''priority:''' Set to true only if you want the bot to only shoot once it has reached the location to guard

==getBotTeam==
returns the Team the bot is on, false if no team

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
string getBotTeam ( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check the team of

==setBotTeam==
changes the bot's team and loyalties

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotTeam ( element theBot, team theTeam )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to change the team of
*'''theTeam:''' The team the bot should join

==getBotAttackEnabled==
returns true if the bot is allowed to attack, false otherwise

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool getBotAttackEnabled( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check if it can atack

==setBotAttackEnabled==
allow or disallow the bot to attack (press fire)

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotAttackEnabled( element theBot, bool enabled)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to set if it can atack
*'''enabled:''' set to false to remove the bots ability to attack, true to allow it

==getBotMode==
returns the mode the bot is in ("chasing", "waiting", "guarding", "hunting", "following") or if the bot is chasing or following, it will return the mode and the target

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
string getBotMode( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check the status of

==isPedBot==
returns true if the ped is a bot, false otherwise

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool isPedbot( element thePed)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''thePed:''' The ped you want to check if its a bot

==setBotWeapon==
sets the bot's weapon id (ammo is always infinite)

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotWeapon( element theBot, float weapon)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to set the weapon of
*'''weapon:''' the weapon id you want to give the bot

=Credits=
*'''Slothman:''' Bot creator, main scripter
*'''Gamesnert:''' EDF creator, scripting, testing
*'''Dragon:''' Gamemode creator, testing, scripting help
*'''EvGeniz:''' early testing, mapping
'''Thanks to Everyone else who made suggestions, tested the script, helped when i was stuck, etc'''
[[Category:Resource]]

[[en:Slothman/Slothbot]]

RU/Slothbot

2020-04-23T14:13:44Z

Baloo Pro: /* setBotHunt */

<pageclass class="resource" subcaption="Resource"></pageclass>

{{translate|ru}}

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

=Особенности=
'''Командная игра:'''
Бот способен отличать врага от союзника.

'''Навигация по карте:'''
Если бот будет заспаунен на карте без специальных путей, он сможет двигаться самостоятельно и искать врагов, но не так ловко.

'''Агрессивность:'''
Эти боты атакуют игроков и ботов состоящих в других командах.

'''Кооператив:'''
При обнаружении союзника, боты могут автоматически объединяться в команду с ним.

'''Подвижность и ловкость:'''
Если на пути бота появятся препятствия он попытается обойти их или перепрыгнуть.

'''Типы игры ботов:'''
*"hunting" - ("Охота") бот следует по указанному пути и выискивает врага.
*"waiting" - ("Выжидание") бот стоит на месте пока в поле его зрения не появится враг.
*"guarding" - ("Охрана") бот не двигается с места и атакует врага если тот находится в поле его зрения.
*"following" - ("Следование") бот следует за союзником (игроком/ботом) и атакует врагов в поле зрения.
*"chasing" - ("Преследование") бот преследует врага и атакует его.

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

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

=События Сервера=

==onBotFindEnemy==
Это условие вызывается когда бот находит врага. Оно может быть отменено, чтобы бот никого не атаковал.

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element enemy
</syntaxhighlight>
*'''enemy''': Игрок или бот являющийся врагом.
<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который нашел врага

==onBotWasted==
Это срабатывает, когда бот убит.

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element attacker, float weapon, float bodypart
</syntaxhighlight>
*'''attacker''': Элемент, который убил бота
*'''weapon''': Идентификатор оружия, используемого для убийства бота
*'''bodypart''': Идентификатор части тела, в который попали, чтобы убить бота
<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который умер

==onBotSpawned==
Это срабатывает, когда появляется бот.

<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который спавнился.

==onBotFollow==
Это срабатывает, когда бот начинает следовать за товарищем по команде

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element leader
</syntaxhighlight>
*'''leader''': Игрок или Ped бот начал следовать за ним
<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который начинает следовать за товарищем по команде

=Server Functions=
All of these funtions will have to be used through the [[call]] function, otherwise they won't work

==spawnBot==
Эта функция создаёт бота в игре, возвращает элемент bot или false, если возникла проблема.

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
element spawnBot ( float x, float y, float z, int rotation = 0, [ int skinID = 0, int interior = 0, int dimension = 0, team theTeam = nil, int weapon = 0, string theMode = "hunting", element theModesubject = nil ] )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''x:''' x координата спавна бота
*'''y:''' y координата спавна бота
*'''z:''' z координата спавна бота
*'''rotation:''' Ротация бота на спавне

<big>'''Optional Arguments'''</big>
*'''skinID:''' Скин бота при спавне
*'''interior:''' Интерьер, в котором появится бот
*'''dimension:''' Идентификатор [[dimension]] - измерения, в котором должен находиться бот
*'''theTeam:''' Команда к которой присоединится бот
*'''weapon:''' Оружие, которое будет носить пед
*'''theMode:''' Действие, которое бот будет выполнять при появлении на свет (см. раздел "режимы игры" выше)
*'''theModeSubject:''' Если theMode "преследует " или" следует", этот аргумент необходим, чтобы сообщить боту, какого противника преследовать или за каким товарищем по команде следовать

==setBotHunt==
заставляет бота путешествовать по путям до тех пор, пока он не найдет врага или товарища по команде

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotHunt ( element theBot )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' Бот, на которого вы хотите охотиться

==setBotWait==
makes the bot stand still untill an enemy of teammate comes into view

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotWait ( element theBot )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to wait

==setBotChase==
makes the bot attack an anemy bot or player

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotChase ( element theBot, element theTarget )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot that you want to do the chasing
*'''theTarget:''' The bot or player you want to be chased

==setBotFollow==
makes the bot follow a teammate bot or player

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotFollow( element theBot, element theTarget )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot that you want to do the following
*'''theTarget:''' The bot or player you want to be followed

==setBotGuard==
makes the bot move to the specific coords and stay there while attacking any enemies

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotGuard( element theBot, float x, float y, float z, [ bool priority = false ] )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to do the guarding
*'''x:''' The X coords you want the bot to guard
*'''y:''' The Y coords you want the bot to guard
*'''z:''' The Z coords you want the bot to guard

<big>'''Optional Arguments'''</big>
*'''priority:''' Set to true only if you want the bot to only shoot once it has reached the location to guard

==getBotTeam==
returns the Team the bot is on, false if no team

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
string getBotTeam ( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check the team of

==setBotTeam==
changes the bot's team and loyalties

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotTeam ( element theBot, team theTeam )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to change the team of
*'''theTeam:''' The team the bot should join

==getBotAttackEnabled==
returns true if the bot is allowed to attack, false otherwise

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool getBotAttackEnabled( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check if it can atack

==setBotAttackEnabled==
allow or disallow the bot to attack (press fire)

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotAttackEnabled( element theBot, bool enabled)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to set if it can atack
*'''enabled:''' set to false to remove the bots ability to attack, true to allow it

==getBotMode==
returns the mode the bot is in ("chasing", "waiting", "guarding", "hunting", "following") or if the bot is chasing or following, it will return the mode and the target

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
string getBotMode( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check the status of

==isPedBot==
returns true if the ped is a bot, false otherwise

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool isPedbot( element thePed)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''thePed:''' The ped you want to check if its a bot

==setBotWeapon==
sets the bot's weapon id (ammo is always infinite)

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotWeapon( element theBot, float weapon)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to set the weapon of
*'''weapon:''' the weapon id you want to give the bot

=Credits=
*'''Slothman:''' Bot creator, main scripter
*'''Gamesnert:''' EDF creator, scripting, testing
*'''Dragon:''' Gamemode creator, testing, scripting help
*'''EvGeniz:''' early testing, mapping
'''Thanks to Everyone else who made suggestions, tested the script, helped when i was stuck, etc'''
[[Category:Resource]]

[[en:Slothman/Slothbot]]

RU/Slothbot

2020-04-23T12:56:13Z

Baloo Pro: /* spawnBot */

<pageclass class="resource" subcaption="Resource"></pageclass>

{{translate|ru}}

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

=Особенности=
'''Командная игра:'''
Бот способен отличать врага от союзника.

'''Навигация по карте:'''
Если бот будет заспаунен на карте без специальных путей, он сможет двигаться самостоятельно и искать врагов, но не так ловко.

'''Агрессивность:'''
Эти боты атакуют игроков и ботов состоящих в других командах.

'''Кооператив:'''
При обнаружении союзника, боты могут автоматически объединяться в команду с ним.

'''Подвижность и ловкость:'''
Если на пути бота появятся препятствия он попытается обойти их или перепрыгнуть.

'''Типы игры ботов:'''
*"hunting" - ("Охота") бот следует по указанному пути и выискивает врага.
*"waiting" - ("Выжидание") бот стоит на месте пока в поле его зрения не появится враг.
*"guarding" - ("Охрана") бот не двигается с места и атакует врага если тот находится в поле его зрения.
*"following" - ("Следование") бот следует за союзником (игроком/ботом) и атакует врагов в поле зрения.
*"chasing" - ("Преследование") бот преследует врага и атакует его.

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

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

=События Сервера=

==onBotFindEnemy==
Это условие вызывается когда бот находит врага. Оно может быть отменено, чтобы бот никого не атаковал.

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element enemy
</syntaxhighlight>
*'''enemy''': Игрок или бот являющийся врагом.
<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который нашел врага

==onBotWasted==
Это срабатывает, когда бот убит.

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element attacker, float weapon, float bodypart
</syntaxhighlight>
*'''attacker''': Элемент, который убил бота
*'''weapon''': Идентификатор оружия, используемого для убийства бота
*'''bodypart''': Идентификатор части тела, в который попали, чтобы убить бота
<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который умер

==onBotSpawned==
Это срабатывает, когда появляется бот.

<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который спавнился.

==onBotFollow==
Это срабатывает, когда бот начинает следовать за товарищем по команде

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element leader
</syntaxhighlight>
*'''leader''': Игрок или Ped бот начал следовать за ним
<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который начинает следовать за товарищем по команде

=Server Functions=
All of these funtions will have to be used through the [[call]] function, otherwise they won't work

==spawnBot==
Эта функция создаёт бота в игре, возвращает элемент bot или false, если возникла проблема.

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
element spawnBot ( float x, float y, float z, int rotation = 0, [ int skinID = 0, int interior = 0, int dimension = 0, team theTeam = nil, int weapon = 0, string theMode = "hunting", element theModesubject = nil ] )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''x:''' x координата спавна бота
*'''y:''' y координата спавна бота
*'''z:''' z координата спавна бота
*'''rotation:''' Ротация бота на спавне

<big>'''Optional Arguments'''</big>
*'''skinID:''' Скин бота при спавне
*'''interior:''' Интерьер, в котором появится бот
*'''dimension:''' Идентификатор [[dimension]] - измерения, в котором должен находиться бот
*'''theTeam:''' Команда к которой присоединится бот
*'''weapon:''' Оружие, которое будет носить пед
*'''theMode:''' Действие, которое бот будет выполнять при появлении на свет (см. раздел "режимы игры" выше)
*'''theModeSubject:''' Если theMode "преследует " или" следует", этот аргумент необходим, чтобы сообщить боту, какого противника преследовать или за каким товарищем по команде следовать

==setBotHunt==
заставляет бота путешествовать по путям до тех пор, пока он не найдет врага или товарища по команде

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotHunt ( element theBot )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to hunt

==setBotWait==
makes the bot stand still untill an enemy of teammate comes into view

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotWait ( element theBot )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to wait

==setBotChase==
makes the bot attack an anemy bot or player

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotChase ( element theBot, element theTarget )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot that you want to do the chasing
*'''theTarget:''' The bot or player you want to be chased

==setBotFollow==
makes the bot follow a teammate bot or player

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotFollow( element theBot, element theTarget )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot that you want to do the following
*'''theTarget:''' The bot or player you want to be followed

==setBotGuard==
makes the bot move to the specific coords and stay there while attacking any enemies

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotGuard( element theBot, float x, float y, float z, [ bool priority = false ] )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to do the guarding
*'''x:''' The X coords you want the bot to guard
*'''y:''' The Y coords you want the bot to guard
*'''z:''' The Z coords you want the bot to guard

<big>'''Optional Arguments'''</big>
*'''priority:''' Set to true only if you want the bot to only shoot once it has reached the location to guard

==getBotTeam==
returns the Team the bot is on, false if no team

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
string getBotTeam ( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check the team of

==setBotTeam==
changes the bot's team and loyalties

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotTeam ( element theBot, team theTeam )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to change the team of
*'''theTeam:''' The team the bot should join

==getBotAttackEnabled==
returns true if the bot is allowed to attack, false otherwise

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool getBotAttackEnabled( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check if it can atack

==setBotAttackEnabled==
allow or disallow the bot to attack (press fire)

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotAttackEnabled( element theBot, bool enabled)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to set if it can atack
*'''enabled:''' set to false to remove the bots ability to attack, true to allow it

==getBotMode==
returns the mode the bot is in ("chasing", "waiting", "guarding", "hunting", "following") or if the bot is chasing or following, it will return the mode and the target

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
string getBotMode( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check the status of

==isPedBot==
returns true if the ped is a bot, false otherwise

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool isPedbot( element thePed)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''thePed:''' The ped you want to check if its a bot

==setBotWeapon==
sets the bot's weapon id (ammo is always infinite)

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotWeapon( element theBot, float weapon)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to set the weapon of
*'''weapon:''' the weapon id you want to give the bot

=Credits=
*'''Slothman:''' Bot creator, main scripter
*'''Gamesnert:''' EDF creator, scripting, testing
*'''Dragon:''' Gamemode creator, testing, scripting help
*'''EvGeniz:''' early testing, mapping
'''Thanks to Everyone else who made suggestions, tested the script, helped when i was stuck, etc'''
[[Category:Resource]]

[[en:Slothman/Slothbot]]

RU/Slothbot

2020-04-23T12:55:16Z

Baloo Pro: /* Server Functions */

<pageclass class="resource" subcaption="Resource"></pageclass>

{{translate|ru}}

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

=Особенности=
'''Командная игра:'''
Бот способен отличать врага от союзника.

'''Навигация по карте:'''
Если бот будет заспаунен на карте без специальных путей, он сможет двигаться самостоятельно и искать врагов, но не так ловко.

'''Агрессивность:'''
Эти боты атакуют игроков и ботов состоящих в других командах.

'''Кооператив:'''
При обнаружении союзника, боты могут автоматически объединяться в команду с ним.

'''Подвижность и ловкость:'''
Если на пути бота появятся препятствия он попытается обойти их или перепрыгнуть.

'''Типы игры ботов:'''
*"hunting" - ("Охота") бот следует по указанному пути и выискивает врага.
*"waiting" - ("Выжидание") бот стоит на месте пока в поле его зрения не появится враг.
*"guarding" - ("Охрана") бот не двигается с места и атакует врага если тот находится в поле его зрения.
*"following" - ("Следование") бот следует за союзником (игроком/ботом) и атакует врагов в поле зрения.
*"chasing" - ("Преследование") бот преследует врага и атакует его.

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

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

=События Сервера=

==onBotFindEnemy==
Это условие вызывается когда бот находит врага. Оно может быть отменено, чтобы бот никого не атаковал.

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element enemy
</syntaxhighlight>
*'''enemy''': Игрок или бот являющийся врагом.
<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который нашел врага

==onBotWasted==
Это срабатывает, когда бот убит.

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element attacker, float weapon, float bodypart
</syntaxhighlight>
*'''attacker''': Элемент, который убил бота
*'''weapon''': Идентификатор оружия, используемого для убийства бота
*'''bodypart''': Идентификатор части тела, в который попали, чтобы убить бота
<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который умер

==onBotSpawned==
Это срабатывает, когда появляется бот.

<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который спавнился.

==onBotFollow==
Это срабатывает, когда бот начинает следовать за товарищем по команде

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element leader
</syntaxhighlight>
*'''leader''': Игрок или Ped бот начал следовать за ним
<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который начинает следовать за товарищем по команде

=Server Functions=
All of these funtions will have to be used through the [[call]] function, otherwise they won't work

==spawnBot==
Эта функция создаёт бота в игре, возвращает элемент bot или false, если возникла проблема.

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
element spawnBot ( float x, float y, float z, int rotation = 0, [ int skinID = 0, int interior = 0, int dimension = 0, team theTeam = nil, int weapon = 0, string theMode = "hunting", element theModesubject = nil ] )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''x:''' x координата спавна бота
*'''y:''' y координата спавна бота
*'''z:''' z координата спавна бота
*'''rotation:''' Ротация бота на спавне

<big>'''Optional Arguments'''</big>
*'''skinID:''' Скин бота при спавне
*'''interior:''' Интерьер, в котором появится бот
*'''dimension:''' Идентификатор [[измерения]], в котором должен находиться бот
*'''theTeam:''' Команда к которой присоединится бот
*'''weapon:''' Оружие, которое будет носить пед
*'''theMode:''' Действие, которое бот будет выполнять при появлении на свет (см. раздел "режимы игры" выше)
*'''theModeSubject:''' Если theMode "преследует " или" следует", этот аргумент необходим, чтобы сообщить боту, какого противника преследовать или за каким товарищем по команде следовать

==setBotHunt==
заставляет бота путешествовать по путям до тех пор, пока он не найдет врага или товарища по команде

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotHunt ( element theBot )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to hunt

==setBotWait==
makes the bot stand still untill an enemy of teammate comes into view

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotWait ( element theBot )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to wait

==setBotChase==
makes the bot attack an anemy bot or player

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotChase ( element theBot, element theTarget )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot that you want to do the chasing
*'''theTarget:''' The bot or player you want to be chased

==setBotFollow==
makes the bot follow a teammate bot or player

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotFollow( element theBot, element theTarget )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot that you want to do the following
*'''theTarget:''' The bot or player you want to be followed

==setBotGuard==
makes the bot move to the specific coords and stay there while attacking any enemies

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotGuard( element theBot, float x, float y, float z, [ bool priority = false ] )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to do the guarding
*'''x:''' The X coords you want the bot to guard
*'''y:''' The Y coords you want the bot to guard
*'''z:''' The Z coords you want the bot to guard

<big>'''Optional Arguments'''</big>
*'''priority:''' Set to true only if you want the bot to only shoot once it has reached the location to guard

==getBotTeam==
returns the Team the bot is on, false if no team

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
string getBotTeam ( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check the team of

==setBotTeam==
changes the bot's team and loyalties

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotTeam ( element theBot, team theTeam )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to change the team of
*'''theTeam:''' The team the bot should join

==getBotAttackEnabled==
returns true if the bot is allowed to attack, false otherwise

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool getBotAttackEnabled( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check if it can atack

==setBotAttackEnabled==
allow or disallow the bot to attack (press fire)

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotAttackEnabled( element theBot, bool enabled)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to set if it can atack
*'''enabled:''' set to false to remove the bots ability to attack, true to allow it

==getBotMode==
returns the mode the bot is in ("chasing", "waiting", "guarding", "hunting", "following") or if the bot is chasing or following, it will return the mode and the target

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
string getBotMode( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check the status of

==isPedBot==
returns true if the ped is a bot, false otherwise

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool isPedbot( element thePed)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''thePed:''' The ped you want to check if its a bot

==setBotWeapon==
sets the bot's weapon id (ammo is always infinite)

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotWeapon( element theBot, float weapon)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to set the weapon of
*'''weapon:''' the weapon id you want to give the bot

=Credits=
*'''Slothman:''' Bot creator, main scripter
*'''Gamesnert:''' EDF creator, scripting, testing
*'''Dragon:''' Gamemode creator, testing, scripting help
*'''EvGeniz:''' early testing, mapping
'''Thanks to Everyone else who made suggestions, tested the script, helped when i was stuck, etc'''
[[Category:Resource]]

[[en:Slothman/Slothbot]]

RU/Slothbot

2020-04-23T12:48:55Z

Baloo Pro: /* onBotFollow */

<pageclass class="resource" subcaption="Resource"></pageclass>

{{translate|ru}}

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

=Особенности=
'''Командная игра:'''
Бот способен отличать врага от союзника.

'''Навигация по карте:'''
Если бот будет заспаунен на карте без специальных путей, он сможет двигаться самостоятельно и искать врагов, но не так ловко.

'''Агрессивность:'''
Эти боты атакуют игроков и ботов состоящих в других командах.

'''Кооператив:'''
При обнаружении союзника, боты могут автоматически объединяться в команду с ним.

'''Подвижность и ловкость:'''
Если на пути бота появятся препятствия он попытается обойти их или перепрыгнуть.

'''Типы игры ботов:'''
*"hunting" - ("Охота") бот следует по указанному пути и выискивает врага.
*"waiting" - ("Выжидание") бот стоит на месте пока в поле его зрения не появится враг.
*"guarding" - ("Охрана") бот не двигается с места и атакует врага если тот находится в поле его зрения.
*"following" - ("Следование") бот следует за союзником (игроком/ботом) и атакует врагов в поле зрения.
*"chasing" - ("Преследование") бот преследует врага и атакует его.

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

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

=События Сервера=

==onBotFindEnemy==
Это условие вызывается когда бот находит врага. Оно может быть отменено, чтобы бот никого не атаковал.

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element enemy
</syntaxhighlight>
*'''enemy''': Игрок или бот являющийся врагом.
<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который нашел врага

==onBotWasted==
Это срабатывает, когда бот убит.

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element attacker, float weapon, float bodypart
</syntaxhighlight>
*'''attacker''': Элемент, который убил бота
*'''weapon''': Идентификатор оружия, используемого для убийства бота
*'''bodypart''': Идентификатор части тела, в который попали, чтобы убить бота
<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который умер

==onBotSpawned==
Это срабатывает, когда появляется бот.

<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который спавнился.

==onBotFollow==
Это срабатывает, когда бот начинает следовать за товарищем по команде

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element leader
</syntaxhighlight>
*'''leader''': Игрок или Ped бот начал следовать за ним
<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который начинает следовать за товарищем по команде

=Server Functions=
All of these funtions will have to be used through the [[call]] function, otherwise they won't work

==spawnBot==
This function spawns a bot ingame, will return the bot element, or false if there was a problem.

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
element spawnBot ( float x, float y, float z, int rotation = 0, [ int skinID = 0, int interior = 0, int dimension = 0, team theTeam = nil, int weapon = 0, string theMode = "hunting", element theModesubject = nil ] )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''x:''' The x co-ordinate to spawn the bot at
*'''y:''' The y co-ordinate to spawn the bot at
*'''z:''' The z co-ordinate to spawn the bot at
*'''rotation:''' Rotation of the bot on spawn

<big>'''Optional Arguments'''</big>
*'''skinID:''' Bots skin on spawn
*'''interior:''' Interior the bot will spawn into
*'''dimension:''' The ID of the [[dimension]] that the bot should be in
*'''theTeam:''' The team the bot will join
*'''weapon:''' The weapon the ped will carry
*'''theMode:''' The action the bot will be performing when spawned (see "modes of playing" above)
*'''theModeSubject:''' If theMode is "chasing" or "following" this arg is needed to tell the bot what opponent to chase or teammate to follow

==setBotHunt==
makes the bot travel pathways untill finding an enemy or teammate

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotHunt ( element theBot )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to hunt

==setBotWait==
makes the bot stand still untill an enemy of teammate comes into view

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotWait ( element theBot )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to wait

==setBotChase==
makes the bot attack an anemy bot or player

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotChase ( element theBot, element theTarget )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot that you want to do the chasing
*'''theTarget:''' The bot or player you want to be chased

==setBotFollow==
makes the bot follow a teammate bot or player

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotFollow( element theBot, element theTarget )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot that you want to do the following
*'''theTarget:''' The bot or player you want to be followed

==setBotGuard==
makes the bot move to the specific coords and stay there while attacking any enemies

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotGuard( element theBot, float x, float y, float z, [ bool priority = false ] )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to do the guarding
*'''x:''' The X coords you want the bot to guard
*'''y:''' The Y coords you want the bot to guard
*'''z:''' The Z coords you want the bot to guard

<big>'''Optional Arguments'''</big>
*'''priority:''' Set to true only if you want the bot to only shoot once it has reached the location to guard

==getBotTeam==
returns the Team the bot is on, false if no team

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
string getBotTeam ( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check the team of

==setBotTeam==
changes the bot's team and loyalties

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotTeam ( element theBot, team theTeam )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to change the team of
*'''theTeam:''' The team the bot should join

==getBotAttackEnabled==
returns true if the bot is allowed to attack, false otherwise

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool getBotAttackEnabled( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check if it can atack

==setBotAttackEnabled==
allow or disallow the bot to attack (press fire)

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotAttackEnabled( element theBot, bool enabled)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to set if it can atack
*'''enabled:''' set to false to remove the bots ability to attack, true to allow it

==getBotMode==
returns the mode the bot is in ("chasing", "waiting", "guarding", "hunting", "following") or if the bot is chasing or following, it will return the mode and the target

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
string getBotMode( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check the status of

==isPedBot==
returns true if the ped is a bot, false otherwise

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool isPedbot( element thePed)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''thePed:''' The ped you want to check if its a bot

==setBotWeapon==
sets the bot's weapon id (ammo is always infinite)

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotWeapon( element theBot, float weapon)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to set the weapon of
*'''weapon:''' the weapon id you want to give the bot

=Credits=
*'''Slothman:''' Bot creator, main scripter
*'''Gamesnert:''' EDF creator, scripting, testing
*'''Dragon:''' Gamemode creator, testing, scripting help
*'''EvGeniz:''' early testing, mapping
'''Thanks to Everyone else who made suggestions, tested the script, helped when i was stuck, etc'''
[[Category:Resource]]

[[en:Slothman/Slothbot]]

RU/Slothbot

2020-04-23T12:47:30Z

Baloo Pro: /* onBotFindEnemy */

<pageclass class="resource" subcaption="Resource"></pageclass>

{{translate|ru}}

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

=Особенности=
'''Командная игра:'''
Бот способен отличать врага от союзника.

'''Навигация по карте:'''
Если бот будет заспаунен на карте без специальных путей, он сможет двигаться самостоятельно и искать врагов, но не так ловко.

'''Агрессивность:'''
Эти боты атакуют игроков и ботов состоящих в других командах.

'''Кооператив:'''
При обнаружении союзника, боты могут автоматически объединяться в команду с ним.

'''Подвижность и ловкость:'''
Если на пути бота появятся препятствия он попытается обойти их или перепрыгнуть.

'''Типы игры ботов:'''
*"hunting" - ("Охота") бот следует по указанному пути и выискивает врага.
*"waiting" - ("Выжидание") бот стоит на месте пока в поле его зрения не появится враг.
*"guarding" - ("Охрана") бот не двигается с места и атакует врага если тот находится в поле его зрения.
*"following" - ("Следование") бот следует за союзником (игроком/ботом) и атакует врагов в поле зрения.
*"chasing" - ("Преследование") бот преследует врага и атакует его.

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

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

=События Сервера=

==onBotFindEnemy==
Это условие вызывается когда бот находит врага. Оно может быть отменено, чтобы бот никого не атаковал.

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element enemy
</syntaxhighlight>
*'''enemy''': Игрок или бот являющийся врагом.
<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который нашел врага

==onBotWasted==
Это срабатывает, когда бот убит.

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element attacker, float weapon, float bodypart
</syntaxhighlight>
*'''attacker''': Элемент, который убил бота
*'''weapon''': Идентификатор оружия, используемого для убийства бота
*'''bodypart''': Идентификатор части тела, в который попали, чтобы убить бота
<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который умер

==onBotSpawned==
Это срабатывает, когда появляется бот.

<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который спавнился.

==onBotFollow==
This triggers when a bot starts following a teammate

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element leader
</syntaxhighlight>
*'''leader''': The Player or Ped the bot has started following
<big>'''Source'''</big>

The [[event system#Event source|source]] of this event is the Bot that starts following a teammate

=Server Functions=
All of these funtions will have to be used through the [[call]] function, otherwise they won't work

==spawnBot==
This function spawns a bot ingame, will return the bot element, or false if there was a problem.

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
element spawnBot ( float x, float y, float z, int rotation = 0, [ int skinID = 0, int interior = 0, int dimension = 0, team theTeam = nil, int weapon = 0, string theMode = "hunting", element theModesubject = nil ] )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''x:''' The x co-ordinate to spawn the bot at
*'''y:''' The y co-ordinate to spawn the bot at
*'''z:''' The z co-ordinate to spawn the bot at
*'''rotation:''' Rotation of the bot on spawn

<big>'''Optional Arguments'''</big>
*'''skinID:''' Bots skin on spawn
*'''interior:''' Interior the bot will spawn into
*'''dimension:''' The ID of the [[dimension]] that the bot should be in
*'''theTeam:''' The team the bot will join
*'''weapon:''' The weapon the ped will carry
*'''theMode:''' The action the bot will be performing when spawned (see "modes of playing" above)
*'''theModeSubject:''' If theMode is "chasing" or "following" this arg is needed to tell the bot what opponent to chase or teammate to follow

==setBotHunt==
makes the bot travel pathways untill finding an enemy or teammate

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotHunt ( element theBot )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to hunt

==setBotWait==
makes the bot stand still untill an enemy of teammate comes into view

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotWait ( element theBot )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to wait

==setBotChase==
makes the bot attack an anemy bot or player

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotChase ( element theBot, element theTarget )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot that you want to do the chasing
*'''theTarget:''' The bot or player you want to be chased

==setBotFollow==
makes the bot follow a teammate bot or player

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotFollow( element theBot, element theTarget )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot that you want to do the following
*'''theTarget:''' The bot or player you want to be followed

==setBotGuard==
makes the bot move to the specific coords and stay there while attacking any enemies

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotGuard( element theBot, float x, float y, float z, [ bool priority = false ] )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to do the guarding
*'''x:''' The X coords you want the bot to guard
*'''y:''' The Y coords you want the bot to guard
*'''z:''' The Z coords you want the bot to guard

<big>'''Optional Arguments'''</big>
*'''priority:''' Set to true only if you want the bot to only shoot once it has reached the location to guard

==getBotTeam==
returns the Team the bot is on, false if no team

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
string getBotTeam ( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check the team of

==setBotTeam==
changes the bot's team and loyalties

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotTeam ( element theBot, team theTeam )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to change the team of
*'''theTeam:''' The team the bot should join

==getBotAttackEnabled==
returns true if the bot is allowed to attack, false otherwise

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool getBotAttackEnabled( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check if it can atack

==setBotAttackEnabled==
allow or disallow the bot to attack (press fire)

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotAttackEnabled( element theBot, bool enabled)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to set if it can atack
*'''enabled:''' set to false to remove the bots ability to attack, true to allow it

==getBotMode==
returns the mode the bot is in ("chasing", "waiting", "guarding", "hunting", "following") or if the bot is chasing or following, it will return the mode and the target

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
string getBotMode( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check the status of

==isPedBot==
returns true if the ped is a bot, false otherwise

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool isPedbot( element thePed)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''thePed:''' The ped you want to check if its a bot

==setBotWeapon==
sets the bot's weapon id (ammo is always infinite)

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotWeapon( element theBot, float weapon)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to set the weapon of
*'''weapon:''' the weapon id you want to give the bot

=Credits=
*'''Slothman:''' Bot creator, main scripter
*'''Gamesnert:''' EDF creator, scripting, testing
*'''Dragon:''' Gamemode creator, testing, scripting help
*'''EvGeniz:''' early testing, mapping
'''Thanks to Everyone else who made suggestions, tested the script, helped when i was stuck, etc'''
[[Category:Resource]]

[[en:Slothman/Slothbot]]

RU/Slothbot

2020-04-23T12:45:08Z

Baloo Pro: /* onBotSpawned */

<pageclass class="resource" subcaption="Resource"></pageclass>

{{translate|ru}}

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

=Особенности=
'''Командная игра:'''
Бот способен отличать врага от союзника.

'''Навигация по карте:'''
Если бот будет заспаунен на карте без специальных путей, он сможет двигаться самостоятельно и искать врагов, но не так ловко.

'''Агрессивность:'''
Эти боты атакуют игроков и ботов состоящих в других командах.

'''Кооператив:'''
При обнаружении союзника, боты могут автоматически объединяться в команду с ним.

'''Подвижность и ловкость:'''
Если на пути бота появятся препятствия он попытается обойти их или перепрыгнуть.

'''Типы игры ботов:'''
*"hunting" - ("Охота") бот следует по указанному пути и выискивает врага.
*"waiting" - ("Выжидание") бот стоит на месте пока в поле его зрения не появится враг.
*"guarding" - ("Охрана") бот не двигается с места и атакует врага если тот находится в поле его зрения.
*"following" - ("Следование") бот следует за союзником (игроком/ботом) и атакует врагов в поле зрения.
*"chasing" - ("Преследование") бот преследует врага и атакует его.

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

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

=События Сервера=

==onBotFindEnemy==
Это условие вызывается когда бот находит врага. Оно может быть отменено, чтобы бот никого не атаковал.

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element enemy
</syntaxhighlight>
*'''enemy''': Игрок или бот являющийся врагом.
<big>'''Source'''</big>

The [[event system#Event source|source]] of this event is the Bot that has found an enemy

==onBotWasted==
Это срабатывает, когда бот убит.

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element attacker, float weapon, float bodypart
</syntaxhighlight>
*'''attacker''': Элемент, который убил бота
*'''weapon''': Идентификатор оружия, используемого для убийства бота
*'''bodypart''': Идентификатор части тела, в который попали, чтобы убить бота
<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который умер

==onBotSpawned==
Это срабатывает, когда появляется бот.

<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который спавнился.

==onBotFollow==
This triggers when a bot starts following a teammate

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element leader
</syntaxhighlight>
*'''leader''': The Player or Ped the bot has started following
<big>'''Source'''</big>

The [[event system#Event source|source]] of this event is the Bot that starts following a teammate

=Server Functions=
All of these funtions will have to be used through the [[call]] function, otherwise they won't work

==spawnBot==
This function spawns a bot ingame, will return the bot element, or false if there was a problem.

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
element spawnBot ( float x, float y, float z, int rotation = 0, [ int skinID = 0, int interior = 0, int dimension = 0, team theTeam = nil, int weapon = 0, string theMode = "hunting", element theModesubject = nil ] )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''x:''' The x co-ordinate to spawn the bot at
*'''y:''' The y co-ordinate to spawn the bot at
*'''z:''' The z co-ordinate to spawn the bot at
*'''rotation:''' Rotation of the bot on spawn

<big>'''Optional Arguments'''</big>
*'''skinID:''' Bots skin on spawn
*'''interior:''' Interior the bot will spawn into
*'''dimension:''' The ID of the [[dimension]] that the bot should be in
*'''theTeam:''' The team the bot will join
*'''weapon:''' The weapon the ped will carry
*'''theMode:''' The action the bot will be performing when spawned (see "modes of playing" above)
*'''theModeSubject:''' If theMode is "chasing" or "following" this arg is needed to tell the bot what opponent to chase or teammate to follow

==setBotHunt==
makes the bot travel pathways untill finding an enemy or teammate

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotHunt ( element theBot )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to hunt

==setBotWait==
makes the bot stand still untill an enemy of teammate comes into view

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotWait ( element theBot )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to wait

==setBotChase==
makes the bot attack an anemy bot or player

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotChase ( element theBot, element theTarget )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot that you want to do the chasing
*'''theTarget:''' The bot or player you want to be chased

==setBotFollow==
makes the bot follow a teammate bot or player

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotFollow( element theBot, element theTarget )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot that you want to do the following
*'''theTarget:''' The bot or player you want to be followed

==setBotGuard==
makes the bot move to the specific coords and stay there while attacking any enemies

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotGuard( element theBot, float x, float y, float z, [ bool priority = false ] )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to do the guarding
*'''x:''' The X coords you want the bot to guard
*'''y:''' The Y coords you want the bot to guard
*'''z:''' The Z coords you want the bot to guard

<big>'''Optional Arguments'''</big>
*'''priority:''' Set to true only if you want the bot to only shoot once it has reached the location to guard

==getBotTeam==
returns the Team the bot is on, false if no team

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
string getBotTeam ( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check the team of

==setBotTeam==
changes the bot's team and loyalties

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotTeam ( element theBot, team theTeam )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to change the team of
*'''theTeam:''' The team the bot should join

==getBotAttackEnabled==
returns true if the bot is allowed to attack, false otherwise

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool getBotAttackEnabled( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check if it can atack

==setBotAttackEnabled==
allow or disallow the bot to attack (press fire)

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotAttackEnabled( element theBot, bool enabled)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to set if it can atack
*'''enabled:''' set to false to remove the bots ability to attack, true to allow it

==getBotMode==
returns the mode the bot is in ("chasing", "waiting", "guarding", "hunting", "following") or if the bot is chasing or following, it will return the mode and the target

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
string getBotMode( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check the status of

==isPedBot==
returns true if the ped is a bot, false otherwise

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool isPedbot( element thePed)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''thePed:''' The ped you want to check if its a bot

==setBotWeapon==
sets the bot's weapon id (ammo is always infinite)

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotWeapon( element theBot, float weapon)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to set the weapon of
*'''weapon:''' the weapon id you want to give the bot

=Credits=
*'''Slothman:''' Bot creator, main scripter
*'''Gamesnert:''' EDF creator, scripting, testing
*'''Dragon:''' Gamemode creator, testing, scripting help
*'''EvGeniz:''' early testing, mapping
'''Thanks to Everyone else who made suggestions, tested the script, helped when i was stuck, etc'''
[[Category:Resource]]

[[en:Slothman/Slothbot]]

RU/Slothbot

2020-04-23T12:44:31Z

Baloo Pro: /* onBotSpawned */

<pageclass class="resource" subcaption="Resource"></pageclass>

{{translate|ru}}

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

=Особенности=
'''Командная игра:'''
Бот способен отличать врага от союзника.

'''Навигация по карте:'''
Если бот будет заспаунен на карте без специальных путей, он сможет двигаться самостоятельно и искать врагов, но не так ловко.

'''Агрессивность:'''
Эти боты атакуют игроков и ботов состоящих в других командах.

'''Кооператив:'''
При обнаружении союзника, боты могут автоматически объединяться в команду с ним.

'''Подвижность и ловкость:'''
Если на пути бота появятся препятствия он попытается обойти их или перепрыгнуть.

'''Типы игры ботов:'''
*"hunting" - ("Охота") бот следует по указанному пути и выискивает врага.
*"waiting" - ("Выжидание") бот стоит на месте пока в поле его зрения не появится враг.
*"guarding" - ("Охрана") бот не двигается с места и атакует врага если тот находится в поле его зрения.
*"following" - ("Следование") бот следует за союзником (игроком/ботом) и атакует врагов в поле зрения.
*"chasing" - ("Преследование") бот преследует врага и атакует его.

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

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

=События Сервера=

==onBotFindEnemy==
Это условие вызывается когда бот находит врага. Оно может быть отменено, чтобы бот никого не атаковал.

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element enemy
</syntaxhighlight>
*'''enemy''': Игрок или бот являющийся врагом.
<big>'''Source'''</big>

The [[event system#Event source|source]] of this event is the Bot that has found an enemy

==onBotWasted==
Это срабатывает, когда бот убит.

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element attacker, float weapon, float bodypart
</syntaxhighlight>
*'''attacker''': Элемент, который убил бота
*'''weapon''': Идентификатор оружия, используемого для убийства бота
*'''bodypart''': Идентификатор части тела, в который попали, чтобы убить бота
<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который умер

==onBotSpawned==
Это срабатывает, когда появляется бот.

[[Event system#Event source|source]] этого события является бот, который спавнился.

==onBotFollow==
This triggers when a bot starts following a teammate

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element leader
</syntaxhighlight>
*'''leader''': The Player or Ped the bot has started following
<big>'''Source'''</big>

The [[event system#Event source|source]] of this event is the Bot that starts following a teammate

=Server Functions=
All of these funtions will have to be used through the [[call]] function, otherwise they won't work

==spawnBot==
This function spawns a bot ingame, will return the bot element, or false if there was a problem.

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
element spawnBot ( float x, float y, float z, int rotation = 0, [ int skinID = 0, int interior = 0, int dimension = 0, team theTeam = nil, int weapon = 0, string theMode = "hunting", element theModesubject = nil ] )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''x:''' The x co-ordinate to spawn the bot at
*'''y:''' The y co-ordinate to spawn the bot at
*'''z:''' The z co-ordinate to spawn the bot at
*'''rotation:''' Rotation of the bot on spawn

<big>'''Optional Arguments'''</big>
*'''skinID:''' Bots skin on spawn
*'''interior:''' Interior the bot will spawn into
*'''dimension:''' The ID of the [[dimension]] that the bot should be in
*'''theTeam:''' The team the bot will join
*'''weapon:''' The weapon the ped will carry
*'''theMode:''' The action the bot will be performing when spawned (see "modes of playing" above)
*'''theModeSubject:''' If theMode is "chasing" or "following" this arg is needed to tell the bot what opponent to chase or teammate to follow

==setBotHunt==
makes the bot travel pathways untill finding an enemy or teammate

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotHunt ( element theBot )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to hunt

==setBotWait==
makes the bot stand still untill an enemy of teammate comes into view

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotWait ( element theBot )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to wait

==setBotChase==
makes the bot attack an anemy bot or player

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotChase ( element theBot, element theTarget )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot that you want to do the chasing
*'''theTarget:''' The bot or player you want to be chased

==setBotFollow==
makes the bot follow a teammate bot or player

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotFollow( element theBot, element theTarget )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot that you want to do the following
*'''theTarget:''' The bot or player you want to be followed

==setBotGuard==
makes the bot move to the specific coords and stay there while attacking any enemies

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotGuard( element theBot, float x, float y, float z, [ bool priority = false ] )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to do the guarding
*'''x:''' The X coords you want the bot to guard
*'''y:''' The Y coords you want the bot to guard
*'''z:''' The Z coords you want the bot to guard

<big>'''Optional Arguments'''</big>
*'''priority:''' Set to true only if you want the bot to only shoot once it has reached the location to guard

==getBotTeam==
returns the Team the bot is on, false if no team

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
string getBotTeam ( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check the team of

==setBotTeam==
changes the bot's team and loyalties

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotTeam ( element theBot, team theTeam )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to change the team of
*'''theTeam:''' The team the bot should join

==getBotAttackEnabled==
returns true if the bot is allowed to attack, false otherwise

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool getBotAttackEnabled( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check if it can atack

==setBotAttackEnabled==
allow or disallow the bot to attack (press fire)

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotAttackEnabled( element theBot, bool enabled)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to set if it can atack
*'''enabled:''' set to false to remove the bots ability to attack, true to allow it

==getBotMode==
returns the mode the bot is in ("chasing", "waiting", "guarding", "hunting", "following") or if the bot is chasing or following, it will return the mode and the target

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
string getBotMode( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check the status of

==isPedBot==
returns true if the ped is a bot, false otherwise

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool isPedbot( element thePed)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''thePed:''' The ped you want to check if its a bot

==setBotWeapon==
sets the bot's weapon id (ammo is always infinite)

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotWeapon( element theBot, float weapon)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to set the weapon of
*'''weapon:''' the weapon id you want to give the bot

=Credits=
*'''Slothman:''' Bot creator, main scripter
*'''Gamesnert:''' EDF creator, scripting, testing
*'''Dragon:''' Gamemode creator, testing, scripting help
*'''EvGeniz:''' early testing, mapping
'''Thanks to Everyone else who made suggestions, tested the script, helped when i was stuck, etc'''
[[Category:Resource]]

[[en:Slothman/Slothbot]]

RU/Slothbot

2020-04-23T12:43:29Z

Baloo Pro: /* onBotSpawned */

<pageclass class="resource" subcaption="Resource"></pageclass>

{{translate|ru}}

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

=Особенности=
'''Командная игра:'''
Бот способен отличать врага от союзника.

'''Навигация по карте:'''
Если бот будет заспаунен на карте без специальных путей, он сможет двигаться самостоятельно и искать врагов, но не так ловко.

'''Агрессивность:'''
Эти боты атакуют игроков и ботов состоящих в других командах.

'''Кооператив:'''
При обнаружении союзника, боты могут автоматически объединяться в команду с ним.

'''Подвижность и ловкость:'''
Если на пути бота появятся препятствия он попытается обойти их или перепрыгнуть.

'''Типы игры ботов:'''
*"hunting" - ("Охота") бот следует по указанному пути и выискивает врага.
*"waiting" - ("Выжидание") бот стоит на месте пока в поле его зрения не появится враг.
*"guarding" - ("Охрана") бот не двигается с места и атакует врага если тот находится в поле его зрения.
*"following" - ("Следование") бот следует за союзником (игроком/ботом) и атакует врагов в поле зрения.
*"chasing" - ("Преследование") бот преследует врага и атакует его.

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

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

=События Сервера=

==onBotFindEnemy==
Это условие вызывается когда бот находит врага. Оно может быть отменено, чтобы бот никого не атаковал.

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element enemy
</syntaxhighlight>
*'''enemy''': Игрок или бот являющийся врагом.
<big>'''Source'''</big>

The [[event system#Event source|source]] of this event is the Bot that has found an enemy

==onBotWasted==
Это срабатывает, когда бот убит.

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element attacker, float weapon, float bodypart
</syntaxhighlight>
*'''attacker''': Элемент, который убил бота
*'''weapon''': Идентификатор оружия, используемого для убийства бота
*'''bodypart''': Идентификатор части тела, в который попали, чтобы убить бота
<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который умер

==onBotSpawned==
Это срабатывает, когда появляется бот.

<big>'''Source'''</big>
[[Event system#Event source|source]] этого события является бот, который спавнился.

==onBotFollow==
This triggers when a bot starts following a teammate

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element leader
</syntaxhighlight>
*'''leader''': The Player or Ped the bot has started following
<big>'''Source'''</big>

The [[event system#Event source|source]] of this event is the Bot that starts following a teammate

=Server Functions=
All of these funtions will have to be used through the [[call]] function, otherwise they won't work

==spawnBot==
This function spawns a bot ingame, will return the bot element, or false if there was a problem.

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
element spawnBot ( float x, float y, float z, int rotation = 0, [ int skinID = 0, int interior = 0, int dimension = 0, team theTeam = nil, int weapon = 0, string theMode = "hunting", element theModesubject = nil ] )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''x:''' The x co-ordinate to spawn the bot at
*'''y:''' The y co-ordinate to spawn the bot at
*'''z:''' The z co-ordinate to spawn the bot at
*'''rotation:''' Rotation of the bot on spawn

<big>'''Optional Arguments'''</big>
*'''skinID:''' Bots skin on spawn
*'''interior:''' Interior the bot will spawn into
*'''dimension:''' The ID of the [[dimension]] that the bot should be in
*'''theTeam:''' The team the bot will join
*'''weapon:''' The weapon the ped will carry
*'''theMode:''' The action the bot will be performing when spawned (see "modes of playing" above)
*'''theModeSubject:''' If theMode is "chasing" or "following" this arg is needed to tell the bot what opponent to chase or teammate to follow

==setBotHunt==
makes the bot travel pathways untill finding an enemy or teammate

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotHunt ( element theBot )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to hunt

==setBotWait==
makes the bot stand still untill an enemy of teammate comes into view

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotWait ( element theBot )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to wait

==setBotChase==
makes the bot attack an anemy bot or player

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotChase ( element theBot, element theTarget )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot that you want to do the chasing
*'''theTarget:''' The bot or player you want to be chased

==setBotFollow==
makes the bot follow a teammate bot or player

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotFollow( element theBot, element theTarget )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot that you want to do the following
*'''theTarget:''' The bot or player you want to be followed

==setBotGuard==
makes the bot move to the specific coords and stay there while attacking any enemies

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotGuard( element theBot, float x, float y, float z, [ bool priority = false ] )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to do the guarding
*'''x:''' The X coords you want the bot to guard
*'''y:''' The Y coords you want the bot to guard
*'''z:''' The Z coords you want the bot to guard

<big>'''Optional Arguments'''</big>
*'''priority:''' Set to true only if you want the bot to only shoot once it has reached the location to guard

==getBotTeam==
returns the Team the bot is on, false if no team

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
string getBotTeam ( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check the team of

==setBotTeam==
changes the bot's team and loyalties

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotTeam ( element theBot, team theTeam )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to change the team of
*'''theTeam:''' The team the bot should join

==getBotAttackEnabled==
returns true if the bot is allowed to attack, false otherwise

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool getBotAttackEnabled( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check if it can atack

==setBotAttackEnabled==
allow or disallow the bot to attack (press fire)

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotAttackEnabled( element theBot, bool enabled)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to set if it can atack
*'''enabled:''' set to false to remove the bots ability to attack, true to allow it

==getBotMode==
returns the mode the bot is in ("chasing", "waiting", "guarding", "hunting", "following") or if the bot is chasing or following, it will return the mode and the target

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
string getBotMode( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check the status of

==isPedBot==
returns true if the ped is a bot, false otherwise

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool isPedbot( element thePed)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''thePed:''' The ped you want to check if its a bot

==setBotWeapon==
sets the bot's weapon id (ammo is always infinite)

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotWeapon( element theBot, float weapon)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to set the weapon of
*'''weapon:''' the weapon id you want to give the bot

=Credits=
*'''Slothman:''' Bot creator, main scripter
*'''Gamesnert:''' EDF creator, scripting, testing
*'''Dragon:''' Gamemode creator, testing, scripting help
*'''EvGeniz:''' early testing, mapping
'''Thanks to Everyone else who made suggestions, tested the script, helped when i was stuck, etc'''
[[Category:Resource]]

[[en:Slothman/Slothbot]]

RU/Slothbot

2020-04-23T12:42:31Z

Baloo Pro: /* onBotWasted */

<pageclass class="resource" subcaption="Resource"></pageclass>

{{translate|ru}}

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

=Особенности=
'''Командная игра:'''
Бот способен отличать врага от союзника.

'''Навигация по карте:'''
Если бот будет заспаунен на карте без специальных путей, он сможет двигаться самостоятельно и искать врагов, но не так ловко.

'''Агрессивность:'''
Эти боты атакуют игроков и ботов состоящих в других командах.

'''Кооператив:'''
При обнаружении союзника, боты могут автоматически объединяться в команду с ним.

'''Подвижность и ловкость:'''
Если на пути бота появятся препятствия он попытается обойти их или перепрыгнуть.

'''Типы игры ботов:'''
*"hunting" - ("Охота") бот следует по указанному пути и выискивает врага.
*"waiting" - ("Выжидание") бот стоит на месте пока в поле его зрения не появится враг.
*"guarding" - ("Охрана") бот не двигается с места и атакует врага если тот находится в поле его зрения.
*"following" - ("Следование") бот следует за союзником (игроком/ботом) и атакует врагов в поле зрения.
*"chasing" - ("Преследование") бот преследует врага и атакует его.

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

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

=События Сервера=

==onBotFindEnemy==
Это условие вызывается когда бот находит врага. Оно может быть отменено, чтобы бот никого не атаковал.

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element enemy
</syntaxhighlight>
*'''enemy''': Игрок или бот являющийся врагом.
<big>'''Source'''</big>

The [[event system#Event source|source]] of this event is the Bot that has found an enemy

==onBotWasted==
Это срабатывает, когда бот убит.

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element attacker, float weapon, float bodypart
</syntaxhighlight>
*'''attacker''': Элемент, который убил бота
*'''weapon''': Идентификатор оружия, используемого для убийства бота
*'''bodypart''': Идентификатор части тела, в который попали, чтобы убить бота
<big>'''Source'''</big>

[[Event system#Event source|source]] этого события является бот, который умер

==onBotSpawned==
This triggers when a bot is spawned.

<big>'''Source'''</big>
The [[event system#Event source|source]] of this event is the Bot that spawned

==onBotFollow==
This triggers when a bot starts following a teammate

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element leader
</syntaxhighlight>
*'''leader''': The Player or Ped the bot has started following
<big>'''Source'''</big>

The [[event system#Event source|source]] of this event is the Bot that starts following a teammate

=Server Functions=
All of these funtions will have to be used through the [[call]] function, otherwise they won't work

==spawnBot==
This function spawns a bot ingame, will return the bot element, or false if there was a problem.

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
element spawnBot ( float x, float y, float z, int rotation = 0, [ int skinID = 0, int interior = 0, int dimension = 0, team theTeam = nil, int weapon = 0, string theMode = "hunting", element theModesubject = nil ] )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''x:''' The x co-ordinate to spawn the bot at
*'''y:''' The y co-ordinate to spawn the bot at
*'''z:''' The z co-ordinate to spawn the bot at
*'''rotation:''' Rotation of the bot on spawn

<big>'''Optional Arguments'''</big>
*'''skinID:''' Bots skin on spawn
*'''interior:''' Interior the bot will spawn into
*'''dimension:''' The ID of the [[dimension]] that the bot should be in
*'''theTeam:''' The team the bot will join
*'''weapon:''' The weapon the ped will carry
*'''theMode:''' The action the bot will be performing when spawned (see "modes of playing" above)
*'''theModeSubject:''' If theMode is "chasing" or "following" this arg is needed to tell the bot what opponent to chase or teammate to follow

==setBotHunt==
makes the bot travel pathways untill finding an enemy or teammate

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotHunt ( element theBot )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to hunt

==setBotWait==
makes the bot stand still untill an enemy of teammate comes into view

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotWait ( element theBot )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to wait

==setBotChase==
makes the bot attack an anemy bot or player

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotChase ( element theBot, element theTarget )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot that you want to do the chasing
*'''theTarget:''' The bot or player you want to be chased

==setBotFollow==
makes the bot follow a teammate bot or player

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotFollow( element theBot, element theTarget )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot that you want to do the following
*'''theTarget:''' The bot or player you want to be followed

==setBotGuard==
makes the bot move to the specific coords and stay there while attacking any enemies

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotGuard( element theBot, float x, float y, float z, [ bool priority = false ] )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to do the guarding
*'''x:''' The X coords you want the bot to guard
*'''y:''' The Y coords you want the bot to guard
*'''z:''' The Z coords you want the bot to guard

<big>'''Optional Arguments'''</big>
*'''priority:''' Set to true only if you want the bot to only shoot once it has reached the location to guard

==getBotTeam==
returns the Team the bot is on, false if no team

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
string getBotTeam ( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check the team of

==setBotTeam==
changes the bot's team and loyalties

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotTeam ( element theBot, team theTeam )
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to change the team of
*'''theTeam:''' The team the bot should join

==getBotAttackEnabled==
returns true if the bot is allowed to attack, false otherwise

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool getBotAttackEnabled( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check if it can atack

==setBotAttackEnabled==
allow or disallow the bot to attack (press fire)

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotAttackEnabled( element theBot, bool enabled)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to set if it can atack
*'''enabled:''' set to false to remove the bots ability to attack, true to allow it

==getBotMode==
returns the mode the bot is in ("chasing", "waiting", "guarding", "hunting", "following") or if the bot is chasing or following, it will return the mode and the target

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
string getBotMode( element theBot)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to check the status of

==isPedBot==
returns true if the ped is a bot, false otherwise

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool isPedbot( element thePed)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''thePed:''' The ped you want to check if its a bot

==setBotWeapon==
sets the bot's weapon id (ammo is always infinite)

<big>'''Syntax'''</big>
<syntaxhighlight lang="lua">
bool setBotWeapon( element theBot, float weapon)
</syntaxhighlight>

<big>'''Required Arguments'''</big>
*'''theBot:''' The bot you want to set the weapon of
*'''weapon:''' the weapon id you want to give the bot

=Credits=
*'''Slothman:''' Bot creator, main scripter
*'''Gamesnert:''' EDF creator, scripting, testing
*'''Dragon:''' Gamemode creator, testing, scripting help
*'''EvGeniz:''' early testing, mapping
'''Thanks to Everyone else who made suggestions, tested the script, helped when i was stuck, etc'''
[[Category:Resource]]

[[en:Slothman/Slothbot]]