> For the complete documentation index, see [llms.txt](https://wiki.aegis-mine.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.aegis-mine.ru/modifications/sozdanie-kontenta/patchouli/sozdanie-knigi.md).

# Создание книги

Перво-наперво следует заняться созданием кастомной книги, в которой будут находиться основные сведения, заполняемые Вами же впоследствии.

Разберём данный процесс поэтапно:

**1. Найдите каталог&#x20;**<mark style="color:blue;">**patchouli\_books**</mark>\
Ваши книги и их содержимое будут размещены в папке <mark style="color:blue;">**patchouli\_books**</mark>. Обратите внимание, что Вам нужно один раз запустить игру с установленным Patchouli, чтобы папка появилась.

**2. Создайте свою структуру папок**\
Как только Вы найдёте папку <mark style="color:blue;">**patchouli\_books**</mark>, выберите название для своей книги. Разрешены только символы нижнего регистра. Это внутреннее название Вашей книги, и мы рекомендуем сделать его особенным. Что касается модов, Вы должны назвать их именно так, для чего, непосредственно, будет предназначена книга (например, lexicon для Botania). Для модпаков назовите их как-нибудь с именем Вашего модпака. После того, как закончите с этим, создайте папки и файлы внутри **patchouli\_books**, чтобы это выглядело следующим образом:

<div align="left"><figure><img src="https://88247998-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwIhyvBxJYLfHMqS8tmat%2Fuploads%2FLxbiPk1sk8KgLC6TJ1SF%2Fphoto_2024-07-25_19-55-00.jpg?alt=media&amp;token=b83db230-b253-430e-a20e-57733700779d" alt=""><figcaption></figcaption></figure></div>

Обратите внимание, что создание **en\_us** папки означает, что вы создаете **"английскую"** версию своей книги. Содержимое, которое Вы помещаете в **en\_us** папку, всегда загружается как "основное", поэтому, даже если изначально книга не должна быть на английском языке, Вам нужно поместить туда свой основной материал. (Но Вы можете писать в этот файл на русском языке)

**3. Заполните&#x20;**<mark style="color:blue;">**book.json**</mark>\
Откройте файл **book.json** с помощью текстового редактора и заполните его следующим образом:

```json
{
    "name": "BOOK NAME",
    "landing_text": "LANDING TEXT",
    "version": 1
}
```

где **"name"** — это название, под которым будет отображаться Ваша книга, а **"landing\_text"** - текст, который будет отображаться на левой странице книги в игре. В **version** указывается, к какому изданию она относится. Всякий раз, когда Вы обновляете свой справочник, необходимо также изменять значение издания.

<div align="left"><figure><img src="https://88247998-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwIhyvBxJYLfHMqS8tmat%2Fuploads%2FJQ0C2dPRT9vfzJN3pq0F%2Fphoto_2024-07-25_19-55-38.jpg?alt=media&amp;token=1b4e7769-ac46-4838-b568-801964a52abf" alt=""><figcaption></figcaption></figure></div>

**4. Проверьте в игре**\
Запустите Майнкрафт и проверьте, появилась ли книга. Если Вы нигде не ошиблись, она будет на вкладке **Разное**. Если Вы не видите своей книги, проверьте, правильно ли загружен Patchouli и нет ли каких-либо ошибок в настраиваемом файле.

<div align="left"><figure><img src="https://88247998-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwIhyvBxJYLfHMqS8tmat%2Fuploads%2FvIwmm4rQG9NzDmpIVDj0%2Fphoto_2024-07-25_19-56-27.jpg?alt=media&amp;token=688e921e-89fe-4e76-9c33-00bda15ec6d6" alt=""><figcaption></figcaption></figure></div>

Книгу можно изменять без выхода из игры!
