Patchouli - книга для создания гайдов и вики в модах и модпаках [1.17.1] [1.16.5] [1.15.2] [1.14.4] [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"
    }
  ]
}

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