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

UO.LimitMove — Предел дальности движения.

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

Движение персонажа, построение пути, двери, препятствия и задержки шагов. Команды переноса вещей находятся в Items → Moving Items.

UO.Move · UO.MoveXY · UO.MoveXYZ · UO.NewMoveXY · UO.Step · UO.StepQ · UO.PMove · UO.MoveOn · UO.MoveOff · UO.MoverStop · UO.CancelMove · UO.Moving · UO.IsMoving · UO.GetRun · UO.IsRunning · UO.AlwaysRun · UO.FixWalk

UO.Dir · UO.Direction · UO.GetDir · UO.GetDirection · UO.CalcDir · UO.PredictedDirection

UO.GetPathArray · UO.GetPathArray3D · UO.AddStep · UO.AddDir

UO.OpenDoor · UO.LastStepQUsedDoor

UO.moveBetweenTwoCorners · UO.moveCheckStamina · UO.moveExitOnDisconnect · UO.moveHeuristicMult · UO.moveOpenDoor · UO.moveThroughCorner · UO.moveThroughNPC · UO.moveTurnCost

UO.PredictedX · UO.PredictedY · UO.PredictedZ

UO.GetRunMountTimer · UO.GetRunUnMountTimer · UO.GetWalkMountTimer · UO.GetWalkUnmountTimer · UO.SetRunMountTimer · UO.SetRunUnmountTimer · UO.SetWalkMountTimer · UO.SetWalkUnmountTimer

В каждой карточке команды есть несколько самостоятельных сценариев: прямой код, функции и классы. Ниже приведены отдельные короткие сценарии; ограничения и полный разбор находятся в карточках.

Параметры, результат и все сценарии

var x = UO.GetX() + 3;
var y = UO.GetY();
var ok = UO.NewMoveXY(x, y, true, 0, false);
if (Truth(ok))
{
    UO.Print("Destination reached");
}
else
{
    UO.Print("Destination not reached");
}

bool Truth(object? value) => value is bool flag ? flag : value is string text ? !string.IsNullOrEmpty(text) : value != null && Convert.ToDouble(value) != 0;

Параметры, результат и все сценарии

var x = UO.GetX();
var y = UO.GetY();
var z = UO.GetZ();
var path = UO.GetPathArray3D(x, y, z, x + 4, y, z, UO.WorldNum(), 0, 0, false);
if (Truth(ArrayLength(path) > 0))
{
    UO.Print("Steps: " + Convert.ToString(ArrayLength(path) - 1));
}

int ArrayLength(object? value) => value is System.Array array ? array.Length : 0;
bool Truth(object? value) => value is bool flag ? flag : value is string text ? !string.IsNullOrEmpty(text) : value != null && Convert.ToDouble(value) != 0;

1 · 2

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

void UO.AddDir(object? directions);

• directions — строка, сохраняемая в legacy-списке. Смысл и формат значения зависят от совместимого скрипта, который его использует.

void. Добавленная запись не является подтверждением движения.

• Значение добавляется в список AddDir текущего состояния runtime. Сам вызов не передаёт пакет движения, не двигает персонажа и не имеет документированного публичного getter для чтения этого списка.

Каждый пример можно сохранить отдельным файлом .csx и запускать в IDE. Объект UO и функции ожидания предоставляет host текущей игровой сессии. Демонстрационные serial, имена, координаты и адреса замените своими.

Выполните этот код как отдельный файл .csx. Аргументы видны прямо в вызове; демонстрационные имена, serial и адреса замените своими.

Команда вызывается отдельной строкой. Сообщение перед ней показывает начало вызова, а не подтверждение действия сервера.

UO.Print("Calling UO.AddDir");
UO.AddDir("E");

Параметры и ход выполнения:

• Сохранить направление как совместимую legacy-запись, не двигая персонажа.

UO.AddDir("E");

Параметры и ход выполнения:

• Передать значение из переменной в legacy-список AddDir.

return  RunScenario();
 object? RunScenario()
{
    var directionEntry = "north-east";
    UO.AddDir(directionEntry);
    return null;
}

Параметры и ход выполнения:

• Каждый вызов добавляет ещё одну строковую запись в состояние runtime.
• Вспомогательная процедура также не отправляет команду движения.

return  new ScriptScenario(UO, WaitAsync, Args, Cancellation, Checkpoint).RunScenario();
class ScriptScenario
{
    private readonly global::ClassicUO.CSharp.CSharpGameApi UO;
    private readonly Func<int, Task> WaitAsync;
    private readonly string[] Args;
    private readonly CancellationToken Cancellation;
    private readonly Action Checkpoint;
    public ScriptScenario(global::ClassicUO.CSharp.CSharpGameApi api, Func<int, Task> wait, string[] args, CancellationToken cancellation, Action checkpoint)
    {
        UO = api;
        WaitAsync = wait;
        Args = args;
        Cancellation = cancellation;
        Checkpoint = checkpoint;
    }

     public object? RunScenario()
    {
        AddLegacyDirection("W");
        return null;
    }

    void AddLegacyDirection(dynamic entry)
    {
        UO.AddDir(entry);
    }
}

C# учитывает регистр. Используйте точное имя UO. Числовые флаги сравнивайте с 0; bool используйте только там, где сигнатура возвращает bool.

Параметры: directions (Any)

Результат: void / Unit.

При вызове:

• InjectionScript.Runtime.InjectionApiUO.ExecuteLegacyManualAlias.
• InjectionScript.Runtime.InjectionApiUO.ExecuteLegacyManualAlias::LegacyList: LegacyList(name).
• InjectionScript.Runtime.InjectionValue.ToString: value.ToString().

Внутренний код реализации, не самостоятельный скрипт.

case "adddir":

                case "addfindlist":

                case "addgate":

                case "addrecall":

                case "addstep":

                    LegacyList(name).Add(string.Join("|", arguments.Select(value => value.ToString())));

                    break;

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

void UO.AddStep(object? directions);

• directions — значение, которое runtime преобразует в текст и добавляет в compatibility-список AddStep. Направление само по себе не интерпретируется.

void. Вызов не возвращает значение и не подтверждает перемещение.

• Каждый вызов добавляет строковое представление аргумента в список AddStep текущего состояния runtime. Эта legacy-запись не отправляет команду движения и не имеет публичного getter в текущей реализации.

Каждый пример можно сохранить отдельным файлом .csx и запускать в IDE. Объект UO и функции ожидания предоставляет host текущей игровой сессии. Демонстрационные serial, имена, координаты и адреса замените своими.

Выполните этот код как отдельный файл .csx. Аргументы видны прямо в вызове; демонстрационные имена, serial и адреса замените своими.

Команда вызывается отдельной строкой. Сообщение перед ней показывает начало вызова, а не подтверждение действия сервера.

UO.Print("Calling UO.AddStep");
UO.AddStep(2);

Параметры и ход выполнения:

• Записать значение в legacy-список; персонаж не перемещается.

UO.AddStep(2);

Параметры и ход выполнения:

• Передать текстовое значение: оно сохраняется как запись, а не выполняется как направление.

return  RunScenario();
 object? RunScenario()
{
    var legacyValue = "east";
    UO.AddStep(legacyValue);
    return null;
}

Параметры и ход выполнения:

• Каждый вызов добавляет отдельную запись в AddStep текущего runtime.

return  new ScriptScenario(UO, WaitAsync, Args, Cancellation, Checkpoint).RunScenario();
class ScriptScenario
{
    private readonly global::ClassicUO.CSharp.CSharpGameApi UO;
    private readonly Func<int, Task> WaitAsync;
    private readonly string[] Args;
    private readonly CancellationToken Cancellation;
    private readonly Action Checkpoint;
    public ScriptScenario(global::ClassicUO.CSharp.CSharpGameApi api, Func<int, Task> wait, string[] args, CancellationToken cancellation, Action checkpoint)
    {
        UO = api;
        WaitAsync = wait;
        Args = args;
        Cancellation = cancellation;
        Checkpoint = checkpoint;
    }

     public object? RunScenario()
    {
        UO.AddStep(1);
        UO.AddStep(2);
        return null;
    }
}

C# учитывает регистр. Используйте точное имя UO. Числовые флаги сравнивайте с 0; bool используйте только там, где сигнатура возвращает bool.

Параметры: directions (Any)

Результат: void / Unit.

При вызове:

• InjectionScript.Runtime.InjectionApiUO.ExecuteLegacyManualAlias.
• InjectionScript.Runtime.InjectionApiUO.ExecuteLegacyManualAlias::LegacyList: LegacyList(name).
• InjectionScript.Runtime.InjectionValue.ToString: value.ToString().

Внутренний код реализации, не самостоятельный скрипт.

case "adddir":

                case "addfindlist":

                case "addgate":

                case "addrecall":

                case "addstep":

                    LegacyList(name).Add(string.Join("|", arguments.Select(value => value.ToString())));

                    break;

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

int UO.AlwaysRun();
void UO.AlwaysRun(object? enabled);

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

• enabled — 0 отключает постоянный бег; любое ненулевое значение включает его.

Форма без аргументов возвращает 1, если настройка включена, иначе 0. Форма с аргументом возвращает null.

• Значение читается из текущего профиля. Установка изменяет AlwaysRun и сохраняет текущий профиль. Без активного профиля getter возвращает 0, а setter сообщает об ошибке в клиентский журнал и не меняет настройку.

Каждый пример можно сохранить отдельным файлом .csx и запускать в IDE. Объект UO и функции ожидания предоставляет host текущей игровой сессии. Демонстрационные serial, имена, координаты и адреса замените своими.

Выполните этот код как отдельный файл .csx. Аргументы видны прямо в вызове; демонстрационные имена, serial и адреса замените своими.

Результат одного вызова выводится в журнал. Число не преобразуется в bool; для массива показано количество элементов.

var result = UO.AlwaysRun();
UO.Print("AlwaysRun: " + Convert.ToString(result));

Параметры и ход выполнения:

• Прочитать настройку; 1 означает, что постоянный бег включён.

var isAlwaysRunning = UO.AlwaysRun();
UO.Print(Convert.ToString(isAlwaysRunning));

Параметры и ход выполнения:

• Включить постоянный бег и сохранить настройку текущего профиля.

return  RunScenario();
 object? RunScenario()
{
    UO.AlwaysRun(1);
    return null;
}

Параметры и ход выполнения:

• Отключить постоянный бег, только если он сейчас включён.

return  new ScriptScenario(UO, WaitAsync, Args, Cancellation, Checkpoint).RunScenario();
class ScriptScenario
{
    private readonly global::ClassicUO.CSharp.CSharpGameApi UO;
    private readonly Func<int, Task> WaitAsync;
    private readonly string[] Args;
    private readonly CancellationToken Cancellation;
    private readonly Action Checkpoint;
    public ScriptScenario(global::ClassicUO.CSharp.CSharpGameApi api, Func<int, Task> wait, string[] args, CancellationToken cancellation, Action checkpoint)
    {
        UO = api;
        WaitAsync = wait;
        Args = args;
        Cancellation = cancellation;
        Checkpoint = checkpoint;
    }

     public object? RunScenario()
    {
        if (Truth(UO.AlwaysRun() != 0))
        {
            UO.AlwaysRun(0);
        }

        return null;
    }

    bool Truth(object? value) => value is bool flag ? flag : value is string text ? !string.IsNullOrEmpty(text) : value != null && Convert.ToDouble(value) != 0;
}

C# учитывает регистр. Используйте точное имя UO. Числовые флаги сравнивайте с 0; bool используйте только там, где сигнатура возвращает bool.

Параметры: Параметров нет.

Результат: int / Integer.

При вызове:

• InjectionScript.Runtime.InjectionApiUO.AlwaysRun.
• ClassicUO.Game.Managers.ClassicUOInjectionApiBridge.AlwaysRun: bridge.AlwaysRun().

Внутренний код реализации, не самостоятельный скрипт.

public int AlwaysRun() => bridge.AlwaysRun();

Параметры: enabled (Integer)

Результат: void / Unit.

При вызове:

• InjectionScript.Runtime.InjectionApiUO.AlwaysRun.
• ClassicUO.Game.Managers.ClassicUOInjectionApiBridge.AlwaysRun: bridge.AlwaysRun(enabled).

Внутренний код реализации, не самостоятельный скрипт.

public void AlwaysRun(int enabled) => bridge.AlwaysRun(enabled);

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

int UO.CalcDir(object? xfrom, object? yfrom, object? xto, object? yto);

Вычисляет направление от одной мировой точки к другой. Персонаж при этом не передвигается.

• xfrom — Координата X исходной точки.
• yfrom — Координата Y исходной точки.
• xto — Координата X назначения.
• yto — Координата Y назначения.

int — код направления: 0=север, 1=северо-восток, 2=восток, 3=юго-восток, 4=юг, 5=юго-запад, 6=запад, 7=северо-запад. Совпавшие точки дают 100. Это не bool: 0 означает север, а не неудачу; 1 означает северо-восток, а не успех. Не передавайте 100 команде шага как направление.

• Только вычисление координат: без пакетов, ожиданий, загрузки карты, проверки препятствий, Z и карты мира. Команда не ищет проходимый маршрут и не гарантирует достижение цели. Точки должны относиться к одной системе координат; обход препятствий может увеличить путь.
• Нужны все четыре параметра. Передавайте мировые координаты int в документированном диапазоне 0..65535. object? в сигнатуре обозначает универсальный адаптер, а не ID предмета. Значений по умолчанию, координат внутри сундука, пятого Z и перегрузки с одним объектом у этих команд нет.
• Из координат назначения вычитаются исходные, затем проверяются знаки разностей. Уменьшение Y — север, увеличение X — восток. Если меняются обе координаты, выбирается диагональ независимо от величины разностей. Если обе разности нулевые — 100.

Каждый пример можно сохранить отдельным файлом .csx и запускать в IDE. Объект UO и функции ожидания предоставляет host текущей игровой сессии. Демонстрационные serial, имена, координаты и адреса замените своими.

Выполните этот код как отдельный файл .csx. Аргументы видны прямо в вызове; демонстрационные имена, serial и адреса замените своими.

Результат одного вызова выводится в журнал. Число не преобразуется в bool; для массива показано количество элементов.

var result = UO.CalcDir(100, 100, 101, 100);
UO.Print("CalcDir: " + Convert.ToString(result));

Параметры и ход выполнения:

• Исходная точка (100,100), назначение (101,100): X увеличивается, Y не меняется. Main возвращает int 2 — восток. Команда передвижения не вызывается.
• int — код направления: 0=север, 1=северо-восток, 2=восток, 3=юго-восток, 4=юг, 5=юго-запад, 6=запад, 7=северо-запад. Совпавшие точки дают 100. Это не bool: 0 означает север, а не неудачу; 1 означает северо-восток, а не успех. Не передавайте 100 команде шага как направление.
• Из координат назначения вычитаются исходные, затем проверяются знаки разностей. Уменьшение Y — север, увеличение X — восток. Если меняются обе координаты, выбирается диагональ независимо от величины разностей. Если обе разности нулевые — 100.

return UO.CalcDir(100,100,101,100);

Параметры и ход выполнения:

• Обе точки равны (100,100). direction=100 означает совпадение, поэтому Main возвращает string "already there". При разных точках сработает другая ветка. Проверяется именно 100, а не true.
• int — код направления: 0=север, 1=северо-восток, 2=восток, 3=юго-восток, 4=юг, 5=юго-запад, 6=запад, 7=северо-запад. Совпавшие точки дают 100. Это не bool: 0 означает север, а не неудачу; 1 означает северо-восток, а не успех. Не передавайте 100 команде шага как направление.
• Из координат назначения вычитаются исходные, затем проверяются знаки разностей. Уменьшение Y — север, увеличение X — восток. Если меняются обе координаты, выбирается диагональ независимо от величины разностей. Если обе разности нулевые — 100.

return  RunScenario();
 object? RunScenario()
{
    var direction = UO.CalcDir(100, 100, 100, 100);
    if (Truth(direction == 100))
    {
        return "already there";
    }

    return "different point";
    return null;
}

bool Truth(object? value) => value is bool flag ? flag : value is string text ? !string.IsNullOrEmpty(text) : value != null && Convert.ToDouble(value) != 0;

Параметры и ход выполнения:

• При переходе от (20,20) к (19,21) X уменьшается, Y увеличивается: UO.CalcDir возвращает 5. RebuildDirection показывает все ветви этого алгоритма и тоже даёт 5. Main возвращает "5:5". Все четыре параметра помощника имеют тот же смысл координат.
• int — код направления: 0=север, 1=северо-восток, 2=восток, 3=юго-восток, 4=юг, 5=юго-запад, 6=запад, 7=северо-запад. Совпавшие точки дают 100. Это не bool: 0 означает север, а не неудачу; 1 означает северо-восток, а не успех. Не передавайте 100 команде шага как направление.
• Из координат назначения вычитаются исходные, затем проверяются знаки разностей. Уменьшение Y — север, увеличение X — восток. Если меняются обе координаты, выбирается диагональ независимо от величины разностей. Если обе разности нулевые — 100.

return  new ScriptScenario(UO, WaitAsync, Args, Cancellation, Checkpoint).RunScenario();
class ScriptScenario
{
    private readonly global::ClassicUO.CSharp.CSharpGameApi UO;
    private readonly Func<int, Task> WaitAsync;
    private readonly string[] Args;
    private readonly CancellationToken Cancellation;
    private readonly Action Checkpoint;
    public ScriptScenario(global::ClassicUO.CSharp.CSharpGameApi api, Func<int, Task> wait, string[] args, CancellationToken cancellation, Action checkpoint)
    {
        UO = api;
        WaitAsync = wait;
        Args = args;
        Cancellation = cancellation;
        Checkpoint = checkpoint;
    }

     public object? RunScenario()
    {
        var actual = UO.CalcDir(20, 20, 19, 21);
        var rebuilt = RebuildDirection(20, 20, 19, 21);
        return Convert.ToString(actual) + ":" + Convert.ToString(rebuilt);
        return null;
    }

    dynamic RebuildDirection(dynamic Xfrom, dynamic Yfrom, dynamic Xto, dynamic Yto)
    {
        var dx = Xto - Xfrom;
        var dy = Yto - Yfrom;
        if (Truth(dx == 0) && Truth(dy == 0))
        {
            return 100;
        }

        if (Truth(dx == 0))
        {
            if (Truth(dy < 0))
            {
                return 0;
            }

            return 4;
        }

        if (Truth(dy == 0))
        {
            if (Truth(dx > 0))
            {
                return 2;
            }

            return 6;
        }

        if (Truth(dx > 0))
        {
            if (Truth(dy < 0))
            {
                return 1;
            }

            return 3;
        }

        if (Truth(dy > 0))
        {
            return 5;
        }

        return 7;
    }

    bool Truth(object? value) => value is bool flag ? flag : value is string text ? !string.IsNullOrEmpty(text) : value != null && Convert.ToDouble(value) != 0;
}

C# учитывает регистр. Используйте точное имя UO. Числовые флаги сравнивайте с 0; bool используйте только там, где сигнатура возвращает bool.

Параметры: xfrom (Any), yfrom (Any), xto (Any), yto (Any)

Результат: int / Integer.

При вызове:

• InjectionScript.Runtime.InjectionApiUO.ExecuteClientApiCompatibility.
• InjectionScript.Runtime.InjectionApiUO.CalculateDirection: CalculateDirection(Arg(0), Arg(1), Arg(2), Arg(3)).
• InjectionScript.Runtime.InjectionApiUO.ExecuteClientApiCompatibility::Arg: Arg(0).

Внутренний код реализации, не самостоятельный скрипт.

case "calcdir": return new InjectionValue(CalculateDirection(Arg(0), Arg(1), Arg(2), Arg(3)));

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

void UO.CancelMove();

Отключает разрешение дальнейшего движения скриптом через MoveOff.

Параметров нет.

void — возвращаемого значения нет.

• Вызывает MoveOff, который переводит runtime/менеджер в состояние MoveEnabled=false. Чтобы снова разрешить движение, нужен MoveOn. Команда не откатывает уже отправленные шаги.

Каждый пример можно сохранить отдельным файлом .csx и запускать в IDE. Объект UO и функции ожидания предоставляет host текущей игровой сессии. Демонстрационные serial, имена, координаты и адреса замените своими.

Выполните этот код как отдельный файл .csx. Аргументы видны прямо в вызове; демонстрационные имена, serial и адреса замените своими.

Команда вызывается отдельной строкой. Сообщение перед ней показывает начало вызова, а не подтверждение действия сервера.

UO.Print("Calling UO.CancelMove");
UO.CancelMove();

Параметры и ход выполнения:

• Следующие команды движения учитывают выключенное разрешение.

UO.CancelMove();

Параметры и ход выполнения:

• MoveOn явно восстанавливает разрешение.

return  RunScenario();
 object? RunScenario()
{
    UO.CancelMove();
    UO.MoveOn();
    return null;
}

Параметры и ход выполнения:

• Отключённое соединение используется как условие для запрета последующих шагов.

return  new ScriptScenario(UO, WaitAsync, Args, Cancellation, Checkpoint).RunScenario();
class ScriptScenario
{
    private readonly global::ClassicUO.CSharp.CSharpGameApi UO;
    private readonly Func<int, Task> WaitAsync;
    private readonly string[] Args;
    private readonly CancellationToken Cancellation;
    private readonly Action Checkpoint;
    public ScriptScenario(global::ClassicUO.CSharp.CSharpGameApi api, Func<int, Task> wait, string[] args, CancellationToken cancellation, Action checkpoint)
    {
        UO = api;
        WaitAsync = wait;
        Args = args;
        Cancellation = cancellation;
        Checkpoint = checkpoint;
    }

     public object? RunScenario()
    {
        if (!(Truth(UO.Connected())))
        {
            UO.CancelMove();
        }

        return null;
    }

    bool Truth(object? value) => value is bool flag ? flag : value is string text ? !string.IsNullOrEmpty(text) : value != null && Convert.ToDouble(value) != 0;
}

C# учитывает регистр. Используйте точное имя UO. Числовые флаги сравнивайте с 0; bool используйте только там, где сигнатура возвращает bool.

Параметры: Параметров нет.

Результат: void / Unit.

При вызове:

• InjectionScript.Runtime.InjectionApiUO.ExecuteLegacyManualAlias.
• InjectionScript.Runtime.InjectionApiUO.MoveOff: MoveOff().

Внутренний код реализации, не самостоятельный скрипт.

case "cancelmove": MoveOff(); break;

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

int UO.Dir();

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

Параметров нет.

int — направление mobile без бита бега: 0=N, 1=NE, 2=E, 3=SE, 4=S, 5=SW, 6=W, 7=NW. Для неизвестного mobile возвращается 0, которое также означает север.

• Читаются уже полученные локальные данные. Запрос не открывает status и не заставляет сервер прислать обновление. После смерти, перехода карты или удаления объекта значения могут измениться между двумя вызовами.
• C# учитывает регистр. Используйте точное имя UO. Числовые флаги сравнивайте с 0; bool используйте только там, где сигнатура возвращает bool.

Каждый пример можно сохранить отдельным файлом .csx и запускать в IDE. Объект UO и функции ожидания предоставляет host текущей игровой сессии. Демонстрационные serial, имена, координаты и адреса замените своими.

Выполните этот код как отдельный файл .csx. Аргументы видны прямо в вызове; демонстрационные имена, serial и адреса замените своими.

Результат одного вызова выводится в журнал. Число не преобразуется в bool; для массива показано количество элементов.

var result = UO.Dir();
UO.Print("Dir: " + Convert.ToString(result));

Параметры и ход выполнения:

• Вызов без аргументов относится к self. Направление персонажа сохраняется в value.
• Convert.ToString преобразует число для вывода и не меняет смысл результата.

var value = UO.Dir();
UO.Print("Dir: " + Convert.ToString(value));

Параметры и ход выполнения:

• Значение читается один раз без аргументов. Направление персонажа используется в показанном расчёте или условии.
• Числовые пороги — пример условий скрипта, а не новые пределы клиента. Поле сохраняет серверные единицы и ограничения, описанные выше.

return  RunScenario();
 object? RunScenario()
{
    var value = UO.Dir();
    if (Truth(value == 2))
    {
        UO.Print("Facing east");
    }

    return null;
}

bool Truth(object? value) => value is bool flag ? flag : value is string text ? !string.IsNullOrEmpty(text) : value != null && Convert.ToDouble(value) != 0;

Параметры и ход выполнения:

• Оба вызова без аргумента читают своё текущее значение. UO.Wait(1000) даёт паузу в миллисекундах между снимками.
• Сравнивается изменение: направление персонажа. Пример ничего не изменяет в мире и не ждёт бесконечно. События внутри этой секунды могут быть пропущены.

return await new ScriptScenario(UO, WaitAsync, Args, Cancellation, Checkpoint).RunScenarioAsync();
class ScriptScenario
{
    private readonly global::ClassicUO.CSharp.CSharpGameApi UO;
    private readonly Func<int, Task> WaitAsync;
    private readonly string[] Args;
    private readonly CancellationToken Cancellation;
    private readonly Action Checkpoint;
    public ScriptScenario(global::ClassicUO.CSharp.CSharpGameApi api, Func<int, Task> wait, string[] args, CancellationToken cancellation, Action checkpoint)
    {
        UO = api;
        WaitAsync = wait;
        Args = args;
        Cancellation = cancellation;
        Checkpoint = checkpoint;
    }

    async public Task<object?> RunScenarioAsync()
    {
        var before = UO.Dir();
        await Delay(1000);
        var after = UO.Dir();
        if (Truth(before != after))
        {
            UO.Print("Before: " + Convert.ToString(before) + "; after: " + Convert.ToString(after));
        }

        return null;
    }

    Task Delay(object? milliseconds) => WaitAsync(checked((int)Convert.ToDouble(milliseconds)));
    bool Truth(object? value) => value is bool flag ? flag : value is string text ? !string.IsNullOrEmpty(text) : value != null && Convert.ToDouble(value) != 0;
}

C# учитывает регистр. Используйте точное имя UO. Числовые флаги сравнивайте с 0; bool используйте только там, где сигнатура возвращает bool.

Параметры: Параметров нет.

Результат: int / Integer.

При вызове:

• InjectionScript.Runtime.InjectionApiUO.RegisterCharacterGetterAliases [Dir].
• ClassicUO.Game.Managers.ClassicUOInjectionApiBridge.GetDir: bridge.GetDir(bridge.Self).
• ClassicUO.Game.Managers.ClassicUOInjectionApiBridge.Self: bridge.Self.

Вызов выполняет сохранённый delegate обработчика. Метод регистрации создаёт этот delegate при построении API.

Внутренний код реализации, не самостоятельный скрипт.

() => bridge.GetDir(bridge.Self)

Создание API: Эти функции создают регистрацию API; они не выполняются заново при каждом вызове команды.

• InjectionScript.Runtime.InjectionApiUO.RegisterCharacterGetterAliases::AddInteger.

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

int UO.Direction();

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

Параметров нет.

int — направление mobile без бита бега: 0=N, 1=NE, 2=E, 3=SE, 4=S, 5=SW, 6=W, 7=NW. Для неизвестного mobile возвращается 0, которое также означает север.

• Читаются уже полученные локальные данные. Запрос не открывает status и не заставляет сервер прислать обновление. После смерти, перехода карты или удаления объекта значения могут измениться между двумя вызовами.
• C# учитывает регистр. Используйте точное имя UO. Числовые флаги сравнивайте с 0; bool используйте только там, где сигнатура возвращает bool.

Каждый пример можно сохранить отдельным файлом .csx и запускать в IDE. Объект UO и функции ожидания предоставляет host текущей игровой сессии. Демонстрационные serial, имена, координаты и адреса замените своими.

Выполните этот код как отдельный файл .csx. Аргументы видны прямо в вызове; демонстрационные имена, serial и адреса замените своими.

Результат одного вызова выводится в журнал. Число не преобразуется в bool; для массива показано количество элементов.

var result = UO.Direction();
UO.Print("Direction: " + Convert.ToString(result));

Параметры и ход выполнения:

• Вызов без аргументов относится к self. Направление персонажа сохраняется в value.
• Convert.ToString преобразует число для вывода и не меняет смысл результата.

var value = UO.Direction();
UO.Print("Direction: " + Convert.ToString(value));

Параметры и ход выполнения:

• Значение читается один раз без аргументов. Направление персонажа используется в показанном расчёте или условии.
• Числовые пороги — пример условий скрипта, а не новые пределы клиента. Поле сохраняет серверные единицы и ограничения, описанные выше.

return  RunScenario();
 object? RunScenario()
{
    var value = UO.Direction();
    if (Truth(value == 2))
    {
        UO.Print("Facing east");
    }

    return null;
}

bool Truth(object? value) => value is bool flag ? flag : value is string text ? !string.IsNullOrEmpty(text) : value != null && Convert.ToDouble(value) != 0;

Параметры и ход выполнения:

• Оба вызова без аргумента читают своё текущее значение. UO.Wait(1000) даёт паузу в миллисекундах между снимками.
• Сравнивается изменение: направление персонажа. Пример ничего не изменяет в мире и не ждёт бесконечно. События внутри этой секунды могут быть пропущены.

return await new ScriptScenario(UO, WaitAsync, Args, Cancellation, Checkpoint).RunScenarioAsync();
class ScriptScenario
{
    private readonly global::ClassicUO.CSharp.CSharpGameApi UO;
    private readonly Func<int, Task> WaitAsync;
    private readonly string[] Args;
    private readonly CancellationToken Cancellation;
    private readonly Action Checkpoint;
    public ScriptScenario(global::ClassicUO.CSharp.CSharpGameApi api, Func<int, Task> wait, string[] args, CancellationToken cancellation, Action checkpoint)
    {
        UO = api;
        WaitAsync = wait;
        Args = args;
        Cancellation = cancellation;
        Checkpoint = checkpoint;
    }

    async public Task<object?> RunScenarioAsync()
    {
        var before = UO.Direction();
        await Delay(1000);
        var after = UO.Direction();
        if (Truth(before != after))
        {
            UO.Print("Before: " + Convert.ToString(before) + "; after: " + Convert.ToString(after));
        }

        return null;
    }

    Task Delay(object? milliseconds) => WaitAsync(checked((int)Convert.ToDouble(milliseconds)));
    bool Truth(object? value) => value is bool flag ? flag : value is string text ? !string.IsNullOrEmpty(text) : value != null && Convert.ToDouble(value) != 0;
}

C# учитывает регистр. Используйте точное имя UO. Числовые флаги сравнивайте с 0; bool используйте только там, где сигнатура возвращает bool.

Параметры: Параметров нет.

Результат: int / Integer.

При вызове:

• InjectionScript.Runtime.InjectionApiUO.RegisterCharacterGetterAliases [Direction].
• ClassicUO.Game.Managers.ClassicUOInjectionApiBridge.GetDir: bridge.GetDir(bridge.Self).
• ClassicUO.Game.Managers.ClassicUOInjectionApiBridge.Self: bridge.Self.

Вызов выполняет сохранённый delegate обработчика. Метод регистрации создаёт этот delegate при построении API.

Внутренний код реализации, не самостоятельный скрипт.

() => bridge.GetDir(bridge.Self)

Создание API: Эти функции создают регистрацию API; они не выполняются заново при каждом вызове команды.

• InjectionScript.Runtime.InjectionApiUO.RegisterCharacterGetterAliases::AddInteger.

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

void UO.FixWalk();

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

Параметров нет.

void — возвращаемого значения нет.

• Ветка ExecuteLegacyManualAlias только вызывает SystemMessage. Она не исправляет движение, речь, контейнеры или сетевой протокол.

Каждый пример можно сохранить отдельным файлом .csx и запускать в IDE. Объект UO и функции ожидания предоставляет host текущей игровой сессии. Демонстрационные serial, имена, координаты и адреса замените своими.

Выполните этот код как отдельный файл .csx. Аргументы видны прямо в вызове; демонстрационные имена, serial и адреса замените своими.

Команда вызывается отдельной строкой. Сообщение перед ней показывает начало вызова, а не подтверждение действия сервера.

UO.Print("Calling UO.FixWalk");
UO.FixWalk();

Параметры и ход выполнения:

• Сообщение описывает отсутствие необходимости в старом патче.

UO.FixWalk();

Параметры и ход выполнения:

• Процедура совместимости не изменяет игровой мир.

return  RunScenario();
 object? RunScenario()
{
    CompatibilityNotice();
    return null;
}

void CompatibilityNotice()
{
    UO.FixWalk();
}

Параметры и ход выполнения:

• После диагностического сообщения выполнение продолжается.

return  new ScriptScenario(UO, WaitAsync, Args, Cancellation, Checkpoint).RunScenario();
class ScriptScenario
{
    private readonly global::ClassicUO.CSharp.CSharpGameApi UO;
    private readonly Func<int, Task> WaitAsync;
    private readonly string[] Args;
    private readonly CancellationToken Cancellation;
    private readonly Action Checkpoint;
    public ScriptScenario(global::ClassicUO.CSharp.CSharpGameApi api, Func<int, Task> wait, string[] args, CancellationToken cancellation, Action checkpoint)
    {
        UO = api;
        WaitAsync = wait;
        Args = args;
        Cancellation = cancellation;
        Checkpoint = checkpoint;
    }

     public object? RunScenario()
    {
        UO.FixWalk();
        UO.Print("continued");
        return null;
    }
}

C# учитывает регистр. Используйте точное имя UO. Числовые флаги сравнивайте с 0; bool используйте только там, где сигнатура возвращает bool.

Параметры: Параметров нет.

Результат: void / Unit.

При вызове:

• InjectionScript.Runtime.InjectionApiUO.ExecuteLegacyManualAlias.
• InjectionScript.Runtime.InjectionApiUO.SystemMessage: SystemMessage($"{name}: obsolete native-client patch; ClassicUO does not require it.").

Внутренний код реализации, не самостоятельный скрипт.

case "boxhack":

                case "fixtalk":

                case "fixwalk":

                    SystemMessage($"{name}: obsolete native-client patch; ClassicUO does not require it.");

                    break;

Follow применяет UO.LimitMove, moveCheckStamina, moveOpenDoor, moveThroughCorner, moveThroughNPC, moveHeuristicMult, moveTurnCost, moveExitOnDisconnect, moveBetweenTwoCorners и снимок SetBadLocation/SetBadObject. Дистанция подхода 0 разрешена также для персонажа; это не предел дальности UO.LimitMove.

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

int UO.Follow();
int UO.Follow(object? target);
int UO.Follow(object? target, object? distance);
int UO.Follow(object? target, object? distance, object? running);
int UO.Follow(object? target, object? distance, object? running, object? stopConditions);
int UO.Follow(object? x, object? y, object? z, object? distance, object? running);
int UO.Follow(object? x, object? y, object? z, object? distance, object? running, object? stopConditions);

Включает фоновое следование за загруженным персонажем/NPC либо движение к точке X, Y, Z. Во время движения клиент проверяет переданные условия остановки; скрипт продолжает выполнение сразу после вызова.

• target — Serial персонажа/NPC: int, hex/десятичная строка, lasttarget либо имя, ранее сохранённое через AddObject. Это не graphic/type и не координаты. Нельзя следовать за собой или предметом. 0 останавливает следование. Без аргументов Follow() также останавливает его; прицел не появляется.
• distance — Допуск по X/Y в клетках: максимум |dx| и |dy|. Для персонажа int 0..18, по умолчанию 1; разница Z до 16 допустима. Для точки int 0..18, аргумент обязателен: 0 требует точного X/Y, 2 допускает остановку в пределах двух клеток; Z должен совпасть точно. Недопустимое значение не заменяет прежний режим.
• running — bool-совместимое значение: true/1 — бег, false/0 — ходьба; по умолчанию true. Серверные ограничения скорости, выносливость, паралич и препятствия сохраняются. Флаг не ускоряет серверные шаги.
• stopConditions — Необязательный массив условий остановки: четвёртый аргумент для персонажа, шестой для координат. Каждый элемент — массив ровно из трёх значений [field, comparison, threshold]. field и comparison — строки, threshold — int/double; для флагов подходят true/false (1/0). Срабатывание ЛЮБОГО условия прекращает Follow (OR). Пустой массив не добавляет условий. Число элементов не ограничено фиксированными 3/5/10 пунктами, но ограничено памятью; большие списки проверяются порциями. Разрешённые поля и единицы перечислены ниже; неизвестное поле, оператор или неправильная форма массива вызывают ошибку до замены прежнего Follow.
• x — Только формы с 5/6 аргументами: целые мировые координаты на текущей карте, 0..65535 и внутри загруженных границ карты. Это не координаты окна/gump и не serial. Переход на другую карту не выполняется.
• y — Только формы с 5/6 аргументами: целые мировые координаты на текущей карте, 0..65535 и внутри загруженных границ карты. Это не координаты окна/gump и не serial. Переход на другую карту не выполняется.
• z — Только формы с 5/6 аргументами: целая высота мира -128..127. Для завершения требуется именно эта высота, поэтому указывайте Z доступной поверхности нужного этажа. Отдельных значений «любой Z» или автоматического выбора высоты нет.

int 1 (true) — режим следования принят клиентом, либо выполнен запрос остановки; int 0 (false) — нет подходящего загруженного персонажа, игрок недоступен/мёртв, цель вне обзора, неверна дистанция или клиент не поддерживает команду. Это не результат прибытия, не serial и не число шагов. В C# используйте if (result != 0) либо if (result == 1); result имеет тип int, а не bool. Ошибки типов/неизвестного имени объекта могут вызвать ошибку скрипта. Для координат 0 также означает недопустимые X/Y/Z или допуск. 1 означает только принятие фоновой задачи; прибытие и будущая проходимость ещё не подтверждены.

• Ровно один режим Follow на клиента: персонаж или координаты. Повторный успешный вызов заменяет цель и параметры. Неуспешный вызов не отменяет прежнюю цель. Для следования за персонажем он должен уже находиться в загруженном списке Mobiles в пределах ClientViewRange; координатная точка может находиться дальше обзора.
• При достижении distance возле персонажа ходьба прекращается, но режим остаётся включённым и возобновляет движение, когда цель отходит. Возле координатной точки задача полностью завершается при соблюдении допуска X/Y и точного Z. Команда не сообщает о гарантированной достижимости маршрута при запуске.
• Follow(), Follow(0), MoverStop(), ручное перемещение мышью/стрелками, новый скриптовый маршрут или стандартное следование клиента прекращают этот режим. TerminateAll/Terminate("all") также его останавливают. Отмена ещё выполняющегося скрипта-владельца останавливает его Follow.
• Оба режима прекращаются при смене карты или персонажа, смерти игрока и разрыве соединения. Следование за персонажем дополнительно прекращается при исчезновении цели из памяти/обзора. Появление цели позднее не запускает режим автоматически: нужен новый Follow.
• Закрытие IDE не останавливает режим. Нормальное завершение запустившего скрипта оставляет Follow включённым. Пауза скрипта сама по себе не является паузой этого клиентского режима; перед паузой используйте Follow(0), когда движение нужно прекратить.
• Pathfinder рассчитывает путь порциями на игровом потоке; незавершённый поиск не перезапускается. Для mobile обычное обновление маршрута ограничено 500 мс. После отказа или окончания маршрута без приближения первые три задержки повторной попытки равны 1000 мс, затем 2000, 4000 и максимум 5000 мс. Счётчик отказов сбрасывается при изменении X/Y/Z игрока или цели; изменение цели может сократить ожидание до 500 мс. Общего предела числа повторов для доступной mobile-цели нет: режим может оставаться активным без движения, поэтому задайте elapsed или явно остановите его. Координатная задача при окончательном отказе пути завершается.
• Поля расстояния/времени: distance — текущая дистанция до цели в клетках max(abs(dx),abs(dy)); height — абсолютная разность Z в единицах мира; elapsed — миллисекунды с принятия этого Follow. distance > 12 останавливает при удалении дальше 12 клеток, elapsed >= 30000 — после 30 секунд. Повторный успешный Follow начинает отсчёт заново.
• Состояние своего персонажа: self.hp / self.mana / self.stam — текущие значения; self.hppercent / self.manapercent / self.stampercent — проценты 0..100 от соответствующего максимума. Неизвестный максимум (<=0) означает неизвестное значение: условие по этой характеристике не срабатывает, а не получает выдуманный 0.
• Логические поля своего персонажа: self.poisoned (отравлен), self.paralyzed (парализован), self.hidden (скрыт). Значения 1/0. В массиве условий Follow правило для поля "self.paralyzed" с оператором "=" и значением true прекращает следование при параличе. Это строковое имя поля правила, а не C#-переменная self.
• Поля цели: target.dead — мёртвый mobile, target.hidden — скрыт, target.visible — видим клиенту (не CheckLOS), target.hp / target.hppercent — загруженные HP/проценты. Если HP max неизвестен, условие HP не срабатывает. Сервер может прислать относительную шкалу HP чужого персонажа, поэтому для неё удобнее hppercent.
• Дополнительные поля цели: target.notoriety — статус 0..7 (0 неизвестный, 1 Innocent, 2 Ally, 3 Gray, 4 Criminal, 5 Enemy, 6 Murderer, 7 Invulnerable); target.body — числовой graphic тела. Это не type одежды. Например target.notoriety != 2 прекращает сопровождение при потере статуса Ally.
• Копия условий фиксируется при вызове, включая числовые пороги. Изменение исходного массива/переменной не обновляет режим; повторите Follow с новым массивом. Отменённый режим сам не возобновляется, когда условие перестанет выполняться.
• Условия проверяются и во время движения, и когда персонаж уже стоит возле цели. Обычный список до 64 элементов проверяется за один игровой кадр, следующая проверка не раньше чем через 250 мс. Больший список — по 64 элемента за кадр, затем пауза 250 мс. Поле elapsed может остановить позже порога на время проверки/кадра: это не точный таймер.
• До окончания первой проверки всего списка новый маршрут не начинается. Если условие уже выполнено, Follow вернёт 1 за принятый запрос, затем остановится на обновлении без первого шага. Пакеты шагов от прежнего движения уже могли быть отправлены.
• Новые условия не отключают обязательные причины остановки: потерю цели/игрока/карты/соединения, смерть игрока, отмену владельца, Terminate all и ручное/другое движение. Скриптовый код не выполняется на игровом потоке; проверяются только перечисленные локальные значения.
• Координатные формы: Follow(x,y,z,distance,running) и Follow(x,y,z,distance,running,stopConditions). Первые пять аргументов обязательны. Follow(x,y,z) не является короткой записью координат: три аргумента по-прежнему означают target,distance,running.
• В координатном режиме distance в условии означает оставшееся расстояние по X/Y до точки, height — абсолютную разницу с её Z; elapsed и все self.* работают как обычно. Поля target.* недопустимы: у точки нет HP, тела или статуса. Попытка передать их вызывает ошибку скрипта до замены прежнего режима.
• Условия проверяются до первого маршрута, во время его расчёта и пока персонаж движется. Срабатывание любого условия снимает задачу и отменяет принадлежащий ей путь. Частота и обработка больших списков такие же, как при следовании за персонажем; уже отправленные серверу шаги могут завершиться.
• Координатная задача завершается при достижении точки либо отказе/окончании поиска и движения без достижения. Бесконечные повторы к недоступной точке не запускаются. Обычные внутренние перерасчёты Pathfinder при препятствиях сохраняются. После завершения уход с места не возобновляет задачу.
• Если Pathfinder уже отправил последние шаги и закончил путь, но эти шаги ещё выполняются/ожидают подтверждения, задача продолжает проверять условия. Сама очередь отправленных шагов не стирается: её должен обработать обычный механизм движения и подтверждений сервера.
• Список можно собрать через List.Add в DO … конец цикла или FOR, а затем один раз передать checks.ToArray() последним аргументом соответствующей формы. Не нужно вызывать Follow заново на каждой итерации: это заменяет режим и сбрасывает elapsed. Количество строк не ограничено небольшим числом, но набор поддерживаемых field ограничен перечисленными выше полями.
• После 2000 мс без изменения X/Y/Z игрока mobile-Follow может заново запросить путь к неподвижной цели. Проверка выполняется только при наступлении очередного срока, вне поиска, после освобождения Player.Steps и очереди Walker и когда разрешён следующий шаг. Медленный темп движения и ожидание подтверждений не обходятся; отправленные шаги не стираются. Координатный Follow не запускает такой внешний бесконечный повтор: восстановлением его пути занимается ограниченный Pathfinder.
• Общий Pathfinder хранит до 8 временных запретов направленного перехода X/Y/Z на 2000 мс, только по отклонённому перемещению соответствующего активного запроса. Поворот, неизвестный sequence, ресинхронизация и старый/чужой запрос не создают такой запрет. Новый внешний запрос и потеря контекста карты/игрока очищают их. Поиск по загруженной геометрии пытается обойти переход; это не знание всех серверных препятствий. Без изменения X/Y/Z игрока разрешены до 8 внутренних перерасчётов с паузой не меньше 40 мс. Нет полного пути или исчерпан этот бюджет — маршрут заканчивается. Координатная задача затем завершается после обработки отправленных шагов; mobile-Follow может повторить попытку по своей задержке.
• Контроллер сравнивает номер собственного запроса движения, а не факт AutoWalking: естественное окончание пути не считается чужой командой. StopOwnedPath передаёт сохранённый номер в StopAutoWalkIfRequestGeneration. Новый внешний запрос прекращает старый Follow; его остановка не отменяет новый чужой маршрут.

Каждый пример можно сохранить отдельным файлом .csx и запускать в IDE. Объект UO и функции ожидания предоставляет host текущей игровой сессии. Демонстрационные serial, имена, координаты и адреса замените своими.

Выполните этот код как отдельный файл .csx. Аргументы видны прямо в вызове; демонстрационные имена, serial и адреса замените своими.

Результат одного вызова выводится в журнал. Число не преобразуется в bool; для массива показано количество элементов.

var result = UO.Follow();
UO.Print("Follow: " + Convert.ToString(result));

Параметры и ход выполнения:

• leader — serial последней цели. Единица подтверждает принятие режима, а не прибытие. После конец метода режим продолжает работать до остановки/потери цели.

var leader = UO.GetSerial("lasttarget");
var accepted = UO.Follow(leader);
if (Truth(Truth(accepted) == true))
{
    UO.Print("Following is enabled; script continues");
}
else
{
    UO.Print("Select a loaded nearby character");
}

bool Truth(object? value) => value is bool flag ? flag : value is string text ? !string.IsNullOrEmpty(text) : value != null && Convert.ToDouble(value) != 0;

Параметры и ход выполнения:

• UO.Wait измеряется в миллисекундах. Follow(0) выключает общий режим следования; последующие перемещения цели больше не вызывают движение.

return await RunScenarioAsync();
async Task<object?> RunScenarioAsync()
{
    var leader = UO.GetSerial("lasttarget");
    if (Truth(UO.Follow(leader, 3, false) == 1))
    {
        await Delay(10000);
        UO.Follow(0);
        UO.Print("Following stopped");
    }

    return null;
}

Task Delay(object? milliseconds) => WaitAsync(checked((int)Convert.ToDouble(milliseconds)));
bool Truth(object? value) => value is bool flag ? flag : value is string text ? !string.IsNullOrEmpty(text) : value != null && Convert.ToDouble(value) != 0;

Параметры и ход выполнения:

• distance=2, running=true; максимум 20 ожиданий по 500 мс. Exists проверяет наличие объекта, не достижимость пути. finally останавливает режим при обычном выходе/ошибке; аварийная отмена владельца дополнительно обрабатывается клиентом.

return await new ScriptScenario(UO, WaitAsync, Args, Cancellation, Checkpoint).RunScenarioAsync();
class ScriptScenario
{
    private readonly global::ClassicUO.CSharp.CSharpGameApi UO;
    private readonly Func<int, Task> WaitAsync;
    private readonly string[] Args;
    private readonly CancellationToken Cancellation;
    private readonly Action Checkpoint;
    public ScriptScenario(global::ClassicUO.CSharp.CSharpGameApi api, Func<int, Task> wait, string[] args, CancellationToken cancellation, Action checkpoint)
    {
        UO = api;
        WaitAsync = wait;
        Args = args;
        Cancellation = cancellation;
        Checkpoint = checkpoint;
    }

    async public Task<object?> RunScenarioAsync()
    {
        var leader = UO.GetSerial("leader");
        if (Truth(UO.Follow(leader, 2, true) == 0))
        {
            UO.Print("Cannot start following");
            return null;
        }

        try
        {
            var attempts = 0;
            while (Truth(attempts < 20) && Truth(UO.Exists(leader)))
            {
                await Delay(500);
                attempts = attempts + 1;
            }
        }
        finally
        {
            UO.Follow();
        }

        return null;
    }

    Task Delay(object? milliseconds) => WaitAsync(checked((int)Convert.ToDouble(milliseconds)));
    bool Truth(object? value) => value is bool flag ? flag : value is string text ? !string.IsNullOrEmpty(text) : value != null && Convert.ToDouble(value) != 0;
}

Параметры и ход выполнения:

• Остановка по ЛЮБОМУ условию: цель дальше 12 клеток ИЛИ наши HP не больше 40% ИЛИ прошло 30 секунд. Это не AND. StopWhen приведена полностью, её можно вынести в Include. Единица означает принятие, не прибытие.

var leader = UO.GetSerial("lasttarget");
dynamic[] conditions = new dynamic[checked((int)(2) + 1)];
conditions[0] = StopWhen("distance", ">", 12);
conditions[1] = StopWhen("self.hppercent", "<=", 40);
conditions[2] = StopWhen("elapsed", ">=", 30000);
var accepted = UO.Follow(leader, 2, true, conditions);
if (Truth(accepted == 0))
{
    UO.Print("Cannot follow this target");
}

dynamic StopWhen(dynamic field, dynamic comparison, dynamic threshold)
{
    dynamic[] rule = new dynamic[checked((int)(2) + 1)];
    rule[0] = field;
    rule[1] = comparison;
    rule[2] = threshold;
    return rule;
}

bool Truth(object? value) => value is bool flag ? flag : value is string text ? !string.IsNullOrEmpty(text) : value != null && Convert.ToDouble(value) != 0;

Параметры и ход выполнения:

• Останавливаемся, если цель скрылась/умерла/перестала быть Ally, осталось не больше 5 выносливости либо перепад Z превысил 16. false означает идти пешком. ToArray передаёт список строк условий; размер заранее не задаётся. Если цель уже не Ally, движение не начнётся.

return  RunScenario();
 object? RunScenario()
{
    var checks = new List<object?>();
    checks.Add(StopWhen("target.hidden", "=", true));
    checks.Add(StopWhen("target.dead", "=", true));
    checks.Add(StopWhen("target.notoriety", "<>", 2));
    checks.Add(StopWhen("self.stam", "<=", 5));
    checks.Add(StopWhen("height", ">", 16));
    var leader = UO.GetSerial("lasttarget");
    var conditions = checks.ToArray();
    UO.Follow(leader, 2, false, conditions);
    return null;
}

dynamic StopWhen(dynamic field, dynamic comparison, dynamic threshold)
{
    dynamic[] rule = new dynamic[checked((int)(2) + 1)];
    rule[0] = field;
    rule[1] = comparison;
    rule[2] = threshold;
    return rule;
}

Параметры и ход выполнения:

• Поддерживаемая дистанция 1, условие остановки <=3; проверка каждые 250 мс может заметить достижение с задержкой. Таймаут 15000 мс не позволяет сопровождать бесконечно. Возврат Follow всё ещё означает принятие, не достижение трёх клеток.

return  new ScriptScenario(UO, WaitAsync, Args, Cancellation, Checkpoint).RunScenario();
class ScriptScenario
{
    private readonly global::ClassicUO.CSharp.CSharpGameApi UO;
    private readonly Func<int, Task> WaitAsync;
    private readonly string[] Args;
    private readonly CancellationToken Cancellation;
    private readonly Action Checkpoint;
    public ScriptScenario(global::ClassicUO.CSharp.CSharpGameApi api, Func<int, Task> wait, string[] args, CancellationToken cancellation, Action checkpoint)
    {
        UO = api;
        WaitAsync = wait;
        Args = args;
        Cancellation = cancellation;
        Checkpoint = checkpoint;
    }

     public object? RunScenario()
    {
        dynamic[] conditions = new dynamic[checked((int)(1) + 1)];
        conditions[0] = StopWhen("distance", "<=", 3);
        conditions[1] = StopWhen("elapsed", ">=", 15000);
        UO.Follow(UO.GetSerial("lasttarget"), 1, true, conditions);
        return null;
    }

    dynamic StopWhen(dynamic field, dynamic comparison, dynamic threshold)
    {
        dynamic[] rule = new dynamic[checked((int)(2) + 1)];
        rule[0] = field;
        rule[1] = comparison;
        rule[2] = threshold;
        return rule;
    }
}

Параметры и ход выполнения:

• while собирает отдельное условие для каждого элемента statuses. Остановка при статусе 5 ИЛИ 6, своих HP <=40% ИЛИ через 30000 мс. Пустой statuses пропустит цикл, но два следующих условия останутся. Новые строки добавляйте до Follow; последующее изменение List не изменяет уже установленную копию. Для background-проверок тело цикла не требуется выполнять повторно.

var statuses = new List<object?>();
statuses.Add(5);
statuses.Add(6);
var checks = new List<object?>();
var index = 0;
while (index < statuses.Count)
{
checks.Add(StopWhen("target.notoriety", "=", statuses[index]));
index += 1;
}
checks.Add(StopWhen("self.hppercent", "<=", 40));
checks.Add(StopWhen("elapsed", ">=", 30000));
var accepted = UO.Follow(UO.GetSerial("lasttarget"), 2, true, checks.ToArray());
if (Truth(accepted == 0))
{
    UO.Print("Select a loaded nearby character");
}

dynamic StopWhen(dynamic field, dynamic comparison, dynamic threshold)
{
    dynamic[] rule = new dynamic[checked((int)(2) + 1)];
    rule[0] = field;
    rule[1] = comparison;
    rule[2] = threshold;
    return rule;
}

bool Truth(object? value) => value is bool flag ? flag : value is string text ? !string.IsNullOrEmpty(text) : value != null && Convert.ToDouble(value) != 0;

Параметры и ход выполнения:

• StopEscort(leader, startedAt) возвращает bool-совместимые 1/0: цель дальше 12 клеток ИЛИ свои HP <=30 ИЛИ прошло 30 секунд. Добавляйте || (ещё_условие); для обязательного сочетания двух проверок используйте (условиеA && условиеB). Неизвестные HP могут читаться как 0; пример тогда отказывается начинать. Пока скрипт выполняется, он проверяет выражения примерно каждые 250 мс; пауза скрипта приостанавливает эти проверки. Finally отправляет остановку при обычном выходе/ошибке; отмену владельца дополнительно отслеживает клиент. Если цель исчезла и клиент уже остановил Follow, этот цикл завершится по своим условиям, не позже проверки таймаута. Для работы после конец метода используйте четвёртый аргумент, как в предыдущих примерах.

return  RunScenario();
 object? RunScenario()
{
    var leader = UO.GetSerial("lasttarget");
    var startedAt = Now();
    if (Truth(leader == "0x00000000") || Truth(StopEscort(leader, startedAt)))
    {
        return null;
    }

    if (Truth(UO.Follow(leader, 2, true) == 0))
    {
        return null;
    }

    try
    {
        do
        {
            UO.Wait(250);
        }
        while (!StopEscort(leader, startedAt));
    }
    finally
    {
        UO.Follow(0);
    }

    return null;
}

dynamic StopEscort(dynamic leader, dynamic startedAt)
{
    return (UO.GetDistance(leader) > 12) || (UO.GetHP("self") <= 30) || (Now() - startedAt >= 30000);
}

bool Truth(object? value) => value is bool flag ? flag : value is string text ? !string.IsNullOrEmpty(text) : value != null && Convert.ToDouble(value) != 0;

Параметры и ход выполнения:

• Пять аргументов: X=1445, Y=1690, Z=0, допуск X/Y=0, бег. Возврат 1 означает принятие, а не уже выполненное прибытие. На месте задача выключится полностью. Для досрочной ручной остановки вызовите UO.Follow(0).

return  new ScriptScenario(UO, WaitAsync, Args, Cancellation, Checkpoint).RunScenario();
class ScriptScenario
{
    private readonly global::ClassicUO.CSharp.CSharpGameApi UO;
    private readonly Func<int, Task> WaitAsync;
    private readonly string[] Args;
    private readonly CancellationToken Cancellation;
    private readonly Action Checkpoint;
    public ScriptScenario(global::ClassicUO.CSharp.CSharpGameApi api, Func<int, Task> wait, string[] args, CancellationToken cancellation, Action checkpoint)
    {
        UO = api;
        WaitAsync = wait;
        Args = args;
        Cancellation = cancellation;
        Checkpoint = checkpoint;
    }

     public object? RunScenario()
    {
        var accepted = UO.Follow(1445, 1690, 0, 0, true);
        if (Truth(accepted == 0))
        {
            UO.Print("Coordinate task was not accepted");
        }

        return null;
    }

    bool Truth(object? value) => value is bool flag ? flag : value is string text ? !string.IsNullOrEmpty(text) : value != null && Convert.ToDouble(value) != 0;
}

Параметры и ход выполнения:

• При HP <=40%, параличе или после 30 секунд клиент прекращает текущий путь. Иначе задача завершится в пределах двух клеток X/Y от (1445,1690), строго на Z=0. Проверки продолжаются и при поиске пути, и в движении; это не разовая проверка перед стартом. target.* здесь не применяется.

var checks = new List<object?>();
checks.Add(StopWhen("self.hppercent", "<=", 40));
checks.Add(StopWhen("self.paralyzed", "=", true));
checks.Add(StopWhen("elapsed", ">=", 30000));
UO.Follow(1445, 1690, 0, 2, true, checks.ToArray());

dynamic StopWhen(dynamic field, dynamic comparison, dynamic threshold)
{
    dynamic[] rule = new dynamic[checked((int)(2) + 1)];
    rule[0] = field;
    rule[1] = comparison;
    rule[2] = threshold;
    return rule;
}

Параметры и ход выполнения:

• distance=0 в вызове задаёт точное прибытие, но условие distance<=3 прекращает задачу раньше, когда очередная проверка заметит такое расстояние. false означает ходьбу. Перепад Z>16 или 20000 мс тоже останавливают задачу. Направление не гарантирует проходимости; замените смещение на точку своего маршрута.

Минимальный интервал шага: пешком — ходьба 400 мс, бег 200 мс; верхом — ходьба 200 мс, бег 100 мс.

Это стандартные пределы клиента, а не автоматически определённые настройки вашего шарда. Серверные режимы скорости и полёт учитываются отдельно. Таймеры скрипта могут замедлить движение, но не уменьшить эти пределы.

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

return  RunScenario();
 object? RunScenario()
{
    var checks = new List<object?>();
    checks.Add(StopWhen("distance", "<=", 3));
    checks.Add(StopWhen("height", ">", 16));
    checks.Add(StopWhen("elapsed", ">=", 20000));
    var x = UO.GetX("self") + 10;
    var y = UO.GetY("self");
    var z = UO.GetZ("self");
    UO.Follow(x, y, z, 0, false, checks.ToArray());
    return null;
}

dynamic StopWhen(dynamic field, dynamic comparison, dynamic threshold)
{
    dynamic[] rule = new dynamic[checked((int)(2) + 1)];
    rule[0] = field;
    rule[1] = comparison;
    rule[2] = threshold;
    return rule;
}

C# учитывает регистр. Используйте точное имя UO. Числовые флаги сравнивайте с 0; bool используйте только там, где сигнатура возвращает bool.

Параметры: Параметров нет.

Результат: int / Integer.

При вызове:

• InjectionScript.Runtime.InjectionApiUO.Register [Follow].
• InjectionScript.Runtime.InjectionApiUO.GetObject: GetObject(values[0]).
• InjectionScript.Runtime.NumberConversions.ToInt: NumberConversions.ToInt(values[1]).

Вызов выполняет сохранённый delegate обработчика. Метод регистрации создаёт этот delegate при построении API.

Внутренний код реализации, не самостоятельный скрипт.

values => new InjectionValue(bridge is IApiFollowBridge follow

                        ? follow.Follow(count == 0 ? 0 : GetObject(values[0]),

                            count < 2 ? 1 : NumberConversions.ToInt(values[1]),

                            count < 3 || NumberConversions.ToInt(values[2]) != 0) : 0)

Параметры: target (Any)

Результат: int / Integer.

При вызове:

• InjectionScript.Runtime.InjectionApiUO.Register [Follow].
• InjectionScript.Runtime.InjectionApiUO.GetObject: GetObject(values[0]).
• InjectionScript.Runtime.NumberConversions.ToInt: NumberConversions.ToInt(values[1]).

Вызов выполняет сохранённый delegate обработчика. Метод регистрации создаёт этот delegate при построении API.

Внутренний код реализации, не самостоятельный скрипт.

values => new InjectionValue(bridge is IApiFollowBridge follow

                        ? follow.Follow(count == 0 ? 0 : GetObject(values[0]),

                            count < 2 ? 1 : NumberConversions.ToInt(values[1]),

                            count < 3 || NumberConversions.ToInt(values[2]) != 0) : 0)

Параметры: target (Any), distance (Any)

Результат: int / Integer.

При вызове:

• InjectionScript.Runtime.InjectionApiUO.Register [Follow].
• InjectionScript.Runtime.InjectionApiUO.GetObject: GetObject(values[0]).
• InjectionScript.Runtime.NumberConversions.ToInt: NumberConversions.ToInt(values[1]).

Вызов выполняет сохранённый delegate обработчика. Метод регистрации создаёт этот delegate при построении API.

Внутренний код реализации, не самостоятельный скрипт.

values => new InjectionValue(bridge is IApiFollowBridge follow

                        ? follow.Follow(count == 0 ? 0 : GetObject(values[0]),

                            count < 2 ? 1 : NumberConversions.ToInt(values[1]),

                            count < 3 || NumberConversions.ToInt(values[2]) != 0) : 0)

Параметры: target (Any), distance (Any), running (Any)

Результат: int / Integer.

При вызове:

• InjectionScript.Runtime.InjectionApiUO.Register [Follow].
• InjectionScript.Runtime.InjectionApiUO.GetObject: GetObject(values[0]).
• InjectionScript.Runtime.NumberConversions.ToInt: NumberConversions.ToInt(values[1]).

Вызов выполняет сохранённый delegate обработчика. Метод регистрации создаёт этот delegate при построении API.

Внутренний код реализации, не самостоятельный скрипт.

values => new InjectionValue(bridge is IApiFollowBridge follow

                        ? follow.Follow(count == 0 ? 0 : GetObject(values[0]),

                            count < 2 ? 1 : NumberConversions.ToInt(values[1]),

                            count < 3 || NumberConversions.ToInt(values[2]) != 0) : 0)

Параметры: target (Any), distance (Any), running (Any), stopConditions (Any)

Результат: int / Integer.

При вызове:

• InjectionScript.Runtime.InjectionApiUO.Register [Follow].
• InjectionScript.Runtime.FollowStopCondition.Parse: FollowStopCondition.Parse(values[3]).
• InjectionScript.Runtime.InjectionApiUO.GetObject: GetObject(values[0]).
• InjectionScript.Runtime.NumberConversions.ToInt: NumberConversions.ToInt(values[1]).
• InjectionScript.Runtime.InjectionApiUO.ToBoolean: ToBoolean(values[2]).

Вызов выполняет сохранённый delegate обработчика. Метод регистрации создаёт этот delegate при построении API.

Внутренний код реализации, не самостоятельный скрипт.

values =>

                {

                    FollowStopCondition[] conditions = FollowStopCondition.Parse(values[3]);

                    return new InjectionValue(bridge is IApiConditionalFollowBridge follow

                        ? follow.Follow(GetObject(values[0]), NumberConversions.ToInt(values[1]), ToBoolean(values[2]), conditions) : 0);

                }

Параметры: x (Any), y (Any), z (Any), distance (Any), running (Any)

Результат: int / Integer.

При вызове:

• InjectionScript.Runtime.InjectionApiUO.Register [Follow].
• InjectionScript.Runtime.FollowStopCondition.Parse: FollowStopCondition.Parse(values[5], coordinateGoal: true).
• InjectionScript.Runtime.NumberConversions.ToInt: NumberConversions.ToInt(values[0]).
• InjectionScript.Runtime.InjectionApiUO.ToBoolean: ToBoolean(values[4]).

Вызов выполняет сохранённый delegate обработчика. Метод регистрации создаёт этот delegate при построении API.

Внутренний код реализации, не самостоятельный скрипт.

values =>

                    {

                        FollowStopCondition[] conditions = count == 6

                            ? FollowStopCondition.Parse(values[5], coordinateGoal: true) : Array.Empty<FollowStopCondition>();

                        return new InjectionValue(bridge is IApiCoordinateFollowBridge follow

                            ? follow.FollowPoint(NumberConversions.ToInt(values[0]), NumberConversions.ToInt(values[1]),

                                NumberConversions.ToInt(values[2]), NumberConversions.ToInt(values[3]), ToBoolean(values[4]), conditions) : 0);

                    }

Параметры: x (Any), y (Any), z (Any), distance (Any), running (Any), stopConditions (Any)

Результат: int / Integer.

При вызове:

• InjectionScript.Runtime.InjectionApiUO.Register [Follow].
• InjectionScript.Runtime.FollowStopCondition.Parse: FollowStopCondition.Parse(values[5], coordinateGoal: true).
• InjectionScript.Runtime.NumberConversions.ToInt: NumberConversions.ToInt(values[0]).
• InjectionScript.Runtime.InjectionApiUO.ToBoolean: ToBoolean(values[4]).

Вызов выполняет сохранённый delegate обработчика. Метод регистрации создаёт этот delegate при построении API.

Внутренний код реализации, не самостоятельный скрипт.

values =>

                    {

                        FollowStopCondition[] conditions = count == 6

                            ? FollowStopCondition.Parse(values[5], coordinateGoal: true) : Array.Empty<FollowStopCondition>();

                        return new InjectionValue(bridge is IApiCoordinateFollowBridge follow

                            ? follow.FollowPoint(NumberConversions.ToInt(values[0]), NumberConversions.ToInt(values[1]),

                                NumberConversions.ToInt(values[2]), NumberConversions.ToInt(values[3]), ToBoolean(values[4]), conditions) : 0);

                    }

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

int UO.GetDir();
int UO.GetDir(object? id);

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

• id — Необязательный объект только в указанных однопараметрических формах: serial числом/hex-строкой, "self", "lasttarget" или имя AddObject. Это не graphic/type. Без аргумента читается собственный персонаж. Перед чтением другого объекта проверяйте UO.Exists; неизвестное имя не открывает прицел.

int — направление mobile без бита бега: 0=N, 1=NE, 2=E, 3=SE, 4=S, 5=SW, 6=W, 7=NW. Для неизвестного mobile возвращается 0, которое также означает север.

• Читаются уже полученные локальные данные. Запрос не открывает status и не заставляет сервер прислать обновление. После смерти, перехода карты или удаления объекта значения могут измениться между двумя вызовами.
• C# учитывает регистр. Используйте точное имя UO. Числовые флаги сравнивайте с 0; bool используйте только там, где сигнатура возвращает bool.

Каждый пример можно сохранить отдельным файлом .csx и запускать в IDE. Объект UO и функции ожидания предоставляет host текущей игровой сессии. Демонстрационные serial, имена, координаты и адреса замените своими.

Выполните этот код как отдельный файл .csx. Аргументы видны прямо в вызове; демонстрационные имена, serial и адреса замените своими.

Результат одного вызова выводится в журнал. Число не преобразуется в bool; для массива показано количество элементов.

var result = UO.GetDir();
UO.Print("GetDir: " + Convert.ToString(result));

Параметры и ход выполнения:

• Вызов без аргументов относится к self. Направление персонажа сохраняется в value.
• Convert.ToString преобразует число для вывода и не меняет смысл результата.

var value = UO.GetDir();
UO.Print("GetDir: " + Convert.ToString(value));

Параметры и ход выполнения:

• Значение читается один раз без аргументов. Направление персонажа используется в показанном расчёте или условии.
• Числовые пороги — пример условий скрипта, а не новые пределы клиента. Поле сохраняет серверные единицы и ограничения, описанные выше.

return  RunScenario();
 object? RunScenario()
{
    var value = UO.GetDir();
    if (Truth(value == 2))
    {
        UO.Print("Facing east");
    }

    return null;
}

bool Truth(object? value) => value is bool flag ? flag : value is string text ? !string.IsNullOrEmpty(text) : value != null && Convert.ToDouble(value) != 0;