create-schematic-compute

Create: Schematic Compute

🎮 9 программируемых блоков · 86 типов узлов · Подсветка синтаксиса формул и автодополнение · Совместная работа в мультиплеере
九种可编程方块 · 86种节点 · 公式语法高亮与自动补全 · 多人实时协作
Перетаскивай, соединяй и строй логику — прямо как в Blueprints из Unreal Engine!
拖拽连接，构建逻辑 — 像虚幻引擎蓝图一样直观！
Создано StarryNight_Luo (y15173334444)

📖 Обзор / 简介

🇬🇧 Create: Schematic Compute — это аддон для Create, добавляющий 10 программируемых блоков + 1 портативный терминал с визуальной системой программирования на основе узлов. Вместо того чтобы строить сложные редстоун-схемы, просто перетаскивай и соединяй узлы, чтобы собрать логику — прямо как в Blueprints из Unreal Engine или Geometry Nodes в Blender. Каждый компьютер работает на 20 Гц (каждый игровой тик) для управления в реальном времени. Все 10 блоков поддерживают совместное редактирование в мультиплеере в реальном времени с отслеживанием курсоров и защитой блокировки узлов. Редактор скриптов FORMULA поддерживает подсветку синтаксиса (9 цветов токенов), умное автодополнение (функции, переменные, @output), проверку в реальном времени с бейджами ошибок и именованные константы (PI)/(E).

🇨🇳 机械动力：蓝图计算机 是一个机械动力附属模组，添加了十种可编程方块和一个便携终端，采用可视化节点图编程系统。无需搭建复杂红石电路，只需拖拽连接节点即可构建逻辑——就像虚幻引擎的蓝图系统或 Blender 的几何节点一样直观。每台设备拥有独立的节点图，以 20Hz（每游戏刻） 的频率运行，适合实时控制应用。全部 10 种方块支持多人实时协作编辑，带实时光标追踪和节点锁定保护。FORMULA 公式脚本编辑器 支持语法高亮（9 种词法颜色）、智能自动补全（函数、变量、@output）、实时校验与错误徽章、以及命名常量 (PI)/(E)。

🖥️ Блоки / 方块

🖥️ Голографический монитор / 全息显示器

3D-дисплей с парящим отображением / 3D 悬浮显示方块

🖥️ Компьютер-чертёж / 蓝图计算机

Контроллер Redstone Link / 红石链接控制器

⚡ Speed Proxy / 转速代理控制器

Speed Controller direct control / 转速直控

⚙️ Programmable Transmission / 可编程变速器

In-line programmable gearbox / 轴上可编程变速

🔧 CNC Gearbox / 数控齿轮箱

Driven clutch + motion quota / 从动离合器 + 运动配额

🔌 Program Computer / 编程计算机

Sequential logic / 时序逻辑专用机

🪑 Control Seat / 控制座椅

Sit-able controller / 可乘坐控制器

📐 Attitude Sensor / 姿态传感器

Physics structure orientation / 物理结构姿态读取

📡 3D Holographic Radar / 3D全息显示雷达

Real-time scanner / 实时实体扫描器

📱 Portable Terminal / 便携终端

Handheld remote editor / 手持远程编辑器

🎛️ Kinetic Gauge / 动力传感器

In-line kinetic readout + graph host / 轴上传动读数 + 节点图宿主

👥 Multiplayer Collaboration / 多人协作（v1.2.4+）

Real-time collaborative graph editing for all 7 block types. Multiple players can edit the same graph simultaneously. 全部 7 种方块支持多人实时协作编辑同一节点图。

📝 Formula Script Node / 公式脚本节点

Multi-line script editor (v1.2.0+) — assignments, control flow, vec3, named outputs, comments, line continuation. 多行脚本编辑器 — 支持赋值、控制流、vec3、命名输出、注释、续行。完整语法见 docs/formula-syntax-manual.md。

🧮 Обзор синтаксиса / 语法速览

Присваивания и входные пины / Assignments & input pins — любое имя, которому где-либо присвоено значение, является внутренней переменной; любое другое имя, которое читается, становится входным пином. 任何处被赋值的名字是内部变量，其余被读取的名字成为输入引脚：

x = a + 1        -- x 内部变量 / internal; a 成为输入引脚 / input pin
@output x

→ 1 входной пин + 1 выход / 1 输入 + 1 输出

Управляющий поток / Control flow — repeat / while / if / else / break / continue：

acc = 0
repeat 100 { acc = acc + 1 }
if (acc > 50) { acc = 0 } else { acc = 1 }
@output acc

Сравнение и логика / Comparison & logic — < > <= >= точные; ==/!= используют допуск 1e-6; && || ! считают истинность как !=0. < > <= >= 精确；==/!= 1e-6 容差；&& || ! 以 !=0 判真。

vec3 и векторные функции / vec3 & vector functions：

v = vec3(3, 4, 0)
@output length(v)     -- 5
@output yaw(v)        -- 角度制,与 DIRECTION 节点一致 / degrees, mirrors DIRECTION
@output v             -- vec3 自动展开为 v.x/v.y/v.z 三个输出引脚 / expands into 3 scalar pins

Векторные функции: vec3 length normalize dot cross dist yaw pitch; доступ к компонентам v.x/y/z. 向量函数：vec3 length normalize dot cross dist yaw pitch；分量访问 v.x/y/z。

Таблица функций / Functions（углы в градусах / trig in degrees）： 15 скалярных функций / 15 scalar functions — sin cos tan asin acos atan2 sinh cosh sqrt ln log exp sec csc cot 7 векторных функций / 7 vector functions — vec3 length normalize dot cross dist yaw pitch

Ввод CJK конвертируется на лету / CJK input converts live — （）→()、×→*、≥→>=，полноширинные буквы/цифры/пробелы конвертируются в полуширинные по мере ввода. （）→()、×→*、≥→>=、全角字母/数字/空格即输即转半角。

Пул бюджета / Budget pool — скрипты с тяжёлыми циклами распределяются по тикам: тонкая полоса прогресса под узлом показывает прогресс решения; выходы замораживаются во время распределения и обновляются только по завершении (emit-on-done); переключатель warm в панели редактирования управляет тем, продолжает ли изменение входа итерации или строго замораживает. 循环重负载脚本跨 tick 分摊：节点下方进度条显示解算进度，spread 期间输出冻结、完成才更新（emit-on-done）；warm 编辑区开关控制输入变更时继续迭代还是严格冻结。Типичный пример применения см. в примере решения баллистики системы управления огнём ниже.

🎯 Пример решения баллистики системы управления огнём / Fire-Control Ballistic Solver Example

Решатель прицеливания методом итераций Ньютона, портированный из эталонной реализации на Python (баллистическая модель CreateBigCannons: полунеявный Эйлер dt=1/20, линейное/квадратичное сопротивление), проверен на четырёх эталонных сценариях. 牛顿迭代弹道反解，移植自 Python 参考实现（CreateBigCannons 弹道模型：半隐式欧拉 dt=1/20、线性/二次阻力），四组场景对拍通过。 Полный готовый к вставке скрипт: docs/examples/ballistic_solver.formula — ~600 тыс. итераций интерпретатора на одно решение, распределяются по тикам пулом бюджета с полосой прогресса. 完整可粘贴脚本：docs/examples/ballistic_solver.formula（约 60 万次迭代，由预算池跨 tick 分摊、带进度条）。

-- 输入:mx,my,mz 炮口 / tx,ty,tz 目标 / v0 初速 / g 重力(正) / fd 阻力系数 / qd 二次阻力 / den 密度
-- inputs: mx,my,mz muzzle / tx,ty,tz target / v0 speed / g gravity(+) / fd drag / qd quadratic drag / den density
-- 输出:ay 射向角[0,360) / ap 射角 / hit 可达 / vx0,vy0,vz0 初速向量
-- outputs: ay aim yaw [0,360) / ap aim pitch / hit reachable / vx0,vy0,vz0 velocity vector
ay = atan2(tx - mx, 0 - (tz - mz))
if (ay < 0) ay = ay + 360
cy = cos(ay)
sy = sin(ay)
-- 俯仰粗扫描(361 点)+ 轨迹模拟(半隐式欧拉 dt=1/20,阻力/重力积分,记录最近距离)
-- pitch coarse scan (361 points) + trajectory simulation (semi-implicit Euler dt=1/20, drag/gravity integration, track closest distance)
p = -89.899
bestd = 1000000
repeat 361 {
  vx = v0 * cos(p) * sy
  vy = v0 * sin(p)
  vz = v0 * cos(p) * (0 - cy)
  -- ... 1200 步轨迹模拟(完整脚本见上方链接) ... / 1200-step simulation (full script linked above)
  p = p + 0.49944
}
-- 牛顿迭代精化(≤50 轮,中心差分,阻尼 0.5) / Newton refinement (≤50 rounds, central difference, damping 0.5)
@output ay
@output ap
@output hit

→ 11 входов + 6 выходов / 11输入 + 6输出

🎨 Подсветка синтаксиса

Редактирование с цветовой разметкой в реальном времени, 9 категорий токенов.

🔍 Автодополнение

Ввод запускает подсказки рядом с курсором, они отображаются поверх всех пинов.

✅ Проверка в реальном времени

Ошибки показываются красным значком ⚠ в заголовке узла. Наведите на значок, чтобы увидеть подробности.

📐 Именованные константы

(PI) и (E) в группирующих скобках — это литеральные константы (π ≈ 3.14159, e ≈ 2.71828). Голые PI / E или PI / E внутри вызовов функций вроде sin(PI) считаются ссылками на переменные (создают входные пины).

-- (PI) = literal π, not a variable / литерал π, не переменная
-- sin(PI) = PI is a variable input / PI — это входная переменная
result = (PI) + sin(PI)
@output result

→ 1 входной пин (PI) + 1 выход

🚌 Система BUS

Глобальная связь между компьютерами через именованные каналы. Что-то вроде шины сообщений «публикация-подписка».

🧩 Справочник узлов (95 видов)