RU Runtime API 24 Persistent State - LIHACHTETAN/ClassicUO-Bad-Newbie-CSharp-Scripts-IDE GitHub Wiki

Українська · Русский · English · Deutsch · Français · Italiano · Español · 繁體中文 · 日本語 · 한국어

Runtime API — Постоянное состояние

Главная · C# · IDE · UO API · A–Z · Примеры · Языки

Каждая команда открывает карточку с C#-сигнатурами, параметрами и несколькими самостоятельными примерами.

UO.AddDir

Движение

UO.AddFigure

Client UI

Добавляет локальную фигуру на карту мира ClassicUO и возвращает её идентификатор. Фигура хранится на стороне клиента, игровой сервер не уведомляется.

UO.AddGate

Магия

UO.Alarm

Sound & Visual Environment

Печатает слово Alarm в локальный системный журнал ClassicUO. Используйте как заметку о наступившем условии в скрипте.

UO.AlwaysRun

Движение

Читает или меняет настройку постоянного бега текущего профиля ClassicUO.

UO.ApiNameExists

Диагностика и самоанализ

Проверяет регистрацию имени вызываемой нативной функции.

UO.ApiParameterExists

Диагностика и самоанализ

Проверяет регистрацию значения runtime или именованного объекта.

UO.ApiSignatureExists

Диагностика и самоанализ

Проверяет регистрацию имени с заданным числом аргументов.

UO.Arm

Персонаж

Восстанавливает ранее сохранённый именованный набор оружия и щита.

UO.AutoBuy

Магазины и продавцы

Создаёт, обновляет либо удаляет правило автоматической покупки в основном списке Default текущего профиля Bad Newbie. Команда настраивает будущую обработку предложения NPC-продавца; сама не произносит buy/sell, не открывает магазин и не подтверждает сделку. Полный порядок действий: списки магазина.

UO.AutoBuyEx

Магазины и продавцы

Создаёт, обновляет либо удаляет правило автоматической покупки в основном списке Default текущего профиля Bad Newbie. Команда настраивает будущую обработку предложения NPC-продавца; сама не произносит buy/sell, не открывает магазин и не подтверждает сделку. Полный порядок действий: списки магазина.

UO.AutoSell

Магазины и продавцы

Создаёт, обновляет либо удаляет правило автоматической продажи в основном списке Default текущего профиля Bad Newbie. Команда настраивает будущую обработку предложения NPC-продавца; сама не произносит buy/sell, не открывает магазин и не подтверждает сделку. Полный порядок действий: списки магазина.

UO.BandageSelf

Бой

Ставит персонажа в качестве UO.Wait-target и использует на себе бинт типа 0x0E21, выбранный из рюкзака. Операция отправляется клиентом и выполняется сервером асинхронно.

UO.BookSetHeader

Книги

Задаёт заголовок и автора открытой редактируемой книги.

UO.Bow

Речь и чат

Отправляет действие персонажа bow через GameActions.EmoteAction.

UO.BoxHack

Преобразование и совместимость

Печатает уведомление, что устаревший патч нативного клиента BoxHack не требуется ClassicUO.

UO.Buy

Магазины и продавцы

Создаёт, обновляет либо удаляет правило автоматической покупки в основном списке Default текущего профиля Bad Newbie. Команда настраивает будущую обработку предложения NPC-продавца; сама не произносит buy/sell, не открывает магазин и не подтверждает сделку. Полный порядок действий: списки магазина.

UO.CanChangeName

Персонажи и существа

Проверяет известный клиенту признак возможности переименовать mobile.

UO.CheckLag

Клиент и подключение

Проверяет, получен ли свежий ответ игрового сервера за отведённое время. Удобна перед продолжением скрипта после сетевой задержки.

UO.CheckLOS

Мир и геометрия

Проверяет локальную проходимость линии между двумя точками карты через CheckPortableLineOfSight.

UO.CircleTrans

Client UI

Читает или меняет настройку круга прозрачности активного профиля.

UO.ClearFigures

Client UI

Удаляет все пользовательские фигуры карты и их записи runtime.

UO.ClearInfoWindow

Client UI

Очищает строки клиентского текстового окна.

UO.CloseUO

Клиент и подключение

Запрашивает выход текущего приложения клиента через Client.Game.Exit.

UO.ConColor

Client UI

Задаёт UO hue для последующих системных сообщений данного скриптового runtime.

UO.Connect

Клиент и подключение

Запрашивает подключение или переподключение текущей клиентской сессии.

UO.ConsoleEntryReply

Меню и контекстные меню

Отвечает текстом на активный серверный prompt через MessageManager.SendServerPromptResponse.

UO.ConsoleEntryUnicodeReply

Меню и контекстные меню

Отвечает текстом на активный серверный prompt через MessageManager.SendServerPromptResponse.

UO.ConvertIntegerToFlags

Мир и геометрия

Разбирает числовую маску tile flags в массив имён перечисления TileFlag.

UO.Disarm

Персонаж

Снимает оружие и щит из рук: слои 1 и 2. Одежду не затрагивает.

UO.Disconnect

Клиент и подключение

Отключает текущий или устанавливаемый транспорт клиента и готовит скрипты к переподключению.

UO.Dismount

Персонаж

Слезть с коня, причём в бекпак положить "седло" - обьект связаный с лошадью, см.

UO.Dist

Мир и геометрия

Вычисляет расстояние в клетках между двумя мировыми точками: наибольшую из абсолютных разностей X и Y.

UO.Drag

Предметы

Поднимает конкретный предмет на курсор; отдельная четырёхаргументная форма перетаскивает мышь в окне Windows.

UO.Dump

Диагностика и самоанализ

Печатает диагностический снимок известного клиенту объекта.

UO.Dye

Предметы

Использует переданный предмет окраски; при втором аргументе заранее ставит объектную UO.Wait-target.

UO.EmoteAction

Речь и чат

Отправляет строковое имя действия/анимации персонажа в GameActions.EmoteAction.

UO.EUO2ID

Преобразование и совместимость

Декодирует буквенную запись EasyUO по основанию 26 с A=0.

UO.EUO2Inj

Преобразование и совместимость

Декодирует буквенную запись EasyUO по основанию 26 с A=0.

UO.Exists

Предметы

Проверяет наличие не удалённого объекта в локальном мире клиента.

UO.ExtendedInfo

Диагностика и самоанализ

Возвращает четыре поля текущей клиентской конфигурации соединения.

UO.FillInfoWindow

Client UI

Добавляет одну строку в текстовое окно и показывает его.

UO.FillNewWindow

Client UI

Очищает текстовое окно, добавляет одну строку и показывает его.

UO.FilterSpeech

Речь и чат

Включает или выключает клиентский фильтр речи.

UO.FilterWeather

Sound & Visual Environment

Включает или выключает клиентский фильтр погоды.

UO.FixTalk

Речь и чат

Печатает уведомление, что устаревший патч нативного клиента FixTalk не требуется ClassicUO.

UO.Flying

Персонаж

Проверяет, летит ли сейчас персонаж. Обычно это нужно для Gargoyle: например, перед запуском маршрута или перед запросом включения полёта. Без аргумента отвечает на вопрос «мой персонаж сейчас летит?». Команда только читает состояние: она не включает полёт, не приземляет и не двигает персонажа.

UO.FontColor

Client UI

Устанавливает hue последующих локальных UO.UOAMessage данного скрипта. Не меняет цвет речи персонажа, обычного UO.Print, InfoFindList или тему IDE.

UO.Forget

Предметы

Без сообщения удаляет сохранённое имя из runtime Objects.

UO.FoundedParamId

Journal

Возвращает номер совпавшей альтернативы поискового шаблона.

UO.Frozen

Персонаж

Проверяет известный клиенту флаг паралича персонажа.

UO.FunRunning

Сценарии и среда выполнения

Проверяет, выполняется ли зарегистрированный C#-callback с указанным именем. Результат 1 включает ручную паузу; завершённая либо отменяющаяся задача даёт 0.

UO.GameServerIPString

Клиент и подключение

Читает настроенный адрес сервера из глобальных настроек клиента.

UO.GetAltName

Предметы

Читает известный клиенту титул персонажа: например, профессию или подпись после имени.

UO.GetAutoBuyDelay

Магазины и продавцы

Читает текущую задержку автоматической покупки из профиля клиента.

UO.GetAutoSellDelay

Магазины и продавцы

Читает текущую задержку автоматической продажи из профиля клиента.

UO.GetBuffBarInfo

Баффы и эффекты

Возвращает снимок buff icons текущего персонажа.

UO.GetCliloc

Локализация

Читает готовый текст свойств объекта из OPL. GetTooltip и GetCliloc являются синонимами.

UO.GetClilocByID

Локализация

Переводит шаблон cliloc из игровых файлов и подставляет переданные параметры.

UO.GetColor

Предметы

Читает hue объекта и форматирует его как шестнадцатеричную строку.

UO.GetContent

Контейнеры

Читает прямое содержимое контейнера или загруженные предметы на земле.

UO.GetDex

Персонаж

Читает текущую ловкость (Dexterity, DEX) персонажа.

UO.GetDir

Движение

Читает направление персонажа из модели клиента.

UO.GetEasyUO

Профили и конфигурация

Читает строку из пользовательского Windows registry EasyUO.

UO.GetFlags

Предметы

Читает битовую маску Entity.Flags из локального известного объекта.

UO.GetFlying

Персонаж

Проверяет, летит ли сейчас персонаж. Обычно это нужно для Gargoyle: например, перед запуском маршрута или перед запросом включения полёта. Без аргумента отвечает на вопрос «мой персонаж сейчас летит?». Команда только читает состояние: она не включает полёт, не приземляет и не двигает персонажа.

UO.GetFrozen

Персонаж

Проверяет известный клиенту флаг паралича персонажа.

UO.GetGraphic

Предметы

Читает graphic предмета или body персонажа и возвращает его в шестнадцатеричном тексте.

UO.GetInfo

Диагностика и самоанализ

Возвращает имя персонажа только для точного селектора character.

UO.GetInt

Персонаж

Читает текущий интеллект (Intelligence, INT) персонажа.

UO.GetLocked

Предметы

Проверяет паралич mobile.

UO.GetMapCell

Мир и геометрия

Читает graphic, высоту и флаги земли в одной клетке карты.

UO.GetMobile

Персонажи и существа

Собирает компактную запись свойств по одному ID.

UO.GetMobiles

Персонажи и существа

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

UO.GetName

Предметы

Читает известное клиенту имя предмета или персонажа.

UO.GetParalisa

Персонаж

Проверяет известный клиенту флаг паралича персонажа.

UO.GetParalysed

Персонаж

Проверяет известный клиенту флаг паралича персонажа.

UO.GetParalyzed

Персонаж

Проверяет известный клиенту флаг паралича персонажа.

UO.GetParent

Контейнеры

Читает непосредственного родителя предмета.

UO.GetPrice

Магазины и продавцы

Читает известную клиенту Item.Price для serial предмета.

UO.GetQuantity

Предметы

Читает количество единиц в одном стеке предмета.

UO.GetQuestArrow

Квесты и добродетели

Читает положение серверной стрелки задания. Позволяет скрипту узнать, куда указывает полученная от сервера стрелка; команду Track она не читает.

UO.GetResist

Персонаж

Читает одно сопротивление своего персонажа по числовому или строковому селектору.

UO.GetRun

Движение

Проверяет флаг бега в последнем известном направлении mobile.

UO.GetStatLockState

Персонаж

Читает локальный режим изменения характеристики.

UO.GetStr

Персонаж

Читает текущую силу (Strength, Str) персонажа.

UO.GetSurfaceZ

Мир и геометрия

Читает среднюю высоту поверхности земли в клетке.

UO.GetTitle

Персонаж

Читает известный клиенту титул персонажа: например, профессию или подпись после имени.

UO.GetTooltip

Предметы

Читает готовый текст свойств объекта из OPL. GetTooltip и GetCliloc являются синонимами.

UO.GetTooltipRec

Предметы

Читает структурированные свойства: cliloc ID и параметры каждой записи OPL.

UO.GetUserCodepage

Локализация

Возвращает Encoding.Default.CodePage без чтения настроек профиля.

UO.GetWord

Файлы / JSON / Данные

Получает отдельное слово или поле из текста. Пригодится для разбора координат, списка приоритетов или сохранённой настройки скрипта.

UO.Ground

Контейнеры

Возвращает специальное обозначение земли для параметра контейнера поиска или места назначения переноса.

UO.Help

Диагностика и самоанализ

UO.HelpRequest

Client UI

Запрашивает серверное меню помощи.

UO.Hex2Int

Преобразование и совместимость

Преобразует числовое значение или числовой текст в int.

UO.HTTP_Body

HTTP

Читает текст последнего HTTP-ответа этого скрипта. Например, после HTTP_Get можно разобрать JSON с настройками или сравнить ответ своего сервиса с ожидаемой строкой. Само чтение не обращается в сеть.

UO.HTTP_Get

HTTP

Загружает данные по HTTP/HTTPS. Подходит для чтения настроек со своего сервиса или получения файла; не управляет игровым подключением и не запускает загруженный код.

UO.HTTP_Header

HTTP

Читает заголовки последнего HTTP-ответа этого скрипта: например, Content-Type, чтобы узнать заявленный формат данных. Это не тело ответа, не заголовки запроса и не числовой код HTTP.

UO.HTTP_Post

HTTP

Отправляет текст своему HTTP-сервису методом POST и возвращает текст ответа. Например, скрипт может передать отчёт об остановке маршрута. Это не готовая команда Telegram/Discord: их протокол, авторизация и формат запроса требуют отдельной поддержки.

UO.Info

Диагностика и самоанализ

Без аргумента включает локальный прицел для выбора загруженного предмета или персонажа. После выбора открывает окно C# Object Information и выводит информацию в журнал. Форма Info(serial) сразу выводит текст об указанном объекте в журнал и не открывает инспектор. Если интерактивный выбор недоступен, форма без аргумента использует lasttarget. Для земли и статических тайлов служит InfoTile.

UO.InfoColor

Диагностика и самоанализ

Выводит цвет объекта в журнал в шестнадцатеричном виде 0xHHHH. Без аргумента используется lasttarget; возвращаемого значения нет.

UO.Inj2EUO

Преобразование и совместимость

Кодирует 32-битное число serial буквами A..Z для EasyUO.

UO.InParty

Группа

Проверяет наличие текущей группы по состоянию Party клиента.

UO.Int

Персонаж

Читает текущий интеллект (Intelligence, INT) персонажа.

UO.Int2Hex

Преобразование и совместимость

Форматирует int как hexadecimal serial-строку.

UO.InviteToParty

Группа

Запрашивает приглашение персонажа в группу.

UO.IsFemale

Персонаж

Проверяет признак женского пола mobile.

UO.IsFlying

Персонаж

Проверяет, летит ли сейчас персонаж. Обычно это нужно для Gargoyle: например, перед запуском маршрута или перед запросом включения полёта. Без аргумента отвечает на вопрос «мой персонаж сейчас летит?». Команда только читает состояние: она не включает полёт, не приземляет и не двигает персонажа.

UO.IsFrozen

Персонаж

Проверяет известный клиенту флаг паралича персонажа.

UO.IsHouse

Мульти и дома

Проверяет признак multi у загруженного объекта: дома, корабля или другой многотайловой конструкции.

UO.IsMovable

Предметы

Проверяет локальные признаки переносимости известного предмета по правилам подбора Classic UO.

UO.IsParalysed

Персонаж

Проверяет известный клиенту флаг паралича персонажа.

UO.IsParalyzed

Персонаж

Проверяет известный клиенту флаг паралича персонажа.

UO.IsRunning

Движение

Проверяет флаг бега в последнем известном направлении mobile.

UO.IsYellowHits

Персонаж

Проверяет флаг жёлтой полосы здоровья mobile.

UO.KeyPress

Мышь и клавиатура

Синтезирует одно или несколько нажатий virtual-key.

UO.Launch

Сценарии и среда выполнения

UO.Light

Sound & Visual Environment

Локально задаёт общую освещённость клиента.

UO.LineID

Journal

Возвращает числовой serial автора выбранной записи журнала.

UO.LineIndex

Journal

Возвращает текущий индекс выбранной записи, если она ещё хранится в журнале.

UO.LineName

Journal

Возвращает имя автора выбранной записи журнала.

UO.LOSOptions

Мир и геометрия

Читает или сохраняет локальную маску параметров LOS runtime.

UO.MFGI

Поиск

Печатает текущий список результатов поиска.

UO.MobileCanBeRenamed

Персонажи и существа

Проверяет известный клиенту признак возможности переименовать mobile.

UO.Morph

Client UI

Локально меняет graphic текущего персонажа.

UO.Msg

Речь и чат

Показывает локальное сообщение о ходе скрипта или условии остановки. Его видите вы, а не другие игроки.

UO.OpenDoor

Движение

Запрашивает открывание двери перед персонажем.

UO.Paralyzed

Персонаж

Проверяет известный клиенту флаг паралича персонажа.

UO.PartyAcceptInvite

Группа

Принимает сохранённое приглашение в группу.

UO.PartyCanLootMe

Группа

Меняет разрешение участникам группы снимать вещи с трупа.

UO.PartyDeclineInvite

Группа

Отклоняет сохранённое приглашение в группу.

UO.PartyLeave

Группа

Запрашивает выход текущего персонажа из группы.

UO.Picking

Предметы

Проверяет, занят ли курсор клиента поднятым предметом.

UO.PlayWav

Sound & Visual Environment

Воспроизводит локальный звуковой файл.

UO.PredictedX

Движение

Читает прогнозируемую координату X после уже поставленных в очередь шагов персонажа.

UO.PredictedY

Движение

Читает прогнозируемую координату Y после уже поставленных в очередь шагов персонажа.

UO.PredictedZ

Движение

Читает прогнозируемую высоту Z после уже поставленных в очередь шагов персонажа.

UO.Press

Мышь и клавиатура

Синтезирует одно или несколько нажатий virtual-key.

UO.ProxyIP

Прокси

Читает адрес прокси текущего профиля, чтобы проверить выбранный маршрут перед подключением.

UO.ProxyPort

Прокси

Читает порт прокси текущего профиля для проверки пары адрес/порт.

UO.QuestRequest

Квесты и добродетели

Запрашивает серверное меню заданий.

UO.Random

Файлы / JSON / Данные

Возвращает случайное целое число. Новая форма UO.Random(min, max) выбирает число ОТ min ДО max включительно. Прежняя форма UO.Random(max) сохранена: она выбирает от 0 до max−1. Результат можно сохранить в переменную и использовать как задержку, координату, индекс или условие.

UO.Rename

Персонажи и существа

Запрашивает изменение имени персонажа/питомца.

UO.RenameMobile

Персонажи и существа

Запрашивает изменение имени персонажа/питомца.

UO.RequestStats

Персонаж

Запрашивает status персонажа по serial.

UO.Resend

Клиент и подключение

Посылает запрос повторной синхронизации мира.

UO.Salute

Речь и чат

Запрашивает анимацию приветствия.

UO.ScanInt

Преобразование и совместимость

Находит первое подписанное double/hex-число в строке, начиная с позиции.

UO.Set

Профили и конфигурация

Меняет одну из трёх legacy-настроек.

UO.SetARExtParams

Персонаж

Задаёт сервер из списка шардов и персонажа для последующего входа. Полезно, когда скрипт должен переподключиться определённым персонажем того же аккаунта.

UO.SetArm

Персонаж

Запоминает текущие оружие и щит в именованном наборе.

UO.SetAutoBuyDelay

Магазины и продавцы

Устанавливает задержку автоматической покупки и сохраняет текущий профиль.

UO.SetAutoSellDelay

Магазины и продавцы

Устанавливает задержку автоматической продажи и сохраняет текущий профиль.

UO.SetBadLocation

Поиск

Добавляет X/Y в список запрещённых клеток для следующих маршрутов MoveXY, NewMoveXY, MoveXYZ, PMove и запросов GetPathArray/GetPathArray3D.

UO.SetCatchBag

Контейнеры

UO.SetDefault

Профили и конфигурация

Сохраняет именованный alias serial в состоянии runtime.

UO.SetEasyUO

Профили и конфигурация

Записывает строковое значение в Windows registry EasyUO.

UO.SetEvent

Сценарии и среда выполнения

Включает или выключает наблюдение за изменениями состояния персонажа и позволяет выбрать одноразовую либо повторяющуюся реакцию. Например, можно один раз отменить оставшийся target после смерти или получать предупреждения о низкой выносливости. Обработчик задаётся отдельно от условия; основной скрипт должен продолжать выполнять UO.Wait.

UO.SetEventProc

Сценарии и среда выполнения

Назначает процедуру, которую клиент будет запускать при изменении наблюдаемого состояния: например, при потере здоровья, изменении маны или появлении нового mobile. Позволяет отделить реакцию от основного цикла. Регистрация сама ничего не запускает: Основной скрипт должен оставаться активным; C#-контрольные точки, WaitAsync и UO.Wait обрабатывают события.

UO.SetRec

Запись/Воспроизведение

Готовит запись следующей legacy-команды UO.

UO.SetSeason

Sound & Visual Environment

Локально меняет отображаемый сезон.

UO.SetShowZ

Client UI

Меняет локальный флаг showZ runtime.

UO.SetSilentMode

Client UI

Меняет локальный флаг SilentMode runtime.

UO.SetStatLockState

Персонаж

Запрашивает изменение режима характеристики.

UO.SetStatState

Персонаж

Запрашивает изменение режима характеристики.

UO.ShardName

Клиент и подключение

Читает имя шарда.

UO.ShutdownWindows

Преобразование и совместимость

Всегда отклоняет попытку выключения Windows из скрипта.

UO.Snap

Client UI

Сохраняет снимок графического окна клиента.

UO.Snoop

Навыки

Использует контейнер/объект, обычно запрашивая его открытие.

UO.Sound

Sound & Visual Environment

Воспроизводит звук по ID из ресурсов клиента.

UO.StealthCnt

Навыки

Читает локальный счётчик смещения персонажа в скрытности.

UO.ClientInfo

Диагностика и самоанализ

Читает краткие сведения о запущенном клиенте.

UO.Str

Персонаж

Reads or changes the requested mobile/player stat/state through the current ClassicUO world model and registered API bridge.

UO.TicksAnim

Sound & Visual Environment

Читает сохранённую отметку TicksAnim.

UO.TicksUse

Предметы

Читает сохранённую отметку TicksUse.

UO.ToggleFly

Персонаж

Запрашивает переключение полёта собственного Gargoyle: с земли — в полёт, из полёта — на землю. Это действие, а UO.Flying() только проверяет состояние. Команда пригодится перед маршрутом, требующим определённого режима.

UO.UnsetArm

Персонаж

Удаляет запись именованного набора оружия, не разоружая персонажа.

UO.UnsetCatchBag

Контейнеры

Очищает контейнер приёма для Grab.

UO.UseFromGround

Предметы

Ищет объект заданного graphic на земле/в мире и сразу вызывает его применение. Обычно используется для лежащих рядом предметов, например для открытия рюкзака. Важная особенность этого runtime: поиск основан на FindType и может найти также mobile с таким body; это не строго item-only выборка. Для предметов с явным радиусом и выбором ближайшего используйте UseType(..., ground, ...).

UO.UseOtherPaperdollScroll

Персонаж

Использует указанный serial через bridge.UseObject, обычно открывая paperdoll персонажа.

UO.UseProxy

Прокси

Проверяет, настроено ли подключение этого сеанса через прокси.

UO.UseRec

Запись/Воспроизведение

Повторяет сохранённую legacy-команду UO.

UO.UseSelfPaperdollScroll

Персонаж

Использует текущего персонажа, обычно открывая paperdoll.

UO.UseVirtue

Квесты и добродетели

Запрашивает применение добродетели.

UO.Version

Диагностика и самоанализ

Печатает название и версию runtime продукта.