Short Circuit

Short Circuit

Быстрый, компактный и модульный способ проектирования редстоун-схем.

Вот Bad Apple, сделанный с помощью Short Circuit:
▶YouTube · плеер загрузится по нажатию

Загрузки

Short Circuit доступен для скачивания на Modrinth и Curseforge, для нескольких загрузчиков модов, включая Fabric, Forge, NeoForge и Quilt (использует Fabric).

• Modrinth
• Curseforge

Вы также можете собрать мод из исходников, используя JDK 21 и выполнив следующее:

git clone https://github.com/North-West-Wind/ShortCircuit.git
cd ShortCircuit
./grawdlew build

Скомпилированные файлы мода будут находиться в {loader}/build/libs/, где {loader} может быть fabric, forge или neoforge.

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

Я сделал видео об этом, если вы предпочитаете визуальное объяснение.
▶YouTube · плеер загрузится по нажатию

Этот мод добавляет 4 предмета, которые вы можете скрафтить:

• Circuit
• Poking Stick
• Truth Assigner
• Labelling Stick

Circuit

Предмет circuit выглядит как повторитель с зелёными факелами. При установке он отображается как стеклянный блок с ковром внутри. Это неинициализированная схема. Чтобы она заработала, возьмите Poking Stick и щёлкните по ней правой кнопкой мыши. Вы попадёте внутрь схемы.

Внутри есть 6 стен, середина каждой из которых помечена как U (вверх), D (вниз), L (влево), R (вправо), F (спереди), B (сзади). Они соответствуют направлению, в котором вы установили блок схемы.

Отметьте стороны как вход или выход по мере необходимости с помощью Poking Stick, щёлкнув правой кнопкой мыши с зажатым Shift по стене. Вход — это то, куда будут поступать внешние редстоун-сигналы, а выход — то, куда сигналы изнутри схемы будут выводиться в мир.

Постройте свою схему внутри. Когда закончите, вы можете покинуть внутреннее пространство, щёлкнув правой кнопкой мыши по стене с Poking Stick.

Когда вы выйдете, щёлкните правой кнопкой мыши по блоку схемы пустой рукой. Если схема не нарушает правила, вы должны увидеть компоненты, которые вы разместили внутри схемы, в блоке. Теперь эта схема готова принимать сигналы!

Дублирование

Вы можете дублировать схемы, щёлкая правой кнопкой мыши предметами circuit по установленному блоку схемы.

Poking Stick

Как было сказано в разделе о схемах, Poking Stick — основной способ взаимодействия со схемой. Однако у него есть и дополнительные применения.

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

Вы также можете задать внешний размер схемы с помощью Poking Stick. Щёлкая правой кнопкой мыши предметом в пустоту, вы можете переключать размеры от 4 до 256 (только степени двойки).

Truth Assigner

Это «быстрая» часть Short Circuit. Поскольку схемы создаются на основе существующих редстоун-компонентов, у них будет определённая задержка. Truth Assigner (он же стиральная машина) решает эту проблему.

Truth Assigner — это машина, которая симулирует динамические (обычные) схемы для создания интегральных схем (ИС). Она записывает выход динамической схемы и строит для неё таблицу истинности, поэтому и называется Truth Assigner.

Интегральные схемы — это результат преобразования Truth Assigner. Главное преимущество интегральных схем в том, что они 0-tick, то есть срабатывают мгновенно от внешних источников, а также сразу обновляют соседние блоки, если те изменились.

Однако стоит учитывать, что интегральные схемы не всегда лучший вариант. Есть 2 основные ситуации, в которых не стоит преобразовывать динамическую схему в ИС.

1. Задержка намеренная
2. В схеме есть компонент памяти

1 — очевидно. Поскольку ИС работают 0-tick, после преобразования задержка не сохраняется. 2 — это просто случай, когда выход схемы зависит от состояний блоков внутри схемы, которые не являются постоянными. Например, если выход схемы зависит от медного блока внутри схемы, и этот медный блок может меняться от разных входных сигналов, то это компонент памяти.

Дублирование

Как и динамические схемы, интегральные схемы можно дублировать тем же способом — нажатием ПКМ предметом схемы по блоку. Любые предметы схем могут переключаться между динамическими и интегральными схемами.

Настройки Truth Assigner

Truth Assigner также нужно настроить, чтобы он выдавал правильную интегральную схему.

Первое числовое поле — максимальная задержка. Это число в (игровых) тиках в секунду. На каждой итерации симуляции, если выход схемы не меняется после максимальной задержки, его выход будет принудительно записан.

Кнопка под максимальной задержкой — это режим записи. Его можно переключать между "First Change" и "Full Delay". "First Change" заставляет Truth Assigner записывать выход, как только один из выходов изменился, а "Full Delay" заставляет ждать полную максимальную задержку перед записью выхода.

Кнопка рядом с максимальной задержкой — это кнопка битов. Она переключается между 4, 2 и 1 битом. Поскольку сигнал Redstone может иметь силу от 0 до 15, его можно представить как 4-битное число. Во время симуляции будут перепробованы все возможные комбинации силы сигнала, если установлено 4 бита. Однако если у схемы много входных сторон, это может занять много времени. Например, схема с 3 входами потребует 16x16x16=4096 итераций, что даже при максимальной задержке в 1 тик займёт больше 3 минут.

Использование 2 бит для 3 входов даст 4x4x4=64 итерации, а использование 1 бита — 2x2x2=8 итераций. Если ваша схема не зависит от силы сигнала, рассмотрите использование 1 или 2 бит.

Labelling Stick

Labelling Stick — это предмет для изменения цветов схем. Это особенно полезно для ИС, так как все они имеют абсолютно одинаковую модель. Изменение цвета позволяет игрокам различать схемы с разной функциональностью.

При нажатии ПКМ по любому блоку схемы блок будет переключаться между 16 цветами красителей. Если делать это приседая, цвета будут переключаться в обратном порядке.

Палочку также можно использовать на стенах внутри блока схемы. При нажатии ПКМ по стене будет переключаться её аннотация.

Известные проблемы

• Модель блока интегральной схемы может использоваться для просмотра сквозь мир при использовании MoreCulling.
• Интегральные схемы не могут напрямую выводить сигнал на стены схем.

Сообщение об ошибках

Просто используйте вкладку issues на GitHub.

Чтобы мне было проще исправлять проблемы, если вы столкнулись с кажущимся непреднамеренным поведением, сначала попробуйте сделать следующее:

• Создайте разные вариации багованной схемы. Это поможет сузить круг того, что на самом деле пошло не так. Примеры вариаций:

  • Поменять порядок компонентов
  • Изменить входные/выходные стороны
• Дублируйте схему и разместите несколько её копий. Проверьте, работает ли какая-либо из них правильно.

Если ты убедился, что схема стабильно глючит, добавь саму схему в баг-репорт.

Вдохновение

Этот мод вдохновлён другим модом — Compact Machines — и реальной компьютерной инженерией.

Compact Machines

Это мод, который позволяет игрокам создавать одиночные блоки, внутри которых помещается больший объём. Игроки могут передавать предметы, жидкости и энергию через стороны машины.

Short Circuit берёт эту концепцию и применяет её к редстоуну.

Компьютерная инженерия

Это не только компьютерная инженерия, но и проектирование схем в целом. В реальном проектировании схем схема часто состоит из меньших и более простых схем.

Несколько примеров:

• 1-битный полный сумматор (FA), который складывает 3 однобитных значения и выдаёт их сумму и перенос, использует 2 элемента XOR, 2 элемента AND и 1 элемент OR.
• В арифметико-логическом устройстве (ALU) по сути сочетаются логические элементы AND, OR, NOT, XOR, полный сумматор и мультиплексор (MUX).
• Внутри процессора он объединяет ALU, память и некоторые другие регистры для работы.

Как показывают эти примеры, мы используем ранее спроектированные схемы, чтобы создавать новые, лучшие и более сложные схемы. Short Circuit стремится к этому, сжимая схемы в 1 блок и делая их клонируемыми, чтобы схемы можно было переиспользовать.

Поддержка

Если тебе нравятся мои проекты, подумай о том, чтобы поддержать меня на Ko-fi!