API UO Notoriety - LIHACHTETAN/ClassicUO-BadNewbie-BasicIDE GitHub Wiki
UO.Notoriety
Оглавление · Алфавитный указатель · Mobiles
ClassicUO • Runtime API
Читает репутацию персонажа из модели клиента.
Точный синтаксис
UO.Notoriety() -> Integer
Выберите одну из зарегистрированных форм. Параметры передаются позиционно. Any означает значение BASIC с преобразованием внутри команды; Unit — отсутствие возвращаемого значения.
Параметры
Параметров нет.
Возвращает
Integer — 0=unknown, 1=innocent, 2=ally, 3=gray, 4=criminal, 5=enemy, 6=murderer, 7=invulnerable. Это код состояния, а не hue, karma или fame. Неизвестный mobile даёт 0.
Поведение
- Читаются уже полученные локальные данные. Запрос не открывает status и не заставляет сервер прислать обновление. После смерти, перехода карты или удаления объекта значения могут измениться между двумя вызовами.
- Это функции чтения: присваивание результата переменной сохраняет снимок. Оно не изменяет характеристику персонажа. Имена нечувствительны к регистру; используйте именно показанную форму с нужным числом аргументов.
Примеры
Пример 1. Вывести текущее значение своего персонажа
# Вывести текущее значение своего персонажа
#
# Читает репутацию персонажа из модели клиента.
#
# Integer — 0=unknown, 1=innocent, 2=ally, 3=gray, 4=criminal, 5=enemy, 6=murderer,
# 7=invulnerable. Это код состояния, а не hue, karma или fame. Неизвестный mobile даёт 0.
SUB Main()
# Вызов без аргументов относится к self. Репутацию персонажа сохраняется в value.
# STR преобразует число для вывода и не меняет смысл результата.
VAR value = UO.Notoriety()
UO.Print('Notoriety: ' + STR(value))
END SUB
Разбор параметров и выполнения:
- Вызов без аргументов относится к self. Репутацию персонажа сохраняется в value.
- STR преобразует число для вывода и не меняет смысл результата.
Пример 2. Использовать значение в прикладной проверке
# Использовать значение в прикладной проверке
#
# Читает репутацию персонажа из модели клиента.
#
# Integer — 0=unknown, 1=innocent, 2=ally, 3=gray, 4=criminal, 5=enemy, 6=murderer,
# 7=invulnerable. Это код состояния, а не hue, karma или fame. Неизвестный mobile даёт 0.
SUB Main()
# Значение читается один раз без аргументов. Репутацию персонажа используется в показанном
# расчёте или условии.
# Числовые пороги — пример условий скрипта, а не новые пределы клиента. Поле сохраняет серверные
# единицы и ограничения, описанные выше.
VAR value = UO.Notoriety()
IF value = 3 OR value = 4 THEN
UO.Print('Gray or criminal notoriety')
END IF
END SUB
Разбор параметров и выполнения:
- Значение читается один раз без аргументов. Репутацию персонажа используется в показанном расчёте или условии.
- Числовые пороги — пример условий скрипта, а не новые пределы клиента. Поле сохраняет серверные единицы и ограничения, описанные выше.
Пример 3. Наблюдать изменение за одну секунду
# Наблюдать изменение за одну секунду
#
# Читает репутацию персонажа из модели клиента.
#
# Integer — 0=unknown, 1=innocent, 2=ally, 3=gray, 4=criminal, 5=enemy, 6=murderer,
# 7=invulnerable. Это код состояния, а не hue, karma или fame. Неизвестный mobile даёт 0.
SUB Main()
# Оба вызова без аргумента читают своё текущее значение. WAIT(1000) даёт паузу в миллисекундах
# между снимками.
# Сравнивается изменение: репутацию персонажа. Пример ничего не изменяет в мире и не ждёт
# бесконечно. События внутри этой секунды могут быть пропущены.
VAR before = UO.Notoriety()
WAIT(1000)
VAR after = UO.Notoriety()
IF before <> after THEN
UO.Print('Before: ' + STR(before) + '; after: ' + STR(after))
END IF
END SUB
Разбор параметров и выполнения:
- Оба вызова без аргумента читают своё текущее значение. WAIT(1000) даёт паузу в миллисекундах между снимками.
- Сравнивается изменение: репутацию персонажа. Пример ничего не изменяет в мире и не ждёт бесконечно. События внутри этой секунды могут быть пропущены.