> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ss14.art/llms.txt
> Use this file to discover all available pages before exploring further.

# Геймплей библиотекаря

| Дизайнеры | Реализовано | GitHub |
| --------- | ----------- | ------ |
| TheShuEd  | :x: Нет     | TBD    |

> WIP

## Обзор

Это предложение направлено на улучшение игрового цикла роли «Библиотекарь» путём добавления уникальной геймплейной значимости этой роли в раунде.
Кратко: предлагается добавить зашифрованные книги, изучая которые, библиотекарь может улучшить качество жизни отделов или антагонистов.

## Основы дизайна

### Социальность — ключ к успеху.

Библиотекарь — это роль, связанная с изучением книг и взаимодействием с людьми.
Сама по себе библиотекарь занимается только обработкой информации и её распространением.
Чтобы выполнять свою работу, он **должен** общаться и договариваться с другими людьми.

### Междисциплинарность

Деятельность библиотекаря должна иметь возможность взаимодействовать со всеми отделами игры двумя способами:

1. Отделы могут помогать библиотекарю в его работе.
2. Работа библиотекаря может улучшить качество жизни отделов.

Это также относится и к антагонистам. Антагонисты могут помогать библиотекарю, и работа библиотекаря может помогать антагонистам.

### Недетерминированность

Учитывая концепцию работы с информацией, для работы следующих принципов эта «информация» должна быть рандомизирована каждый раунд.

## Реализация

### Зашифрованные книги

Весь геймплей библиотекаря будет вращаться вокруг зашифрованных книг.

Все книги изначально имеют зашифрованные названия и случайный внешний вид, что не позволяет сразу понять, что это за знание.
Но под зашифрованной обложкой находится одна из конкретных книг, имеющих следующие параметры:

| Параметр          | Тип          | Описание                                                                                                                                                                                |
| ----------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Дисциплина        | `List<Enum>` | Все книги относятся к определённым дисциплинам. Книги могут относиться к нескольким дисциплинам. Это влияет на то, какой отдел может помочь вам изучить эту книгу.                      |
| Легальность       | Bool         | Нелегальные книги содержат опасные знания, и служба безопасности должна контролировать, что именно изучается, чтобы предотвратить утечку опасных знаний к обычному персоналу.           |
| Результат рецепта | ProtoId      | Книги содержат рецепт предметов, крафт которых рандомизирован каждый раунд. Успешная расшифровка книги — это литературное повествование с описанием последовательности крафта предмета. |

Это альтернативный способ исследования мощного снаряжения, не касающийся научного отдела.
Предметы, открываемые книгами, тематически больше связаны с «мистическим», «инопланетным» и «самодельным», чем с «высокими технологиями».
Книга может содержать рецепты крафта 1 или нескольких предметов, или сложных структур.

Также эта категория должна быть хорошим источником отсылок к существующим фантастическим или научно-фантастическим книгам.
Для начала предлагаются следующие предметы:

| Книга                                              | Описание                                                                                                                         | Ключевые слова дисциплины          | Легальность |
| -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- | ----------- |
| Легенда о Кинжале Увядания                         | Особое оружие ближнего боя, распыляющее Plant-B-Gone во время атак. Чрезвычайно эффективно против кудзу.                         | 3 Биология + 2 Военное + 1 Мистика | ✔️          |
| История о волшебниках с глупыми палочками и совами | Отсылка к Гарри Поттеру, самонаводящееся оружие дальнего боя, стреляющее радужными снарядами с небольшим уроном.                 | 7 Мистика + 3 Военная              | :x:         |
| Звёздные врата                                     | Открывает сложную последовательность крафта, позволяющую инженерам создавать врата для телепортации на планеты (текущие Gateway) | 18 Инженерия + 2 Мистика           | ✔️          |

### Игровой цикл

Весь геймплей библиотекаря можно условно разделить на 3 части, образующих цикл.

1. Поиск информации
2. Анализ и расшифровка информации
3. Распространение информации

#### Поиск

Каждый раунд зашифрованные книги появляются в случайных точках станции (книжные шкафы, шкафчики, тумбочки).
Их количество ограничено, они не повторяются, и не все могут появиться в раунде. У этих книг случайная обложка и непримечательное название с описанием. Если открыть книгу, виден только бессмысленный текст.

На этом этапе библиотекарь занят поиском этих зашифрованных книг. Процесс поиска может включать:

1. Исследование всех доступных общественных мест.
2. Просьбы к людям поискать в их отделах.
3. Запрос доступа в отделы для поиска книг.
4. Утилизаторы могут находить книги в экспедициях.

Люди также могут сами приносить книги библиотекарю. Как вы понимаете, этот этап полностью завязан на социализацию.

#### Исследование

В начале раунда создаются две таблицы: «Ключевые слова» и «Тарабарщина». Кроме того, ключевые слова сгруппированы по дисциплинам для лучшей тематичности. Каждому ключевому слову соответствует определённое слово-тарабарщина. Пример:

| Ключевое слово | Дисциплина  | Тарабарщина |
| -------------- | ----------- | ----------- |
| Legacy         | Социальная  | Grauugha    |
| Bluespace      | Техническая | Pupilo      |
| Clown          | Социальная  | Filurgha    |
| Tesla          | Техническая | Hiiski      |
| Revenant       | Мистика     | Jubaijin    |

Для каждой книги создаётся уникальный ключ из этих слов:
`Legacy Revenant Tesla`
и элементы ключа заменяются словами-тарабарщиной из таблицы.

Дисциплины — это категории знаний. Разные категории знаний позволяют изучать разные рецепты, а также различаются по сложности получения этих знаний.

| Дисциплина | Методы получения                                                                                                                                                      | Темы применения                                 |
| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- |
| Мистика    | Библиотекарь, Священник, Репортёр. Справочники по фольклору, которые можно найти в pietyvend, купить в карго или найти в экспедициях.                                 | Создание мистических и оккультных предметов.    |
| Технология | Все виды инженеров, все учёные. Справочники по древним технологиям, которые редко можно найти в шкафчиках учёных и инженеров. Купить в карго или найти в экспедициях. | Создание технологических самодельных устройств. |
| Биология   | Повар, ботаник, все врачи. Справочники по биологии, которые можно найти в медицинском отделе, купить в карго или найти в экспедициях.                                 | Живые существа, импланты, биомеханика.          |
| Военная    | Вся служба безопасности. Справочники по военным технологиям, которые НЕЛЬЗЯ купить, только найти в оружейной или экспедициях, или купить в аплинке предателя.         | Оружие и другие опасные вещи.                   |
| Социальная | Все роли. Можно найти случайно где угодно.                                                                                                                            | Забавные вещи                                   |

Каждая книга с секретной информацией состоит из N ключевых слов. Ключевые слова заменяются тарабарщиной, и при просмотре книги виден только этот тарабарный текст.
Книга может состоять из ключевых слов разных категорий. Например: метатель пирогов изучается за 1 Военное и 7 Социальных ключевых слов.

Задача библиотекаря — выяснить, какие ключевые слова обозначаются какими словами-тарабарщиной.
В этом ему могут помочь следующие 2 способа:

1. Специальные словари-справочники. Это особые книги, объясняющие значение серии из 3–6 случайных ключевых слов. Эти книги сгруппированы по дисциплинам, например, «История биологии, том 1».
2. Общение с игроками. Все игроки в начале раунда получают «знание» о некоторых ключевых словах. Это зависит от дисциплины: например, инженер будет знать 10 слов из дисциплины «Техническая» в начале раунда, а учёный — 5 слов из «Технической» и 5 из «Мистики». Эти игроки, столкнувшись с тарабарщиной в тексте в разговоре или при чтении, автоматически поймут, что означает это слово.

В результате библиотекарю нужно либо общаться с людьми с просьбами почитать книги и поделиться крохами информации, либо перерыть десятки справочников в поисках правильных значений непонятных слов.
Когда библиотекарь находит значение нужного слова, он может начать работу по переводу книги.

У библиотекаря появляется новая структура **«Дешифратор книг»**, расположенная в библиотеке. Она выглядит как старый пыльный компьютер с аналоговой клавиатурой.

Этот дешифратор имеет 2 слота для книг и интерфейс со следующими элементами:

1. Текст первой книги
2. Текст второй книги
3. Поле для ввода тарабарщины
4. Поле для ввода ключевых слов
5. Кнопка «Зашифровать»
6. Процент расшифровки книги и известная информация

Чтобы начать, библиотекарь должен поместить книгу, которую хочет расшифровать, в дешифратор, а затем поместить пустую книгу во второй слот.
После нажатия «Расшифровать» через 5-секундную задержку дешифратор превращает пустую книгу в «\[исходная книга] исследовательский проект» со статусом расшифровки 0%.

Процесс расшифровки книги — это значение от 0 до 100%. Чем выше это значение, тем больше информации об исходной книге можно узнать.

| % расшифровки | Раскрытые данные книги                                                               |
| ------------- | ------------------------------------------------------------------------------------ |
| 0%            | Дисциплина                                                                           |
| 33%           | Легальность                                                                          |
| 66%           | Настоящее название и описание                                                        |
| 100%          | Становится доступно изучение навыка или открывается полная последовательность крафта |

При 0% игрок немедленно получает информацию о дисциплине и часть HHcode в виде дат. Это выглядит так:

```
-- Исследовательский проект "Книга Ngaad-trec" --
Статус расшифровки: [0%]
Дисциплина: Биология и Мистика
Название: Неизвестно
Описание: Неизвестно
Легальность: Неизвестно
```

Библиотекарь вводит пару «Тарабарщина / ключевое слово», нажимает «Расшифровать», и после 30-секундной задержки может произойти следующее:

1. Пара расшифрована правильно. Если эта пара используется в текущей зашифрованной книге, расшифровка этого слова записывается в её исследуемую копию. Это увеличивает шкалу расшифровки и может открыть новые данные о книге в соответствии с таблицей выше.
2. Пара неверна или не используется в текущей книге. Ничего не происходит.

Таким образом, библиотекарю нужно найти все N ключевых слов и правильно ввести их в дешифратор, что приведёт к полной расшифровке книги и возможности использовать случайный крафт, описанный в ней.

#### Использование

Что делать с полностью изученной книгой и содержащейся в ней информацией — полностью на усмотрение библиотекаря. Можно распространять нелегальные знания по станции, можно отдать их командованию. Если рецепты крафта достаточно сложны и требуют серьёзных ресурсов, отдайте их инженерам для строительства.

В результате работы библиотекаря на станции появляется доступ к специальным предметам и знаниям, и именно библиотекарь решает, кто и как будет их получать.
