Cosmonautics: Warp Drive

使用储存的电能，将你的 Sable 实体化飞船和空间站跃迁到任何已记录的位置——可跨越
任何维度。

这是 Create + Cosmonautics 生态的附属模组，构建于 Sable 的
物理/子层级系统之上。

✨ 特性

Warp Drive——插入跃迁水晶（或记忆卡），注册

驱动器当前位置，选择一个已保存的目的地，然后跃迁其附着的整个
实体化结构——包括跨维度跃迁。
控制台屏幕显示实时信息（FE、倒计时、坐标或所选
地点的名称——可配置）。

Warp Crystal——数据核心。只有跃迁水晶才能真正触发

跃迁。

Memory Card——一种更便宜的位置记录方式，无需前往

月球。它可以像跃迁水晶一样注册和存储地点，但无法
自行触发跃迁——请先用
水晶驱动器将其中的地点复制到跃迁水晶上。存储容量可配置。

Crystal Driver——将一个跃迁水晶或记忆卡中保存的位置复制到另一个，

或删除不再需要的位置。

Moon Crystal——一种仅存在于 Cosmonautics 月球

维度中的新资源。开采矿石，然后用 Create 的砂纸精炼。

Hyperspace jump effect——每次跃迁前有短暂的充能，伴随

屏幕扭曲效果（仅实际乘坐飞船的玩家可见）
和汇聚粒子效果（附近所有玩家可见）。

完全可配置：每次跃迁的 FE 消耗、充能时间、粒子数量、

控制台显示模式和记忆卡容量。

CC: Tweaked support——跃迁驱动器可作为外设使用，因此计算机可以读取其状态并通过 Lua 驱动它。此为可选功能；未安装 CC: Tweaked 时模组也能正常运行。

🚀 使用方法

在月球上开采Moon Crystal Ore（需要钻石镐）以获得

Raw Moon Crystal。

用 Create 的砂纸将其精炼为Moon Crystal。
制作一个Warp Crystal——或者如果你还不想跑一趟，可以制作更便宜的Memory Card

——然后制作一个Warp Drive，并将驱动器安装到
Sable 实体化结构上（例如 Create 飞艇）。

插入水晶/记忆卡并按下Register Here以保存该位置。
飞到别处，在同一张（或另一张）

水晶/记忆卡上注册另一个位置——可从跃迁驱动器的 GUI 重命名条目以便
区分。

选择一个目的地并按下Warp。驱动器会消耗 FE，播放一段

短暂的超空间序列，并将整个结构移动到那里。（使用的是
记忆卡？请先用水晶驱动器将其中的地点复制到跃迁水晶上
——跃迁只能通过跃迁水晶进行。）

使用Crystal Driver在水晶/记忆卡之间复制已保存的位置，
或删除其中一个。

📦 前置需求

NeoForge for 1.21.1
Create
Create Cosmonautics——提供

月球维度、钛物品，以及本模组
跨维度跃迁所依赖的 Dimensional Sable 支持

Sable
Dimensional Sable——通常

已通过 Create Cosmonautics 自带的副本存在

本模组不会自行产生 FE——请自备电源

（Create 发电机或任何其他产生 FE 的模组）。

可选：

CC: Tweaked——启用跃迁驱动器的计算机外设功能。

安装 CC: Tweaked 后，跃迁驱动器可作为类型为 warp_drive 的外设使用——可直接连接计算机或通过有线调制解调器连接。

可用方法：getEnergy、getEnergyCapacity、getWarpCost、hasCrystal、getWarpPoints、getSelectedPoint、selectPoint、registerHere、renamePoint、warp、isCharging、getChargeSeconds。

warp() 会开始充能，而不是瞬间跳跃，效果与在 GUI 中按下 Warp 完全一致，并返回 true 或 false 以及一个原因字符串。

GitHub 仓库中包含两个示例程序：warp.lua 会打印驱动器的状态并跃迁到选定坐标点，warp_monitor.lua 则会在高级显示器上绘制一个触摸控制界面。两者都只是可供编辑的起点，而非成品程序——该外设刻意只暴露数据和控制接口，因此界面设计完全由你决定。

完整的方法参考见 GitHub 上的 README。

⚙️ 配置

| 选项 | 默认值 | 描述 |
| ———————– | ——— | ———————————————————————- |
| warpCostFE | 2,000,000 | 每次激活 Warp Drive 消耗的 FE |
| warpChargeTicks | 60 (3s) | 按下 Warp 与实际跳跃之间的延迟 |
| warpParticleCount | 32 | 充能期间在飞船周围生成的粒子数量 |
| warpDriveDisplayMode | FE | 控制台屏幕显示的内容：FE、COUNTDOWN、COORDINATES 或 POINT_NAME |
| memoryCardCapacity | 5 | 内存卡可保存的位置数量（1–10） |

🤖 关于开发的说明

本模组的大部分代码是在 AI（Claude）的帮助下编写的。
设计决策、测试和最终决定由我做出，但我想坦诚说明所使用的工具。

🙏 致谢

Sable 与 Sable Companion，作者 ryanhcode ——

本模组跃迁机制所基于的物理/子层级系统。

Dimensional Sable，作者 hollow_egg —— 跨维度子层级支持，

直接用于实际的跃迁跳跃。

Create Cosmonautics，作者 Cosmonautics Team。
Create，作者 Create 团队。
新模组图标
作者：Devina_X
作品：Create Cosmonautics Expansion

🐛 已知问题

Warp Drive / Crystal Driver 的方块碰撞箱仍是简化的

占位符。

欢迎提交错误报告和反馈——这还是一个早期测试版！

源码与问题追踪：GitHub~~~~

如果你对本模组有建议或发现了 bug，可以在 cosmonautics 的 Discord 服务器上告诉我，并在专用频道中 @.waco__！

Cosmonautics: Warp Drive

截图

介绍