API UO UseFromGround

UO.UseFromGround

ClassicUO / Basic IDE

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

Ищет объект указанного типа и цвета на земле, затем использует (double-click) его.

Синтаксис

UO.UseFromGround(type:Any) -> Integer
UO.UseFromGround(type:Any, color:Any) -> Integer

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

Параметры

Имя	Назначение
type	Graphic/body/tile ID. Use a decimal or 0x-prefixed hexadecimal value; wildcard -1/0xFFFF is valid only for overloads whose behavior documents wildcard matching.
color	Графика/цвет объекта: десятичное или 0x-число. Маску -1 используйте только в поисковых перегрузках, где она поддерживается.

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

Допустимые значения

ObjType — Decimal or 0x-prefixed graphic/body/tile ID; -1/0xFFFF is wildcard only where Behavior explicitly allows it.

• Color — Decimal or 0x-prefixed hue; -1 is any/default only where Behavior explicitly allows it.
• type — Decimal or 0x-prefixed graphic/body/tile ID; -1/0xFFFF is wildcard only where Behavior explicitly allows it.

Примеры

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

Пример 1

SUB Main()
    VAR result = UO.UseFromGround(0x0190, -1)
END SUB

Пример 2

SUB Main()
    VAR result = UO.UseFromGround(0)
END SUB

Пример 3

SUB Main()
    VAR result = UO.UseFromGround(0x0EED)
    UO.Print(CStr(result))
END SUB

Пример 4

SUB Main()
    VAR arg1 = 0x0EED # type
    VAR arg2 = -1 # color
    VAR result = UO.UseFromGround(arg1, arg2)
    UO.Print(CStr(result))
END SUB

Пример 5

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

Пример 6

FUNCTION ReadResult()
    VAR arg1 = 0x0EED # type
    VAR result = UO.UseFromGround(arg1)
    RETURN result
END FUNCTION

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

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

• InjectionScript.Runtime.InjectionApiUO.UseFromGround

Соответствующая ветвь совместимого обработчика в InjectionApiUO.cs. Arg(i)/Text(i) читают позицию с нуля; bridge обращается к клиенту. Прямые типизированные перегрузки перечислены выше и могут иметь отдельный маршрут.

{
                        int found = bridge.FindType(Arg(0), arguments.Length > 1 ? Arg(1) : -1, 1, -1, false);
                        if (found != 0) bridge.UseObject(found);
                        return new InjectionValue(found);
                    }

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