CircuitSim

CircuitSim — мод для Minecraft с симуляцией электрических схем

Этот мод был полностью создан с помощью ИИ.

CircuitSim — это мод для Minecraft Forge версии 1.20.1, который позволяет строить и симулировать настоящие электронные схемы прямо в игре. Размещайте блоки-компоненты в мире, соединяйте их проводами и щёлкайте правой кнопкой по Simulate Block, чтобы запустить полноценную SPICE-симуляцию на базе ngspice.

Возможности

Пассивные и базовые компоненты

• Резистор, конденсатор, катушка индуктивности
• Источники напряжения: DC, синусоидальный (SIN), импульсный (PULSE)
• Источник тока
• Диод
• Провод и земля

Управляемые (зависимые) источники

• VCVS — источник напряжения, управляемый напряжением (E)
• VCCS — источник тока, управляемый напряжением (G)
• CCVS — источник напряжения, управляемый током (H)
• CCCS — источник тока, управляемый током (F)

Компоненты IC / PDK

• IC Resistor, IC Capacitor
• IC NMOS4, IC PMOS4 (4-выводные MOSFET)
• Поддержка PDK SKY130A с настройкой пути .lib, а также универсальный заглушечный PDK и режим свободного .include для пользовательских библиотек

Многоблочные компоненты

• Amplifier — 5×5 субсхема операционного усилителя с выбором 5- или 7-выводного (offset-null) варианта и переключателем вертикального зеркалирования для смены инвертирующего/неинвертирующего входа и шин питания

Измерения

• Voltage Probe — с меткой, измеряет напряжение в узле
• Current Probe — ставится последовательно для измерения тока в ветви

Управление симуляцией

• Simulate Block — запускает анализ. Поддерживаемые типы:

  • .OP — рабочая точка по постоянному току
  • .AC — частотная развёртка (start/stop/точек на декаду, логарифмическая ось частоты)
  • .TRAN — анализ переходных процессов (шаг по времени, время остановки)
• Temperature — одно значение (например, 27) или спецификация развёртки (например, 20:40:5 или 20,30,40) для запуска по одному на каждую температуру
• Режимы совместимости ngspice: hsa, psa, lt, ki, va
• Parametric Block — перебирает параметр целевого компонента (value, W, L, mult, nf) по прогонам
• Commands Block — многострочный блок сырых команд ngspice, вставляемых дословно в секцию .control нетлиста
• Sim Link Block — связывает две физически разъединённые подсхемы в один нетлист без объединения их узлов (полезно для прокладки управляющего источника CCVS/CCCS из удалённой области)

Вывод

• Экран графиков — строит до двух проб одновременно (друг под другом), с всплывающими подсказками с точными значениями; ось X в log10 для AC-развёрток
• SPICE-симуляция через ngspice как подпроцесс — реальные напряжения в узлах и токи в ветвях
• Результаты .OP выводятся в игровой чат
• Внутриигровой GUI для каждого компонента с настройкой значений и разбором SI-суффиксов (p, n, u, m, k, M, …)

Требования

• Minecraft 1.20.1
• Minecraft Forge 47.3.0
• Java 17
• Установленный ngspice, доступный в PATH вашей системы

Установка

Способ 1: просто взять готовое

1. Установите Java 17 и Minecraft Forge 47.3.0 для Minecraft 1.20.1.
2. Установите ngspice и убедитесь, что ngspice_con (Windows) или ngspice (Linux/Mac) доступны из терминала.
3. Скачайте последний релиз
4. Положите мод в папку mods/ вашего Minecraft

Способ 2: собрать самому

1. Установите Java 17 и Minecraft Forge 47.3.0 для Minecraft 1.20.1.
2. Установите ngspice и убедитесь, что ngspice_con (Windows) или ngspice (Linux/Mac) доступны из терминала.

3. Клонируйте этот репозиторий:

   git clone https://github.com/Dank0v/circuitsim.git
   cd circuitsim

4. Соберите мод с помощью Gradle wrapper:

   # Windows
   gradlew.bat build
   
   # Linux / Mac
   ./gradlew build

5. Найдите собранный .jar в build/libs/ — он будет называться примерно так: circuitsim-x.x.x.jar.
6. Положите этот .jar в папку mods/ вашего Minecraft.
7. Запустите игру.

Как использовать

1. Открой творческую вкладку Circuit Simulator, чтобы найти все блоки.
2. Размести блоки-компоненты и соедини их блоками Wire. Любой схеме нужен хотя бы один блок Ground.
3. Нажми правой кнопкой мыши по любому компоненту, чтобы открыть его интерфейс настройки и задать значение.
4. Размести Simulate Block в любом месте, подключённом к схеме.
5. Нажми правой кнопкой мыши по Simulate Block, чтобы запустить симуляцию. Результаты появятся в чате.

Датчики

• Voltage Probe — размести рядом с узлом провода. Нажми правой кнопкой мыши, чтобы дать ему метку. Симуляция покажет напряжение в этом узле.
• Current Probe — размести последовательно (между двумя проводами), чтобы измерить ток через эту ветвь.

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

Лицензия

GPL-3.0 — см. LICENSE.