RU/Slothbot
Этот ресурс разработан для создания виртуального игрока (бота), который может выполнять некоторые задачи реального игрока (стрелять по врагу, следовать за союзником, искать врага, ходить по путям(вайпоинтам) )
Особенности
Командная игра: Бот способен отличать врага от союзника.
Навигация по карте: Если бот будет заспаунен на карте без специальных путей, он сможет двигаться самостоятельно и искать врагов, но не так ловко.
Агрессивность: Эти боты атакуют игроков и ботов состоящих в других командах.
Кооператив: При обнаружении союзника, боты могут автоматически объединяться в команду с ним.
Подвижность и ловкость: Если на пути бота появятся препятствия он попытается обойти их или перепрыгнуть.
Типы игры ботов:
- "hunting" - ("рус. Охота") бот следует по указанному пути и выискивает врага.
- "waiting" - ("рус. Выжидание") бот стоит на месте пока в поле его зрения не появится враг.
- "guarding" - ("рус. Охрана") бот не двигается с места и атакует врага если тот находится в поле его зрения.
- "following" - ("рус. Следование") бот следует за союзником (игроком/ботом) и атакует врагов в поле зрения.
- "chasing" - ("рус. Преследование") бот преследует врага и атакует его.
Gamemode/Script integration: This script provides several functions and events to allow other resources to see and control what the bot's are doing, and even take control of certain behaviour.
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
Это условие вызывается когда бот находит врага. Оно может быть отменено, чтобы бот никого не атаковал
Параметры
element enemy
- enemy: Игрок или бот являющийся врагом
Source
The source of this event is the Bot that has found an enemy
onBotWasted
Это условие вызывается когда бот умирает.
Parameters
element attacker, float weapon, float bodypart
- attacker: Игрок/Бот/Элемент убивший sloth-бота.
- weapon: Орудие убийства.
- bodypart: Часть тела в которую sloth-бот был убит.
Source
The source of this event is the Bot that died
onBotSpawned
Это условие вызывается когда бот возраждается.
Source The source of this event is the Bot that spawned
onBotFollow
Это условие вызывается когда бот следует за союзником.
Parameters
element leader
- leader: Союзник за которым следует sloth-бот
Source
The 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.
Syntax
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 ] )
Required Arguments
- 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
Optional Arguments
- 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
Syntax
bool setBotHunt ( element theBot )
Required Arguments
- theBot: The bot you want to hunt
setBotWait
makes the bot stand still untill an enemy of teammate comes into view
Syntax
bool setBotWait ( element theBot )
Required Arguments
- theBot: The bot you want to wait
setBotChase
makes the bot attack an anemy bot or player
Syntax
bool setBotChase ( element theBot, element theTarget )
Required Arguments
- 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
Syntax
bool setBotFollow( element theBot, element theTarget )
Required Arguments
- 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
Syntax
bool setBotGuard( element theBot, float x, float y, float z, [ bool priority = false ] )
Required Arguments
- 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
Optional Arguments
- 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
Syntax
string getBotTeam ( element theBot)
Required Arguments
- theBot: The bot you want to check the team of
setBotTeam
changes the bot's team and loyalties
Syntax
bool setBotTeam ( element theBot, team theTeam )
Required Arguments
- 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
Syntax
bool getBotAttackEnabled( element theBot)
Required Arguments
- theBot: The bot you want to check if it can atack
setBotAttackEnabled
allow or disallow the bot to attack (press fire)
Syntax
bool setBotAttackEnabled( element theBot, bool enabled)
Required Arguments
- 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
Syntax
string getBotMode( element theBot)
Required Arguments
- theBot: The bot you want to check the status of
isPedBot
returns true if the ped is a bot, false otherwise
Syntax
bool ispedbot( element thePed)
Required Arguments
- thePed: The ped you want to check if its a bot
setBotWeapon
sets the bot's weapon id (ammo is always infinite)
Syntax
bool setBotWeapon( element theBot, float weapon)
Required Arguments
- 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