redmon

Redmon

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

• Повторители (вкл/выкл)
• Компараторы (вкл/выкл)
• Факелы (вкл/выкл)
• Редстоуновая пыль (вкл/выкл и сила сигнала)
• Редстоуновые лампы (вкл/выкл)

Краткое руководство

Горячие клавиши

В моде есть небольшое количество выделенных горячих клавиш для частых операций.

• = — Переключить видимость оверлея мода.
• [ — Показать предыдущую страницу профиля.
• ] — Показать следующую страницу профиля. Эти горячие клавиши можно настроить в настройках игры.

Создание профиля

Redmon работает с помощью «профилей». Прежде чем создавать или просматривать сигналы, нужно создать профиль, который будет их содержать. При первой загрузке мода ни один профиль не выбран (см. верхний левый угол). Первый шаг к добавлению отладочного вывода в вашу постройку — выбрать место активации для профиля и отметить его, чтобы потом можно было найти: Выбрав опорный блок, встаньте на него и создайте профиль: `/redmon profile create ` Это создаст пустой профиль с указанным именем и сделает его текущим относительно вашего положения в мире. После выполнения этой команды вы должны увидеть профиль в верхнем левом углу экрана, вот так:

• new_page — Текущая страница профиля (имя по умолчанию).
• test — Имя созданного профиля. Профили хранятся на диске по пути .minecraft/config/redmon_profiles.json и сохраняются автоматически по мере внесения изменений. Просмотреть сохранённые профили можно командами /redmon profile list и /redmon profile search. Существующие профили можно выбрать так: `/redmon profile select При выборе профиль «привязывается» к миру относительно текущей позиции игрока. Это позволяет применять профили к постройкам независимо от их положения в мире. Рекомендуется отмечать позицию, где был создан профиль, чтобы знать, где встать при повторном его выборе! Если компоненты отсутствуют или профиль был выбран в неправильном месте, и мод, соответственно, не может найти один или несколько блоков, в оверлее появятся ошибки, вот так: ![image](https://raw.githubusercontent.com/ac101m/redmon/refs/heads/master/images/multibit-signal-error.png) Вы также можете добавлять дополнительные страницы в профиль, которые можно переключать с помощью [горячих клавиш](#hotkeys): /redmon page add Наконец, когда вы закончите с выбранным профилем, можно выполнить /redmon profile deselect`, чтобы вернуть интерфейс в исходное состояние.

Добавление сигналов

Сигнал состоит из блока (или набора блоков), который вы хотите отслеживать в оверлее. Сигналы добавляются, когда вы смотрите на блок или провод и выполняете команду /redmon signal add, чтобы добавить сигнал в текущий активный профиль: `/redmon signal add ` На данный момент доступно 5 типов сигналов:

• repeater — Редстоуновый повторитель.
• torch — Редстоуновый факел.
• dust_binary — Редстоуновая пыль (вкл или выкл).
• dust_ss — Редстоуновая пыль (сила сигнала).
• comparator_binary — Компаратор. На следующем скриншоте показан результат выполнения команды /redmon signal create dust dust_binary 1, когда вы смотрите на участок редстоуновой пыли. Эта команда создаёт одиночный сигнал редстоуновой пыли с именем "dust": Также можно добавлять сигналы из нескольких блоков одной командой. Для этого нужно навести прицел на компонент, представляющий самый старший бит нужного сигнала, и указать количество блоков больше одного, вот так: /redmon signal create repeaters repeater 8 При создании такого многоблочного сигнала мод будет искать дополнительные подходящие блоки вдоль ближайшего к углу взгляда игрока кардинального направления. Если запрошенное количество блоков не найдено, в консоли появится ошибка. Обязательно смотрите в нужную сторону при использовании этой команды! Сигналы также можно удалять, перемещать, переименовывать или переформатировать с помощью следующих команд:
• `/redmon signal remove `
• `/redmon signal move (up|down) []`
• `/redmon signal move column `
• `/redmon signal rename `
• `/redmon singal format `

Встроенный дизассемблер

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

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

Создание набора инструкций

Первый шаг к использованию встроенного дизассемблера — создать набор инструкций, который будет содержать ваши схемы инструкций: `/redmon isa create ![image](https://raw.githubusercontent.com/ac101m/redmon/refs/heads/master/images/created-isa.png) В приведённом выше случае был создан ISA с именем test_isa` шириной 16 бит. Существующие инструкции

Наборы также можно запрашивать с помощью: `/redmon isa list []`

Добавление инструкций

Когда ISA создан, в него можно добавлять инструкции. Инструкции добавляются с помощью следующей команды: `/redmon instruction add `

• `` — Имя ISA, в который добавляется инструкция.
• `` — Имя инструкции (также мнемоника, которая будет отображаться в оверлее).
• `` — Описание, обычно краткая сводка того, что делает инструкция.
• `— Разделённый точками с запятой список спецификаторов полей инструкции. Например, следующая команда создаёт инструкцию под названием "ADDI" с пятибитным кодом операции (01000), семибитным знаковым непосредственным значением и четырёхбитным адресом регистра. Инструкция добавляется в набор инструкцийtest_isa. /redmon instruction add test_isa ADDI "Add signed immediate to a register." opcode:01000; imm_s:7; reg_rw:4` Разбор спецификаторов полей для этой команды:
• opcode:01000 — Настраивает код операции для инструкции.
• imm_s:7 — Семибитное знаковое непосредственное значение.
• reg_rw:4 — Четырёхбитный адрес регистра. После создания инструкции можно просмотреть подробный разбор её полей так: /redmon instruction info test_isa ADDI У инструкций может быть сколько угодно полей, но их суммарный размер должен совпадать с шириной набора инструкций, а код операции не должен совпадать с кодом любой другой инструкции. Коды операции переменной длины поддерживаются. Доступны следующие типы полей:
• `opcode:` — Поле кода операции.
• `flag_bit:` — Одиночный бит флага, ожидает один символ, задающий имя флага.
• `imm_s:` — Знаковое непосредственное поле.
• `imm_u:` — Беззнаковое непосредственное поле.
• `reg_r:` — Поле адреса регистра для чтения.
• `reg_w:` — Адрес регистра для записи.
• `reg_rw:` — Адрес регистра для чтения + записи.
• `ignore:` — Биты, игнорируемые этой инструкцией.

Включение ISA

После создания ISA следующий шаг — выбрать его для текущей страницы профиля (см. создание профиля для инструкции по созданию профиля). Следующая команда настроит текущую страницу на использование выбранного ISA: `/redmon isa select ` После этого в левом верхнем углу появится индикация того, что ISA выбран. Выбор ISA работает на уровне отдельной страницы, что позволяет одному профилю ссылаться на несколько наборов инструкций на разных страницах.

Просмотр дизассемблирования сигнала

Есть два способа просмотреть дизассемблирование: первый — с помощью команды ./redmon isa disassemble, которая дизассемблирует инструкцию, переданную прямо в команде, а второй — выбрав ISA путём форматирования сигнала со спецификатором формата asm. В чате: `/redmon isa disassemble (bin|dec|hex) В оверлее: /redmon signal format asm` Оверлей с дизассемблированием инструкции в чате и в оверлее: Если инструкция не распознана или в сигнале присутствует неверное число битов (больше или меньше размера isa), то в оверлее будет показана ошибка.