Просмотр кода страницы BQL

''Перевод [https://docs.spacestation14.io/en/administration/bql BQL]

BQL - язык запросов выборки игровых сущностей для использования в команде <code>forall</code>.

Команда <code>forall</code> доступна для администраторов с +QUERY и используется для выборки всех игровых сущностей, которые удовлетворяют заданным пользователем условиям. Команда выглядит так:

<code>forall QUERY do COMMAND</code>

''Не совсем ясно, что означает "B" в BQL. Кто-то предлагал расшифровывать первую букву как "bad', "badmin" или "better"''

== Запросы ==

Запросы выбирают/отфильтровывают все игровые сущности игры по определённым заданным критериям.

Возможно задание нескольких условий для выборки. Например, взрыв всех живых существ, названных "Urist McHands":

<code>forall alive named "Urist McHands" do invokeverb self $ID Explode</code>

# <code>alive</code> - фильтр, выбирающий все живые игровые сущности;
# <code>named "Urist McHands"</code> - фильтр, выбирающий все игровые сущности, названные "Urist McHands".

В любой игре очень много сущностей, поэтому помните:
* BQL по умолчанию применяется ГЛОБАЛЬНО. Каждый запрос начинается с выборки абсолютно всех сущностей. Если вам нужны сущности только определённой '''сетки''', то используйте фильтры <code>ongrid</code> или <code>onmap</code>.
* Не все запросы выполняются одинаково быстро. Лучше всего начинать перечисление условий выборки с фильтра <code>with <comp</code> или любого другого фильтра, который наиболее точно находит искомое (наподобие <code>tagged</code>, <code>mindful</code> или <code>alive</code>), так как этим фильтрам не нужно проверять каждую сущность в игре на соответствие условиям. Будьте точны: используйте фильтры так, чтобы они выбирали как можно меньшее количество сущностей. ''Вы же не хотите, чтобы из-за вашей попытки сделать из каждого мыла разумное существо, сервер тормознулся на несколько секунд?''

=== Запросы движка ===

Данные фильтры предоставляются RobustToolbox'ом (движок, на котором сделана ss14) и доступны во всех играх, которые сделаны на нём:

* <code>not</code> можно поставить перед любым запросом, если только <code>not</code> не инвертировано себя само;
* <code>with X</code> выбирает все сущности с компонентом X;
* <code>named X</code> выбирает все сущности с данным именем X с помощью регулярных выражений (<code>^</code> и <code>$</code> вставлены автоматически?);
* ? <code>parentedto</code> выбирает все сущности, которые являются родительскими по отношению к данной сущности;
* ? <code>rparentedto</code> выбирает все сущности, которые являются по отношению к данной сущности, даже если косвенно;
* <code>children</code> выбирает все сущности, которые являются дочерними к данной;
* <code>rchildren</code> выбирает все сущности, которые являются дочерними к данной рекурсивно;
* <code>parent</code> выбирает все сущности, которые являются родительскими к данной;
* <code>prototyped</code> выбирает все сущности, базирующиеся на данном '''прототипе''';
* <code>rprototyped</code> выбирает все сущности, базирующиеся на данном '''прототипе''', даже если косвенно;
* <code>select</code> выбирает N случайных сущностей или N% сущностей в зависимост от данного аргумента. Не инвертируйте этот фильтр, иначе это выберет все 100%. Считайте, что это как выборка абсолютно всех сущностей, но в кол-ве N.
* <code>near</code> выбирает все сущности около '''пользователей''' (сущности, которые используют BQL) в данном радиусе.
* <code>anchored</code> выбирает все сущности, которые закреплены;
* <code>ongrid</code> выбирает все сущности на данной '''сетке''';
* <code>onmap</code> выбирает все сущности на данной карте;
* <code>above</code> выбирает все сущности над данном типом тайла.

=== Запросы SS14 ===

Это дополнительные фильтры, доступные в Space Station 14:

* <code>tagged</code> выбирает все сущности с данным '''тегом''';
* <code>mindful</code> выбирает все сущности, за которыми в данный момент закреплён '''разум''';
* <code>alive</code> выбирает все живые сущности с '''разумом''';
* <code>hasreagent</code> выбирает все сущности с данным реагентом внутри или где-то еще;
* <code>apcpowered</code> выбирает все сущности, которые в данный момент запитаны от ЛКП.

== Команды ==

Это именно то, как происходят потрясающие вещи с выбранными сущностями. Это обычные команды из консоли, которые будут запускаться ''''на каждую сущность'''' со следующими подстановками:

* <code>$ID</code> - ID сущности, с которой происходят манипуляции;
* <code>$NAME</code> - название сущности, с которой производятся манипуляции;
* <code>$WX</code>, <code>$WY</code> - глобальные координаты X и Y сущности, с которой производятся манипуляции;
* <code>$LX</code>, <code>$LY</code> - локальные (относительно родителя?) координаты X и Y сущности, с которой происходят манипуляции;
* ...

== Примеры ==

* Зарядить все батареи:<br><code>forall with Battery do setbatterypercent $ID 100</code>
* Вернуть/реанимировать всех к жизни:<br><code>forall with Mind do rejuvenate $ID</code>
* Выдать всему, кто зовётся "Walter White" lung cancer:<br><code>forall named "Walter White" do invokeverb self "Lung Cancer"</code>
* Взорвать всех и каждого (не надо это делать):<br><code>forall with Body do invokeverb $ID "Explode"</code>
* Удалить все ghost-роли:<br><code>forall with GhostTakeoverAvailable do rmcomp $ID GhostTakeoverAvailable; rmcomp $ID Mind</code>
* День полного доступа:<br><code>forall with AccessReader do rmcomp $ID AccessReader</code>
* Выставить всем игрокам форму мима:<br><code>forall with Mind prototyped MobHuman do setoutfit $ID MimeGear; rmcomp $ID Speech</code>
* Объявить минуту молчания:<br><code>forall with Humanoid do addreagent $ID chemicals MuteToxin 30</code>