Patchouli - книга для создания гайдов и вики в модах и модпаках [1.20.1] [1.19.4] [1.18.2] [1.17.1] [1.16.5] [1.12.2]

Для начала вам необходимо установить мод и запустить игру, либо руками создать папку .minecraf/patchouli_books
Внутри создайте папку с названием вашей книги, например ruminecraft
Внутри файл book.json и папку en_us внутри папки entries, categories,templates

Насчет папки en_us, это стандартная папка загружаемая первой и она обязательно должна быть, если вы делаете русскую книгу, русский текст может быть в ней, если книга поддерживает несколько языков, то en_us создается на английском, а для русского создается ru_ru, и если в игре выбран русский, то подгружается книга из ru-ru, все аналогично переводам модов.

Внутрь файла book.json напишите например это:

{
"name": "Имя книги",
"landing_text": "Описание книги",
"version": 1
}

В книге на главной странице существуют категории, для создания категории создайте файл \patchouli_books\ruminecraft\en_us\categories\test_category.json

{
"name": "Пользователи Румайна",
"description": "Эта категория посвящена самым опасным пользователям румайна!",
"icon": "minecraft:writable_book"
}

Я думаю тут все понятно, обратите внимание на категорию test_category в названии файла, в статьях (для распределения по категориям) будет указываться именно оно.
Для создания статьи, создайте файл .minecraft\patchouli_books\ruminecraft\en_us\entries\test_entry.json

{
"name": "Соус Парк",
"icon": "minecraft:writable_book",
"category": "test_category",
"pages": [
{
"type": "text",
"text": "Эта статья посвящена главному уроду на сайте - Админу Соусу, если вы общаетесь с ним, вероятно вы играете в овервотч и несете в игровой чат всякий бред, иногда добрый и справеделивый, любит новости, а хорошие новости любит еще сильней!"
}
]
}

{
"name": "Как создать Соуса",
"icon": "minecraft:diamond",
"category": "test_category",
"pages": [
{
"type": "crafting",
"text": "Вы можете создать соуса в верстаке, так как это не простой юнит, создается довольно дорого"
},
{
"type": "crafting",
"recipe": "minecraft:diamond_chestplate"
}
]
}

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

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

Создаем статью с таким содержимым:

{
"name": "Портал к Соусу",
"icon": "minecraft:obsidian",
"category": "test_category",
"pages": [
{
"type": "multiblock",
"name": "Портал к Соусу",
"text": "Это обычный портал созданный из алмазных блоков и золотого",
"multiblock": {
"pattern": [
[ " OO " ],
[ "OPPO" ],
[ "OPPO" ],
[ "OPPO" ],
[ " O0 " ]
],
"mapping": {
" ": "ANY",
"0": "minecraft:gold_block",
"O": "minecraft:diamond_block",
"P": "AIR"
},
"symmetrical": true,
"offset" : [0, 0, 0],
"view_offset": [0, 0, 0]
}
}, {
"type": "spotlight",
"title": "Как активировать портал к Соусу",
"text": "Просто создайте хорошую новость, запишите на бумагу и киньте в портал, сразу прибежит соус",
"item": "minecraft:flint_and_steel#10"
}
]
}

Я думаю все понятно, описание, а так же изображение самого портала, а так же типы блоков, получаем такую страницу:



Вот пример создания статьи с рендерингом моба:

{
"name": "Люимое животное Соуса",
"icon": "minecraft:obsidian",
"category": "test_category",
"pages": [
{
"type": "entity",
"name": "Любимое животное Соуса",
"text": "Он любит курицу, принесите ему немного жареной курочки",
"entity": "minecraft:chicken"
}
]
}

Получаем результат: