HexParse

HexParse - мод для Майнкрафт, который сильно упрощает жизнь игрокам в Hex Casting. Если вы хоть раз пытались вручную собирать длинные заклинания через фокусы, книги заклинаний или узлы мысли, то знаете главную боль мода: код в Hex Casting удобно хранить не всегда, а вот читать, переносить и редактировать его в обычном текстовом виде - намного проще. HexParse как раз решает эту задачу.

Суть простая: мод превращает пользовательский код в список иот, то есть в pattern list или literal list, через команды и специальные паттерны. Проще говоря, вы можете писать заклинания как текст, а потом быстро загонять их в предмет в руке. И наоборот - взять предмет, считать из него иоты и получить обратно читаемый код в чате. Для игроков, которые реально пишут сложные касты в Minecraft, это один из тех инструментов, после которых возвращаться на ванильный ввод уже не хочется.

Скачать HexParse стоит в первую очередь тем, кто играет с Hex Casting на версиях Minecraft 1.19.2, 1.20.1 и 1.21.1. Мод доступен для Fabric, Forge и NeoForge, работает и на клиенте, и на сервере. Это важный момент: проект не выглядит как узкая клиентская игрушка, а ощущается как полноценная утилита для практической игры, тестирования заклинаний и обмена кодом.

Что делает HexParse

HexParse добавляет пару паттернов и целый набор команд, которые конвертируют пользовательский код в список иот. Для работы нужно держать в руке поддерживаемый предмет - обычно это фокус, книга заклинаний или другой совместимый контейнер из Hex Casting.

Поддерживаются:

• Focuses
• Spell Books
• Thought Knots для 1.20
• дополнительные типы предметов через HexParseAPI или IOMethod

То есть мод не привязан жестко только к одному предмету. Он распознает классы предметов, а значит систему можно расширять. Для разработчиков аддонов это прямо полезная штука.

Зачем вообще нужен этот мод

В Hex Casting очень быстро упираешься в неудобство хранения и переноса кода. Особенно когда заклинание становится длинным, вложенным, с кучей паттернов, констант и служебных вставок. В игре это выглядит красиво, но редактировать такое вручную - удовольствие сомнительное.

HexParse убирает этот барьер. Он позволяет:

• писать код заклинания в текстовом виде
• вставлять код из буфера обмена
• считывать уже готовые иоты обратно в чат
• делиться кодом с другими игроками
• сохранять макросы и диалекты
• разбираться с конфликтами коротких имен паттернов
• работать с комментариями внутри списка иот

По факту это не просто "удобная команда", а целая прослойка между человеком и системой заклинаний Hex Casting. Если вы строите сложные касты, тестируете идеи, переносите схемы между мирами или серверами - мод реально экономит кучу времени.

Основные команды HexParse

Команд у мода много, и это как раз тот случай, когда список действительно важен. Ниже - самое полезное.

Чтение и запись

• /hexParse[ ](/mod/hexparse)<code string> [rename] - парсит введенный код в поддерживаемый предмет в руке. Аргумент rename позволяет сразу переименовать предмет.
• /hexParse[ ](/mod/hexparse)read - читает иоты из предмета в руке, превращает их в код и показывает в чате. По клику результат копируется.
• /hexParse[ ](/mod/hexparse)read_signatures - похоже на read, но игнорирует известные ID паттернов и выводит все как угловые сигнатуры.
• /hexParse[ ](/mod/hexparse)clipboard [rename] - берет текст из буфера обмена клиента и парсит его в предмет в руке.
• /hexParse[ ](/mod/hexparse)clipboard_angles [rename] - то же самое, но принимает паттерны только в виде сырых угловых строк вроде "wedsaq".
• /hexParse[ ](/mod/hexparse)clipboard_hexpattern [rename] - экспериментальный вариант для формата .hexpattern. Поддерживается не все, так что тут лучше тестировать аккуратно.
• /hexParse[ ](/mod/hexparse)share - экспериментальная команда, которая отправляет сырой контент иоты и кликабельный код всем игрокам на сервере.
• /hexParse[ ](/mod/hexparse)read_hexbug - переводит результат в формат, который использует Discord HexBug для /patterns hex. Нюанс: не-паттерновые константы и часть старых registry-имен все еще придется править руками.
• /hexParse[ ](/mod/hexparse)mind_stack ... - чтение и запись иот из mind stack игрока, то есть из staff casting VM.
  • ...[ ](/mod/hexparse)peek - показать последнюю иоту в стеке разума. Если стек пуст, вернется null.
  • ...[ ](/mod/hexparse)push <code> - распарсить код и положить его в mind stack.
  • ...[ ](/mod/hexparse)push_clipboard - то же самое, но код берется из буфера обмена.
• /hexParse[ ](/mod/hexparse)property ... - интеграция с Hexcellular, чтение и запись данных для PropertyIota. Все имена свойств принудительно получают префикс _ из соображений безопасности.
  • ...[ ](/mod/hexparse)read <propName> - прочитать и распарсить свойство.
  • ...[ ](/mod/hexparse)write <propName> <code> - записать код в свойство.
  • ...[ ](/mod/hexparse)clipboard <propName> - записать код из буфера обмена.

На практике чаще всего вы будете жить на read, clipboard и обычной записи через /hexParse <code>. Это базовый рабочий цикл: написал код, вставил, проверил, считал обратно, поправил.

Макросы, диалекты и конфликты

• /hexParse[ ](/mod/hexparse)(macro/dialect) ... - редактирование клиентских диалектов кода и макросов.
  • ...[ ](/mod/hexparse)list - показать все сохраненные макросы или диалекты.
  • ...[ ](/mod/hexparse)define <key> <value> - создать или переопределить соответствие.
  • macro[ ](/mod/hexparse)define_clipboard <key> - создать макрос из содержимого буфера обмена.
  • ...[ ](/mod/hexparse)remove <key> - удалить запись по ключу, если она есть.
• /hexParse[ ](/mod/hexparse)conflict - разрешение конфликтов, когда несколько паттернов имеют одинаковое короткое имя.
  • ... или ... list - показать все короткие имена, на которые ссылаются несколько длинных ID.
  • ...[ ](/mod/hexparse)list <short_name> - показать все конфликтующие ID под конкретным коротким именем.
  • ...[ ](/mod/hexparse)set <short_name> <long_ID> - перенаправить короткое имя на нужный ID паттерна.

Вот это очень полезная часть, особенно если у вас стоит не только Hex Casting, но и аддоны. Когда разные моды добавляют похожие паттерны, короткие имена начинают конфликтовать, и без нормального инструмента это быстро превращается в головную боль. HexParse хотя бы дает вам рычаг управления.

Прочие помощники

• /hexParse[ ](/mod/hexparse)donate [amount] - "пожертвовать" немного медиа природе. По сути шуточная команда, но в духе Hex Casting.
• /hexParse[ ](/mod/hexparse)learn_great - читает предмет в руке и изучает great pattern или сразу несколько.
• /hexParse[ ](/mod/hexparse)lehmer [...nums] - считает код Лемера для заданной перестановки. Пригодится для Swindler's Gambit.

OP-команды

• /hexParse[ ](/mod/hexparse)unlock_great (unlockAll|lockAll|unlock <pattern id>|lock <pattern id>) - управление разблокировкой great-паттернов в текущем мире. Можно открыть или закрыть все сразу, либо работать с конкретным паттерном.

Для админов сервера это удобно. Особенно если вы делаете прогрессию, ивенты или просто хотите контролировать, какие великие заклинания вообще доступны игрокам.

Какие паттерны добавляет мод

HexParse не ограничивается командами. Он еще и добавляет свои паттерны, которые встраиваются в экосистему Hex Casting.

• comment_switcher - превращает входной Comment Iota в String Iota, а все остальное - в Comment Iota.
• code2focus - эквивалент /hexParse clipboard, только уже через паттерн. И несмотря на название, работает не только с фокусами.
• focus2code - эквивалент /hexParse read.
• remove_comments - очищает comment iotas из входного списка, включая вложенные списки.
• learn_patterns - читает предмет в руке и изучает great pattern или несколько.
• create_linebreak - добавляет в стек comment iota с переносом строки и отступами на заданное число пробелов.
• donate - эквивалент /hexParse donate.
• compile - great spell, который берет строковую иоту из MoreIotas и парсит ее в список кода.

Отдельно приятно, что описания этих паттернов также есть внутри книги, в разделе HexParse Patterns. То есть мод не бросает вас одного с командной строкой.

CommentIota - зачем нужны комментарии в заклинаниях

Одна из самых недооцененных фич мода - новый тип иоты CommentIota.

Она отображает строку внутри себя, а при парсинге превращается в null-иоту с id "hexparse:comment", которая при исполнении ничего не делает. Звучит просто, но на практике это очень удобно.

Комментарии могут быть:

• текстовыми заметками
• переносами строк
• отступами
• плейсхолдерами неизвестных great spell

Если зажать Shift, все комментарии скрываются. Это особенно полезно, когда хочется посмотреть чистую структуру заклинания без визуального шума.

Для больших кастов это прямо must-have. Ну реально. Когда заклинание длинное, без комментариев через пару дней ты уже сам не помнишь, зачем там стоял тот или иной блок.

Дополнительные мелочи

Еще одна удобная вещь: на странице каждого паттерна можно нажать Shift, чтобы увидеть registry ID паттерна. Мелочь, но для отладки, конфликтов и аддонов - очень приятная мелочь.

HexParseAPI для разработчиков

Если вы не просто игрок, а делаете аддоны или интеграции, у HexParse есть свой API.

Расположение: io.yukkuric.hexparse.api.HexParseAPI

Что внутри:

• AddForthParser(p:[ ](/mod/hexparse)IStr2Nbt)
• AddBackParser(p:[ ](/mod/hexparse)INbt2Str)
• <T[ ](/mod/hexparse): SpecialHandler> AddSpecialHandlerBackParser(cls: Class<T>, func: (T, CompoundTag) -> String)
• CreateItemIOMethod(cls:[ ](/mod/hexparse)Class<*>, writer: ((ItemStack, CompoundTag) -> Unit)?, reader: ((ItemStack) -> CompoundTag?)?, priority: Int = 0, validator: ((ItemStack, Boolean) -> Boolean)?

Для обычного игрока это не самый важный раздел, а вот для моддера - уже интересно. Можно расширять парсеры, добавлять поддержку новых типов предметов и встраивать HexParse в свои механики.

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

По свежим данным, HexParse актуален для Minecraft Java 1.21.1, 1.20.1 и 1.19.2, поддерживает Fabric, Forge и NeoForge и работает как на клиенте, так и на сервере. Проект живой: на Modrinth у него около 18,6 тыс. загрузок, лицензия MIT, а страница обновлялась совсем недавно.

Из заметных свежих улучшений для 1.20.1 стоит выделить команду /hexParse read_signatures, которая выводит сигнатуры вместо известных ID паттернов, а также добавленные парсеры для Potion Iota и Dimension Iota. Это как раз тот случай, когда мод не просто существует, а продолжает аккуратно развиваться по мелочам, которые реально нужны игрокам.

Кому HexParse нужен в первую очередь

Если вы играете в Hex Casting совсем чуть-чуть и не пишете сложные заклинания, мод может показаться избыточным. Но если вы:

• пишете длинные касты
• часто переносите код между предметами
• работаете с буфером обмена
• делитесь заклинаниями с другими игроками
• тестируете great patterns
• собираете сервер с Hex Casting

то HexParse очень быстро станет одним из тех модов, без которых уже неудобно.

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

Важный нюанс

HexParse - это мод именно для экосистемы Hex Casting, а не универсальный редактор всего подряд. Если у вас нет Hex Casting или вы им не пользуетесь, толку от него не будет. А вот если Hex Casting уже стоит в сборке, HexParse воспринимается как логичное продолжение мода, почти обязательная утилита для серьезной работы с кодом заклинаний.

Если хотите удобнее писать, читать, хранить и переносить заклинания в Minecraft, скачать HexParse однозначно стоит. Особенно если ваша сборка уже крутится вокруг Hex Casting и вы хотите меньше возни с ручным вводом и больше контроля над кодом.