⚙️Методы

На этой странице собраны все доступные методы, которые могут быть вызваны.

Информация

В bLua метод — это "функция", связанная с конкретным объектом (таблицей или переменной). Метод вызывается через двоеточие :. Но в отличие от обычной Lua - метод не является обычной функцией. Его нельзя использовать без : Пример:

--
-- Стандартная функция/метод в Lua
--

local location

find_players(location, 15) -- Вызываем ФУНКЦИЮ, и укаываем два параметра

-- Или же:

location:find_players(15) -- Аргумент location указывается как первый аргумент функции

--
-- Система в bLua работает по-другому:
--

local location

location:find_players(15) -- Правильно

find_players(location, 15) -- Неправильно, отправит Debug ошибку
-- В данном случае find_players является МЕТОДОМ,
-- поэтому его НЕЛЬЗЯ использовать как функцию.

Методы

on_hover

any:on_hover("text")  

Аргумент	Описание	Значение по умолчанию	Обязателен
Текст	Текст, отображаемый при наведении	-

Возвращает копию элемента в переменной any как наводимый элемент. Аргумент text будет отображаться при наведении на элемент только в чате или книге.

on_click

any:on_click("command")

Аргумент	Описание	Значение по умолчанию	Обязателен
Команда	Команда без /, которая будет исполняться при нажатии на элемент	-

Возвращает копию элемента в переменной any, при нажатии на который исполняется команда из аргумента command.

separated_by

list:separated_by("text")

Аргумент	Описание	Значение по умолчанию	Обязателен
Текст	Текст, который будет использован в качестве разделителя листа.	-

Возвращает элемент листа, разделенного текстом аргумента text.

local list = "li@Jane|Alex|Maxwell"

print("chat", list:separated_by(" and "))
-- Выводит "Jane and Alex and Maxwell"

bool_condition

boolean:bool_condition("if_true", "if_false")

Аргумент	Описание	Значение по умолчанию	Обязателен
Любой	Значение/переменная, которая будет выведена, если boolean == true	-
Любой	Значение/переменная, которая будет выведена, если boolean == false	-

Возвращает первый или второй аргумент, в зависимости от результата boolean. (true/false). Если результатом не является bool, метод вернет nil.

local boolean = true

print("chat", boolean:bool_condition("Cola", "Pepsi"))
-- Выводит "Cola"

not

element:not()

Аргумент	Описание	Значение по умолчанию	Обязателен
-	-	-

Отрицает значение. true ⇒ false, false ⇒ true.

local element = true

print("chat", element:not())
-- Выводит false

find_players

location:find_players(number)

Аргумент	Описание	Значение по умолчанию	Обязателен
Радиус	Число, которое будет использованно в качестве расстояния. Максимально значение - 30.	10

Возвращает лист всех игроков в указанном в аргументе радиусе.

local location = e.location

print("chat", location:find_players(10))
-- Выводит li@p@23b87e4c-67a3-4619-a93f-60fe7408965a|p@213c1464-ab31-41c0-be70-5184c014a4d6

add

location|element:add(num, num, num)

Аргумент	Описание	Значение по умолчанию	Обязателен
Слогаемое	Число, которое будет прибавлено к результату	-
Слогаемое	Число, которое будет прибавлено к результату	-
Слогаемое	Число, которое будет прибавлено к результату	-

Прибавляет к локации или любому элементу указанное значение. Если указан 1 аргумент - выражение будет выполнено к элементу. Если указано 3 аргумента - выражение будет выполнено к локации.

local location = e.location -- l@2,3,1,world
local element = 6

print("chat", "Number is " .. element:add(4) .. ", location " .. location:add(1, 4, 9))
-- Выводит "Number is 10, location l@3,7,10,world

sub

location|element:sub(num, num, num)

Аргумент	Описание	Значение по умолчанию	Обязателен
Вычитаемое	Число, которое будет вычтено из результату	-
Вычитаемое	Число, которое будет вычтено из результату	-
Вычитаемое	Число, которое будет вычтено из результату	-

Вычитает из локации или любого элемента указанное значение. Если указан 1 аргумент - выражение будет выполнено к элементу. Если указано 3 аргумента - выражение будет выполнено к локации.

local location = e.location -- l@2,3,1,world
local element = 6

print("chat", "Number is " .. element:sub(4) .. ", location " .. location:add(1, 4, 9))
-- Выводит "Number is 2, location l@1,-1,-8,world

mul

element:mul(number)

Аргумент	Описание	Значение по умолчанию	Обязателен
Множитель	Число, которое будет использованно в качестве множителя к элементу	-

Умножает элемент на указанное значение. Работает и с типом "локация"

local element = 4

print("chat", element:mul(5))
-- Выводит 20

div

element:div(7)

Аргумент	Описание	Значение по умолчанию	Обязателен
Делитель	Число, которое будет использованно в качестве делителя к элементу	-

Делит элемент на указанное значение. Работает и с типом "локация"

local element = 56

print("chat", element:div(7))
-- Выводит 8

round

element:round()

Аргумент	Описание	Значение по умолчанию	Обязателен
-	-	-

Возвращает округленное число. Может округлять и location.

local element = 5.5

print("chat", element:round())
-- Выводит 6

include

list:include(any)

Аргумент	Описание	Значение по умолчанию	Обязателен
Значение	Вставляемое значение	-

Возвращает копию листа, с добавленным в конец указанным элементом.

local list = "li@Maxwell|Kate|Tom"

print("chat", list:include("Jane"))
-- Выводит li@Maxwell|Kate|Tom|Jane

exclude

list:exclude(any)

Аргумент	Описание	Значение по умолчанию	Обязателен
Значение	Удаляемое значение	-

Возвращает копию листа, со всеми удаленными указанными элементами.

local list = "li@Maxwell|Kate|Tom"

print("chat", list:exclude("Kate"))
-- Выводит li@Maxwell|Tom

deduplicate

list:deduplicate()

Аргумент	Описание	Значение по умолчанию	Обязателен
-	-	-

Возвращает копию листа из которого удалены все дублирующиеся элементы.

local list = "li@Potatoes|Carrot|Pie|Potatoes"

print("chat", list:deduplicate())
-- Выводит li@Potatoes|Carrot|Pie

sort_text

list:sort_text(attribute)

Аргумент	Описание	Значение по умолчанию	Обязателен
Парсинговый ключ	Используется для получения данных. Смотрите пример.

Возвращает копию листа, отсортированную по алфавиту и цифрам. Сортировка выполняется не по самому элементу, а по атрибуту, считанному из объекта. (если указан аргумент)

local list = e.players

print("chat", list:sort_text("name"))
-- Выводит отсортированные по атрибуту "name" объекты в list

sort_number

list:sort_number(attribute)

Аргумент	Описание	Значение по умолчанию	Обязателен
Парсинговый ключ	Используется для получения данных. Смотрите пример.

Возвращает копию листа, отсортированную таким образом, что меньшие числа идут первыми, а большие — последними. Сортировка выполняется не по самому элементу, а по атрибуту, считанному из объекта (если указан аргумент). Ввод нечислового значения считается ошибкой, и результат не гарантируется.

local list = e.players

print("chat", list:sort_number("health"))
-- Выводит отсортированные по атрибуту "health" объекты в list

reverse

list:reverse()

Аргумент	Описание	Значение по умолчанию	Обязателен
-	-	-

Возвращает копию листа, в котором все элементы расположены в обратном порядке.

local list = "li@1|2|3"

print("chat", list:reverse())
-- Выводит li@3|2|1

contains

list:contains(any)

Аргумент	Описание	Значение по умолчанию	Обязателен
Элемент	Элемент, который будет использован для проверки "Содержит ли"	-

Возвращает true или false, в зависимости от того, содержится ли указанный элемент в листе.

local list = "li@1|2|3"

print("chat", list:contains("1"))
-- Выводит true

contains_text

element:contains_text(element)

Аргумент	Описание	Значение по умолчанию	Обязателен
Элемент	Элемент, который будет использован для проверки "Содержит ли"	-

Возвращает true или false, в зависимости от того, содержится ли указанный элемент в тексте.

local element = "189332ijefufghuh_tower_vdc7334vm"

print("chat", element:contains_text("_tower_"))
-- Выводит true

replace

element:replace(element, element)

Аргумент	Описание	Значение по умолчанию	Обязателен
Поисковое значение	Значение для поиска	-
Значение для замены	Значение, которое будет вставлено вместо значения для поиска	-

Возвращает текст, в котором все поисковые элементы заменены другим.

local element = "1h"

print("chat", element:replace("h", " час"))
-- Выводит "1 час"

attribute

any:attribute(element)

Аргумент	Описание	Значение по умолчанию	Обязателен
Элемент	Элемент, который будет использован для получения аттрибута. Может разделяться через .	-

Получает любое значение атрибута. Может разделяться через .. Атрибуты лучше использовать в последнюю очередь, так как они могут быть ненадежны. См. пример.

В настоящее время может не работать или работать плохо

local player = TowerLoc:find_players(15).1

print("chat", player:attribute("name"))
-- Выводит никнейм ближайшего игрока к вышке

abs

element:abs()

Аргумент	Описание	Значение по умолчанию	Обязателен
-	-	-

Возвращает модуль указанного числа

local element = "-2"

print("chat", element:abs())
-- Выводит 2

cos

element:cos()

Аргумент	Описание	Значение по умолчанию	Обязателен
-	-	-

Возвращает косинус указанного числа

sin

element:sin()

Аргумент	Описание	Значение по умолчанию	Обязателен
-	-	-

Возвращает синус указанного числа

tan

element:tan()

Аргумент	Описание	Значение по умолчанию	Обязателен
-	-	-

Возвращает тангенс указанного числа

pow

element:pow(number)

Аргумент	Описание	Значение по умолчанию	Обязателен
Степень	Число, в степень которого будет возведено число из указанной переменной	-

Возвращает число в степени указанного в аргументе числа

mod

element:mod(number)

Аргумент	Описание	Значение по умолчанию	Обязателен
Делитель	Число, которое будет использованно в качестве делителя к элементу	-

Возвращает остаток числа, деленного на число в аргументе

sqrt

element:sqrt()

Аргумент	Описание	Значение по умолчанию	Обязателен
-	-	-

Возвращает квадратный корень числа

floor

element:floor()

Аргумент	Описание	Значение по умолчанию	Обязателен
-	-	-

Возвращает число, округленное до нижнего.

local element = "-2.6"

print("chat", element:floor())
-- Выводит -3

ceil

element:ceil()

Аргумент	Описание	Значение по умолчанию	Обязателен
-	-	-

Возвращает число, округленное до вышнего.

local element = 1.1

print("chat", element:floor())
-- Выводит 2

min

element:min(number)

Аргумент	Описание	Значение по умолчанию	Обязателен
Число	Число для сравнения	-

Возвращает минимальное число из двух указанных

local element = 1

print("chat", element:min(3))
-- Выводит 1

max

element:max(number)

Аргумент	Описание	Значение по умолчанию	Обязателен
Число	Число для сравнения	-

Возвращает максимальное число из двух указанных

local element = 1

print("chat", element:max(3))
-- Выводит 3

log

element:log()

Аргумент	Описание	Значение по умолчанию	Обязателен
Базированное число	Число, которое будет использоваться как основание	-

Возвращает логарифм элемента, основанный на указанном в аргументе числе

local element = 3

print("chat", element:log(50))
-- Выводит 0.28082971064938145