/metabuild

Create Minecraft resourcepacks with stylized description in MiniMessage format, placeholders and more

Primary LanguageKotlinGNU General Public License v3.0GPL-3.0

Собирает Minecraft-ресурспак из папки в zip, обходя все ненужные файлы, а также использует специальный конфиг pack.yml для создания pack.mcmeta, в котором можно использовать синтаксис MiniMessage в описании ресурспака.

pack.yml

# Название, которое будет использовано для архива. 
# Плейсхолдер %dirname% существует по умолчанию и является именем корневой папки
name: "%dirname%-%version%"

placeholders:
  version: 1.0

# Может быть как числом pack_format, так и напрямую версией игры. 
# Программа автоматически подбирает нужный pack_format для версии.
pack-format: "1.20"

# Описание ресурспака с синтаксисом MiniMessage
description: |-
  <#BDB8F6>Resourcepack</#BDB8F6> <#ECAEF6>%version%</#ECAEF6>
  <gray>by</gray> <gradient:#f6895a:#fff16b>ᴏᴜᴛʙʀᴇᴀᴋ</gradient>

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

Собрать ресурспак из папки resourcepack и сохранить zip в папку build:

java -jar metabuild-1.0.jar zip --input resourcepack --output build

Создать pack.mcmeta на основе pack.yml в текущей папке:

java -jar metabuild-1.0.jar mcmeta

Создать pack.yml и pack.mcmeta в текущей папке:

java -jar metabuild-1.0.jar init

Как установить в систему

Инструкция для Windows:

  1. Создаём в любом месте папку и копируем туда metabuild.jar

  2. Создаём в папке скрипт metabuild.bat со следующим содержимым:

    @echo off
java -jar %~dp0metabuild-1.0.jar %*

  3. Добавляем в системную переменную PATH путь к папке с исполняемым файлом и скриптом.

  4. Перезапускаем консоль. Готово, теперь в консоли будет работать команда metabuild (т. е. название скрипта).

Команды

zip

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

Параметры:

  • -i, --input <путь> - путь к папке ресурспака
  • -o, --output <путь> - путь к папке для сохранения архива
  • --overwrite, -y - перезаписать, если файлы существуют (по умолчанию выполнение будет отменено, если файлы существуют)

mcmeta

Генерирует файл pack.mcmeta на основе существующего pack.yml.

Параметры:

  • -d, --dir <путь> - путь к корневой папке ресурспака

init

Создаёт файл pack.yml с конфигурацией по умолчанию и сразу же генерирует pack.mcmeta.

Параметры:

  • -d, --dir <путь> - путь к корневой папке ресурспака
  • --overwrite, -y - перезаписать, если файлы существуют (по умолчанию выполнение будет отменено, если файлы существуют)

info

Выводит информацию о ресурспаке на основе pack.yml, такую как версия, название и описание.

Параметры:

  • -w, --what - какую информацию выводить. Допустимые варианты: name, version, description, description-raw, description-plain.