Remove
Событие: Кто-то пытается снять предмет
NArg: Не используется
Argument: Не используется
Возвращаемое значение: == 0 – предмет не будет снят
<> 0 – продолжить обработку
Локальные переменные: actor UID персонаж, снимающий предмет
Drop
Событие: Кто-то пытается избавиться от предмета (бросить или положить в контейнер)
NArg: Вероятность (в процентах), что триггер будет запущен
Argument: Не используется
Возвращаемое значение: == 0 – предмет не будет брошен
<> 0 – продолжить обработку
Локальные переменные: actor UID персонаж, избавляющийся от предмета
Give
Событие: Кто-то пытается отдать предмет
NArg: Вероятность (в процентах), что триггер будет запущен.
Argument: Не используется
Возвращаемое значение: == 0 – предмет не будет отдан
<> 0 – продолжить обработку
Локальные переменные: actor UID кто пытается отдать предмет
victim UID кому пытаются передать предмет
Load
Событие: Предмет создан и загружен в мир.
NArg: Вероятность (в процентах), что триггер будет запущен
Argument: Не используется
Возвращаемое значение: Не используется
Локальные переменные: Нет
Pick
Событие: Кто-то пытается взломать предмет
NArg: Вероятность (в процентах), что триггер будет запущен
Argument: Не используется
Возвращаемое значение: == 0 – предмет не будет взломан
<> 0 – продолжить обработку
Локальные переменные: actor UID персонаж, взламывающий предмет
Unlock / Open
Событие: Кто-то пытается отпереть/открыть предмет
NArg: Вероятность (в процентах), что триггер будет запущен
Argument: Не используется
Возвращаемое значение: == 0 – отпереть/открыть предмет не получится
<> 0 – продолжить обработку
Локальные переменные: actor UID персонаж, выполняющий действие
mode число режим: 0-“открыть”, 1–“отпереть”.
Примечание
(от автора): переменная mode, по меньшей мере, странная. Для Open
триггеров эта переменная всегда 0, а для Unlock
– 1. И зачем нужна такая переменная?
Lock / Close
Событие: Кто-то пытается запереть/закрыть предмет
NArg: Вероятность (в процентах), что триггер будет запущен
Argument: Не используется
Возвращаемое значение: == 0 – запереть/закрыть предмет не получится
<> 0 – продолжить обработку
Локальные переменные: actor UID персонаж, выполняющий действие
mode число режим: 0-“закрыть”, 1–“запереть”.
Примечание
(от автора): переменная mode, по меньшей мере, странная. Для Close
триггеров эта переменная всегда 0, а для Lock
– 1. И зачем нужна такая переменная?
Greet-All PC
Событие: К предмету, лежащему на полу комнаты, вошел PC (даже невидимый)
NArg: Вероятность (в процентах), что триггер будет запущен.
Argument: Не используется
Возвращаемое значение: Используется, но непонятно как :)
Локальные переменные: actor UID идентификатор вошедшего персонажа
direction направление откуда вошел персонаж, если такой переменной нет, то персонаж просто появился в комнате.
Примечание
(от автора): триггер сделан по принципу “на безрыбье и рак - рыба”. Неужели
нельзя было сделать систему триггеров, аналогичную Greet
системе для мобов. Примечание к тому набору триггеров также относится и к этому
триггеру.
Типы триггеров
для комнат
Reset
Событие: Зона, в состав которой входит комната, перегружается
NArg: Вероятность (в процентах), что триггер будет запущен
Argument: Не используется
Возвращаемое значение: Не используется
Локальные переменные: Нет
Random / Global
Событие: Периодически, примерно каждые 13 сек. Если для Random триггера не установлен тип Global, для запуска необходимо наличие хотя бы одного PC в зоне, к которой принадлежит комната. В противном случае (Global установлен) наличие PC в зоне с комнатой не требуется.
NArg: Вероятность (в процентах), что триггер будет запущен.
Argument: Не используется
Возвращаемое значение: Не используется
Локальные переменные: Нет
Enter / Enter-PC
Событие: В комнату пытаются войти [кто угодно / PC]
NArg: Вероятность (в процентах), что триггер будет запущен.
Argument: Не используется
Возвращаемое значение: == 0 – войти нельзя
<> 0 – продолжить обработку
Локальные переменные: actor UID идентификатор вошедшего персонажа
direction направление откуда вошел персонаж, если такой переменной нет, то персонаж просто появился в комнате.
Command
Событие: Кто-то пытается выполнить команду в комнате
NArg: Способ сравнения команды с текстовым образцом
0 – аргумент - фраза (список фраз)
1 – аргумент - слово (список слов)
другой – точное совпадение.
Argument: Образец команды. Если образец начинается с символа ‘*’, то триггер будет запускаться на любую команду, независимо от значения NArg.
Возвращаемое значение: == 0 – команда не обработана, продолжить стандартную интерпретацию
<> 0 – команда обработана
Локальные переменные: actor UID выполняющий команду персонаж
cmd строка команда, на которую сработал триггер
arg строка аргументы команды
Speech
Событие: Кто-то что-то сказал в комнате
NArg: Способ сравнения команды с текстовым образцом
0 – аргумент - фраза (список фраз)
1 – аргумент - слово (список слов)
другой – точное совпадение.
Argument: Образец команды. Если образец начинается с символа ‘*’, то триггер будет запускаться на любую команду, независимо от значения NArg.
Возвращаемое значение: Не используется
Локальные переменные: actor UID выполняющий команду персонаж
speech строка сказанная фраза целиком
Drop
Событие: Кто-то в комнате пытается бросить предмет на землю
NArg: Вероятность (в процентах), что триггер будет запущен
Argument: Не используется
Возвращаемое значение: == 0 – предмет не будет брошен
<> 0 – продолжить обработку
Локальные переменные: actor UID персонаж, бросающий предмет
object UID бросаемый объект
Примечание
(от автора): Триггер проверяется в двух случаях: бросают деньги и бросают
предмет. Деньги пропадают бесследно в случае возвращения 0. Триггер никак не
связан с переносом объекта в комнату другим способом. А упасть на пол можно
столькими способами. Есть предложение разместить этот триггер в функции obj_decay() или obj_to_room(). Короче, странный триггер, а можно было бы такого
сделать.
Pick
Событие: Кто-то пытается взломать дверь в комнате
NArg: Вероятность (в процентах), что триггер будет запущен
Argument: Не используется
Возвращаемое значение: == 0 – дверь не будет взломана
<> 0 – продолжить обработку
Локальные переменные: actor UID персонаж, взламывающий дверь
direction направление направление взламываемой двери
Unlock / Open
Событие: Кто-то пытается отпереть/открыть дверь в комнате
NArg: Вероятность (в процентах), что триггер будет запущен
Argument: Не используется
Возвращаемое значение: == 0 – отпереть/открыть дверь не получится
<> 0 – продолжить обработку
Локальные переменные: actor UID персонаж, выполняющий действие
direction направление направление двери
mode число режим: 0-“открыть”, 1–“отпереть”.
Примечание
(от автора): переменная mode, по меньшей мере, странная. Для Open
триггеров эта переменная всегда 0, а для Unlock
– 1. И зачем нужна такая переменная?
Lock / Close
Событие: Кто-то пытается запереть/закрыть дверь
NArg: Вероятность (в процентах), что триггер будет запущен
Argument: Не используется
Возвращаемое значение: == 0 – запереть/закрыть дверь не получится
<> 0 – продолжить обработку
Локальные переменные: actor UID персонаж, выполняющий действие
direction направление направление двери
mode число режим: 0-“закрыть”, 1–“запереть”.
Примечание
(от автора): переменная mode, по меньшей мере, странная. Для Close
триггеров эта переменная всегда 0, а для Lock
– 1. И зачем нужна такая переменная?
Общие правила для триггеров
В этом разделе будут
даны советы как нужно и как не нужно использовать триггеры. Будут приведены
самые распространенные ошибки при использовании триггеров и даны некоторые
разъяснения по поводу взаимодействия триггеров разного типа друг с другом.
1. Триггеры одного
типа для объекта.
В принципе, объекту можно назначить несколько разных триггеров для обработки одного и того же события (одинаковые триггеры назначить нельзя). Этого делать не рекомендуется, однако иногда такое решение позволяет требуемую функциональность. Поиск триггера для обработки события происходит в порядке, обратном их назначению объекту. Если подходящий триггер найден, начинается проверка его параметров (шансы вызова, аргументы и т.д.). В случае успешной проверки – триггер вызывается, иначе пропускается, и поиск триггера продолжается дальше. Все триггеры после своего завершения (с любым возвращенным значением) прекращают дальнейший поиск, за исключением MOB_COMMAND и OBJ_COMMAND (обратите внимание, что WLD_COMMAND не является исключением). Для этих триггеров происходит дальнейший поиск обработчика, если вызванный обработчик вернул 0, т.е. команда не обработана. В результате могут быть проверены все возможные обработчики команд мобов и объектов.
Примечание
(от автора): непонятно почему такой возможности лишены WLD_COMMAND триггеры.
К обсуждаемому вопросу косвенно относится проблема идентичных триггеров для разных объектов, расположенных в одном месте. Те же самые Command триггеры проверяются только до первого совпадения и если в комнате расположены несколько одинаковых мобов с триггерами Command, то выполнится только 1 триггер. Для триггеров типа MOB_GREET и OBJ_GREET проверяются триггеры всех объектов, и результат получается логическим произведением возвращаемых значений.
2. Запуск триггера
Триггер может быть на запущен не только по причине несовпадения его параметров. Еще необходимо, чтобы этот триггер не выполнялся для данного объекта. Для MOB-триггеров еще важно состояние моба, которому назначен триггер. Т.о. можно сформулировать такие правила:
1. Триггер не будет запущен, если для данного объекта он уже выполняется;
2. Для MOB-триггеров GREET, MEMORY и SPEECH моб должен бодрствовать.
3. Взаимодействие триггеров
Многие триггеры при обработке различных ситуаций работают вместе.
Например, при передаче объекта сначала вызывается OBJ_GIVE триггер и, в случае успешного его выполнения, вызывается MOB_RECEIVE триггер. Предмет будет передан, если MOB_RECEIVE триггер завершится успешно.
4. Приоритеты COMMAND триггеров
WORLD_COMMAND çвысший
MOB_COMMAND
OBJ_COMMAND
<стандартные команды>
<социалы> ç низший
5. Задержки в Death триггере
Никогда не используйте задержки в DEATH триггере. По команде паузы (wait) выполнение триггера прервется, чтобы продолжиться позднее. Моб будет уничтожен (все же это его смерть) вместе со сценарием и триггером соответственно. Т.о. вы никогда ничего не выполните после паузы в Death триггерах. Такое поведение может быть вызвано не только явными командами wait, но и их скрытыми вариантами.
Переменные DG Script
Как все языки программирования DG Script обеспечивает возможность работать с переменными различных типов. Кроме того, в DG Script определяется три класса переменных, которыми определяется область видимости и время жизни переменной.
Классы переменных
и контекст сценария
DG Script определяет три класса переменных: локальные, глобальные, мировые.
Объект может содержать несколько триггеров обработки различных событий. Множество триггеров для объекта называется сценарием. Сценарий это не просто объединение триггеров, он еще обладает некоторым контекстом и определяет время жизни глобальных переменных. Если у объекта нет ни одного триггера, у него нет сценарий со всеми вытекающими последствиями.
Локальные переменные принадлежат конкретному триггеру в сценарии объекта и существуют только во время выполнения триггера. Значения переменных между вызовами триггера не сохраняются. На эти переменные (в отличие от глобальных и мировых) не влияет контекст сценария. Все параметры, которые устанавливает программа при вызове триггера, передаются как локальные переменные. Подробнее об этих локальных переменных можно посмотреть в разделе Триггеры DG Script. Количество и размер данных локальных переменных ограничен только объемом памяти компьютера, на котором работает МПМ “Былины”.
Сценарий объекта может содержать глобальные переменные и в каждый конкретный момент времени обладать определенным контекстом. Глобальные переменные сохраняют свое значение между вызовами отдельных триггеров сценария, доступны всем триггерам данного сценария и также доступны из триггеров других (!) объектов. Идентификация глобальных переменных сценария осуществляется не только по имени, но и по значению контекста. Глобальные переменные автоматически уничтожаются при уничтожении сценария. Контекст сценария сохраняется в течение жизни сценария объекта, он одинаков для всех триггеров данного сценария и может быть изменен специальными командами DG Script.
Мировые переменные очень похожи на глобальные переменные сценария, за исключением того, что они не принадлежат ни одному сценарию и время их жизни совпадает со временем жизни мира. При этом, как и для глобальных переменных, есть возможность создания и уничтожения переменных из триггеров объектов.
Взаимодействие различных классов переменных, сценариев и контекста представлено на рисунке.
Локальные переменные сценария идентифицируются только по имени. Происходит сравнение имен с учетом регистра. Контекст сценария позволяет индексировать мировые переменные и глобальные переменные сценария (на локальные переменные контекст сценария не влияет). Каждую переменную перечисленных классов идентифицирует пара имя:контекст. Общим контекстом называется значение контекста равное 0. При поиске переменной проверяется совпадение и имени (сравнение с учетом регистра), и контекста переменной. Имя должно совпасть обязательно, а контекст проверяется сложнее. Сначала ищется переменная с запрошенным контекстом:
а) Если такой переменной не оказывается и запрошенный контекст == 0, то сообщается, что переменной нет.
б) Если такой переменной не оказывается и требуемый контекст <> 0, то производится попытка поиска переменной в общем контексте (контекст = 0).
Рисунок. Алгоритм поиска глобальной/мировой переменной.
Область видимости переменных, если явным образом не указан тип доступа, следующая:
1. Поиск локальной переменной триггера
2. Поиск глобальной переменной сценария с текущим контекстом сценария
3. Поиск мировой переменной с текущим контекстом сценария
Типы данных DG Script
Значения всех переменных в DG Script – текстовые строки. Но в зависимости от оператора, содержимого строки и т.д. можно выделить типы данных переменных DG Script.
Строка
Строка – всеобъемлющий тип данных DG Script. Как было сказано выше, значения всех переменных представляют собой текстовые строки. При этом в этих строках могут содержаться разделители, знаки арифметических действий, различные непечатные символы и т.д. Т.е. переменная DG Script может принимать практически любое значение и значение любой переменной можно рассматривать как текстовую строку и выполнять с ней операции, как с текстовой строкой.
Число
Текстовая строка, представляет собой запись целого со знаком, является числом. Числа достаточно часто используются в DG Script, поэтому имеет смысл выделить их в отдельный тип данных.
Направление
Некоторым триггерам передается параметр-направление. Тип данных направление – это строка, которая представляет собой одно из слов: north, east, south, west, up, down.
Список
Текстовую строку можно рассматривать как список. Элементами этого списка являются части строки, разделенные пробелами. Т.о. просто слово является списком из одного элемента. Пустая строка – пустой список.
Уникальный
идентификатор (UID)
Все объекты мира (персонажи, мобы, предметы, комнаты) имеют свой уникальный идентификатор, по которому можно однозначно установить объект, о котором идет речь. DG Script позволяет переменным иметь значениями уникальные идентификаторы. Такой тип данных называется UID. ВНИМАНИЕ: UID это не ЧИСЛО. UID это особое текстовое представление уникального идентификатора (ссылки) на объект мира. Однако существуют специальные возможности преобразования UID в число и обратно.
Значения
переменных
Переменные заменяются на их значения в процессе “подстановки значений” (см. раздел Команды DG Script). На место переменной в строку вставляется ее значение. Для того чтобы текст был интерпретирован как имя переменной, его необходимо заключить в символы ‘%’.
Существует три формы
представления переменной.
1. Простая переменная: %name%. Форма используется для получения значения переменной name.
2. Сложная переменная: %name.field%. Существует большое количество переменных, для которых определены т.н. поля. Форма используется для доступа к полю filed переменной name. При этом для получения значения поля переменной, возможно, необходимо произвести различные преобразования.
3. Параметризованная переменная: %name.field(param)%. Если при вычислении поля необходимо знать дополнительные параметры, то используется эта форма представления переменной. Тип значения param зависит от конкретного поля filed переменной name. Особенность такой формы записи переменной в том, что поле param может быть в свою очередь выражено переменной.
Примеры:
%actor% получение UID персонажа actor
%actor.name% получение имени персонажа actor
%actor.hitp(100)% установка здоровья 100 hp
%actor.hitp(+%random.100%)% увеличение здоровья на случ. величину [1..100]
Любая переменная может быть использована в своей простой форме, т.е. %name%.
Если переменная используется в сложной или параметризованной форме, то значение переменной name должно быть одним из объектов мира или name должна быть встроенной переменной. Поиск объекта мира по значению переменной осуществляется в следующем порядке:
1. Для MOB-триггеров: предмет в экипировке, предмет в инвентаре, персонаж в комнате, предмет в комнате, персонаж, предмет, комната.
2. Для OBJ-триггеров: персонаж, предмет, комната.
3. Для WLD-триггеров: персонаж, предмет, комната.
Очевидно, что если значением переменной будет UID, то поиск будет более предсказуемым и быстрым. Предпочтительнее использовать UID для ссылки на объект мира, чем имя объекта.
Если переменная не была найдена, то она заменяется на пустую строку (стирается из текста). Ниже по тексту пустая строка будет называться nil.
В нижеследующих разделах
перечисляются все доступные в DG Script переменные.
Автозамена команд
В сценариях DG Script существуют дополнительные команды, недоступные для игроков. При этом существуют модификации таких команд для разного типа объектов (мобы/предметы/комнаты). Для облегчения написания триггеров в DG Script поддерживается механизм автозамены команд, который каждую команду-псевдопеременную заменит на команду, подходящую данному типу триггера. Список этих команд приведен в таблице.
|
Псевдопеременная |
Команда для мобов |
Команда для предметов |
Команда для комнат |
|
%send% |
msend |
osend |
wsend |
|
%echo% |
mecho |
oecho |
wecho |
|
%echoaround% |
mechoaround |
oechoaround |
wechoaround |
|
%door% |
mdoor |
odoor |
wdoor |
|
%force% |
mforce |
oforce |
wforce |
|
%load% |
mload |
oload |
wload |
|
%purge% |
mpurge |
opurge |
wpurge |
|
%teleport% |
mteleport |
oteleport |
wteleport |
|
%damage% |
mdamage |
odamage |
wdamage |
|
%skillturn% |
mskillturn |
oskillturn |
wskillturn |
|
%skilladd% |
mskilladd |
oskilladd |
wskilladd |
|
%spellturn% |
mspellturn |
ospellturn |
wspellturn |
|
%spelladd% |
mspelladd |
ospelladd |
wspelladd |
|
%spellitem% |
mspellitem |
ospellitem |
wspellitem |
|
%portal% |
mportal |
oportal |
wportal |
Встроенные переменные
|
Переменная |
Тип |
Описание |
Результат |
|
self |
UID |
Получение владельца триггера |
Владелец триггера |
|
exist.mob(vnum) |
Число |
Проверка существования в мире моба vnum |
1 – моб существует 0 – странный результат nil – моба не существует |
|
exist.obj(vnum) |
число |
Проверка существования в мире предмета vnum |
1 – предмет существует 0 – странный результат nil – предмета не существует |
|
world.curobjs(vnum) |
число |
Количество vmun-предметов в мире (в игре в текущий момент и на ренте) |
Количество предметов |
|
world.gameobjs(vnum) |
число |
Количество vmun-предметов в мире (в игре в текущий момент) |
Количество предметов |
|
world.people(vmun) |
число |
Количество персонажей в комнате vnum (PC, NPC и др) |
Количество персонажей -1 если комнаты не существует |
|
world.curmobs(vmun) |
число |
Количество vnum-мобов в мире в текущий момент |
Количество мобов |
|
world.zreset(vnum) |
- |
Вызов процедуры ресета зоны vnum |
nil |
|
world.mob(vnum) |
число |
Получение численного значения UID персонажа VNUM |
Численное значение UID |
|
world.obj(vnum) |
число |
Получение численного значения UID пердмета VNUM |
Численное значение UID |
|
world.room(vnum) |
число |
Получение численного значения UID комнаты VNUM |
Численное значение UID |
|
weather.temp |
число |
Температура на дворе |
Температура |
|
weather.sky weather.sky(vnum) |
число |
Облачность в мире Облачность в комнате VNUM |
0 – облачно 1 – пасмурно 2 – тяжелые тучи 3 – ясно |
|
weather.moon |
число |
Возраст луны |
Возраст в днях |
|
weather.type weather.type(vnum) |
строка |
Множество букв, описывающее текущую погоду в мире или в комнате VNUM соответственно |
a – резкое похолодание b – резкое потепление c – моросящий дождь d – дождь e – льет как из ведра f – дождь с градом g – снежок h – снегопад i – валит снег j – ветерок k – умеренный ветер l – сильный ветер |
|
time.hour |
число |
Игровое время, час |
Игровой час |
|
time.day |
число |
Игровое время, день |
Игровой день |
|
time.month |
число |
Игровое время, месяц |
Игровой месяц |
|
time.year |
число |
Игровое время, год |
Игровой год |
|
random.char random.pc random.npc |
UID |
Случайный выбор персонажа в комнате. В поиск не включаются self, NOHASSLE и невидимые для моба/объекта персонажи. char – выбор из всех pc – выбор только из pc npc – выбор только из npc |
Случайно выбранный персонаж |
|
random.num random.num(num) |
число |
Возвращает случайное число [1,num] Вторую форму удобно использовать, когда значение num заранее не известно. |
Случайное число |
Примечание: встроенные переменные exist, world, time и random в простой форме НЕ СУЩЕСТВУЮТ.
Текстовая обработка
Значение любой переменной является текстовой строкой, и к ней может быть применены операции текстовой обработки. Значение самой переменной не изменяется.
|
Операция |
Тип |
Действие |
Результат |
|
var.strlen |
число |
Вычисление длины строки |
Длина строки |
|
var.trim |
строка |
Удаление начальных и конечных пробелов |
Урезаная строка |
|
var.contains(str) |
число |
Проверка подстроки |
1 – str является подстрокой значения переменной var 0 – str не является подстрокой значения переменной var |
|
var.car |
строка |
Выделение первого слова строки |
Первое слово |
|
var.cdr |
строка |
Выделение части строки после первого слова. |
Остаток строки |
|
var.words |
число |
Определение количества слов в строке (элементов с списке) |
Количество слов |
|
var.words(n) |
строка |
Получение n-ого слова строки |
Слово |
|
var.mudcommand |
строка |
Получение полной версии команды MUD по значению переменной var. Ищется стандартная MUD команда, аббревиатурой которой является var. |
Команда MUD или nil |
Поля переменных моба
|
Операция |
Тип |
Действие |
Результат |
|
char.iname |
строка |
Имя (именительный падеж) |
Имя |
|
char.rname |
строка |
Имя (родительный падеж) |
Имя |
|
char.dname |
строка |
Имя (дательный падеж) |
Имя |
|
char.vname |
строка |
Имя (винительный падеж) |
Имя |
|
char.tname |
строка |
Имя (творительный падеж) |
Имя |
|
char.pname |
строка |
Имя (предложный падеж) |
Имя |
|
char.name |
строка |
Короткое описание (если есть), иначе имя |
Имя |
|
char.id |
число |
Получение численного значения UID персонажа char. |
Численное значение UID |
|
char.alias |
строка |
Имя |
Имя |
|
char.level |
число |
Уровень персонажа |
Уровень |
|
char.hitp |
число |
Получение количества hp |
Текущее значение hp |
|
char.hitp(num) |
число |
Изменение hp. Формат num: num – установить значение в num +num – увеличить значение на num -num – уменьшить значение на num |
Новое значение hp |
|
char.maxhitp |
число |
Получение максимального количества hp |
Максимальное количество hp |
|
char.mana |
число |
Получение количества маны |
Текущее количество маны |
|
char.mana(num) |
число |
Изменения маны. Формат num: num – установить значение в num +num – увеличить значение на num -num – уменьшить значение на num |
Новое значение маны |
|
char.maxmana |
число |
Получение максимального количества маны |
Максимальное количество маны |
|
char.move |
число |
Получение количества энергии |
Текущее количество энергии |
|
char.move(num) |
число |
Изменение энергии. Формат num: num – установить значение в num +num – увеличить значение на num -num – уменьшить значение на num |
Новое значение энергии |
|
char.maxmove |
число |
Получение максимального количества энергии |
Максимальное количество энергии |
|
char.align |
число |
GET_ALIGNMENT |
|
|
char.religion |
число |
Религия персонажа |
0 – язычник 1 – христианин |
|
char.gold |
число |
Получение количества денег |
Количество денег |
|
char.gold(num) |
число |
Установка количества денег Формат num: число – установить значение в num +число – увеличить значение на num -число – уменьшить значение на num |
Новое количество денег |
|
char.bank |
число |
Получение количества денег в банке |
Количество денег в банке |
|
char.bank(num) |
число |
Установка количества денег в банке Формат num: num – установить значение в num +num – увеличить значение на num -num – уменьшить значение на num |
Новое количество денег в банке |
|
char.exp |
число |
Получение опыта |
Текущий опыт |
|
char.exp(num) |
число |
Изменение опыта. Формат num: num – установить значение в num +num – увеличить значение на num -num – уменьшить значение на num |
Новый опыт |
|
char.sex |
число |
Пол персонажа |
0 – средний 1 – мужской 2 – женский 3 – мн. число |
|
char.clan |
строка |
Название клана (в нижнем регистре) |
Название клана персонажа |
|
char.clanrank |
число |
Положение в клане |
9 - RANK_KNIEZE 7 - RANK_CENTURION 4 - RANK_VETERAN 2 - RANK_JUNIOR 1 - RANK_NOVICE 0 - RANK_GUEST |
|
char.g |
строка |
о//а/и |
Суффикс |
|
char.u |
строка |
ось/ся/ась/ись |
Суффикс |
|
char.w |
строка |
ое/ый/ая/ые |
Суффикс |
|
char.q |
строка |
ло//ла/ли |
Суффикс |
|
char.y |
строка |
ло/ел/ла/ли |
Суффикс |
|
char.a |
строка |
о//а/ы |
Суффикс |
|
char.weight |
число |
Вес персонажа |
Вес персонажа |
|
char.canbeseen |
число |
Проверка видит ли персонаж self, персонаж char. |
0 – self не видит персонажа 1 – self видит персонажа или self не моб |
|
char.class |
число |
Класс персонажа |
0 – CLERIC 1 – BATTLEMAGE 2 – THIEF 3 – WARRIOR 4 – ASSASINE 5 – GUARD 6 – CHARMMAGE 7 – DEFENDERMAGE 8 – NECROMANCER 9 – PALADINE 10 – RANGER 11 – SMITH 12 – MERCHANT 13 – DRUID |
|
char.race |
число |
Раса персонажа |
0 – SEVERANE 1 – POLANE 2 – KRIVICHI 3 – VATICHI 4 – VELANE 5 – DREVLANE |
|
char.fighting |
UID |
Получение противника в бою |
Противник или nil |
|
char.is_killer[(on|off)] |
число |
Управление флагом ДУШЕГУБ. on – устанавливает флаг off – сбрасывает флаг |
0 – игрок душегуб 1 – игрок не душегуб |
|
char.is_thief[(on|off)] |
число |
Работа с флагом PLR_THIEF |
0 – игрок не имеет флага 1 – игрок имеет флаг |
|
char.rentable |
число |
Проверка на боевые действия |
0 – не может уйти на постой 1 – может уйти на постой |
|
char.riding |
UID |
Определение лошади |
Лошадь или nil |
|
char.ridden_by |
UID |
Определение наездника |
Наездник или nil |
|
char.vnum |
число |
vnum моба. –1 для PC |
VNUM |
|
char.str |
число |
Врожденная сила персонажа |
Сила |
|
char.str(num) |
число |
Изменение врожденной силы num – установить силу равную num +num – увеличить силу на num -num – уменьшить силу на num |
Сила |
|
char.stradd |
число |
Добавочная сила персонажа |
Сила |
|
char.int |
число |
Врожденный ум персонажа |
Ум |
|
char.int(num) |
число |
Изменение врожденного ума |
Ум |
|
char.intadd |
число |
Добавочный ум персонажа |
Ум |
|
char.wis |
число |
Врожденная мудрость персонажа |
Мудрость |
|
char.wis(num) |
число |
Изменение врожденной мудрости |
Мудрость |
|
char.wisadd |
число |
Добавочная мудрость персонажа |
Мудрость |
|
char.dex |
число |
Врожденная ловкость персонажа |
Ловкость |
|
char.dex(num) |
число |
Изменение врожденной ловкости |
Ловкость |
|
char.dexadd |
число |
Добавочная ловкость персонажа |
Ловкость |
|
char.con |
число |
Врожденное тело персонажа |
Телосложение |
|
char.con(num) |
число |
Изменение врожденного тела |
Телосложение |
|
char.conadd |
число |
Добавочное тело персонажа |
Телосложение |
|
char.cha |
число |
Врожденное обаяние персонажа |
Обаяние |
|
char.cha(num) |
число |
Изменение врожденного обаяния |
Обаяние |
|
char.chaadd |
число |
Добавочное обаяние персонажа |
Обаяние |
|
char.size |
число |
Врожденный размер персонажа |
Размер |
|
char.size(num) |
число |
Изменение врожденного размера |
Размер |
|
char.sizeadd |
число |
Добавочный размер персонажа |
Размер |
|
char.room |
число |
Получение комнаты, в которой находится персонаж |
RNUM комнаты |
|
char.realroom |
число |
VNUM комнаты, в которой находится персонаж |
VNUM комнаты |
|
char.loadroom |
число |
Получение загрузочной комнаты |
VNUM комнаты |
|
char.loadroom(vnum) |
число |
Установка загрузочной комнаты |
VNUM комнаты |
|
char.skill(str) |
число |
Уровень умения str у персонажа. Str – название умения |
Уровень владения умением |
|
char.spellcount(str) |
число |
Количество у персонажа выученных заклинаний str. Str – имя заклинания |
Количество заклинаний |
|
char.spelltype(str) |
число |
Тип запоминания заклинания str у персонажа. Флаги из массива SplKnw. Str – имя заклинания |
? |
|
char.quested(num) |
число |
Проверка на то, выполнял ли персонаж квест номер num. |
1 – выполнял 0 – не выполнял |
|
char.setquest(num) |
число |
Установка признака выполнения квеста номер num |
1 – выполнял |
|
char.eq(pos) |
UID |
Получение предмета экипировки. pos – позиция (текст или номер позиции) |
Предмет или nil |
|
char.haveobj(obj)[1] |
число |
Несет ли персонаж предмет obj? obj может быть vnum или именем предмета. |
1 – несет 0 – не несет |
|
char.varexists(name)[2] |
число |
Проверяет у сценария объекта char наличие глобальной переменной name. |
1 – есть 0 – нет |
|
char.position |
число |
Возвращает положение персонажа |
0 – dead 1 – mortally wounded 2 – incapacitated 3 – stunned 4 – sleeping 5 – resting 6 – sitting 7 – fighting 8 – standing |
|
char.position(pos) [3] |
? BUG |
Устанавливает позицию персонажа. Не действует на богов и т.д. |
? |
|
char.wait |
число |
Возвращает лаг персонажа в секундах. |
Лаг |
|
char.wait(pause)
3 |
? BUG |
Устанавливает лаг персонажа в пульсах. Не действует на богов и т.д. |
? |
|
char.affect(name) |
число |
Проверяет наличие на персонаже аффекта name. |
1 – аффект есть 0 – аффекта нет |
|
char.leader |
UID |
Возвращает лидера для char. |
Лидер или nil |
|
char.people |
UID |
Первый персонаж в комнате с char. |
Персонаж или nil |
|
char.next_in_room |
UID |
Следующий за char персонаж в комнате |
Персонаж или nil |
|
char.all char.char char.pc char.npc char.group char.attackers |
список из UID |
Список персонажей в комнате: all – все в комнате char – все PC и чармисы pc – все PC npc – все NPC (мобы не чармисы) group – список группы, в которой состоит char. Начинается с лидера, включает всех последователей. attackers – список персонажей, атакующих char. |
Список персонажей, может быть пустым |
|
char.global(name)
2 |
строка |
Поиск и замена глобальной переменной другого сценария. При поиске переменной используется текущий контекст сценария char. |
Значение глобальной переменной сценария char |
|
char.var 2 |
строка |
Поиск и замена глобальной переменной другого сценария. При поиске переменной используется текущий контекст сценария self. |
Значение глобальной переменной сценария char |
Поля переменных предмета
|
Операция |
Тип |
Действие |
Результат |
|
obj.iname |
строка |
Имя (именительный падеж) |
Имя |
|
obj.rname |
строка |
Имя (родительный падеж) |
Имя |
|
obj.dname |
строка |
Имя (дательный падеж) |
Имя |
|
obj.vname |
строка |
Имя (винительный падеж) |
Имя |
|
obj.tname |
строка |
Имя (творительный падеж) |
Имя |
|
obj.pname |
строка |
Имя (предложный падеж) |
Имя |
|
obj.name |
строка |
Имя |
Имя |
|
obj.id |
число |
Получение численного значения UID предмета obj. |
Численное значение UID |
|
obj.shortdesc |
строка |
Короткое описание |
Описание |
|
obj.vnum |
число |
vnum предмета |
VNUM |
|
obj.type |
число |
Тип предмета |
Код типа предмета |
|
obj.timer |
число |
Таймер предмета |
Таймер |
|
obj.val0 |
число |
Параметр предмета 0 |
Значение параметра |
|
obj.val1 |
число |
Параметр предмета 1 |
Значение параметра |
|
obj.val2 |
число |
Параметр предмета 2 |
Значение параметра |
|
obj.val3 |
число |
Параметр предмета 3 |
Значение параметра |
|
obj.carried_by |
UID |
Кто несет |
Персонаж или nil |
|
obj.worn_by |
UID |
На ком одет |
Персонаж или nil |
|
obj.g |
строка |
о//а/и |
Суффикс |
|
obj.u |
строка |
ось/ся/ась/ись |
Суффикс |
|
obj.w |
строка |
ое/ый/ая/ые |
Суффикс |
|
obj.q |
строка |
ло//ла/ли |
Суффикс |
|
obj.y |
строка |
ло//ла/ли |
Суффикс |
|
obj.a |
строка |
о//а/ы |
Суффикс |
|
obj.count |
число |
Количество предметов в мире (в игре в текущий момент и на ренте) |
Количество |
|
obj.sex |
число |
Род предмета |
0 – средний 1 – мужской 2 – женский 3 – мн. число |
|
obj.room |
число |
Комната, в которой находится предмет, или тот на ком он одет. |
VNUM комнаты |
|
obj.all obj.char obj.pc obj.npc |
список из UID |
Список персонажей в комнате: all – все в комнате char – все PC и чармисы pc – все PC npc – все NPC (мобы не чармисы) |
Список персонажей |
Назначение
полей val0 – val4 для разных типов предметов
|
Тип объекта |
Константа ITEM_xxx |
VAL0 |
VAL1 |
VAL2 |
VAL3 |
|
Источник света |
LIGHT |
|
|
-1 – вечный свет n – сколько часов гореть |
|
|
Свиток |
SCROLL |
Уров. заклин |
Закл. 1 |
Закл. 2 |
Закл. 3 |
|
|
WAND |
Уров. заклин |
Макс. кол-во |
Тек. кол-во |
Заклинание |
|
|
STAFF |
Уров. заклин |
Макс. кол-во |
Тек. кол-во |
Заклинание |
|
Оружие |
WEAPON |
|
Кол. бросков |
Разм. кости |
Тип |
|
Ценности |
TREASURE |
|
|
|
|
|
Доспех |
ARMOR |
AC |
Броня |
|
|
|
Зелье |
POTION |
Уров. заклин |
Закл. 1 |
Закл. 2 |
Закл. 3 |
|
|
OTHER |
|
|
|
|
|
Хлам |
TRASH |
|
|
|
|
|
Сумка |
CONTAINER |
Вместимость |
Тип ключа |
Номер ключа |
1 – труп 0 – не труп |
|
Записка |
NOTE |
|
|
|
|
|
Емкость |
DRINКCON |
Макс. кол-во |
Тек. кол-во |
Жидкость |
Отравлен |
|
Ключ |
KEY |
|
|
|
|
|
Еда |
FOOD |
Насыщение |
|
|
Отравлен |
|
Деньги |
MONEY |
Количество |
|
|
|
|
Ручка |
PEN |
|
|
|
|
|
Лодка |
BOAT |
|
|
|
|
|
Колодец |
FOUNTAIN |
Макс. кол-во |
Тек. кол-во |
Жидкость |
Отравлен |
|
Книга |
BOOK |
|
Заклинание |
|
|
|
|
INGRADIENT |
Интервал применений, уровень |
прототип |
Кол-во применений |
Время последнего применения |
Коды типов предметов