Create: Schematic Compute

🎮 9 Programmable Blocks · 86 Node Types · Formula Syntax Highlighting & Autocomplete · Multiplayer Collaboration
九种可编程方块 · 86种节点 · 公式语法高亮与自动补全 · 多人实时协作
Drag, connect, and build logic — just like Unreal Engine Blueprints!
拖拽连接，构建逻辑 — 像虚幻引擎蓝图一样直观！
Created by StarryNight_Luo (y15173334444)

📖 Overview / 简介

🇬🇧 Create: Schematic Compute is a Create mod addon that introduces 10 programmable blocks + 1 portable terminal with a visual node-based programming system. Instead of writing complex redstone circuits, simply drag and connect nodes to build logic — just like Unreal Engine Blueprints or Blender Geometry Nodes. Each computer runs at 20Hz (every game tick) for real-time control. All 10 blocks support real-time multiplayer collaborative editing with live cursor tracking and node lock protection. The FORMULA script editor features syntax highlighting (9 token colours), intelligent autocomplete (functions, variables, @output), real-time validation with error badges, and named constants (PI)/(E).

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

🖥️ Blocks / 方块

🖥️ Holographic Monitor / 全息显示器

3D floating display / 3D 悬浮显示方块

🖥️ Blueprint Computer / 蓝图计算机

Redstone Link controller / 红石链接控制器

⚡ 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。

🧮 Syntax Overview / 语法速览

赋值与输入引脚 / Assignments & input pins — any name assigned anywhere is an internal variable; every other name that is read becomes an input pin. 任何处被赋值的名字是内部变量，其余被读取的名字成为输入引脚：

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

→ 1 input pin + 1 output / 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 — < > <= >= are exact; ==/!= use a 1e-6 tolerance; && || ! judge truthiness as !=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

Vector functions: vec3 length normalize dot cross dist yaw pitch; component access 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 input converts live — （）→()、×→*、≥→>=，full-width letters/digits/spaces convert to half-width as you type. （）→()、×→*、≥→>=、全角字母/数字/空格即输即转半角。

预算池 / Budget pool — loop-heavy scripts spread across ticks: a thin progress bar below the node shows solve progress; outputs freeze during the spread and update only on completion (emit-on-done); the warm edit-panel toggle controls whether an input change keeps iterating or strictly freezes. 循环重负载脚本跨 tick 分摊：节点下方进度条显示解算进度，spread 期间输出冻结、完成才更新（emit-on-done）；warm 编辑区开关控制输入变更时继续迭代还是严格冻结。典型应用见下方火控弹道解算示例。

🎯 火控弹道解算示例 / Fire-Control Ballistic Solver Example

Newton-iteration aim solver ported from a Python reference (CreateBigCannons ballistic model: semi-implicit Euler dt=1/20, linear/quadratic drag), verified against four reference scenarios. 牛顿迭代弹道反解，移植自 Python 参考实现（CreateBigCannons 弹道模型：半隐式欧拉 dt=1/20、线性/二次阻力），四组场景对拍通过。 Full paste-ready script: docs/examples/ballistic_solver.formula — ~600k interpreter iterations per solve, spread across ticks by the budget pool with a progress bar. 完整可粘贴脚本：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 inputs + 6 outputs / 11输入 + 6输出

🎨 Syntax Highlighting / 语法高亮

Real-time colour-coded editing with 9 token categories. 9 种词法分类的实时彩色标注。

🔍 Autocomplete / 自动补全

Type to trigger suggestions near the caret, rendered above all pins. 输入即触发，候选框显示在光标下方、所有引脚上方。

✅ Real-Time Validation / 实时校验

Issues shown as red ⚠ badge on the node title bar. Hover the badge to see details. 错误以红色 ⚠ 徽章显示在节点标题栏，悬停查看详情。

📐 Named Constants / 命名常量

(PI) and (E) in grouping parentheses are literal constants (π ≈ 3.14159, e ≈ 2.71828). Bare PI / E or PI / E inside function calls like sin(PI) are treated as variable references (create input pins). (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 input pin (PI) + 1 output / 1 输入引脚 + 1 输出

🚌 BUS System / BUS 总线系统

Global named-channel communication across computers. Like publish-subscribe message bus. 全局命名通道跨计算机通信系统，类似发布-订阅消息总线。

🧩 Node Reference / 节点参考（95 种）

🎮 Controls / 操作指南

🔄 Sable Physics Integration / Sable 物理集成

Deep integration with Sable physics engine for rotating structures. / 与Sable物理引擎深度集成，支持旋转结构。

Thread safe / 线程安全: Shared fields volatile. Without Sable / 无Sable: Control Seat fully functional, Sensor outputs 0 / 控制座椅完全可用，传感器输出0

💾 Schematic Support / 蓝图兼容

All 10 blocks support Create's Schematicannon — graphs and state fully preserved. / 全部十种方块支持蓝图大炮，图与状态完整保留。

Uses Create's IMergeableBE + SafeNbtWriter / 采用 Create 官方接口

📦 Recipes / 合成配方

⚙️ Block Properties / 方块属性

🔧 Technical Highlights / 技术亮点

📜 Changelog / 更新日志

完整变更日志已拆分至 CHANGELOG.md —— 每个版本一个 <details> 块。 The full changelog now lives in CHANGELOG.md — one <details> block per release.

更早版本（v1.2.3 及以前）见 CHANGELOG.md。 Older releases (v1.2.3 and earlier): see CHANGELOG.md.

❓ FAQ / 常见问题

📥 Installation / 安装

Sable is optional / Sable 为可选

1. Install NeoForge + Create / 安装 NeoForge + Create
2. Place .jar in mods folder / 将 .jar 放入 mods
3. Launch! / 启动！

🌐 Links / 链接

• GitHub: github.com/y15173334444/create-schematic-compute
• Modrinth: modrinth.com/mod/create-schematic-compute
• License / 许可证: MIT © 2026 StarryNight_Luo

⭐ If you enjoy this mod, star us on GitHub! / 喜欢请在GitHub点⭐！
Unleash Create's potential with visual programming! / 用可视化编程释放机械动力的潜力！🚀