FTMC TouchSign Datapack

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

Датапак предоставляет инструменты для создания интерактивных интерфейсов, позволяя определять, в какую именно часть таблички на стене кликнул игрок. Это превращает стандартные объекты в функциональные кнопки или панели управления.

Для использования фреймворка необходимо создать собственный датапак и вызвать функцию ftmc:touchsign/click_handler. Она передаёт данные о позиции клика в переменные fttsign_touchx и fttsign_touchy.

Диапазон координат клика: fttsign_touchx от -500 (крайний левый) до 500 (крайний правый); fttsign_touchy от -250 (верхний) до 250 (нижний).

function ftmc:touchsign/click_handler
execute if score @s fttsign_touchx matches <X1>..<X2> if score @s fttsign_touchy matches <Y1>..<Y2> run <YourAction1>
execute if score @s fttsign_touchx matches <X3>..<X4> if score @s fttsign_touchy matches <Y3>..<Y4> run <YourAction2>

Примеры использования координат можно увидеть на скриншоте ниже. Например, нажатие на розовую зону активирует действие <YourAction1>, а на зелёную — <YourAction2>.

Автор подготовил несколько примеров использования фреймворка, доступных в исходном коде проекта:

• Отладочная табличка (debug sign) — проверка корректности передачи координат в значения счета.
• Компьютерная клавиатура — симуляция физической клавиатуры. При клике на букву в чат выводится соответствующее сообщение (доступно две вариации с поддержкой Unicode).
• Пианино — 25 клавиш в диапазоне C3–C5. При нажатии на клавиши воспроизводятся звуки разной частоты, имитирующие игру на фортепиано.

Предметы для этих демо-примеров можно получить командами вида /function ftmc:touchsign/demo/give_xxxxx_sign, где xxxxx заменяется на соответствующий идентификатор.

Из-за ограничений 32-битных знаковых целых чисел в системе счётов (scoreboard) и специфики математических операций, корректное определение координат ожидается только в радиусе ±2,147,000 блоков от точки спавна. При выходе за пределы этого диапазона позиция клика может определяться неверно.