BQL - История изменений

Kevicky9: /* Примеры */ добавлена минута молчания

2023-02-08T07:19:02Z

Примеры: добавлена минута молчания

← Предыдущая версия		Версия от 10:19, 8 февраля 2023
Строка 74:		Строка 74:
	* День полного доступа:<br><code>forall with AccessReader do rmcomp $ID AccessReader</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 Mind prototyped MobHuman do setoutfit $ID MimeGear; rmcomp $ID Speech</code>
			* Объявить минуту молчания:<br><code>forall with Humanoid do addreagent $ID chemicals MuteToxin 30</code>

Kevicky9: typo

2023-02-08T07:18:23Z

typo

← Предыдущая версия		Версия от 10:18, 8 февраля 2023
Строка 7:		Строка 7:
	<code>forall QUERY do COMMAND</code>		<code>forall QUERY do COMMAND</code>

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

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

Kevicky9 в 18:37, 25 ноября 2022

2022-11-25T18:37:29Z

← Предыдущая версия		Версия от 21:37, 25 ноября 2022
Строка 24:		Строка 24:
	* Не все запросы выполняются одинаково быстро. Лучше всего начинать перечисление условий выборки с фильтра <code>with <comp</code> или любого другого фильтра, который наиболее точно находит искомое (наподобие <code>tagged</code>, <code>mindful</code> или <code>alive</code>), так как этим фильтрам не нужно проверять каждую сущность в игре на соответствие условиям. Будьте точны: используйте фильтры так, чтобы они выбирали как можно меньшее количество сущностей. ''Вы же не хотите, чтобы из-за вашей попытки сделать из каждого мыла разумное существо, сервер тормознулся на несколько секунд?''		* Не все запросы выполняются одинаково быстро. Лучше всего начинать перечисление условий выборки с фильтра <code>with <comp</code> или любого другого фильтра, который наиболее точно находит искомое (наподобие <code>tagged</code>, <code>mindful</code> или <code>alive</code>), так как этим фильтрам не нужно проверять каждую сущность в игре на соответствие условиям. Будьте точны: используйте фильтры так, чтобы они выбирали как можно меньшее количество сущностей. ''Вы же не хотите, чтобы из-за вашей попытки сделать из каждого мыла разумное существо, сервер тормознулся на несколько секунд?''

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

	Данные фильтры предоставляются RobustToolbox'ом (движок, на котором сделана ss14) и доступны во всех играх, которые сделаны на нём:		Данные фильтры предоставляются RobustToolbox'ом (движок, на котором сделана ss14) и доступны во всех играх, которые сделаны на нём:
Строка 45:		Строка 45:
	* <code>above</code> выбирает все сущности над данном типом тайла.		* <code>above</code> выбирает все сущности над данном типом тайла.

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

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

Kevicky9: чуть больше примеров

2022-11-25T18:36:30Z

чуть больше примеров

← Предыдущая версия		Версия от 21:36, 25 ноября 2022
Строка 65:		Строка 65:
	* ...		* ...

	=== Примеры ===		== Примеры ==

	* Зарядить все батареи:<br><code>forall with Battery do setbatterypercent $ID 100</code>		* Зарядить все батареи:<br><code>forall with Battery do setbatterypercent $ID 100</code>
Строка 71:		Строка 71:
	* Выдать всему, кто зовётся "Walter White" lung cancer:<br><code>forall named "Walter White" do invokeverb self "Lung Cancer"</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>		* Взорвать всех и каждого (не надо это делать):<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>

Kevicky9: черновик перевода

2022-11-25T14:01:13Z

черновик перевода

Новая страница

''Перевод [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>