Create: Avionics
让你的飞艇自动飞行。
为 Create: Aeronautics 中所有可配置的方块提供 CC: Tweaked 外围设备。读取姿态、高度、速度和航向。控制油门、螺旋桨和气球气体。用 Lua 编写你的自动驾驶程序(这是个糟糕的谐音梗,但依然如此!)
功能
- 热气球的高度保持
- 螺旋桨飞机的航向与俯仰自动驾驶
- 绑定方向盘的巡航控制
- 用于 mounted potato cannon(土豆加农炮)的追踪炮塔
- 以及你可以编写任何控制循环的其他功能
开始使用
双引擎飞船的航向保持:
local nav = peripheral.find("navigation_table")
local port, stbd = peripheral.find("analog_transmission")
local target = nav.getHeadingRad()
while true do
local err = (target - nav.getHeadingRad() + math.pi) % (2*math.pi) - math.pi
local diff = math.max(-5, math.min(5, err * 4))
port.setSignal(7 - diff); stbd.setSignal(7 + diff)
sleep(0.05)
end
三个外围设备,一个 P 控制器,飞船即可锁定航向。每个 Aeronautics(以及几乎每个 Create)方块都是一个外围设备——读取传感器,设置执行器,编写你想要的控制循环。
方块
- Avionics controller(航空电子设备控制器) — 一根电缆将飞船上的每个外围设备连接到你的计算机,命名遵循船首方向(例如
ship_velocity_sensor_forward_0、ship_propeller_bearing_aft_port_0)。同时也是飞船的应答机。指南 - Radar Mk.1(雷达 MK.1) — 单束扫描,范围 256 格:显示船只、地形、距离、接近速度和应答机名称。
- 气象仪器 — 温度计、湿度计、气压计、雨量计、日历;它们读取飞船所处空气的气象数据。指南
不仅限于飞行器
相同的 peripheral.find() 接口驱动着升降机、车辆以及整个旋转网络——不仅仅是会飞的东西。
Create Elevators(Create 电梯) — 枚举楼层,呼叫轿厢,读取其位置:
local lift = peripheral.find("Create_ElevatorPulley")
lift.setTargetFloor(lift.getFloors()[3].y) -- 发送轿厢到第 3 层
repeat sleep(0.1) until lift.isArrived()
print("Arrived: " .. lift.getCurrentFloor().short_name)
Kinetic SCADA(动能 SCADA 系统) — 遍历旋转网络,在过载时报警:
local draw, capacity = 0, 0
for _, name in ipairs(peripheral.getNames()) do
local p = peripheral.wrap(name)
if p.getNetworkId then -- 任何动能方块
draw = draw + p.getStressImpact()
capacity = capacity + p.getStressContribution()
if p.isOverstressed() then
print("OVERSTRESSED " .. p.getSelfId() .. " (" .. p.getKind() .. ")")
end
end
end
print(("Network load: %.0f / %.0f SU"):format(draw, capacity))
Vehicles(载具) — 对轮式挂载点进行转向和制动覆盖:
for _, w in ipairs({ peripheral.find("wheel_mount") }) do
w.setSteering(0.5) -- -1..1 -> +/-30 度
if w.getTouchingFriction() < 0.5 then w.setBrake(0) end -- 在湿滑路面上松开刹车
end
getKind、getSubnetworkAnchorId、getColumnContacts、getTouchingFriction —— 读取侧的功能同样丰富。
完整 API 文档 — 单位、体坐标系约定、所有方法说明。
阅读平行指南。5 Hz 和 20 Hz 的感觉是不同的。
安装
依赖: MC 1.21.1 · NeoForge 21.1.219+ · Create 6.0.10+ · Simulated/Aeronautics/Offroad 1.2.1+ · Sable 1.1.0+ · CC: Tweaked 1.115+
可选: Thermoo(为仪器提供气候模拟)· Serene Seasons(为日历提供季节支持)
需在客户端和服务端同时安装。
官方下载仅在此处发布:Modrinth、CurseForge 和 GitHub。其他列表均为重新上传,通常已过时。
社区
Discord — 提问、分享脚本、展示飞船。Bug 请提交至 GitHub Issues。
搭配模组
源代码 · Issue
github.com/SolAstrius/CreateAvionics
MIT 协议。基于 RyanHCode 在 Simulated 中构建的 CC 外围设备基础 —— NOTICE。
由我本人 Sol Astrius Phoenix 制作。
Create: Avionics
Make your airship fly itself.
CC: Tweaked peripherals for every instrumentable block in Create: Aeronautics. Read attitude, altitude, velocity, bearing. Drive throttle, propellers, balloon gas. Write your autopilot in Lua (that's a bad pitch, but still!)
Build
- Altitude-hold for hot-air balloons
- Heading-and-pitch autopilots for propeller aircraft
- Cruise control bound to a steering wheel
- Tracked turrets for mounted potato cannons
- Whatever else you can write a control loop for
Start
Heading hold on a twin-engine ship:
local nav = peripheral.find("navigation_table")
local port, stbd = peripheral.find("analog_transmission")
local target = nav.getHeadingRad()
while true do
local err = (target - nav.getHeadingRad() + math.pi) % (2*math.pi) - math.pi
local diff = math.max(-5, math.min(5, err * 4))
port.setSignal(7 - diff); stbd.setSignal(7 + diff)
sleep(0.05)
end
Three peripherals, one P-controller, the ship locks heading. Every Aeronautics (and nearly every Create) block is a peripheral — read sensors, set actuators, write the loop you want.
Blocks
- Avionics controller — one cable connects every peripheral on the ship to your computer, under names that follow the ship's bow (
ship_velocity_sensor_forward_0,ship_propeller_bearing_aft_port_0). Also the ship's transponder. Guide - Radar Mk.1 — one beam, 256 blocks: ships, terrain, distance, closing speed, transponder names.
- Weather instruments — thermometer, hygrometer, barometer, rain gauge, almanac; they read the air the ship is flying through. Guide
Not just aircraft
The same peripheral.find() surface drives lifts, vehicles, and your whole rotational network — not only things that fly.
Create Elevators — enumerate floors, call the cabin, read where it is:
local lift = peripheral.find("Create_ElevatorPulley")
lift.setTargetFloor(lift.getFloors()[3].y) -- send the cabin to the 3rd floor
repeat sleep(0.1) until lift.isArrived()
print("Arrived: " .. lift.getCurrentFloor().short_name)
Kinetic SCADA — walk the rotation network, alarm on overstress:
local draw, capacity = 0, 0
for _, name in ipairs(peripheral.getNames()) do
local p = peripheral.wrap(name)
if p.getNetworkId then -- any kinetic block
draw = draw + p.getStressImpact()
capacity = capacity + p.getStressContribution()
if p.isOverstressed() then
print("OVERSTRESSED " .. p.getSelfId() .. " (" .. p.getKind() .. ")")
end
end
end
print(("Network load: %.0f / %.0f SU"):format(draw, capacity))
Vehicles — steering and brake override on wheel mounts:
for _, w in ipairs({ peripheral.find("wheel_mount") }) do
w.setSteering(0.5) -- -1..1 -> +/-30 deg
if w.getTouchingFriction() < 0.5 then w.setBrake(0) end -- ease off on slippery stuff
end
getKind, getSubnetworkAnchorId, getColumnContacts, getTouchingFriction — the read side is as rich as the write side.
Full API docs — units, body-frame conventions, every method.
Read the parallel guide. 5 Hz and 20 Hz feel different.
Install
Needs: MC 1.21.1 · NeoForge 21.1.219+ · Create 6.0.10+ · Simulated/Aeronautics/Offroad 1.2.1+ · Sable 1.1.0+ · CC: Tweaked 1.115+
Optional: Thermoo (climate for the instruments) · Serene Seasons (the almanac's calendar)
Install on both client and server.
Official downloads are only here, on Modrinth, CurseForge and GitHub. Other listings are reuploads, usually outdated.
Community
Discord — questions, scripts, ships. Bugs go to GitHub issues.
Pairs with
Source · Issues
github.com/SolAstrius/CreateAvionics
MIT. Built on RyanHCode's CC peripheral foundation in Simulated — NOTICE.
Created by yours truly, Sol Astrius Phoenix.
下载 Create: Avionics — ComputerCraft 用于航空
下载 Create: Avionics — ComputerCraft 用于航空
下载 Create: Avionics — ComputerCraft 用于航空
下载 Create: Avionics — ComputerCraft 用于航空
下载 Create: Avionics — ComputerCraft 用于航空
下载 Create: Avionics — ComputerCraft 用于航空
下载 Create: Avionics — ComputerCraft 用于航空
下载 Create: Avionics — ComputerCraft 用于航空
下载 Create: Avionics — ComputerCraft 用于航空
新增
-
navigation_table:getMaxRange. 持有物品的信号截止范围,该距离下表现得就像已停靠在目标旁——因此仅靠航向编程的程序可能会追逐一个失效的指针。上游将“无限制”表示为零,但这无法与距离进行比较;此情况返回math.huge。罗盘和地图始终无限制,而其他所有项目则采用 200 格默认值,因此这两个常量都不适合硬编码。 -
navigation_table:getBearingRate/getBearingRateRad. 指针摆动的速度,单位为每秒度数(或弧度)。这是拦截信号——当目标在前方且正在接近时,接近零的航向率意味着当前航线将抵达目标,而稳定的非零航向率意味着将会错过,且随着距离缩短,错过幅度会越来越大。上游从未计算过此值,因此程序需要在 Lua 中对getBearing()进行差分运算,并自行处理 ±180 度接缝问题,其中指针扫过正后方时会被读作另一方向的完整旋转。每服务器刻采样一次——即表格重新计算角度的节奏,而非 11 刻的距离周期——并在切换航点后抑制一帧,因为重新瞄准指针不属于载具运动。 -
navigation_table:getTargetName和getTargetDisplayName. 每个携带单项目的导航项对程序而言都是匿名的:绑定锚点的罗盘仅报告追踪器 UUID,标记地图仅报告数字 ID,探险家/自然罗盘的目标甚至不指向任何东西。显示端可以说它 heading 哪里,但从未说明航点 叫什么。getTargetName返回铁砝赋予的名称——玩家实际选择的标签——对于未命名物品则为 nil;getTargetDisplayName回退到物品自身的名称,以确保读数总有内容可打印 ([#28])。 -
气象仪器:温度计、湿度计、气压计、雨量筒和年历。 Avionics 首批自有方块。每个仪器以固定单位读取单一数值(
C、rh、hPa、mm/h,以及year或moon),每秒采样一次并缓存,因此轮询开销极低。读数取自方块在世界中的位置,并投影出任何 Sable 子层级之外,因此安装在飞艇上的仪器读取的是其飞行经过的空气,而非其方块存储所在地块的空气。温度和湿度来自 Thermoo 的环境数据(如果已安装),这会捕获所有接入 Thermoo 的气候模组;压力来自 Sable 的维度物理机制,即飞艇浮力使用的同一曲线,降雨和雷暴会降低压力;年历在主世界遵循 Serene Seasons,在其他地方则遵循月亮周期。所有仪器均回退至原版生物群系数据的估算值,read会报告每个值的来源。雨量筒还维护一个累计总量,empty操作可将其重置。 -
Avionics 控制器:为整艘飞船提供一条有线连接。 放置在 Sable 飞船上并连接到计算机后,它将飞船上的每个外设发布到该网络,仿佛每个外设都拥有自己的调制解调器。名称带有
ship_前缀,因此绝不会与调制解调器共享的名称冲突,只要方块留在飞船上,编号就会保持不变,并且重启后也能保留。按方向测量的外设以飞船术语命名(如ship_velocity_sensor_forward_0、ship_optical_sensor_down_0、ship_docking_connector_up_0),螺旋桨、燃烧器和引擎则以其在船体上的位置命名(如ship_propeller_bearing_aft_port_0),相对于由第一个控制器设定、并由扳手移动的方向舵。一艘飞船上的多个控制器共享同一组名称,当发布方被摧毁时,下一个接管而无需重命名。计算机、调制解调器和纯传输(create_avionics:not_bridged标签)被排除在外;控制器仅作为ship_avionics_controller出现一次。 -
应答机。 控制器同时也是飞船的应答机:用扳手点击其天线,或通过 Lua 调用
setTransponder,即可全局切换。开启时,命中该飞船的雷达会报告其名称;关闭时,该飞船即为不明接触目标。 -
雷达 Mk.1. 从其正面发射一道狭窄波束,每秒两次,射程 256 格。
getContact报告其遇到的内容(ship、terrain,或因雷达自身飞船而obstructed)、距离、接近速度和应答机名称;比较器读取的范围从近距离的 15 到满射程时的 1。 -
所有七个方块的配方。仪器在无斑岩外壳上形状无关,类似于 Create 自带的仪表;控制器是黄铜级部件,包含精密机构、电子管和有线调制解调器。
-
文档站点上关于 [the ship bridge] 和 [the instruments] 的指南。
-
新版本到达时在聊天栏中提示。 在安装或更新到新版本后首次加入世界时,客户端会一次性显示其带来的内容,并提供更新日志、指南和社区链接([Discord],或 [Telegram] 用于俄语社区)。补丁版本保持静默;在
create_avionics-client.toml中设置announceUpdates = false可关闭此功能。
更改
- Avionics 现在必须同时安装在客户端和服务端。 它添加了方块、模型和纹理,因此缺少它的客户端无法加入安装了它的服务器 ([#1])。
修复
- ComputerCraft 不再为高度传感器、导航表、万向节传感器、速度传感器、扭转弹簧、便携式引擎、物理装配机、方向盘和模拟传动外设记录 "Lua Method … should be final" 警告。CC 会在计算机首次使用外设时对所有可覆盖的
@LuaFunction发出警告;现在全部设为final。无行为变更。
文档
propeller_bearing.getRotationSpeed和getAngularSpeed此前仅描述为“旋转速度”和“角速度”([#29])。两者单位均为每刻度的度数,且报告的是螺旋桨的实际转速,而非传动轴的转速:由于每刻度会以0.4 / sqrt(sailPower)的幅度向输入值收敛,因此较大的螺旋桨加速和减速更缓慢。文档现已补充了单位、转换为 RPM 的方法、在 Create 默认最大配置下完全加速时读数为 76.8,以及未组装或正在拆解时的行为说明。从计算机接口调用时,这两个函数始终返回相同的值;上游的差异仅限于轴承自身的每刻处理逻辑及渲染部分。getSpeed在动能外设中现明确其单位为 RPM(带符号),并指出该值为网络速度,惯性块可能会导致读数延迟。gimbal_sensor.getAngles现警告其在接近垂直方向时角度计算会出现问题,并指向不受此影响的读数:使用getGravity获取倾斜度,或使用navigation_table.getOrientation获取作为四元数的完整朝向([#30])。
新增
Create_GantryShaft现在可以在移动过程中检测到车厢。 门式起重机车厢在组装完成的瞬间就不再是一个方块——Create 会将装置锚定在车厢自身的位置,并从世界中移除其方块——因此整个移动期间每次位置读取都返回 nil,而这恰恰是控制程序需要获取位置的时候。外围设备现在首先查找装置实体,如果找不到则回退到方块扫描,并使用 Create 自身的轨道成员资格测试,从而使位置在整个行程中保持实时,且在行进过程中为小数而非整数。Create_GantryShaft:getCarriage,在一次读取中返回位置、状态以及适用的 id/错误/剩余值。在控制循环中优先使用此方法,因为所有字段均来自同一次观测,因此不会出现因跨刻轮询而导致的字段不一致问题。Create_GantryShaft:getState,区分empty(空)、parked(停放)、moving(移动)、stalled(停滞)和failed(失败)。之前这些状态全部返回 nil,无法区分“无车厢”、“被阻塞”或“组装失败”。Create_GantryShaft:isAssembled、isStalled、getRemainingMovement、getLastAssemblyError、getRailStart和disassemble。这使得门式起重机的功能与其他装置控制器(活塞、绳索滑轮、轴承和电梯滑轮)保持一致——它们都已具备组装状态和错误读取功能。getRailStart暴露了测量轨道索引的起始点,这样航点可以锚定在世界空间中,而不是当玩家在起始端延伸轨道时发生无声偏移。Create_GantryShaft现在会队列化gantry_departed、gantry_arrived、gantry_stalled和gantry_assembly_failed,这样控制器可以等待事件而不是进行轮询。上游组件不会触发任何这些事件;每五刻对轨道进行边缘轮询,且仅针对实际连接了计算机的轴进行。
修复
Create_GantryShaft:hasCarriage和getCarriagePosition正在查找错误的方块。 车厢检测测试的逻辑被反转了——它要求GantryCarriageBlock.FACING指向轴本身,而在 Create 中它是指向 远离 轴的方向。因此谓词从未匹配到查询轨道上的任何车厢;它实际匹配到的是一个属于 不同 轨道、距离两个方块远的、位于一个方块外的车厢。由于方向迭代从DOWN(下)开始,实际效果是“报告轨道下方的车厢,永远不是自己的”——这在堆叠的门式起重机上最为明显,其中轨道、车厢和第二轨道恰好呈现这种几何结构。已在 #24 中报告。Create_GantryShaft: 轨道长度和索引超出了轨道末端。 轨道遍历接受同一 轴 上的任何相邻轴;Create 仅在朝向完全相等时将轴加入同一个轨道。两个背靠背放置但朝向相反的轴是两个独立的轨道,而 sneaking(潜行)放置在现有轴旁边会故意给予相反的朝向——因此这并非边缘情况,而是极易触发的正常操作。影响了getRailLength、getRailIndex以及原始的getCarriagePosition所基于的起始点测量。Create_GantryShaft可以通过 Lua 调用加载并生成区块。 轨道遍历在每个方向最多调用getBlockState256 次,且没有加载检查,而Level.getBlockState会使用requireChunk = true解析其区块。因此,指向未生成地形的轨道会在服务器线程上同步生成它。现在,遍历在未加载的区块处停止,与 Create 自身的行为一致。Create_GantryShaft文档描述了一种不存在的红石行为。isPowered声称供电会使轴的行驶方向反转,而getMovementSpeed声称对此反转进行了考量。Create 的getPinionMovementSpeed根本不读取任何红石状态。供电的门式起重机轴会停止平移其车厢,并将旋转传递到车厢的输出轴上——文档将真实机制搞反了。此外,现已补充文档:±0.49 方块/刻的限制,以及canAssembleOn是按轴回答的,单个轴永远无法组装,且两端需要相反的符号。
文档
altitude_sensor.getVerticalSpeed文档描述了一个 Lua 调用者无法观察到的区别。注释称“仅限服务端——客户端返回 0”,这描述的是方块实体:有限差分是在 tick 处理器中累积的,该处理器在客户端级别会提前返回。但 CC:Tweaked 在服务端运行 Lua,因此外围设备调用永远不会看到客户端副本。已重述为实际可观察的内容——存在一刻的延迟,且在传感器放置或加载后tick两次之前返回 0。同样的表述漏洞已从四个gas_provider气球获取器中移除(“或 0 如果没有服务端气球” → “或 0 如果没有附加气球”);在外围设备调用中,附加的气球始终是服务端的那个。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
添加区块认领和玩家组队功能,并与 Xaero's Minimap 和 World Map 集成
评论 0
登录后参与评分
还没有评论,来抢沙发吧