Create: Schematic Compute

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

Table of Contents / 目录

• Overview / 简介
• Blocks / 方块
• Multiplayer Collaboration / 多人协作
• Formula Script Node / 公式脚本节点
• BUS System / BUS 总线系统
• Node Reference / 节点参考
• Controls / 操作指南
• Sable Physics Integration / Sable 物理集成
• Schematic Support / 蓝图兼容
• Recipes / 合成配方
• Block Properties / 方块属性
• Technical Highlights / 技术亮点
• Changelog / 更新日志
• FAQ / 常见问题
• Installation / 安装
• Links / 链接

📖 Overview / 简介

🇬🇧 Create: Schematic Compute is a Create mod addon that introduces 12 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 12 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（每游戏刻） 的频率运行，适合实时控制应用。全部 12 种方块支持多人实时协作编辑，带实时光标追踪和节点锁定保护。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 / 轴上传动读数 + 节点图宿主

🎛️ Amplifier Computer / 功放计算机

Audio graph host with program-computer timing / 音频图宿主 + 编程计算机时序

🔊 Speaker / 音响

Band-subscribed playback terminal / 频段订阅式播放终端

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

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

📝 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

Segment-collision aim solver aligned with the CreateBigCannons 5.11.x ballistic model (semi-implicit Euler dt=1/20, linear drag, per-tick segment hit test matching the in-game raycast), validated against the CBC tick-model golden reference — landing error ≤ 0.24 blocks across five scenarios. 弹道反解火控，对齐 CreateBigCannons 5.11.x 弹道模型（半隐式欧拉 dt=1/20、线性阻力、逐 tick 线段碰撞判定，与游戏内 raycast 同语义），对照 CBC tick 模型金标准五组场景对拍通过（落点误差 ≤ 0.24 格）。 Full paste-ready script: docs/examples/ballistic_solver.formula — ~2.5k–9k interpreter steps per solve (~65–250× leaner than the v1 600 000-step Newton solver), spread across ticks by the budget pool with a progress bar. Parameters baked in for a size-7 barrel · 8 charges · HE/AP shell (v0=160 b/s, g=20 b/s², fd=0.2); the script header table shows how to re-derive them for other charges or shell types. 完整可粘贴脚本：docs/examples/ballistic_solver.formula（每次解算约 2.5k–9k 步，较 v1 的 60 万步牛顿法精简 65–250 倍，由预算池跨 tick 分摊、带进度条）。参数已内化：7 系炮管 · 8 装药 · HE/AP 弹（v0=160、g=20、fd=0.2），脚本头部表格给出换装药/弹种的换算方法。

-- 输入:mx,my,mz 炮口 / tx,ty,tz 目标(参数已内化,见脚本头部参数表)
-- inputs: mx,my,mz muzzle / tx,ty,tz target (ballistic params baked in, see the header table)
-- 输出: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)
-- 俯仰粗扫描(46 点 × 4°,记录低伸首谷+全局最优谷)+ 线段碰撞弹道模拟(半隐式欧拉 dt=1/20,距离持续增大 20 步提前终止)
-- pitch coarse scan (46 pts × 4°, flat-first + best valleys) + segment-collision simulation (semi-implicit Euler dt=1/20, early exit after 20 steps of increasing distance)
p = -89.899
bestwd = 1000000
repeat 46 {
  vx = v0 * cos(p) * sy
  vy = v0 * sin(p)
  vz = v0 * cos(p) * (0 - cy)
  -- ... 400 步线段碰撞模拟(完整脚本见上方链接) ... / 400-step segment simulation (full script linked above)
  p = p + 4
}
-- 细扫(0.5° × 17 点)+ 割线精化(≤10 轮),先低伸解、失败回退高抛解
-- fine scan (0.5° × 17 pts) + secant refinement (≤10 rounds), flat-first with high-arc fallback
@output ay
@output ap
@output hit

→ 6 inputs + 6 outputs / 6输入 + 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 / 节点参考（102 种）

🎮 Controls / 操作指南

All editor actions above are rebindable — editor settings (top-right button) → Keys tab. / 上表编辑器动作均可在编辑器设置（右上角按钮）→「键位」标签页重绑。

🔄 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 12 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! / 用可视化编程释放机械动力的潜力！🚀