📺 Кастомный интерфейс

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

Кастомные интерфейсы

Для начала, вам нужно перейти в пространство создания интерфейсов, делается это одноимённой командой. Примечание: чтобы скрипт продолжился после открытия gui необходимо будет его закрыть.

gui {
    // Здесь вы можете располагать свои виджеты
}

---

Виджеты

Картинка

    //путь к картинке указывается в формате ResourceLocation.
    image("modid:path/to/texture.png>") {
        // Настройки виджета
    }

Кнопка

    // Текстура кнопки должна состоять из верхней и нижней части, где верхняя - обычная кнопка, нижняя - нажатая кнопка.
    button("Текст кнопки", "modid:path/to/texture.png>") {
        
        // Настройки виджета - Кнопка
        anchor = Anchor.END //Центрирование текста в кнопке, есть: START, CENTER, END
        textOffsetX = <num) // Int | Смещение текста в кнопке на оси X
        textOffsetY = <num> // Int | Смещение текста в кнопке по оси Y
        hoverText = "<text>" // String | Изменение текста при наведении курсором
        color = 0x<HEX> // #HEX_CODE | Основнйо цвет
        hoverColor = 0x<HEX> // #HEX_CODE | Изменение цвета кнопки при наведении курсором
        scale = <float> // Float | Размер элемента

        // Действие при нажатии
        onClick = {
            // Здесь Вы можете указать что будет происходить при нажатии.
            // Учтите, здесь пишутся одноразовые действия (т.е. запускаемые на этапе выполнения скрипта, как например в функции next { ... })
            // Это значит что например дать нпс задачу идти к блоку Вы тут не сможете, но поменять значение переменной - вполне возможно

            close() // Команда для закрытия этого GUI
        }
    }

Заголовок / Текст

    label("Текст на экране") {
        
        // Настройки виджета - Текст
        anchor = Anchor.END //Центрирование текста, есть: START, CENTER, END
        color = 0x<HEX> // #HEX_CODE | Основной цвет
        scale = <float> // Float | Размер элемента
    }

Моб / Сущность / НИП

    // Можно указать как НИПа, так и любого моба (примечание - строка "minecraft:zombie", это не моб, это строка!)
    // Моба можно или взять из мира или создать самому
    entity(<mob>) {
        
        // Настройки виджета - Сущность
        scale = <float> // Float | Размер элемента
        entityX = <screenPos> // px/pw/ps/mouse | Положение сущности по оси X
        entityY = <screenPos> // px/pw/ps/mouse | Положение сущности по оси Y
    }

Настройки виджета

Единицы измерения

Прежде всего рассмотрим, как указывается разметка в GUI, она вам будет нужна чтобы указать размеры и координаты виджетов. Её есть 4 вида:

1. px - В пикселях
2. pw - В процентах от предыдущего виджета
3. ps - В процентах от размера окна игры
4. mouse - Текущее расположение мыши Например если вы хотите добавить виджет в 2 раза меньше чем окно игры, то можно указать ему размеры так: size(50.ps, 50.ps)

• Примечание: для mouse разметки просто так и пишите - mouse, а не 50.mouse или что-то в этом духе.

Общие параметры для виджетов

// Размер виджета
size(width, height) //Разметка для размеров виджета по ширине и высоте.

// Смещение виджета
offset(x, y) //Разметка для смещения виджета относительно его начального положения по x и y.

// Смещение от краёв (каждый из параметров не обязателен)
// Сместятся виджеты расположенные внутри текущего виджета
padding(
    top = placement, //смещение от верхней части окна
    left = placement, //смещение от левой части окна
    bottom = placement, //смещение от нижней части окна
    left = placement, //смещение от правой части окна
)

// Выравнивание относительно предыдущего виджета
align(Alignment.TYPE)
/**
 * TYPE:
 * - TOP_LEFT      | Сверху слева
 * - TOP_CENTER    | Сверху по центру
 * - TOP_RIGHT     | Сверху справа
 * - ---           | ---
 * - LEFT_CENTER   | Слева по середине
 * - CENTER        | По центру
 * - RIGHT_CENTER  | Справа по середине
 * - ---           | ---
 * - BOTTOM_LEFT   | Снизу слева
 * - BOTTOM_CENTER | Снизу по центру
 * - BOTTOM_RIGHT  | Снизу справа
*/

// Слой - для переноса на задний или передний слой
zLayer = <int> //целое число
enableDepth = true //Нужно для работы предыдущего, по умолчанию на переднем плане рисуется то, что рисовалось последним, если включить глубину, тогда будет работать и zLayer.

---

Примеры:

gui {
    size(90.pw, 90.pw)

    image("hc:textures/gui/background_ftbq.png") {
        align(Alignment.LEFT_CENTER)
        size(100.pw, 100.pw)
    }

    label("Как дела?") {
        align(Alignment.TOP_CENTER)
        offset(0.px, 0.px)
        size(35.ps, 8.ps)
    }

    button("Нормально", "hc:textures/gui/buttons/hollow_button.png") {
        align(Alignment.TOP_LEFT)
        size(70.pw, 30.pw)
    }

    button("Классно", "hc:textures/gui/buttons/hollow_button.png") {
        align(Alignment.LEFT_CENTER)
        size(70.pw, 30.pw)
        offset(0.px, 30.pw + 10.px)

        anchor = Anchor.END
    }
}