Home API Manuals About Forum
Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage

Step

Performs a single movement step in the specified direction with server confirmation.

Direction — direction to step (0–7). See ConstantsAndEnums for direction values.

RunningTrue to run, False to walk.

Returns a result code indicating the outcome:

Code Meaning
0 Unknown error / disconnected
2 Step buffer overflow (too many pending steps)
3 Client-side check failed: point not passable
4 Timeout waiting for server response
5 Move rejected by server
6 Move request sent, awaiting confirmation
7 Step accepted by server

Unlike StepQ, this method waits for the server to confirm or reject the step before returning. This makes it slower but more reliable for precise positioning.

Respects the moveCheckStamina variable — if stamina is below the configured threshold, the step is skipped and 0 is returned. Also respects moveExitOnDisconnect — if the character disconnects, returns 0 immediately when this flag is set.

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

Direction — направление шага (0–7). См. ConstantsAndEnums для значений направлений.

RunningTrue для бега, False для ходьбы.

Возвращает код результата:

Код Значение
0 Неизвестная ошибка / отключён
2 Переполнение буфера шагов
3 Клиентская проверка: точка непроходима
4 Таймаут ожидания ответа сервера
5 Шаг отклонён сервером
6 Запрос на шаг отправлен, ожидается подтверждение
7 Шаг принят сервером

В отличие от StepQ, этот метод ожидает подтверждение или отклонение шага сервером перед возвратом. Это медленнее, но надёжнее для точного позиционирования.

Учитывает переменную moveCheckStamina — если stamina ниже порога, шаг пропускается и возвращается 0. Также учитывает moveExitOnDisconnect — при отключении немедленно возвращает 0.

Deprecated Alias

Raw_Move(Direction, Running): Boolean — deprecated wrapper that returns True if the step was accepted (result code 7), False otherwise. Use Step directly for full result codes.

Raw_Move(Direction, Running): Boolean — устаревшая обёртка, возвращающая True при успешном шаге (код 7), False в остальных случаях. Используйте Step напрямую для получения полных кодов результата.

function Raw_Move(Direction: Byte; Running: Boolean): Boolean;
// Equivalent to: Result := Step(Direction, Running) = 7;

Pascal

function Step(Direction: Byte; Running: Boolean): Byte;

Python

def Step(Direction: int, Running: bool) -> int: ...

Pascal Example

begin
  // Step north, walking
  case Step(0, False) of
    7: AddToSystemJournal('Step accepted');
    5: AddToSystemJournal('Step rejected');
    3: AddToSystemJournal('Tile not passable');
    4: AddToSystemJournal('Timeout');
  else
    AddToSystemJournal('Step failed');
  end;
end.

Python Example

result = Step(0, False)  # Step north, walking
if result == 7:
    AddToSystemJournal('Step accepted')
elif result == 5:
    AddToSystemJournal('Step rejected')
elif result == 3:
    AddToSystemJournal('Tile not passable')
else:
    AddToSystemJournal(f'Step result: {result}')

See Also

StepQ, Raw_Move, MoveXY, CalcDir