API UO CastAbility

UO.CastAbility

ClassicUO / Basic IDE

Оглавление · Алфавитный указатель · Magic

Активирует способность оружия по её имени или числовому ID. CastAbility является алиасом UseAbility. Возвращает 0 при неверном ID/отсутствии персонажа; принятие запроса не гарантирует успешный удар на сервере.

Синтаксис

UO.CastAbility(abilityName:String) -> Integer
UO.CastAbility(abilityId:Integer) -> Integer

Регистр имени не важен. Any — динамическое значение Basic; Unit — отсутствие возвращаемого значения. Integer — знаковое 32-битное число, Decimal — число с плавающей точкой. Правила типов, serial, индексов и ожиданий.

Параметры

Имя	Назначение
abilityName	Позиционный аргумент этой перегрузки. Подробности использования указаны в описании/фактической ветви runtime ниже.
abilityId	Numeric identifier (Integer). Use the ID domain documented by this command; 0 is a sentinel only when Behavior/Notes explicitly says so.

Параметры обязательны внутри каждой показанной сигнатуры. Опустить аргумент можно только при наличии более короткой перегрузки; пропуск позиции посередине не подразумевается.

Примеры

Каждый блок — самостоятельный скрипт из мануала проекта. Параметры демонстрационного объекта/контейнера и условия действия необходимо сопоставить с вашей игровой ситуацией.

Пример 1

SUB Main()
    VAR result = UO.CastAbility('example')
    UO.Print(CStr(result))
END SUB

Пример 2

SUB Main()
    VAR arg1 = 'example' # abilityName
    VAR result = UO.CastAbility(arg1)
    # Пример порога; выберите подходящий смыслу команды.
    IF result > 0 THEN
        UO.Print(CStr(result))
    END IF
END SUB

Пример 3

FUNCTION ReadResult()
    VAR arg1 = 'example' # abilityName
    VAR result = UO.CastAbility(arg1)
    RETURN result
END FUNCTION

SUB Main()
    VAR answer = ReadResult()
    UO.Print(CStr(answer))
END SUB

Реализация и проверка контракта

• InjectionScript.Runtime.InjectionApiUO.UseAbility

Источник реестра и отчёт сверки. Примеры проверяются загрузчиком/парсером включённого runtime. Действия на игровом сервере этой проверкой не исполняются.