Поваренная книга админа: различия между версиями

Данная статья посвящена всяким полезностям для админов.

{{ModernTitle|Работа с консолью|h1}}

== Основы ==

* <code>deadmin/readmin</code> - убирает/возвращает права администратора

* <code>aghost</code> - та же команда <code>ghost</code>, но с правами администратора

* <code>setadminooc #FFFFFF</code> - устанавливает цвет вашему нику, который будет виден в чате OOC.

* <code>help [название команды]</code> - расскажет вам о команде, не забывайте про неё!

* <code>list</code> - выводит список доступных вам команд

* <code>listgamerules</code> - выводит список всех игровых событий

* <code>forcemap</code> - перманентно устанавливает карту (сброс карты делается forcemap "")

* <code>> self scale:multiplyvector [2, 1]</code> (ТУЛШЕД!) - <strike>способ получить аварн</strike> изменение размера спрайта(увеличить в два раза = 2, уменьшить = 0,5)

* <code>tpto</code> - телепортация куда кого, алтернатива tp

* <code>playglobalsound</code> - чтобы все услышали ваше аудио(после указания пути идёт громкость, она может быть отрицательной, если нужно тише)

* <code>ftldisk</code> - диск БСС скачков шаттла

* <code>explosionui</code> - искусство это взрыв

* <code>green</code> - {{цвет|text|green|c=зелёный}};

* <code>blue</code> - {{цвет|text|blue|c=синий}};

* <code>yellow</code> - {{цвет|text|darkyellow|c=жёлтый}};

* <code>violet</code> - {{цвет|text|violet|c=фиолетовый}};

* <code>red</code> - {{цвет|text|red|c=красный}};

* <code>gamma</code> - {{цвет|text|gamma|c=гамма}};

* <code>delta</code> - {{цвет|text|delta|c=дельта}};

* <code>epsilon</code> - {{цвет|text|violet|dark|c=эпсилон}}.

* <code>sendstationgoal</code> - позволяет по факсу отправить цель на выбор. Примеры:

 

* <code>callshuttle #</code>, где <code>#</code> - кол-во минут до шаттла, вызывает эвакуационный шаттл.

<code>customvote <вопрос> <ответ1> <ответ2> ... <ответN></code> - создаёт голосование с заданными параметрами, которое видно и в раунде, и в лобби.

* <code>delaystart [seconds]</code> - ставит старт раунда на паузу в лобби. Если указан аргумент, то откладывает старт на указанное количество секунд.

* <code>forcemap</code> - позволяет поменять карту до начала раунда.

* <code>BasicStationEventScheduler</code> - спавнер редких игровых ивентов. Стоит во всех режимах игры кроме выживания.

* <code>RampingStationEventScheduler</code> - спавнер частых игровых ивентов для режима выживания.

* <code>Secret</code> - режим игры "Секрет"

* <code>DeathMatch</code> - режим игры "Все против всех".

* <code>NukeOps</code> - режим игры ядерных оперативников - спавнит пять нюкеров и их базу.

* <code>Pirates</code> - режим игры "Пираты" - создаёт шаттл с пиратами, пиратов по хорошему переспавнить и сделать через Уристов, сломаны.

* <code>Sandbox</code> - режим игры "Песочница", игроки имеют права спавнить энтити/декали/тайлы.

* <code>Suspicion</code> - TTT - Все вооружены, среди вооруженных есть предатели, задача не-предателей найти их и убить.

* <code>TraitorDeathMatch</code> - режим игры, резня агентов.

* <code>Zombie</code> - режим игры "Зомби".

* <code>FalseAlarm</code> - ивент, создающий фальшивые обьявления о игровых ивентах.

* <code>BureaucraticError</code> - бюрократическая ошибка.

* <code>KudzuGrowth</code> - кудзу.

* <code>MeteorSwarm</code> - метеоритный рой.

* <code>Dragon</code> - дракон, не работает, админу нужно спавнить вручную.

* <code>Traitor</code> - игра выдаёт случайным игрокам предателей.

* <code>VentCritters</code> - из вентиляции лезут существа, от мышей до тарантулов.

* <code>MouseMigration</code> - крысиный король с его свитой.

* <code>BluespaceLockerLink</code> - блюспейс-шкаф.

 

Чтобы убрать пацифизм у дионы, нужно удалить компоненты PacifedComponent и CombatModeComponent, а затем добавить CombatModeComponent снова. Это делается через просмотр переменных (<code>vv <EntityUID></code>) во вкладке "Компоненты сервера". Если добавить CombatModeComponent, пока у моба стоит PacifedComponent, то ничего не сработает.

* Civilian  

* Command  

* Engineering  

* Medical  

 

* Система навыков - Навыки: <code>ShuttleControl</code> <code>Shooting</code> <code>AdvancedBuilding</code> <code>Surgery</code> <code>MedicalEquipment</code>   <code>Butchering</code>

* <code>grantskill <euid> <skill></code> - выдаёт скилл.

* <code>revokeskill <euid> <skill></code> - забирает скилл.

* <code>listskills <euid></code> - перечисляет скиллы.

* AntagObjectiveImmunityComponent - иммунитет от становления целью

== Основы ==

В игре всё является сущностями(entity), сущность - это экземпляр(версия, или сын) прототипа. Когда вы создаёте что-либо на основе прототипа - вы спавните сущность, которая имеет уникальный айди и характеристики прототипа, которые вы можете менять.

Компоненты - это переменные, они хранят разные данные - простые - true/false(включен-выключен), сложные - словарь определяющий тип урона. Они могут своим добавлением могут позволять что-либо — например, боргам пользоваться прибором; являться связующим посредником - stepTrigger(активировался если наступишь), представлять механику игры - Anomaly, и многое другое. Отношения между компонентами определены их кодом, знать его не обязательно, их описание довольно неплохо документировано [https://github.com/space-syndicate/space-station-14/tree/master/Content.Shared/ просто нужно знать, где искать].

Прототип - это описание чего-либо(режимы игры тоже определяются ими но не являются сущностями), которое состоит из компонентов. Если нам нужно описать хлебушек - самое простое из компонентов будет - itemComponent(его можно поднять и положить, он имеет объём для сумки), спрайт, набор звуков; сложные - являются частями механик и могут для изменения требовать понимания кода игры(с этим вы столкнётесь рано или поздно) - для хлебушка это его питательность(в метаболизме), это не трудно. И из кучи компонентов получим прототип хлеба(зарезервировавший уникальное имя прототипа), который без особого тестирования вполне может уронить сервер(и подарить аварн).

Отдельно упомяну, что прототипы существуют в иерархии - предыдущий передаёт компоненты последующему, для описания чего либо вам не нужно начинать в нуля, вы можете унаследоваться от существующего прототипа, расширив его компоненты.

Итог, для понимания - карта, грид на карте, стена на гриде, станция(со счётом в карго) - это всё сущности. Игрок видит объекты потому что имеет компонент глаз, управляет благодаря компоненту актёра. Прототипы написаны на YAML и могут быть изучены на гитхабе в /Resources/Prototypes/... .

На серверах Корвакс размер файлах ограничен 25-ю мб, но для этого надо пойти в cvar в \Resources\ConfigPresets\Build  

== Работа с файлами и загрузка прототипов ==

При автодополнении пути для указания файла вы будете в [https://github.com/space-syndicate/space-station-14/tree/master/Resources/ Resources]. Если вам нужно что-то быстро найти - легче всего будет скачать с гитхаба и найти сначала у себя, а потом в игре. Когда вы пишете /, вы начинаете уже в папке, имя Resources вам писать не надо.

Чем эта папка отличается от гитхаба? У мапперов есть свои папки, которую можете создать и вы себе для хранения маперских наработок(при сохранении необходимо в пути указать имя новой папки — по традиции ваш сикей, срать папкам НЕ НАДО!). Во-вторых, есть новая папка - Resources/Uploaded/ в неё отправляется всё, что загружается на сервер через <code>uploadfile</code> или <code>uploadfolder</code>, при перезапуске сервер она очищается. ОДНАКО это не значит, что в неё можно срать, при заходе на сервер эти файлы отправляются игрокам, что может приводить к тому, что окно подключения к серверу у них будет висеть и минуту и больше, сжимайте аудио.

* Когда вы пользуетесь <code>uploadfolder</code> вы указываете имя папки которая на вашем компьюторе лежит на пути - C:\Users\(ИМЯ ПОЛЬЗОВАТЕЛЯ)\AppData\Roaming\Space Station 14\data\UploadFolder

* Для загрузки прототипа <code>loadprototype</code> , нужно выбрать yml файл.  

Сначала вы загружаете ресурсы прототипа - музыку, спрайты, если оно того требует, потом сам прототип, иначе может крашнуть. Учитывайте, если ваш прототип перезаписывает существующие на карте сущности, после раундстарта оно не заменит уже созданные сущности, но возможно сломает, если там присутствуют сложные механики(например, новый список товаров в автомате).

== Загрузка RSI ==

 

[https://docs.spacestation14.io/en/engine/rsi RSI] - формат группы изображений, изобретённый создателями SS14. Используется для спрайтов. У администраторов существует возможность загрузить свои RSI для использования их в прототипах без необходимости перезапуска сервера или перекомпиляции сборки.

В недавнем обновлении появился более лёгкий способ загрузки папок - команда <code>uploadfolder</code>.

 

* Карта (map) - БСС-пространство, содержащее сетки (grids).

* Сетка (grid) - совокупность соединённых тайлов и игровых сущностях, находящихся на них. Собственно, станция - большая единая сетка. Например, если отделить от неё кусочек или поставить прутья на космос, то получится новая сетка, отдельная от станции.

 

Карта - БСС-пространство и содержащиеся в нём сетки (grids). Имеет два состояния <code>init: True</code> и <code>init: False</code> - пауза и не пауза. С помощью команды <code>lsmap</code> можно вывести список всех существующих в текущий момент карт, их ID и их состояние (пауза или нет). Основные команды:

 

Сетка - совокупность соединённых вместе тайлов (пол) и лежащих на них предметов. Например, станция - отдельная сетка, шаттл карго - тоже отдельная сетка.

* <code>tpgrid <id сетки> <x> <y></code> - сама команда для телепорта;

<li>Далее сама команда для сохранения сетки как карты: <code>savebp <gridUid> <path></code>, где <code><gridId></code> это ранее полученное число, а <code><path></code> - путь, по которому ''сетка'' будет сохранена в папке сервера. Достаточно просто указать название файла. Обязательно укажите расширение <code>.yml</code> для файла.<br>

Чтобы сделать сетку доступной для прыжка к ней через БСС, нужно открыть окно просмотра переменных этой сетки. Для этого прописывается <code>vv <gridUID></code>. Во вкладке "Компоненты сервера" нужно добавить компонент "FTLDestination" через кнопку "Добавить компонент". Готово! Сетка, а вместе с ней и карта, на которой она расположена, доступны для прыжка, например, карго-шаттла.

Опционально можно переименовать сетку опять в просмотре переменных <code>vv</code> - во вкладке "Переменные сервера" в поле Name прописывается новое имя и обязательно нажимается Enter по завершению ввода.

* <code>0000FF</code> — Дистра

* <code>FF0000</code> — Вейст

* <code>17E8E2</code> — Воздух

* <code>947507</code> — Грязный

* <code>FFD800</code> — Автобус

* <code>FF9900</code> — Сигнальный

* <code>D3FC03</code> — Вирусология

* <code>FEF101</code> — Жёлтый

* <code>A505FA</code> — Фиолетовый

<code>loadmappacts</code> - подгружает некоторые инструменты для более удобного маппинга (ставит в меню действий некоторые тайлы и стены).

{{ModernTitle|BQL|h1}}

 

BQL - язык запросов движка SS14, который позволяет проводить массовые манипуляции с игровыми сущностями. Примеры:

Toolshed - разработана как замена старым BQL командам, но не сильно от них отличается. (см. файл [https://docs.spacestation14.com/en/robust-toolbox/toolshed.html])

Например: