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

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

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

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

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

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

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

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

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

'''EDF for map path creation:'''
Integrated into the map editor, map designers can easily place paths for bots to follow along in their maps. this greatly increased the bots ability to simulate true playing.

=Server Events=

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

<big>'''Параметры'''</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''': Игрок/Бот/Элемент убивший sloth-бота.
*'''weapon''': Орудие убийства.
*'''bodypart''': Часть тела в которую sloth-бот был убит.
<big>'''Source'''</big>

The [[event system#Event source|source]] of this event is the Bot that died

==onBotSpawned==
Это условие вызывается когда бот возраждается.

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

==onBotFollow==
Это условие вызывается когда бот следует за союзником.

<big>'''Parameters'''</big>
<syntaxhighlight lang="lua">
element leader
</syntaxhighlight>
*'''leader''': Союзник за которым следует sloth-бот
<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:RU/Resource]]

[[en:Slothman/Slothbot]]