Текстовые команды (функции) КБ

Этот сайт лучше всего просматривать в современном браузере с включённым JavaScript.

Текстовые команды (функции) КБ

Vol3k

Текстовые команды (функции) - текстовые команды, которые вы можете использовать внутри командных блоков в качестве условий для проверки, получения данных а так-же арифметики.
Текстовые команды используются в двух форматах - глобальная функция и под.функция.
Глобальная функция записывается через символ “ # ”,а под.функция “ ` ” (клавиша Ё в анг.регистре).

Примеры использования:

Вывести ваш никнейм -
```
#getplayername#
```
Вывести никнейм случайного игрока в мире -
```
#getplayername(`randomplayer`)#
```

Во втором варианте мы сначала запрашиваем ID случайного игрока в мире функцией RANDOMPLAYER. а далее используя его ID - возвращаем и имя через функцию getplayername

*ДОСТУПНЫЕ ТЕКСТОВЫЕ ФУНКЦИИ:*

**Массивы**

- #random(0,100)# - сгенерировать случайное число от 0 до 100. Указать можно любой диапазон чисел.
- #array(0 - 9)# - вернуть данные внутри массива 0 - 9 слот.
- #server(0 - 9)# - вернуть данные внутри массива 0 - 9 слот (сервер).
- #retval(0 - 9)# - возвращаемые параметры для игрока
- #retstr(0-9)# - возвращаемые параметры для игрока текстовые

**Команды**
- #teamOnline(1-10)# - вывести онлайн команды.
- #team# - вернуть ID команды в которой состоит игрок.

**Данные Мира**
- #online# - вывести онлайн мира
- #time# - время мира.
- #weather# - погода мира.
- #GetDistObject(id)# - получить расстояние до объекта

**Данные игрока**
- #GetPlayerName(id)# - получить ник игрока
- #ping# - пинг игрока
- #netstat# - потери пакетов в % (Качество соединения. Идеально: 0%)
- #score# - очки игрока.
- #money# - деньги игрока.
- #health# - здоровье игрока.
- #armour# - броня игрока.
- #playerid# - ID игрока.
- #name# - ник игрока.
- #xyz# - координаты игрока.
- #x# #y# #z# - отдельно координаты игрока по X Y Z
- #speed# - скорость игрока.
- #gun# - ID оружия в руках игрока.
- #fa# - получить значение поворота игрока
- #GetFAPlayer(id)# - получить значение поворота игрока
- #GetDistPlayer(id)# - получить расстояние до игрока
- #wanted# - уровень розыска игрока.
- #skin# - скин игрока.
- #attach(1-10)# - модель аттача в слоте.

**Транспорт**
- #vehicle# - вернуть ID транспорта.
- #vehName# - название транспорта.
- #vehHealth# - здоровье транспорта.
- #vehColor# - цвет транспорта. В RGB формате без { }.
- #VehModel# - модель транспорта в котором сидит игрок
- #getvehmodel(model)# - возвращает модель Транспорта по ID модели
- #vehpos(ID)# - возвращает X Y Z указанного Транспорта
- #GetVehName(id)# - получить название транспорта
- #GetDistVeh(id)# - получить расстояние до транспорта
- #nearveh# - возвращает ID транспортна, рядом с которым вы находитесь (R=3m)

**Оружие**
- #gunName# - название оружия в руке игрока.
- #bodypart# - часть тела в которую нанесли урон.
- #issuerGun# - оружие с какого был нанесен урон.
- #GetGunName(id)# - название оружие по ID
- #gun# - ID оружия в руках игрока.
- #ammo# - кол-во патрон в оружии, которое в руках


**Прочее**
- #randomPlayer# - выбрать случайного игрока в мире.
- #timestamp# - время в секундах от 1970 года.
- #getzoneid(x y)# возвращает номер зоны по координатам
- #zone# - название района в котором игрок (#zone(id)# - узнать зону по ID игрока)
- #getzone(x y)# - возвращает название зоны по X Y
- #getZ(x,y)# - найти высоту рельефа по координатам X Y
- #getdistpos(x y z)# - расстояние от игрока до координат

Vol3k

Использование функции в качестве проверки

Настройка условий >>> Сверять >>> Свое значение
Вставляем внутрь текстовую функцию и возвращаемый параметр будет сверятся с указанным.

Внимание: В случае если вы допустили ошибку или данные нельзя запросить - будет возвращено число 0, а значит сверятся будет 0 с указанным вам значением.

Пример использования:
Для проверки дистанции между игроками, текстовые проверки обязательны. Для проверки, вам понадобиться колбек возвращающий ID игрока, с которым происходит взаимодействие. Например можно использовать: аллиасы, ввод ID через диалог, колбеки урона или ID записаный в один из массивов.

В свое значение вводим:

Сверять: #getdistplayer(retval-0)# // Правильно укажите коллбек игрока, иначе проверка не будет работать
Сверять: Меньше или Равно
Значение: 3

Таким образом, блок будет активироваться когда дистанция между игроками Не более 3х метров.

Goodman

Не отформатированные данные:

#acid# - ID аккаунта игрока из /stats
#afk# - Число в секундах сколько игрок бездействует или в меню.
#ammo# - Число патронов в активном слоте оружия.
#armour# - Уровень брони.
#array(0 - 26)# - Массив игрока /data
#attach(0 - 9 *playerid)# - Модель аттача (id). *playerid - если не указать, вернет ID игрока который вызвал блок.
#ban# - Возвращает 1 если у игрока есть активные варны и 0 если нет.
#bodypart# - ID части тела в которую игрок получил последний урон. Схема
#channel# - Канал рации игрока.

#death# - Сколько осталось секунд стадии игрока. Если он жив - 0.
#drunk# - Уровень оьяениня игрока. Если уровень меньше 2000, игрок трезвый.
#ext(блок0-1000 строка1-5)# - Возвращает содержимое строки определенного блока.
#fa# - Направление игрока. 0 - 360.
#getDistObject(объект *playerid)# - Расстояние до объекта. *playerid - если не указать, вернет ID игрока который вызвал блок.
#getDistPlayer(userid *playerid)# - Расстояние до игрока. *playerid - если не указать, вернет ID игрока который вызвал блок.
#getDistPos(x y z *playerid)# - Расстояние до координат. *playerid - если не указать, вернет ID игрока который вызвал блок.
#getDistVeh(vehicleid *playerid)# - Расстояние до транспорта. *playerid - если не указать, вернет ID игрока который вызвал блок.
#getGunName(0 - 51)# - Название оружия по его модели.
#getPlayerName# - Игровой ник игрока.
#getVehModel(411 - 611)# - Название транспорта по его модели.
#getVehName(ид транспорта)# - Название транспорта.
#getZ(x y)# - Поиск координаты Z (высоты).
#getZone(x y)# - Название района по координатам X Y.
#getzoneID(x y)# - Уникальный ID района по координат X Y.
#gun# - ID активного оружия у игрока.
#gunName# - Название активного оружия у игрока.
#health# - Очки здоровья игрока.
#hr# - Процент попадения выстрелов игрока.
#issuerGun# - ID оружия с которого игрок получил урон.
#money# - Деньги игрока.
#name# - Игровой ник игрока. (Дубликат #getPlayerName#)
#nearVeh# - ID ближайщего транспорта до игрока.
#netStat# - Процент потери пакетов от игрока к серверу.
#online# - Число игроков в мире.
#passInfo# - ID прохода возле игрока.
#ping# - Задержка от игрока до сервера в мс.
#playerid# - ID игрока.
#pvar(переменная)# - Содержимое переменной игрока /pvar /pvarlist.
#random(0, 9999)# - Сгенерировать случайное число.

#randomPlayer(team 1)# - вернуть случайного игрока из 1 команды.
#randomPlayer(skin 228)# - вернуть случайного игрока с скином 228.
#randomPlayer(veh 411)# - вернуть случайного игрока в транспорте модель 411.
#randomPlayer(wanted 6)# - вернуть случайного игрока у которого 6 звезд розыска.
#randomPlayer(action 3)# - вернуть случайного игрока у которого специальное дейсвтие равно 3. Таблица специальных действий: https://open.mp/docs/scripting/resources/specialactions
#randomPlayer(dead)# - вернуть случайного игрока в состоянии смерти.
#randomPlayer(alive)# - вернуть случайного живого игрока.
#raycast(cam расстояние 0/1) - вернуть точку коллизии между камерой игрока и объектом. 3й параметр отвечает за возврат в случае отсутсвия коллизии. Если 1 - вернет координаты конечной точки. Если 0 - вернет 0.0 0.0 0.0
#raycast(pos расстояние 0/1) - вернуть точку коллизии мигроком и объектом. 3й параметр отвечает за возврат в случае отсутсвия коллизии. Если 1 - вернет координаты конечной точки. Если 0 - вернет 0.0 0.0 0.0
#retstr# - вернуть передаваемое значение строки.
#retval(0-9)# - вернуть передаваемое числовое значение.
#score# - Очки из TAB игрока.
#server(0 - 51)# - Данные массива мира. /server
#skin# - Скин игрока.
#speed# - Скорость передвижения игрока.
#target# - ID игрока которого выделил через ПКМ игрок.
#team# - ID команды в которой состоит игрок.
#teamName# - Название команды в которой состоит игрок.
#teamOnline(1 - 20)# - Число игроков состоящих в команде.
#time# - Время установленное в мире. /vw -> Время мира.
#timestamp# - Количество секунд от 1970 года.
#var(переменная)# - Вернуть содержимое переменной сервера. /var /varlist
#vdata(vehicleid 0 - 51)# - Массив транспорта.
#vehColor# - Цвет транспорта в котором сидит игрок.
#vehHealth# - Очки здоровья транспорта в котором сидит игрок.
#vehicle# - ID транспорта в котором сидит игрок.
#vehModel# - Модель транспорта в котором сидит игрок.
#vehName# - Название транспорта в котором сидит игрок.
#vehPos(vehicleid)# - Координаты X y Z транспорта.
#vehSeat# - Место которое занимает игрок в транспорте. 0 - водитель. 1 - пассажир справа. 2 - сзади за водителем. 3 - сзади справа.
#wanted# - Уровень розыска игрока.
#waterlvl# - Глубина воды под игроком. Если игрок не в воде - 0.0
#weather# - ID погоды в мире. /vw -> Погода
#x# - X координат игрока.
#y# - Y координат игрока.
#z# - Z координат игрока.
#xyz# - X Y Z координаты игрока.
#zone# - Название района в котором находится игрок.

Параметры без кавычек
data-0 - Аналог #data#
retval-0 - Аналог #retval#
server-0 - Аналог #server#

Кокеточка

Goodman #vehSeat# - Место которое занимает игрок в транспорте. 0 - водитель. 1 - пассажир справа. 2 - сзади за водителем. 3 - сзади справа.

Все в топике https://forum.training-server.com/d/10021-tekstovye-komandy-funktsii-kb/1

Vol3k

Тема забагалась, пипец