Back-burner

Back-burner

Полностью клиентский список дел, отображаемый сбоку экрана и управляемый через команды.

Каждый мир и сервер сохраняет свой список дел отдельно.

Расположение файлов

Данные сохраняются в виде JSON-массивов строк.

Для одиночных миров они сохраняются в корне директории мира под именем backlog.json

Для мультиплеера они сохраняются в .minecraft/remote_backlogs/, используя ip/адрес и порт сервера в качестве имени файла. Миры по LAN обрабатываются так же.

Конфиг

Конфиг можно редактировать прямо в игре с помощью Cloth-Config и ModMenu. Это позволит менять положение и размер hud.

Команды

По умолчанию все подкоманды используют /note в качестве корня. Имя корня можно изменить в меню конфига на случай конфликта.

Аргументы `` принимают как обычный текст, так и SNBT-текст (см. Формат текста ниже). Обычный текст не нужно брать в кавычки.

Аргументы `также поддерживаютfirstиlast` как альтернативу числовым значениям.

Добавление элементов

• `push ` Добавляет элемент наверх.
• `queue ` Добавляет элемент вниз.
• `write ` Добавляет элемент в список. (См. меню конфига.)
• `add|insert ` Добавляет элемент по произвольному индексу.

Удаление элементов

• pop Удаляет самый верхний элемент.
• shift Удаляет самый нижний элемент.
• `pop|remove ` Удаляет указанный элемент. Автодополнение покажет текст для соответствующего индекса.
• clear Удаляет всё.

Редактирование

• `edit ` Перезаписывает существующий элемент. Автодополнение предложит старое значение.
• `bump ` Перемещает элемент на одну позицию вверх.
• `bump ` Перемещает элемент на заданное число позиций. Положительные значения двигают вверх, отрицательные — вниз.
• `move ` Перемещает элемент с одного индекса на другой.

Hud

• `hide ` Включает или выключает hud списка дел. Можно вызвать без аргумента.

Отладка

Эти команды не нужны для обычного использования.

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

Формат текста

Обычный текст жадно поглощает всё и не нуждается в кавычках:

/note push I am an unquoted text

Когда используется SNBT-текст, его также можно применять в массивах, например для полей description в ресурспаках. Формат имеет некоторые различия в разных версиях Minecraft.

Простой SNBT:

/note push { text:"32x Redstone", color:red, bold:1, italic:1 }

Частично окрашенный текст: (MC 1.21.5 и ранее)

/note push [{text:"32x "}, {text:Redstone,color:red}]

Частично окрашенный текст: (MC 1.21.6 и новее)

/note push ["32x ", {text:Redstone,color:red}]

Текст со спрайтами: (MC 1.21.9 и новее)

/note push ["32x ", {atlas:items,sprite:item/redstone}, {text:Redstone,color:red}]

Ресурспаки

Помимо текстур, ресурспаки могут менять некоторые мелкие аспекты разметки hud списка дел, изменяя .mcmeta файл соответствующей текстуры.

• basis: { width, height } Базовый размер элемента на экране.
  Для 16x-паков он строго равен размеру текстуры. Для 32x-паков это половина размера текстуры. И так далее. Для этих элементов не ожидается какого-то конкретного размера текстуры; именно указанные здесь значения определяют ожидаемые размеры.
• basis: { fill } (boolean) Должен ли элемент занимать столько горизонтального места, сколько разрешено (true), или сжиматься под текст (false).
• ninepatch: { top, bottom, left, right } Отступы 9-patch. То есть области, которые не будут растягиваться под размер элемента.
• padding: { top, bottom, left, right } Пустое пространство, которое будет добавлено вокруг элемента. Отрицательные значения можно использовать, чтобы убрать пространство и заставить элементы перекрываться.
• textarea: { top, bottom, left, right } Отступы внутри текстуры, которые не будут заполняться текстом.

• text: {...} Различные цвета текста для этого элемента, заданные в виде hex-кодов #aarrggbb. Альфа-компонент обязателен.

  • colour — основной цвет текста
  • outline задаёт основной цвет обводки.
  • outerline добавляет более толстую обводку вокруг первой обводки. Требует, чтобы первая была задана.
• text: { shadow } (boolean) Должен ли текст иметь тень. Несовместимо с любой обводкой.