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

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

Управление движением и остановкой лодки; доступность команды определяется текущей лодкой и сервером.

UO.MoveBoat · UO.StopBoat

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

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

UO.MoveBoat(0, 1);

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

UO.StopBoat();

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

void UO.MoveBoat(object? direction, object? speed);

Запрашивает направление и скорость движения лодки.

• direction — int, младшие 3 бита задают направление 0..7: N,NE,E,SE,S,SW,W,NW.
• speed — int, ограничивается до 0..255 и приводится к byte; 0 — запрос остановки. Код протокола, не скорость в клетках/секунду.

void — значения нет. Вызывайте отдельной строкой; завершение не подтверждает действие сервера.

• Bridge.MoveBoat вызывает BoatMovingManager.MoveRequest((Direction)(direction&7), clamp(speed,0,255)). Текущая лодка и право управления определяются клиентом/сервером.
• Не перемещает персонажа по Pathfinder, не ждёт шага и не возвращает координаты лодки. Сервер может отклонить запрос.

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

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

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

UO.Print("Calling UO.MoveBoat");
UO.MoveBoat(0, 1);

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

• Запрашивает направление и скорость движения лодки.

UO.MoveBoat(0, 1);

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

• Bridge.MoveBoat вызывает BoatMovingManager.MoveRequest((Direction)(direction&7), clamp(speed,0,255)). Текущая лодка и право управления определяются клиентом/сервером.

return  RunScenario();
 object? RunScenario()
{
    UO.MoveBoat(2, 1);
    UO.Wait(500);
    UO.StopBoat();
    return null;
}

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

• Не перемещает персонажа по Pathfinder, не ждёт шага и не возвращает координаты лодки. Сервер может отклонить запрос.

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.MoveBoat(0, 0);
        return null;
    }
}

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

Параметры: direction (Any), speed (Any)

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

При вызове:

• InjectionScript.Runtime.InjectionApiUO.ExecuteClientApiCompatibility.
• ClassicUO.Game.Managers.ClassicUOInjectionApiBridge.MoveBoat: bridge.MoveBoat(Arg(0), Arg(1)).
• InjectionScript.Runtime.InjectionApiUO.ExecuteClientApiCompatibility::Arg: Arg(0).

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

case "moveboat": bridge.MoveBoat(Arg(0), Arg(1)); return InjectionValue.Unit;

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

void UO.StopBoat();

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

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

void — значения нет. Вызывайте отдельной строкой; завершение не подтверждает действие сервера.

• StopBoat вызывает BoatMovingManager.MoveRequest с направлением Player.Direction (или North без Player) и speed=0. Запрос не возвращает серверное положение лодки.
• В примерах UO.Wait задаёт только паузу скрипта; окончание паузы не доказывает выполнение запроса сервером.

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

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

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

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

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

• Запрашивает остановку движения лодки.

UO.StopBoat();

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

• StopBoat вызывает BoatMovingManager.MoveRequest с направлением Player.Direction (или North без Player) и speed=0. Запрос не возвращает серверное положение лодки.

return  RunScenario();
 object? RunScenario()
{
    if (Truth(UO.IsOnline()))
    {
        UO.StopBoat();
    }

    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 задаёт только паузу скрипта; окончание паузы не доказывает выполнение запроса сервером.

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.StopBoat();
        UO.Wait(250);
        UO.Print(UO.GetX());
        return null;
    }
}

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

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

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

При вызове:

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

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

case "stopboat": bridge.StopBoat(); return InjectionValue.Unit;